Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
- Um ponto de acesso de blob. Para criar um, consulte Criar um ponto de acesso blob.
- Acesso de rede à conta de armazenamento a partir do seu cliente. As regras de rede da conta de armazenamento se aplicam aos pontos de acesso blob da mesma forma que se aplicam a outros contêineres. Para mais informações, consulte Considerações sobre rede.
- Permissão para ler dados de blob, como a função de Storage Blob Data Reader . Para outras opções, consulte Autorizar acesso a pontos de acesso blob.
- Para navegar pelos dados no portal Azure, você precisa da função Azure Resource Manager Reader ou de uma função com mais permissões na conta de armazenamento. O Storage Blob Data Reader sozinho não permite que você abra a conta de armazenamento no portal. Para obter mais informações, confira Como autorizar o acesso aos dados de blob no portal do Azure.
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.
No portal do Azure, acesse sua conta de armazenamento.
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.
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.
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
409de status e códigoOperationNotSupportedForBlobAccessPointsde 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.