Solucionar problemas de pontos de acesso de blob

Este artigo ajuda você a encontrar a causa dos erros comuns de pontos de acesso blob e corrigi-los. Cada seção lista o sintoma, a causa e a resolução.

BlobAccessPointsNotAllowed

Sintoma: A criação, atualização ou desativação de uma configuração falha com código de status 409 e código de erro BlobAccessPointsNotAllowed. A mensagem diz que a allowBlobAccessPoints propriedade não está definida ou está definida como false.

Causa: A criação de pontos de acesso de blob não é permitida na conta de armazenamento.

Resolução: Permita a criação de pontos de acesso de blob e então tente novamente. Para etapas, consulte Permitir criação de ponto de acesso de blobs. A configuração pode levar alguns minutos para fazer efeito.

As leituras falham devido às configurações de rede

Sintoma: A configuração existe e seu teste de conexão passa, mas as leituras pelo ponto de acesso ao blob falham. No portal Azure, uma mensagem diz que as configurações de rede da conta de armazenamento podem estar bloqueando o acesso. Outros clientes normalmente recebem código 403 de status com código AuthorizationFailurede erro .

Causa: As regras de rede da conta de armazenamento bloqueiam o cliente. Os pontos de acesso Blob seguem as mesmas regras de rede que outros contêineres na conta de armazenamento.

Resolução: Permita o cliente nas regras de rede da conta de armazenamento. Por exemplo, defina o acesso à rede pública como Habilitado de todas as redes, adicione a rede virtual do cliente ou o endereço IP em Habilitado de redes virtuais e endereços IP selecionados, ou conecte-se por meio de um endpoint privado para a conta de armazenamento. Para mais informações, consulte Considerações de rede e Definir a regra padrão de acesso à rede pública.

Falha no teste de conexão

Sintoma: O teste de conexão falha com código TestConnectionFailurede erro . A mensagem pode mencionar um conector de armazenamento, que é o nome interno de uma configuração.

Causa e solução:

Cause Resolução
ID da chave de acesso, chave de acesso secreta ou região de assinatura incorretas Verifique os valores na sua fonte de dados e, em seguida, atualize as credenciais. Veja Atualizar credenciais e BlobAccessPointAuthError.
O endpoint de origem não está acessível a partir do Azure Para uma conexão pública, verifique o DNS e as regras de firewall na sua fonte de dados. Se sua fonte de dados restringir o tráfego de entrada, permita os intervalos de endereços IP da Storage tag de serviço para a região da sua conta de armazenamento. Para uma conexão privada, verifique se a conexão de endpoint privado foi aprovada.
O certificado da fonte de dados não é confiável Instale um certificado de uma autoridade certificadora confiável na sua fonte de dados. Apenas para testes, permita certificados autoassinados. Veja Alterar verificação TLS.

BlobAccessPointConfigurationNameNotFound

Sintoma: A criação de um ponto de acesso blob falha com código 409 de status e código BlobAccessPointConfigurationNameNotFoundde erro .

Causa: Não existe nenhuma configuração com esse nome na conta de armazenamento.

Resolução: Verifique o nome da configuração. A configuração deve estar na mesma conta de armazenamento que o ponto de acesso do blob.

BlobAccessPointConfigurationUniqueIdMismatch

Sintoma: A criação de um ponto de acesso blob falha com código 409 de status e código BlobAccessPointConfigurationUniqueIdMismatchde erro .

Causa: A configuração existe, mas seu ID único não corresponde ao valor da solicitação.

Resolução: Recupere a configuração novamente e use seu valor atual de uniqueId.

OperationNotSupportedForBlobAccessPoints

Sintoma: Uma solicitação para escrever, atualizar ou excluir um blob falha com código 409 de status e código OperationNotSupportedForBlobAccessPointsde erro .

Causa: Os blobs em um ponto de acesso de blob são somente de leitura. Esse erro é esperado.

Resolução: Não é necessária nenhuma ação. Para gravar dados, grave-os diretamente na sua fonte de dados ou use um contêiner regular.

BlobAccessPointDisabled

Sintoma: As leituras por meio de um ponto de acesso de blob falham com código de status 409 e código de erro BlobAccessPointDisabled. A mensagem diz que o ponto de acesso do blob está desativado.

Causa: A configuração está inativa.

Resolução: Ative a configuração. Veja Desativar ou ativar uma configuração.

