Acesse dados em um ponto de acesso blob

Um ponto de acesso a um blob se comporta como um contêiner com blobs somente de leitura. Ferramentas e serviços que leem do Armazenamento de Blobs podem ler os dados da sua fonte de dados sem alterações no código, desde que usem o endpoint Armazenamento de Blobs.

Prerequisites

Navegar pelos dados no portal do Azure

Você pode navegar pelos dados no portal Azure apenas em regiões onde a experiência do portal Azure para pontos de acesso blob está disponível. Em outras regiões suportadas, leia dados usando a API REST ou outra ferramenta. Consulte Regiões compatíveis. Para listar pontos de acesso blob com a API REST, consulte Ler dados com a API REST.

  1. No portal do Azure, acesse sua conta de armazenamento.

  2. Em Armazenamento de dados, selecione Containers e, em seguida, selecione a aba Pontos de acesso Blob .

    A aba lista cada ponto de acesso de blob com a configuração que ele utiliza.

    Captura de tela da aba Pontos de acesso Blob na página Containers de uma conta de armazenamento, com a aba destacada.

  3. Selecione um ponto de acesso blob para navegar por suas pastas e blobs.

    A barra de ferramentas oferece apenas Atualizar e Editar colunas, porque os blobs são somente de leitura. A página também mostra o método de autenticação que o portal usa e a configuração que o ponto de acesso do blob utiliza.

    Captura de tela de blobs de uma fonte de dados externa em um ponto de acesso de blobs, com a barra de ferramentas somente de leitura destacada.

  4. Para trabalhar com um blob, selecione More (...) ao lado dele. Você pode visualizar suas Propriedades, Copiar URL, Baixá-lo ou Gerar SAS.

Leia dados com a API REST

Use as mesmas operações de Armazenamento de Blobs que você usa para qualquer contêiner. Use o nome do ponto de acesso blob como nome do contêiner.

Em cada requisição, substitua <utc-date-time> pelo horário UTC atual no formato RFC 1123, como Mon, 02 Nov 2026 16:00:00 GMT. Substitua <authorization> pelo valor do seu método de autorização. Para obter mais informações, consulte Authorize o acesso aos dados em Armazenamento do Azure.

Para encontrar os pontos de acesso do blob em uma conta de armazenamento, chame List Containers. Use um perfil ou assinatura de acesso compartilhado com escopo para a conta de armazenamento. Um que está limitado a um único ponto de acesso de blob não pode listar pontos de acesso de blob.

GET https://<storage-account>.blob.core.windows.net/?comp=list
x-ms-version: 2026-12-06
x-ms-date: <utc-date-time>
Authorization: <authorization>

A resposta lista contêineres e pontos de acesso blob juntos. Para cada ponto de acesso de blob, o Properties elemento inclui mais três elementos:

<Container>
  <Name>my-blob-access-point</Name>
  <Properties>
    <!-- Standard container properties -->
    <IsBlobAccessPointContainer>true</IsBlobAccessPointContainer>
    <BlobAccessPointConfigurationName>my-configuration</BlobAccessPointConfigurationName>
    <BlobAccessPointConfigurationUniqueId>configuration-guid</BlobAccessPointConfigurationUniqueId>
  </Properties>
</Container>

Listar Blobs, Obter Propriedades do Blob e Obter Blob não precisam de um x-ms-version específico. Os exemplos usam 2026-12-06, mas versões anteriores também funcionam.

Para listar blobs, chame List Blobs:

GET https://<storage-account>.blob.core.windows.net/<blob-access-point>?restype=container&comp=list
x-ms-version: 2026-12-06
x-ms-date: <utc-date-time>
Authorization: <authorization>

Se a resposta incluir um NextMarker valor, adicione &marker=<next-marker> à solicitação para obter a próxima página.

Para obter as propriedades de um blob, chame Obter Propriedades do Blob:

HEAD https://<storage-account>.blob.core.windows.net/<blob-access-point>/<blob-name>
x-ms-version: 2026-12-06
x-ms-date: <utc-date-time>
Authorization: <authorization>

Para baixar um blob, chame Get Blob:

GET https://<storage-account>.blob.core.windows.net/<blob-access-point>/<blob-name>
x-ms-version: 2026-12-06
x-ms-date: <utc-date-time>
Authorization: <authorization>

Leia dados com ferramentas e bibliotecas de clientes

Ferramentas e bibliotecas cliente que listam, obtêm propriedades e baixam blobs através do endpoint Armazenamento de Blobs podem ler a partir de um ponto de acesso de blob. Use o nome do ponto de acesso blob onde quer que a ferramenta peça o nome do contêiner.

Use uma assinatura de acesso compartilhado

Para conceder a uma aplicação acesso de leitura com limite de tempo, crie uma assinatura de acesso compartilhado (SAS). Conceda apenas as permissões que a leitura precisa, porque os blobs em um ponto de acesso de blobs são somente leitura:

  • Para um único blob, crie um SAS de blob com permissão de Leitura . No portal Azure, selecione Gerar SAS para o blob.
  • Para todo o ponto de acesso de blob, crie um SAS de contêiner com permissões de Leitura e de Listagem. Permissão de lista funciona apenas em um SAS de contêiner.

Para saber mais, confira Conceder acesso limitado a dados com assinaturas de acesso compartilhado (SAS).

Use pontos de acesso de blob com os serviços Azure

Os serviços do Azure que leem do Armazenamento de Blobs podem ler a partir de um ponto de acesso de blob, desde que usem as operações List Blobs, Get Blob Properties e Get Blob. Verifique os seguintes pontos antes de se conectar a um serviço:

  • Endpoint. O serviço deve ler por meio do endpoint Armazenamento de Blobs (<storage-account>.blob.core.windows.net). Solicitações feitas pelo endpoint Data Lake Storage (<storage-account>.dfs.core.windows.net) falham.
  • Identidade. Use uma identidade gerenciada para o serviço e atribua a ele a função de Leitor de Dados de Blocos de Armazenamento na conta de armazenamento.
  • Detecção de alterações. O rastreamento de mudanças não está disponível para pontos de acesso blob. Serviços que dependem dele para detectar objetos novos ou excluídos podem não perceber mudanças.

Comportamento somente de leitura e propriedades do blob

  • Solicitações de gravação, atualização e exclusão de blobs falham com código 409 de status e código OperationNotSupportedForBlobAccessPointsde erro.
  • O ETag, Last-Modified, e o tamanho (Content-Length) de cada blob vêm da sua fonte de dados. Obter Propriedades do Blob e Obter Blob também retornam cabeçalhos de conteúdo suportados quando sua fonte de dados os fornece. O nível de acesso é sempre reportado como Quente. Ele não reflete a classe de armazenamento do objeto na sua fonte de dados. Outras propriedades do Armazenamento de Blobs podem estar ausentes ou apresentar valores padrão.
  • O Armazenamento do Azure lê dados diretamente da sua fonte de dados para cada solicitação, sem cache nenhum. Espere uma latência maior do que quando você lê dados armazenados no Armazenamento do Azure.
  • Contas de armazenamento que permitem a criação de pontos de acesso de blobs não retornam resultados da operação List Blobs no formato Apache Arrow. Para mais detalhes, consulte as listagens do Apache Arrow.

Para a lista completa, consulte Limitações e problemas conhecidos com pontos de acesso blob.