Obter Tags Blob

A Get Blob Tags operação devolve todas as tags definidas pelo utilizador para a bolha, versão ou instantâneo especificados.

Pedir

O Get Blob Tags pedido pode ser construído da seguinte forma. HTTPS é recomendado. Substitua a minha conta pelo nome da sua conta de armazenamento:

GET Método Request URI Versão HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags&snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags&versionid=<DateTime>
HTTP/1.1

Parâmetros URI

Os seguintes parâmetros adicionais podem ser especificados no pedido URI.

Parâmetro Descrição
snapshot Opcional. O parâmetro instantâneo é um valor opaco DateTime que, quando presente, especifica o instantâneo blob para recuperar. Para obter mais informações sobre o trabalho com instantâneos blob, consulte Criar um Instantâneo de uma Bolha
versionid Opcional para versões 2019-12-12 e mais recentes. O parâmetro versídico é um valor opaco DateTime que, quando presente, especifica a versão da bolha para recuperar.
timeout Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, consulte os intervalos de definição para operações de serviço de blob.

Pedido cabeçalhos

A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais.

Cabeçalho do Pedido Description
Authorization Obrigatório. Especifica o esquema de autorização, nome da conta e assinatura. Para mais informações, consulte Os pedidos autorizados à Azure Armazenamento.
Date ou x-ms-date Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para mais informações, consulte Os pedidos autorizados à Azure Armazenamento.
x-ms-version Requerido para todos os pedidos autorizados, opcional para pedidos anónimos. Especifica a versão da operação a utilizar para este pedido. Para mais informações, consulte a versão para os Serviços Azure Armazenamento.
x-ms-lease-id:<ID> Necessário se a bolha tiver um arrendamento ativo.

Para realizar esta operação numa bolha com um arrendamento ativo, especifique o ID de locação válido para este cabeçalho. Se não for especificado um ID de locação válido no pedido, a operação falhará com o código de estado 403 (Proibido).
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 KiB que é gravado nos registos de análise quando o registo de análise de armazenamento está ativado. Recomenda-se a utilização deste cabeçalho para correlacionar as atividades do lado do cliente com os pedidos recebidos pelo servidor. Para obter mais informações, consulte Sobre Armazenamento Analítica registação e registo de registos Azure: Utilização de Registos para rastrear pedidos de Armazenamento.

Esta operação suporta o x-ms-if-tags cabeçalho condicional para obter etiquetas de bolhas apenas se uma condição especificada for satisfeita. Para obter mais informações, consulte especificar cabeçalhos condicional para operações de serviço de bolhas.

Corpo do Pedido

Nenhum.

Resposta

A resposta inclui um código de estado HTTP, cabeçalhos de resposta e corpo de resposta.

Código de Estado

Uma operação bem sucedida devolve o código de estado 200 (OK).

Para obter informações sobre códigos de estado, consulte códigos de estado e de erro.

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos standard estão em conformidade com a especificação do protocolo HTTP/1.1.

Cabeçalho de resposta Descrição
Content-Type application/xml
Content-Length O tamanho do documento XML devolvido, em bytes
x-ms-request-id Este cabeçalho identifica exclusivamente o pedido que foi feito e pode ser usado para resolver problemas no pedido. Para obter mais informações, consulte operações de API de resolução de problemas.
x-ms-version Indica a versão do serviço Blob utilizado para executar o pedido.
Date Uma data/valor de hora UTC gerado pelo serviço que indica o momento em que a resposta foi iniciada.
x-ms-client-request-id Este cabeçalho pode ser usado para resolver pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente no pedido e o valor for no máximo 1024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente no pedido, este cabeçalho não estará presente na resposta.

Corpo de Resposta

O formato do corpo de resposta é o seguinte:

<?xml version="1.0" encoding="utf-8"?>  
<Tags>  
    <TagSet>  
        <Tag>  
            <Key>tag-name-1</Key>  
            <Value>tag-value-1</Value>  
        </Tag>  
        <Tag>  
            <Key>tag-name-2</Key>  
            <Value>tag-value-2</Value>  
        </Tag>  
    </TagSet>  
</Tags>  

O corpo de resposta é um documento UTF-8 XML bem formado que representa todas as etiquetas armazenadas na bolha.

Autorização

Esta operação pode ser chamada pelo proprietário da conta e por qualquer pessoa com uma Assinatura de Acesso Partilhado que tenha permissão para as etiquetas do blob (a t permissão SAS).

Além disso, os utilizadores do RBAC com a Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read permissão podem realizar esta operação.

Observações

A Get Blob Tags operação é suportada na versão REST API 2019-12-12 e posteriormente.

A encomenda de etiquetas não está garantida na resposta.

O serviço de armazenamento mantém uma forte consistência entre uma bolha e as suas etiquetas, mas o índice secundário é eventualmente consistente. As etiquetas podem ser visíveis numa resposta antes Get Blob Tags de serem visíveis às Find Blobs by Tags operações.

Ver também

Gerir e localizar dados no Armazenamento de Blobs do Azure com o Índice de Blobs
Autorizar pedidos à Azure Armazenamento
Códigos de Estado e erro
Códigos de Erro do Serviço de Blobs