Obter marcas de BLOBGet Blob Tags

A Get Blob Tags operação retorna todas as marcas definidas pelo usuário para o blob, a versão ou o instantâneo especificado.The Get Blob Tags operation returns all user-defined tags for the specified blob, version, or snapshot.

SolicitaçãoRequest

A solicitação Get Blob Tags pode ser criada da seguinte maneira.The Get Blob Tags request may be constructed as follows. HTTPS é recomendado.HTTPS is recommended. Substitua myaccount pelo nome da sua conta de armazenamento:Replace myaccount with the name of your storage account:

URI de solicitação do método GETGET Method Request URI Versão de HTTPHTTP Version
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.1HTTP/1.1

Parâmetros do URIURI parameters

Os seguintes parâmetros adicionais podem ser especificados no URI de solicitação.The following additional parameters may be specified on the request URI.

ParâmetroParameter DescriçãoDescription
snapshot Opcional.Optional. O parâmetro de instantâneo é um valor DateTime opaco que, quando presente, especifica o instantâneo de blob a ser recuperado.The snapshot parameter is an opaque DateTime value that, when present, specifies the blob snapshot to retrieve. Para obter mais informações sobre como trabalhar com instantâneos de BLOB, consulte criando um instantâneo de um blobFor more information on working with blob snapshots, see Creating a Snapshot of a Blob
versionid Opcional para as versões 2019-12-12 e mais recentes.Optional for versions 2019-12-12 and newer. O parâmetro VersionId é um DateTime valor opaco que, quando presente, especifica a versão do blob a recuperar.The versionid parameter is an opaque DateTime value that, when present, specifies the version of the blob to retrieve.
timeout Opcional.Optional. O parâmetro timeout é expresso em segundos.The timeout parameter is expressed in seconds. Para obter mais informações, consulte definindo tempos limite para operações do serviço blob.For more information, see Setting Timeouts for Blob Service Operations.

Cabeçalhos de solicitaçãoRequest Headers

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.The following table describes required and optional request headers.

Cabeçalho da solicitaçãoRequest Header DescriçãoDescription
Authorization Obrigatórios.Required. Especifica o esquema de autorização, o nome da conta e a assinatura.Specifies the authorization scheme, account name, and signature. Para obter mais informações, consulte autorizar solicitações ao armazenamento do Azure.For more information, see Authorize requests to Azure Storage.
Date ou x-ms-dateDate or x-ms-date Obrigatórios.Required. Especifica o UTC (Tempo Universal Coordenado) para a solicitação.Specifies the Coordinated Universal Time (UTC) for the request. Para obter mais informações, consulte autorizar solicitações ao armazenamento do Azure.For more information, see Authorize requests to Azure Storage.
x-ms-version Necessário para todas as solicitações autorizadas, opcional para solicitações anônimas.Required for all authorized requests, optional for anonymous requests. Especifica a versão da operação a ser usada para esta solicitação.Specifies the version of the operation to use for this request. Para obter mais informações, consulte controle de versão para os serviços de armazenamento do Azure.For more information, see Versioning for the Azure Storage Services.
x-ms-lease-id:<ID> Obrigatório se o blob tiver uma concessão ativa.Required if the blob has an active lease.

Para executar essa operação em um blob com uma concessão ativa, especifique a ID de concessão válida para esse cabeçalho.To perform this operation on a blob with an active lease, specify the valid lease ID for this header. Se uma ID de concessão válida não for especificada na solicitação, ocorrerá uma falha na operação com o código de status 403 (Proibido).If a valid lease ID is not specified on the request, the operation will fail with status code 403 (Forbidden).
x-ms-client-request-id Opcional.Optional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 KiB que é registrado nos logs de análise quando o log da análise de armazenamento está habilitado.Provides a client-generated, opaque value with a 1 KiB character limit that is recorded in the analytics logs when storage analytics logging is enabled. O uso desse cabeçalho é altamente recomendável para correlacionar as atividades do lado do cliente com as solicitações recebidas pelo servidor.Using this header is highly recommended for correlating client-side activities with requests received by the server. Para obter mais informações, consulte sobre log de análise de armazenamento e log do Azure: usando logs para rastrear solicitações de armazenamento.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.