BlobAccessPointConfigError

Sintoma: As leituras por meio de um ponto de acesso de blob falham com código de status 409 e código de erro BlobAccessPointConfigError.

Causa: A configuração que o ponto de acesso do blob usa foi excluída.

Resolução: Não é possível reconectar o ponto de acesso de blob. Exclua-o, crie uma nova configuração se necessário e, em seguida, crie um novo ponto de acesso blob. Veja Criar um ponto de acesso blob.

BlobAccessPointAuthError

Sintoma:Listar blobs, obter propriedades do blob e obter solicitações de blob para um ponto de acesso de blob falham com código 409de status, código BlobAccessPointAuthErrorde erro e a mensagem "BlobAccessPoint retornou um erro de autenticação." O teste de conexão falha com código TestConnectionFailurede erro .

Causa: Sua fonte de dados rejeitou a solicitação que o Armazenamento do Azure assinou com as credenciais na configuração. Por exemplo, o ID da chave de acesso ou a chave secreta de acesso está errado, as chaves foram rotadas na fonte de dados mas não na configuração, a região de assinatura está errada, ou a chave de acesso não consegue listar e ler objetos no bucket. As credenciais do chamador que lê do ponto de acesso do blob não estão envolvidas. Sua fonte de dados retornou código 403de status, mas o Armazenamento do Azure retorna 409 porque a configuração precisa ser corrigida.

Solução:

  1. Verifique o ID da chave de acesso, a chave secreta de acesso e a região de assinatura na sua fonte de dados. Se seus logs mostrarem a solicitação rejeitada, o código de erro aponta para a causa:

    Código de erro da fonte de dados Causa provável
    SignatureDoesNotMatch A chave de acesso secreta ou a região de assinatura está errada.
    InvalidAccessKeyId O ID da chave de acesso está errado ou foi excluído.
    AccessDenied A chave de acesso não tem permissão sobre o bucket.

    Se você trabalhar com um provedor de fonte de dados, forneça a eles o horário UTC da solicitação falhada para que possam encontrá-la em seus logs.

  2. Atualize as credenciais na configuração. Digite o ID da chave de acesso e a chave secreta de acesso juntos. Consulte Atualização de credenciais.

  3. Teste a ligação. Veja Teste a conexão.

Erros 403 ao ler dados

Sintoma: As leituras por meio de um ponto de acesso de blob falham com o código de status 403.

Causa: O chamador não tem permissão para ler dados do blob, ou uma nova atribuição de função ainda não entrou em vigor. Se o código de erro for AuthorizationFailure, as regras de rede da conta de armazenamento podem estar bloqueando o cliente em vez disso.

Resolução: Atribua uma função que possa ler dados de blob, como Storage Blob Data Reader, e aguarde alguns minutos até que a atribuição entre em vigor. Veja Autorizar acesso a pontos de acesso de blob. Para causas de rede, veja Falha nas leituras devido às configurações de rede.

Cabeçalhos de pontos de acesso blob estão ausentes

Sintoma: Obter Propriedades do Contêiner ou Listar Contêineres não retorna os cabeçalhos ou campos dos pontos de acesso de blob.

Causa: A solicitação usa um x-ms-version anterior a 2026-12-06.

Resolução: Definir x-ms-version para 2026-12-06 ou posterior.

Pontos de acesso de blob não aparecem no portal Azure

Sintoma: Você não consegue encontrar pontos de acesso Blob para sua conta de armazenamento no portal Azure.

Causa: A conta de armazenamento está em uma região onde a experiência do portal Azure para pontos de acesso blob ainda não está disponível, ou em uma região onde pontos de acesso blob não estão disponíveis.

Resolução: Verifique a região da sua conta de armazenamento em Regiões suportadas. Se pontos de acesso blob estiverem disponíveis na região, mas a experiência do portal Azure não estiver, use a API REST. Para os passos, selecione a aba API REST em Criar um ponto de acesso blob.

Informações a incluir em uma solicitação de suporte

Se você não conseguir resolver um problema, abra uma solicitação de suporte e inclua as seguintes informações:

  • O horário da solicitação em UTC, a região e o nome da conta de armazenamento.
  • O nome da configuração e o ID único.
  • O x-ms-request-id cabeçalho para solicitações de dados, ou o x-ms-correlation-request-id cabeçalho para solicitações de gerenciamento.
  • O corpo completo de resposta, com segredos removidos.