Get Blob Properties
A operação Get Blob Properties retorna todos os metadados definidos pelo usuário, propriedades HTTP padrão e propriedades do sistema para o blob. Ele não retorna o conteúdo do blob.
Solicitação
Você pode construir a solicitação da Get Blob Properties seguinte maneira. Recomendamos que você use HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento.
| URI de solicitação do método HEAD | Versão HTTP |
|---|---|
https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime> |
HTTP/1.1 |
URI do serviço de armazenamento emulado
Ao fazer uma solicitação no serviço de armazenamento emulado, especifique o nome do host do emulador e Armazenamento de Blobs do Azure porta como 127.0.0.1:10000, seguido pelo nome da conta de armazenamento emulada:
| URI de solicitação do método HEAD | Versão HTTP |
|---|---|
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob |
HTTP/1.1 |
Para saber mais, confira Usar o Emulador de Armazenamento do Azure para desenvolvimento e teste.
Parâmetros do URI
Você pode especificar os seguintes parâmetros adicionais no URI da solicitação:
| Parâmetro | Descrição |
|---|---|
snapshot |
Opcional. O parâmetro instantâneo é um valor opaco DateTime que, quando presente, especifica o instantâneo de blob a ser recuperado. Para obter mais informações sobre como trabalhar com instantâneos de blob, consulte Create um instantâneo de um blob. |
versionid |
Opcional. Versão 2019-12-12 e posterior. O versionid parâmetro é um valor opaco DateTime que, quando está presente, especifica a versão do blob a ser recuperada. |
timeout |
Opcional. O parâmetro timeout é expresso em segundos. Para obter mais informações, consulte Configurando tempos limite para operações de Armazenamento de Blobs. |
Cabeçalhos da solicitação
A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.
| Cabeçalho da solicitação | Descrição |
|---|---|
Authorization |
Obrigatórios. Especifica o esquema de autorização, o nome da conta e a assinatura. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure. |
Date ou x-ms-date |
Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure. |
x-ms-version |
Necessário para todas as solicitações autorizadas. Opcional para solicitações anônimas. Especifica a versão da operação a ser usada para esta solicitação. Para obter mais informações, consulte Controle de versão para os Serviços de Armazenamento do Azure. |
x-ms-lease-id: <ID> |
Opcional. Se esse cabeçalho for especificado, a Get Blob Properties operação será executada somente se ambas as seguintes condições forem atendidas:- A concessão do blob está ativa no momento. - A ID de concessão especificada na solicitação corresponde à ID de concessão do blob. Se qualquer uma dessas condições não for atendida, a solicitação falhará e a Get Blob Properties operação falhará com status código 412 (Falha na pré-condição). |
x-ms-upn |
Opcional. Versão 2020-06-12 e posterior. Válido para contas com namespace hierárquico habilitado. Se for true, os valores de identidade do usuário retornados nos x-ms-ownerx-ms-group cabeçalhos de resposta e x-ms-acl serão transformados de Microsoft Entra IDs de objeto para Nomes de Entidade de Usuário. Se o valor for false, eles serão retornados como Microsoft Entra IDs de objeto. O valor padrão é false. Observe que as IDs de objeto de grupo e aplicativo não são traduzidas, pois não têm nomes amigáveis exclusivos. |
x-ms-client-request-id |
Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres KiB (1 kibibyte), que é registrado nos logs de análise quando o log de análise de armazenamento está habilitado. É altamente recomendável que você use esse cabeçalho ao correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre o log de Análise de Armazenamento do Azure. |
Essa operação também dará suporte ao uso de cabeçalhos condicionais para retornar propriedades de blob e metadados somente se uma determinada condição for atendida. Para obter mais informações, consulte Especificar cabeçalhos condicionais para operações de Armazenamento de Blobs.
Cabeçalhos de solicitação (chaves de criptografia fornecidas pelo cliente)
A partir da versão 2019-02-02, você pode especificar os cabeçalhos a seguir na solicitação para ler um blob criptografado com uma chave fornecida pelo cliente. A criptografia com uma chave fornecida pelo cliente (e o conjunto correspondente de cabeçalhos) é opcional. Se um blob tiver sido criptografado anteriormente com uma chave fornecida pelo cliente, você deverá incluir esses cabeçalhos na solicitação para que a operação de leitura possa ser concluída com êxito.
| Cabeçalho da solicitação | Descrição |
|---|---|
x-ms-encryption-key |
Obrigatórios. A chave de criptografia AES-256 codificada em Base64. |
x-ms-encryption-key-sha256 |
Opcional. O hash SHA256 codificado em Base64 da chave de criptografia. |
x-ms-encryption-algorithm: AES256 |
Obrigatórios. Especifica o algoritmo a ser usado para criptografia. O valor deste cabeçalho deve ser AES256. |
Corpo da solicitação
Nenhum.
Resposta
A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.
Código de status
Uma operação bem-sucedida retorna o código de status 200 (OK).
Para obter mais informações sobre códigos de status, consulte Códigos de status e de erro.
Cabeçalhos de resposta
A resposta para essa operação inclui os cabeçalhos na tabela a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
| Cabeçalho de resposta | Descrição |
|---|---|
Last-Modified |
A data e a hora da última modificação feita no blob. O formato da data segue RFC 1123. Para obter mais informações, consulte Representar valores de data/hora em cabeçalhos. Qualquer operação que modificar o blob, incluindo uma atualização dos metadados ou das propriedades do blob, alterará a hora da última modificação do blob. |
x-ms-creation-time |
Versão 2017-11-09 e posterior. A data/hora em que o blob foi criado. O formato da data segue RFC 1123. Para obter mais informações, consulte Representar valores de data/hora em cabeçalhos. |
x-ms-meta-name:value |
Um conjunto de pares nome-valor que correspondem aos metadados definidos pelo usuário associados a esse blob. |
x-ms-tag-count |
Versão 2019-12-12 e posterior. Se o blob tiver marcas, retornará o número de marcas armazenadas no blob. Esse cabeçalho não será retornado se não houver marcas no blob. |
x-ms-blob-type:<BlockBlob\|PageBlob\|AppendBlob> |
O tipo de blob. |
x-ms-copy-completion-time:<datetime> |
Versão 2012-02-12 e posterior. A hora da conclusão da última tentativa de executar a operação Copy Blob em que esse blob foi o blob de destino. Esse valor pode especificar a hora de uma tentativa de cópia concluída, cancelada o com falha. Esse cabeçalho não aparecerá se uma cópia estiver pendente, se esse blob nunca tiver sido o destino em uma Copy Blob operação ou se esse blob tiver sido modificado após uma operação concluída Copy Blob que usa Set Blob Properties, Put Blobou Put Block List. |
x-ms-copy-status-description: <error string> |
Versão 2012-02-12 e posterior. Aparece somente quando x-ms-copy-status é failed ou pending. Descreve a causa de uma falha de operação de cópia fatal ou não fatal. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma Copy Blob operação ou se esse blob tiver sido modificado após uma operação concluída Copy Blob que usa Set Blob Properties, Put Blobou Put Block List. |
x-ms-copy-id: <id> |
Versão 2012-02-12 e posterior. O identificador de cadeia de caracteres da última tentativa Copy Blob de operação, em que esse blob era o blob de destino. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma Copy Blob operação ou se esse blob tiver sido modificado após uma operação concluída Copy Blob que usa Set Blob Properties, Put Blobou Put Block List. |
x-ms-copy-progress: <bytes copied/bytes total> |
Versão 2012-02-12 e posterior. Contém o número de bytes copiados e o total de bytes na origem na última tentativa Copy Blob de operação, em que esse blob era o blob de destino. Pode mostrar de 0 a Content-Length bytes copiados. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma Copy Blob operação ou se esse blob tiver sido modificado após uma operação concluída Copy Blob que usa Set Blob Properties, Put Blobou Put Block List. |
x-ms-copy-source: url |
Versão 2012-02-12 e posterior. Uma URL de até 2 KiB de comprimento que especifica o blob de origem que foi usado na última tentativa Copy Blob de operação, em que esse blob era o blob de destino. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma Copy Blob operação ou se esse blob tiver sido modificado após uma operação concluída Copy Blob que usa Set Blob Properties, Put Blobou Put Block List. |
x-ms-copy-status: <pending \| success \| aborted \| failed> |
Versão 2012-02-12 e posterior. O estado da operação de cópia identificado por x-ms-copy-id, com estes valores: - success: cópia concluída com êxito.- pending: a cópia está em andamento. Verifique x-ms-copy-status-description se erros intermitentes e não fatais impedirem o andamento da cópia, mas não causarem falha.- aborted: a cópia foi encerrada por Abort Copy Blob.- failed: falha na cópia. Consulte x-ms-copy-status-description para obter detalhes da falha.Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma Copy Blob operação ou se esse blob tiver sido modificado após uma operação concluída Copy Blob que usa Set Blob Properties, Put Blobou Put Block List. |
x-ms-incremental-copy: true |
Versão 2016-05-31 e posterior. Incluído se o blob for um blob de cópia incremental. |
x-ms-copy-destination-snapshot:<datetime> |
Versão 2016-05-31 e posterior. Incluído se o blob for um blob de cópia incremental ou uma cópia incremental instantâneo, se x-ms-copy-status for bem-sucedido. Hora do instantâneo da última cópia incremental bem-sucedida instantâneo para esse blob. |
x-ms-lease-duration: <infinite \| fixed> |
Quando um blob é concedido, especifica se a concessão tem duração infinita ou fixa. Incluído para solicitações que usam a versão 2012-02-12 e posterior. |
x-ms-lease-state: <available \| leased \| expired \| breaking \| broken> |
O estado de concessão do blob. Incluído para solicitações que usam a versão 2012-02-12 e posterior. |
x-ms-lease-status:<locked\| unlocked> |
O status da concessão do blob. |
Content-Length |
O tamanho do blob em bytes. Para um blob de páginas, esse cabeçalho retorna o valor do x-ms-blob-content-length cabeçalho armazenado com o blob. |
Content-Type |
O tipo de conteúdo especificado para o blob. Se nenhum tipo de conteúdo for especificado, o tipo de conteúdo padrão será application/octet-stream. |
Etag |
A ETag contém um valor que você pode usar para executar operações de forma condicional. Para obter mais informações, consulte Especificar cabeçalhos condicionais para operações de Armazenamento de Blobs. Se a versão da solicitação for 2011-08-18 ou posterior, o valor de ETag será colocado entre aspas. |
Content-MD5 |
Se o cabeçalho Content-MD5 tiver sido definido para o blob, esse cabeçalho de resposta será retornado de modo que o cliente possa verificar a integridade do conteúdo da mensagem.Na versão 2012-02-12 e posterior, Put Blob define o valor MD5 de um blob de blocos mesmo quando a solicitação Put Blob não inclui um cabeçalho MD5. |
Content-Encoding |
Se o cabeçalho de solicitação Content-Encoding tiver sido definido previamente para o blob, esse valor será retornado nesse cabeçalho. |
Content-Language |
Se o cabeçalho de solicitação Content-Language tiver sido definido previamente para o blob, esse valor será retornado nesse cabeçalho. |
Content-Disposition |
Se o cabeçalho de solicitação Content-Disposition tiver sido definido previamente para o blob, esse valor será retornado nesse cabeçalho, para solicitações contra a versão 15-08-2013 e posterior.O campo do cabeçalho de resposta Content-Disposition transmite informações adicionais sobre como processar a carga de resposta, e também pode ser usado para anexar metadados adicionais. Por exemplo, se o cabeçalho estiver definido attachmentcomo , ele indicará que o agente do usuário não deve exibir a resposta, mas, em vez disso, mostrará uma caixa de diálogo Salvar como. |
Cache-Control |
Se o cabeçalho de solicitação Cache-Control tiver sido definido previamente para o blob, esse valor será retornado nesse cabeçalho. |
x-ms-blob-sequence-number |
O número de sequência atual de um blob de páginas. Esse cabeçalho não é retornado para blobs de blocos ou blobs de acréscimo. Esse cabeçalho não é retornado para blobs de blocos. |
x-ms-request-id |
Esse cabeçalho identifica exclusivamente a solicitação que foi feita e você pode usá-la para solucionar problemas da solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API. |
x-ms-version |
Indica a versão do Armazenamento de Blobs que está sendo usada para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e posterior. Esse cabeçalho também será retornado para solicitações anônimas sem uma versão especificada se o contêiner tiver sido marcado para acesso público usando o Armazenamento de Blobs versão 2009-09-19. |
Date |
Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada. |
Accept-Ranges: bytes |
Indica se o serviço oferece suporte a solicitações de conteúdo de blob parcial. Incluído para solicitações feitas usando a versão 2013-08-15 e posterior. |
x-ms-blob-committed-block-count |
O número de blocos confirmados presentes no blob. Esse cabeçalho é retornado somente para blobs de acréscimo. |
x-ms-server-encrypted: true/false |
Versão 2015-12-11 e posterior. O valor desse cabeçalho será definido true como se os dados de blob e os metadados do aplicativo forem completamente criptografados usando o algoritmo especificado. Caso contrário, o valor será definido false como (quando o blob for descriptografado ou se apenas partes dos metadados de blob/aplicativo forem criptografadas). |
x-ms-encryption-key-sha256 |
Versão 2019-02-02 e posterior. Esse cabeçalho será retornado se o blob for criptografado com uma chave fornecida pelo cliente. |
x-ms-encryption-context |
Versão 2021-08-06 e posterior. Se o valor da propriedade de contexto de criptografia for definido, ele retornará o valor definido. Válido somente quando o Namespace Hierárquico está habilitado para a conta. |
x-ms-encryption-scope |
Versão 2019-02-02 e posterior. Esse cabeçalho será retornado se o blob for criptografado com um escopo de criptografia. |
x-ms-access-tier |
Versão 2017-04-17 e posterior. A camada de blob de páginas em uma conta de Armazenamento Premium ou camada de um blob de blocos em uma conta do Armazenamento de Blobs ou de uso geral v2. Para obter uma lista das camadas de blob de páginas premium permitidas, consulte Discos gerenciados e Armazenamento Premium de alto desempenho para VMs. Para armazenamento de blobs ou conta de uso geral v2, os valores válidos são Hot, Cool, Colde Archive.
Nota:Cold A camada tem suporte para a versão 2021-12-02 e posterior. Para obter informações detalhadas sobre a camada de nível de blob de blocos da conta de blob padrão , consulte Camadas de armazenamento frequentes, esporádicas e de arquivos. |
x-ms-access-tier-inferred: true |
Versão 2017-04-17 e posterior. Somente para blobs de páginas em uma conta Armazenamento Premium. Se a camada de acesso não estiver definida explicitamente no blob, a camada será inferida com base em seu comprimento de conteúdo e esse cabeçalho será retornado com um valor de true. Para blobs de blocos no Armazenamento de Blobs ou em uma conta de uso geral v2, se o blob não tiver a camada de acesso definida, você poderá inferir a camada das propriedades da conta de armazenamento. Esse cabeçalho será definido somente se a camada de blob de blocos for inferida. |
x-ms-archive-status |
Versão 2017-04-17 e posterior. Para armazenamento de blobs ou conta de uso geral v2, os valores válidos são rehydrate-pending-to-hot, rehydrate-pending-to-coole rehydrate-pending-to-cold. Se o blob estiver sendo reidratado e estiver incompleto, esse cabeçalho será retornado, o que indica que a reidração está pendente e exibe a camada de destino. Para obter informações detalhadas sobre a camada de blob de blocos de conta de blob padrão, consulte Camadas de armazenamento frequente, esporádico e de arquivos. |
x-ms-access-tier-change-time |
Versão 2017-04-17 e posterior. Indica a última vez em que a camada foi alterada no objeto . Esse cabeçalho será retornado somente se uma camada no blob de blocos tiver sido definida. O formato da data segue RFC 1123. Para obter mais informações, consulte Representar valores de data/hora em cabeçalhos. Para obter mais informações sobre camadas de blob de blocos de conta de blob padrão, consulte Camadas de armazenamento frequente, esporádico e de arquivos. |
x-ms-client-request-id |
Pode ser usado para solucionar problemas de solicitações e suas respostas correspondentes. O valor desse cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho, se ele estiver presente na solicitação e o valor for no máximo 1.024 caracteres ASCII visíveis. 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. |
x-ms-rehydrate-priority |
Versão 2019-12-12 e posterior. Se um objeto estiver no estado pendente de reidração, esse cabeçalho será retornado com prioridade de reidratar. Os valores válidos são High/Standard. Para obter informações detalhadas sobre a camada de nível de blob de blocos da conta de blob padrão , consulte Camadas de armazenamento frequentes, esporádicas e de arquivos. |
x-ms-or-{policy-id}_{rule-id} |
Versão 2019-12-12 e posterior, retornada somente para blobs de blocos.
policy-id é um valor GUID que representa o identificador de uma política de replicação de objeto na conta de armazenamento.
rule-id é um valor GUID que representa o identificador de uma regra de política no contêiner de blob. Se a conta estiver ObjectReplicationhabilitada, o valor desse cabeçalho representará o status de replicação do blob com a política e os identificadores de regra fornecidos, seja complete ou failed. |
x-ms-or-policy-id |
Versão 2019-12-12 e posterior, retornada somente para blobs de blocos. Se a conta estiver ObjectReplicationhabilitada, o valor desse cabeçalho representará a política que rege a replicação. |
x-ms-last-access-time |
Versão 2020-02-10 e posterior. Indica a última vez em que os dados do blob foram acessados com base na política de acompanhamento de hora do último acesso da conta de armazenamento. O cabeçalho não será retornado se a conta de armazenamento não tiver uma política de acompanhamento de hora do último acesso ou se a política estiver desabilitada. Para obter informações sobre como definir a política de rastreamento de hora do último acesso da conta de armazenamento, consulte API de Armazenamento de Blobs. |
x-ms-blob-sealed |
Versão 2019-12-12 e posterior, retornada somente para blobs de acréscimo. Se o blob de acréscimo tiver sido lacrado, o valor será true. Para obter mais informações, consulte Anexar selo de blob |
x-ms-immutability-policy-until-date |
Versão 2020-06-12 e posterior. Especifica a data de 'retenção até' definida no blob. Essa é a data até a qual o blob pode ser protegido contra modificação ou exclusão. Retornado somente se uma política de imutabilidade estiver definida no blob. O valor desse cabeçalho é RFC1123 formato. |
x-ms-immutability-policy-mode: unlocked/locked |
Versão 2020-06-12 e posterior. O modo de política de imutabilidade, retornado se uma política de imutabilidade for definida no blob. Os valores são unlocked/locked.
unlocked indica que o usuário pode alterar a política aumentando ou diminuindo a data de retenção até.
locked indica que essas ações são proibidas. |
x-ms-legal-hold: true/false |
Versão 2020-06-12 e posterior. Esse cabeçalho não será retornado se não houver nenhuma retenção legal no blob. O valor desse cabeçalho será definido como true se o blob contiver uma retenção legal e seu valor for true. Caso contrário, o valor será definido como false se o blob contiver uma retenção legal e seu valor false. |
x-ms-owner |
Versão 2020-06-12 e posterior. Somente para contas com namespace hierárquico habilitado. Retorna o usuário proprietário do arquivo ou diretório. |
x-ms-group |
Versão 2020-06-12 e posterior. Somente para contas com namespace hierárquico habilitado. Retorna o grupo proprietário do arquivo ou diretório. |
x-ms-permissions |
Versão 2020-06-12 e posterior. Somente para contas com namespace hierárquico habilitado. Retorna as permissões definidas para usuário, grupo e outras no arquivo ou diretório. Cada permissão individual está no [r,w,x,-]{3} formato . |
x-ms-acl |
Versão 2023-11-03 e posterior. Somente para contas com namespace hierárquico habilitado. Retorna a lista combinada de acesso e a lista de controle de acesso padrão definida para usuário, grupo e outros no arquivo ou diretório. Cada ACE (entrada de controle de acesso) consiste em um escopo, um tipo, um identificador de usuário ou grupo e permissões no formato [scope]:[type]:[id]:[permissions]. O default escopo indica que a ACE pertence à ACL padrão de um diretório; caso contrário, o escopo será implícito e a ACE pertence à ACL de acesso. Cada permissão individual está no [r,w,x,-]{3} formato . |
x-ms-resource-type |
Versão 2020-10-02 e posterior. Somente para contas com um namespace hierárquico habilitado. Retorna o tipo de recurso para o caminho, que pode ser file ou directory. |
x-ms-expiry-time |
Versão 2020-02-10 e posterior. Somente para contas com um namespace hierárquico habilitado. Retorna o tempo de expiração definido no blob. É retornado somente para arquivos que têm um tempo de expiração definido. |
Corpo da resposta
Nenhum.
Resposta de exemplo
Response Status:
HTTP/1.1 200 OK
Response Headers:
x-ms-meta-Name: myblob.txt
x-ms-meta-DateUploaded: <date>
x-ms-blob-type: AppendBlob
x-ms-lease-status: unlocked
x-ms-lease-state: available
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: <date>
ETag: "0x8CAE97120C1FF22"
Accept-Ranges: bytes
x-ms-blob-committed–block-count: 1
x-ms-version: 2015-02-21
Last-Modified: <date>
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6
x-ms-copy-source: <url>
x-ms-copy-status: success
x-ms-copy-progress: 11/11
x-ms-copy-completion-time: <date>
Autorização
A autorização é necessária ao chamar qualquer operação de acesso a dados no Armazenamento do Azure. Você pode autorizar a Get Blob Properties operação conforme descrito abaixo.
Importante
A Microsoft recomenda usar Microsoft Entra ID com identidades gerenciadas para autorizar solicitações para o Armazenamento do Azure. Microsoft Entra ID fornece segurança superior e facilidade de uso em comparação com a autorização de Chave Compartilhada.
O Armazenamento do Azure dá suporte ao uso de Microsoft Entra ID para autorizar solicitações para dados de blob. Com Microsoft Entra ID, você pode usar o RBAC (controle de acesso baseado em função) do Azure para conceder permissões a uma entidade de segurança. A entidade de segurança pode ser um usuário, um grupo, uma entidade de serviço de aplicativo ou uma identidade gerenciada do Azure. A entidade de segurança é autenticada por Microsoft Entra ID para retornar um token OAuth 2.0. Em seguida, o token pode ser usado para autorizar uma solicitação no serviço de Blob.
Para saber mais sobre a autorização usando Microsoft Entra ID, consulte Autorizar o acesso a blobs usando Microsoft Entra ID.
Permissões
Veja abaixo a ação RBAC necessária para um usuário Microsoft Entra, grupo, identidade gerenciada ou entidade de serviço para chamar a Get Blob Properties operação e a função rbac interna do Azure com privilégios mínimos que inclui esta ação:
- Ação rbac do Azure:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
- Função interna com privilégios mínimos:Leitor deDados de Blob de Armazenamento
Para saber mais sobre como atribuir funções usando o RBAC do Azure, confira Atribuir uma função do Azure para acesso aos dados de blob.
Comentários
Para determinar se uma Copy Blob operação foi concluída, primeiro marcar para garantir que o valor do x-ms-copy-id cabeçalho corresponda à ID de cópia fornecida pela chamada original para Copy Blob. Uma correspondência garante que outro aplicativo não anule a cópia e inicie uma nova Copy Blob operação. Em seguida, marcar para o x-ms-copy-status: success cabeçalho. Mas lembre-se de que todas as operações de gravação em um blob, exceto Lease, Put Pagee Put Block , removem todas as x-ms-copy-* propriedades do blob. Essas propriedades também não são copiadas por Copy Blob operações que usam versões anteriores a 2012-02-12.
x-ms-copy-status-description contém mais informações sobre a falha Copy Blob. Os x-ms-copy-status-description valores são descritos na tabela a seguir:
| Componente | Descrição |
|---|---|
| Código de status HTTP | Um inteiro padrão de 3 dígitos que especifica a falha. |
| Código do erro | Um palavra-chave que descreve o erro fornecido pelo Azure no <elemento ErrorCode>. Se nenhum <elemento ErrorCode> for exibido, será usado um palavra-chave com o texto de erro padrão associado ao código de status HTTP de três dígitos na especificação HTTP. Para saber mais, confira Códigos de erro comuns da API REST. |
| Informações | Descrição detalhada da falha, entre aspas. |
Os x-ms-copy-status valores e x-ms-copy-status-description de cenários comuns de falha são descritos na tabela a seguir:
Importante
As descrições de erro a seguir podem ser alteradas sem aviso, mesmo sem uma alteração de versão, portanto, o texto pode não corresponder exatamente.
| Cenário | Valor x-ms-copy-status | Valor x-ms-copy-status-description |
|---|---|---|
| Operação de cópia concluída com êxito. | sucesso | vazio |
| O usuário anulou a operação de cópia antes da conclusão. | aborted | vazio |
| Falha na leitura do blob de origem durante uma operação de cópia, mas a operação será repetida. | pending | 502 BadGateway "Encontrado um erro reproduzível ao ler a origem. Uma nova tentativa será realizada. Hora da falha: <tempo>" |
| Falha ao gravar no blob de destino de uma operação de cópia, mas a operação será repetida. | pending | 500 InternalServerError "Encontrado um erro reproduzível. Uma nova tentativa será realizada. Hora da falha: <tempo>" |
| Falha irrecuperável durante a leitura do blob de origem de uma operação de cópia. | falhou | 404 ResourceNotFound "Falha na cópia ao ler a origem". Observação: quando o serviço relata esse erro subjacente, ele retorna ResourceNotFound no <elemento ErrorCode> . Se nenhum <elemento ErrorCode> aparecesse na resposta, uma representação de cadeia de caracteres padrão do status HTTP, como NotFound, seria exibida. |
| O tempo limite que limita todas as operações de cópia expirou. (Atualmente, o período de tempo limite é de duas semanas.) | falhou | 500 OperationCancelled "A cópia excedeu o tempo máximo permitido.” |
| A operação de cópia falhou com muita frequência ao ler da origem e não atendeu a uma proporção mínima de tentativas para êxitos. (Esse tempo limite impede a repetição de uma fonte muito ruim ao longo de duas semanas antes de falhar). | falhou | 500 OperationCancelled "Falha na cópia durante a leitura da origem.” |
x-ms-last-access-time controla a hora em que os dados do blob foram acessados, com base na política de acompanhamento de hora do último acesso da conta de armazenamento. Acessar os metadados de um blob não altera a hora do último acesso.
Cobrança
As solicitações de preços podem ser originadas de clientes que usam APIs de Armazenamento de Blobs, diretamente por meio da API REST do Armazenamento de Blobs ou de uma biblioteca de clientes do Armazenamento do Azure. Essas solicitações acumulam encargos por transação. O tipo de transação afeta a forma como a conta é cobrada. Por exemplo, as transações de leitura se acumulam em uma categoria de cobrança diferente das transações de gravação. A tabela a seguir mostra a categoria de cobrança para Get Blob Properties solicitações com base no tipo de conta de armazenamento:
| Operação | Tipo de conta de armazenamento | Categoria de cobrança |
|---|---|---|
| Get Blob Properties | Blob de blocos Premium Uso geral v2 Standard |
Outras operações |
| Get Blob Properties | Uso geral v1 Standard | Operações de leitura |
Para saber mais sobre os preços da categoria de cobrança especificada, confira Preços Armazenamento de Blobs do Azure.
Confira também
Autorizar solicitações para o Armazenamento do Azure
Status e códigos de erro
Códigos de erro do Armazenamento de Blobs