Esta operação dará suporte ao x-ms-if-tags cabeçalho condicional para obter marcas de blob somente se uma condição especificada for atendida.This operation supports the x-ms-if-tags conditional header to get blob tags only if a specified condition is met. Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.For more information, see Specifying Conditional Headers for Blob Service Operations.

Corpo da solicitaçãoRequest Body

nenhuma.None.

RespostaResponse

A resposta inclui um código de status HTTP, cabeçalhos de resposta e corpo da resposta.The response includes an HTTP status code, response headers, and response body.

Código de statusStatus Code

Uma operação bem-sucedida retorna o código de status 200 (OK).A successful operation returns status code 200 (OK).

Para obter informações sobre códigos de status, consulte status e códigos de erro.For information about status codes, see Status and Error Codes.

Cabeçalhos de respostaResponse Headers

A resposta para esta operação inclui os cabeçalhos a seguir.The response for this operation includes the following headers. A resposta também pode incluir cabeçalhos padrão HTTP adicionais.The response may also include additional standard HTTP headers. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.All standard headers conform to the HTTP/1.1 protocol specification.

Cabeçalho de respostaResponse header DescriçãoDescription
Content-Type application/xml
Content-Length O tamanho do documento XML retornado, em bytesThe size of the returned XML document, in bytes
x-ms-request-id Esse cabeçalho identifica a solicitação que foi feita de forma exclusiva e pode ser usado para solucionar problemas na solicitação.This header uniquely identifies the request that was made and can be used for troubleshooting the request. Para obter mais informações, consulte Solucionando problemas de operações de API.For more information, see Troubleshooting API Operations.
x-ms-version Indica a versão do serviço Blob usado para executar a solicitação.Indicates the version of the Blob service used to execute the request.
Date Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
x-ms-client-request-id Esse cabeçalho pode ser usado para solucionar problemas de solicitações e respostas correspondentes.This header can be used to troubleshoot requests and corresponding responses. O valor desse cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente na solicitação e o valor for de no máximo 1024 caracteres ASCII visíveis.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. Se o x-ms-client-request-id cabeçalho não estiver presente na solicitação, esse cabeçalho não estará presente na resposta.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

Corpo da respostaResponse Body

Formato do corpo da resposta:The format of the response body is as follows:

<?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 da resposta é um documento XML UTF-8 bem formado que representa todas as marcas armazenadas no BLOB.The response body is a well-formed UTF-8 XML document that represents all the tags stored on the blob.

AutorizaçãoAuthorization

Essa operação pode ser chamada pelo proprietário da conta e por qualquer pessoa com uma assinatura de acesso compartilhado que tenha permissão para as marcas do blob (a t permissão SAS).This operation can be called by the account owner and by anyone with a Shared Access Signature that has permission to the blob's tags (the t SAS permission).

Além disso, os usuários do RBAC com a Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read permissão podem executar essa operação.In addition, RBAC users with the Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read permission can perform this operation.

ComentáriosRemarks

A Get Blob Tags operação tem suporte na API REST versão 2019-12-12 e posterior.The Get Blob Tags operation is supported in REST API version 2019-12-12 and later.

A ordem das marcas não é garantida na resposta.The ordering of tags is not guaranteed in the response.

O serviço de armazenamento mantém uma consistência forte entre um blob e suas marcas, mas o índice secundário é eventualmente consistente.The storage service maintains strong consistency between a blob and its tags, but the secondary index is eventually consistent. As marcas podem ser visíveis em uma resposta para antes de serem Get Blob Tags visíveis para Find Blobs by Tags as operações.Tags may be visible in a response to Get Blob Tags before they are visible to Find Blobs by Tags operations.

Confira tambémSee also

Gerenciar e localizar dados no Armazenamento de Blobs do Azure com o Índice de BlobsManage and find data on Azure Blob Storage with Blob Index
Autorizar solicitações ao armazenamento do AzureAuthorize requests to Azure Storage
Status e códigos de erroStatus and Error Codes
Códigos de erro do serviço BlobBlob Service Error Codes