Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Um ponto de acesso a um blob comporta-se como um contentor com blobs só de leitura. Ferramentas e serviços que leem a partir do Armazenamento de Blobs podem ler os dados na sua fonte de dados sem alterações de código, desde que utilizem o endpoint Armazenamento de Blobs.
Prerequisites
- Um ponto de acesso de blob. Para criar um, consulte Criar um ponto de acesso blob.
- Acesso em rede à conta de armazenamento a partir do seu cliente. As regras de rede da conta de armazenamento aplicam-se aos pontos de acesso blob da mesma forma que se aplicam a outros contentores. Para mais informações, consulte Considerações de rede.
- Permissão para ler dados de blob, como a função de Leitor de Dados de Blob de Armazenamento . Para outras opções, consulte Autorizar acesso a pontos de acesso blob.
- Para navegar pelos dados no portal Azure, a função Azure Resource Manager Reader, ou uma função com mais permissões, na conta de armazenamento. O Storage Blob Data Reader por si só não lhe permite abrir a conta de armazenamento no portal. Para obter mais informações, consulte Escolher como autorizar o acesso a dados de blob no portal do Azure.
Navegar nos dados no portal do Azure
Só pode navegar pelos dados no portal Azure em regiões onde a experiência do portal Azure para pontos de acesso blob está disponível. Noutras regiões suportadas, leia dados utilizando a API REST ou outra ferramenta. Consulte Regiões suportadas. Para listar pontos de acesso blob com a API REST, consulte Ler dados com a API REST.
No portal do Azure, vá para sua conta de armazenamento.
Em Armazenamento de dados, selecione Contentores e, em seguida, selecione o separador Pontos de acesso Blob .
O separador lista cada ponto de acesso blob com a configuração que utiliza.
Selecione um ponto de acesso a um blob para navegar pelas suas pastas e blobs.
A barra de ferramentas oferece apenas colunas Atualizar e Editar, porque os blobs são só de leitura. A página também mostra o método de autenticação que o portal utiliza e a configuração que o ponto de acesso do blob utiliza.
Para trabalhar com um blob, selecione Mais (...) ao lado dele. Pode visualizar as suas Propriedades, Copiar URL, Descarregá-la ou Gerar SAS.
Ler dados com a API REST
Utilize as mesmas operações de Armazenamento de Blobs que utiliza para qualquer contentor. Use o nome do ponto de acesso blob como nome do contentor.
Em cada pedido, substitua <utc-date-time> pela hora 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 mais informações, consulte Autorizar o acesso a dados em Armazenamento do Azure.
Para encontrar os pontos de acesso ao blob numa conta de armazenamento, chame List Containers. Utilize uma função ou assinatura de acesso partilhada com âmbito na conta de armazenamento. Um que está limitado a um único ponto de acesso a um blob não pode listar pontos de acesso a 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 contentores e pontos de acesso blob em conjunto. Para cada ponto de acesso ao blob, o elemento Properties 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 de Blob e Obter Blob não necessitam de um x-ms-version Blob 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> ao pedido para obter a página seguinte.
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 descarregar 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 de cliente que listam, obtêm propriedades e descarregam blobs através do endpoint Armazenamento de Blobs podem ler a partir de um ponto de acesso a blob. Utilize o nome do ponto de acesso ao blob sempre que a ferramenta pedir o nome do contentor.
Utilizar uma assinatura de acesso partilhado
Para conceder a uma aplicação acesso de leitura com limite de tempo, crie uma assinatura de acesso partilhado (SAS). Conceda apenas as permissões de que a leitura necessita, porque os blobs num ponto de acesso a blobs são apenas de leitura:
- Para um único blob, crie um blob SAS com permissão de leitura . No portal Azure, selecione Gerar SAS para o blob.
- Para todo o ponto de acesso de blobs, crie um contentor SAS com permissões de Leitura e de Lista. A permissão de lista funciona apenas num SAS de contentores.
Para obter mais informações, consulte Conceder acesso limitado a dados com assinaturas de acesso compartilhado (SAS).
Use pontos de acesso de blobs com os serviços do Azure
Os serviços Azure que leem a partir do Armazenamento de Blobs podem ler a partir de um ponto de acesso a um blob, desde que utilizem as operações List Blobs, Get Blob Properties e Get Blob. Verifique os seguintes pontos antes de ligar um serviço:
- Endpoint. O serviço deve ler através do endpoint Armazenamento de Blobs (
<storage-account>.blob.core.windows.net). Os pedidos através do endpoint Data Lake Storage (<storage-account>.dfs.core.windows.net) falham. - Identidade. Utilize uma identidade gerida para o serviço e atribua-lhe a função de Leitor de Dados de Blocos de Armazenamento na conta de armazenamento.
- Deteção de alterações. O rastreamento de alterações não está disponível para pontos de acesso ao blob. Os serviços que dependem dele para detetar objetos novos ou eliminados podem não detetar alterações.
Comportamento em modo só de leitura e propriedades dos blobs
- Os pedidos de escrita, atualização e eliminação de blobs falham com código
409de estado e códigoOperationNotSupportedForBlobAccessPointsde erro. - O
ETag,Last-Modified, e o tamanho (Content-Length) de cada blob provêm da sua fonte de dados. Obter Propriedades do Blob e Obter Blob também retornam cabeçalhos de conteúdo suportados quando a sua fonte de dados os fornece. O nível de acesso é sempre reportado como Hot. Não reflete a classe de armazenamento do objeto na sua fonte de dados. Outras propriedades do Armazenamento de Blobs podem estar em falta ou apresentar valores predefinidos. - O Armazenamento do Azure lê dados diretamente da sua fonte de dados para cada pedido, sem cache em memória. Espere uma latência maior do que quando lê dados armazenados no Armazenamento do Azure.
- As contas de armazenamento que permitem a criação de pontos de acesso a blobs não retornam resultados de List Blobs em 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.