Compartilhar via

az storage file metadata

Note

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

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

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

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

 Extension GA
az storage file metadata update

Atualizar metadados de arquivo.

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

Atualizar metadados de arquivo.

 Extension GA

az storage file metadata show

Editar

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--account-key

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

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 uma chave de 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.

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

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon 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 aceitos: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro necessário para usar com a Autenticação do OAuth (Azure AD) para Arquivos. Isso ignorará as verificações de permissão de nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo se houver ACLs em vigor para esses arquivos/diretórios.

Propriedade Valor
Valor padrão: False
--connection-string

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

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

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

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--file-endpoint

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

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

Uma SAS (Assinatura de Acesso Compartilhado). 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.

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 da solicitação em segundos. Aplica-se a cada chamada ao serviço.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

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

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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 uma chave de 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.

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

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon 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 aceitos: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro necessário para usar com a Autenticação do OAuth (Azure AD) para Arquivos. Isso ignorará as verificações de permissão de nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo se houver ACLs em vigor para esses arquivos/diretórios.

Propriedade Valor
Valor padrão: False
--connection-string

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

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

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

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--sas-token

Uma SAS (Assinatura de Acesso Compartilhado). 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 da solicitação em segundos. Aplica-se a cada chamada ao serviço.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az storage file metadata update

Editar

Atualizar metadados de arquivo.

az storage file metadata update --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]
                                [--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 arquivo.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--account-key

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

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 uma chave de 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.

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

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon 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 aceitos: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro necessário para usar com a Autenticação do OAuth (Azure AD) para Arquivos. Isso ignorará as verificações de permissão de nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo se houver ACLs em vigor para esses arquivos/diretórios.

Propriedade Valor
Valor padrão: False
--connection-string

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

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

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

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--file-endpoint

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

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

Metadados em pares separados por espaço no formato key=value. Isso substitui todos os metadados existentes.

--sas-token

Uma SAS (Assinatura de Acesso Compartilhado). 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.

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

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

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

Atualizar metadados de arquivo.

az storage file metadata update --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}]
                                [--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 arquivo.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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 uma chave de 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.

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

O modo no qual executar o comando. O modo de "logon" usará diretamente suas credenciais de logon 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 aceitos: key, login
--backup-intent --enable-file-backup-request-intent

Parâmetro necessário para usar com a Autenticação do OAuth (Azure AD) para Arquivos. Isso ignorará as verificações de permissão de nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo se houver ACLs em vigor para esses arquivos/diretórios.

Propriedade Valor
Valor padrão: False
--connection-string

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

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

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

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--metadata

Metadados em pares separados por espaço no formato key=value. Isso substitui todos os metadados existentes.

--sas-token

Uma SAS (Assinatura de Acesso Compartilhado). 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 da solicitação em segundos. Aplica-se a cada chamada ao serviço.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False