Compartilhar via


az storage blob tag

Note

Essa referência faz parte da extensão storage-blob-preview para a CLI do Azure (versão 2.75.0 ou superior). A extensão instalará automaticamente a primeira vez que você executar um comando az storage blob tag. Saiba mais sobre extensões.

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerenciar marcas de blob.

Comandos

Nome Description Tipo Status
az storage blob tag list

Obtenha marcas em um blob ou versão específica do blob ou instantâneo.

Extension Preview
az storage blob tag set

Defina marcas em um blob ou em uma versão específica do blob, mas não no instantâneo.

Extension Preview

az storage blob tag list

Versão Prévia

A "marca de blob de armazenamento" do grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Obtenha marcas em um blob ou versão específica do blob ou instantâneo.

az storage blob tag list [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--sas-token]
                         [--snapshot]
                         [--tags-condition]
                         [--timeout]
                         [--version-id]

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
--blob-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
--blob-url

A URL do ponto de extremidade completo para o Blob, incluindo token SAS e instantâneo, se usado. Pode ser o ponto de extremidade primário ou o ponto de extremidade secundário, dependendo do location_modeatual.

--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
--container-name -c

O nome do contêiner.

--name -n

O nome do blob.

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

O parâmetro de instantâneo é um valor datetime opaco que, quando presente, especifica o instantâneo de blob a ser recuperado.

--tags-condition

Especifique um SQL em que a cláusula em marcas de blob opere somente em blobs com um valor correspondente.

--timeout

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

--version-id

Uma ID de versão opcional do blob. Esse parâmetro é apenas para a conta habilitada para controle de versã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 blob tag set

Versão Prévia

A "marca de blob de armazenamento" do grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Defina marcas em um blob ou em uma versão específica do blob, mas não no instantâneo.

Cada chamada para essa operação substitui todas as marcas existentes anexadas ao blob. Para remover todas as marcas do blob, chame essa operação sem marcas definidas.

az storage blob tag set --tags
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--blob-url]
                        [--connection-string]
                        [--container-name]
                        [--name]
                        [--sas-token]
                        [--tags-condition]
                        [--timeout]
                        [--version-id]

Parâmetros Exigidos

--tags
Versão Prévia

Marcas separadas por espaço: key[=value] [key[=value] ...]. As marcas diferenciam maiúsculas de minúsculas. O conjunto de marcas pode conter no máximo 10 marcas. As chaves de marca devem ter entre 1 e 128 caracteres e os valores de marca devem ter entre 0 e 256 caracteres. Caracteres válidos de chave de marca e valor incluem: letras minúsculas e maiúsculas, dígitos (0-9), espaço ( ), mais (+), menos (-), período (.), solidus (/), dois-pontos (:), iguais (=), sublinhado (_).

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
--blob-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
--blob-url

A URL do ponto de extremidade completo para o Blob, incluindo token SAS e instantâneo, se usado. Pode ser o ponto de extremidade primário ou o ponto de extremidade secundário, dependendo do location_modeatual.

--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
--container-name -c

O nome do contêiner.

--name -n

O nome do blob.

--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
--tags-condition

Especifique um SQL em que a cláusula em marcas de blob opere somente em blobs com um valor correspondente.

--timeout

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

--version-id

Uma ID de versão opcional do blob. Esse parâmetro é apenas para a conta habilitada para controle de versã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