az storage file metadata

  • Referência

Observação

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

Gerenciar metadados de arquivo.

Comandos

Nome Description Tipo Status
az storage file metadata show

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

 Núcleo GA
az storage file metadata show (storage-preview extensão)

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

 Extensão Visualizar
az storage file metadata update

Atualizar metadados do arquivo.

 Núcleo GA
az storage file metadata update (storage-preview extensão)

Atualizar metadados do arquivo.

 Extensão Visualizar

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]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--file-endpoint]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Exemplos

Mostrar metadados para o arquivo

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

Parâmetros Exigidos

--path -p

O caminho para o arquivo dentro do compartilhamento de arquivos.

--share-name -s

O nome do compartilhamento de arquivos.

Parâmetros Opcionais

--account-key

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

--account-name

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

--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.

valores aceitos: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro necessário para usar com a autenticação OAuth (Azure AD) para arquivos. 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.

valor padrão: False
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Se verdadeiro, o ponto à direita será cortado do URI de destino. O padrão é False.

valores aceitos: false, true
valor padrão: False
--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 de serviço com az storage account showo . Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

--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 de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--snapshot

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

--timeout

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

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

Versão Prévia

O grupo de comando 'az storage' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

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]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Exemplos

Mostrar metadados para o arquivo

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

Parâmetros Exigidos

--path -p

O caminho para o arquivo dentro do compartilhamento de arquivos.

--share-name -s

O nome do compartilhamento de arquivos.

Parâmetros Opcionais

--account-key

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

--account-name

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

--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.

valores aceitos: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro necessário para usar com a autenticação OAuth (Azure AD) para arquivos. 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.

valor padrão: False
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Se verdadeiro, o ponto à direita será cortado do URI de destino. O padrão é False.

valores aceitos: false, true
valor padrão: False
--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.

--snapshot

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

--timeout

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az storage file metadata update

Editar

Atualizar metadados do arquivo.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--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 Exigidos

--path -p

O caminho para o arquivo dentro do compartilhamento de arquivos.

--share-name -s

O nome do compartilhamento de arquivos.

Parâmetros Opcionais

--account-key

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

--account-name

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

--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.

valores aceitos: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro necessário para usar com a autenticação OAuth (Azure AD) para arquivos. 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.

valor padrão: False
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Se verdadeiro, o ponto à direita será cortado do URI de destino. O padrão é False.

valores aceitos: false, true
valor padrão: False
--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 de serviço com az storage account showo . Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

--metadata

Metadados em pares key=value 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 de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

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

Versão Prévia

O grupo de comando 'az storage' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualizar metadados do arquivo.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--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 Exigidos

--path -p

O caminho para o arquivo dentro do compartilhamento de arquivos.

--share-name -s

O nome do compartilhamento de arquivos.

Parâmetros Opcionais

--account-key

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

--account-name

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

--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.

valores aceitos: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro necessário para usar com a autenticação OAuth (Azure AD) para arquivos. 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.

valor padrão: False
--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Se verdadeiro, o ponto à direita será cortado do URI de destino. O padrão é False.

valores aceitos: false, true
valor padrão: False
--metadata

Metadados em pares key=value 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.

--timeout

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.