Partilhar via

az storage file metadata

Note

Este grupo de comandos tem comandos definidos tanto no CLI do Azure como em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerencie metadados de arquivos.

Comandos

Name Description Tipo Status
az storage file metadata show

Retornar todos os metadados definidos pelo usuário para o arquivo.

 Core disponibilidade geral
az storage file metadata show (storage-preview extensão)

Retornar todos os metadados definidos pelo usuário para o arquivo.

 Extension disponibilidade geral
az storage file metadata update

Atualizar metadados do arquivo.

 Core disponibilidade geral
az storage file metadata update (storage-preview extensão)

Atualizar metadados do arquivo.

 Extension disponibilidade geral

az storage file metadata show

Editar

Retornar todos os metadados definidos pelo usuário para o arquivo.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent --enable-file-backup-request-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--file-endpoint]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Exemplos

Mostrar metadados para o ficheiro

az storage file metadata show -s MyShare --path /path/to/file

Parâmetros Obrigatórios

--path -p

O caminho para o arquivo dentro do compartilhamento de arquivos.

--share-name -s

O nome do compartilhamento de arquivos.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com a chave da conta de armazenamento ou um token SAS. Se nenhum deles estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta Azure autenticada. Se um grande número de comandos de armazenamento for executado, a cota da API poderá ser atingida.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--auth-mode

O modo no qual executar o comando. O modo "login" usará diretamente suas credenciais de login para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceites: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro obrigatório para usar com a autenticação OAuth (Azure AD) para ficheiros. Isso ignorará qualquer verificação de permissão no nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo que haja ACLs em vigor para esses arquivos/diretórios.

Propriedade Valor
Default value: False
--connection-string

String de cadeia de ligação de conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--disallow-trailing-dot

Se verdadeiro, o ponto à direita será cortado do URI de destino. Padrão para False.

Propriedade Valor
Default value: False
Valores aceites: false, true
--file-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com a chave da conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário do serviço com az storage account showo . Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--snapshot

Uma cadeia de caracteres que representa a versão do instantâneo, se aplicável.

--timeout

Tempo limite de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az storage file metadata show (storage-preview extensão)

Retornar todos os metadados definidos pelo usuário para o arquivo.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent --enable-file-backup-request-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Exemplos

Mostrar metadados para o ficheiro

az storage file metadata show -s MyShare --path /path/to/file

Parâmetros Obrigatórios

--path -p

O caminho para o arquivo dentro do compartilhamento de arquivos.

--share-name -s

O nome do compartilhamento de arquivos.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com a chave da conta de armazenamento ou um token SAS. Se nenhum deles estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta Azure autenticada. Se um grande número de comandos de armazenamento for executado, a cota da API poderá ser atingida.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--auth-mode

O modo no qual executar o comando. O modo "login" usará diretamente suas credenciais de login para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceites: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro obrigatório para usar com a autenticação OAuth (Azure AD) para ficheiros. Isso ignorará qualquer verificação de permissão no nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo que haja ACLs em vigor para esses arquivos/diretórios.

Propriedade Valor
Default value: False
--connection-string

String de cadeia de ligação de conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--disallow-trailing-dot

Se verdadeiro, o ponto à direita será cortado do URI de destino. Padrão para False.

Propriedade Valor
Default value: False
Valores aceites: false, true
--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--snapshot

Uma cadeia de caracteres que representa a versão do instantâneo, se aplicável.

--timeout

Tempo limite de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az storage file metadata update

Editar

Atualizar metadados do arquivo.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--acquire-policy-token]
                                [--auth-mode {key, login}]
                                [--backup-intent --enable-file-backup-request-intent]
                                [--change-reference]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--file-endpoint]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

Exemplos

Atualizar metadados para o arquivo

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

Parâmetros Obrigatórios

--path -p

O caminho para o arquivo dentro do compartilhamento de arquivos.

--share-name -s

O nome do compartilhamento de arquivos.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com a chave da conta de armazenamento ou um token SAS. Se nenhum deles estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta Azure autenticada. Se um grande número de comandos de armazenamento for executado, a cota da API poderá ser atingida.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--auth-mode

O modo no qual executar o comando. O modo "login" usará diretamente suas credenciais de login para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceites: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro obrigatório para usar com a autenticação OAuth (Azure AD) para ficheiros. Isso ignorará qualquer verificação de permissão no nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo que haja ACLs em vigor para esses arquivos/diretórios.

Propriedade Valor
Default value: False
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--connection-string

String de cadeia de ligação de conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--disallow-trailing-dot

Se verdadeiro, o ponto à direita será cortado do URI de destino. Padrão para False.

Propriedade Valor
Default value: False
Valores aceites: false, true
--file-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com a chave da conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário do serviço com az storage account showo . Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--metadata

Metadados em pares chave=valor separados por espaço. Isso substitui quaisquer metadados existentes.

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--timeout

Tempo limite de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az storage file metadata update (storage-preview extensão)

Atualizar metadados do arquivo.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--acquire-policy-token]
                                [--auth-mode {key, login}]
                                [--backup-intent --enable-file-backup-request-intent]
                                [--change-reference]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

Exemplos

Atualizar metadados para o arquivo

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

Parâmetros Obrigatórios

--path -p

O caminho para o arquivo dentro do compartilhamento de arquivos.

--share-name -s

O nome do compartilhamento de arquivos.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com a chave da conta de armazenamento ou um token SAS. Se nenhum deles estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta Azure autenticada. Se um grande número de comandos de armazenamento for executado, a cota da API poderá ser atingida.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--auth-mode

O modo no qual executar o comando. O modo "login" usará diretamente suas credenciais de login para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade Valor
Valores aceites: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro obrigatório para usar com a autenticação OAuth (Azure AD) para ficheiros. Isso ignorará qualquer verificação de permissão no nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo que haja ACLs em vigor para esses arquivos/diretórios.

Propriedade Valor
Default value: False
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--connection-string

String de cadeia de ligação de conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--disallow-trailing-dot

Se verdadeiro, o ponto à direita será cortado do URI de destino. Padrão para False.

Propriedade Valor
Default value: False
Valores aceites: false, true
--metadata

Metadados em pares chave=valor separados por espaço. Isso substitui quaisquer metadados existentes.

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade Valor
Grupo de parâmetros: Storage Account Arguments
--timeout

Tempo limite de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False