Resolver problemas de pontos de acesso a blobs

Este artigo ajuda-o a encontrar a causa dos erros comuns nos pontos de acesso blob e a corrigi-los. Cada secçã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 estado 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 a blob não é permitida na conta de armazenamento.

Resolução: Permita a criação de pontos de acesso de blobs e depois tente novamente. Para os passos, consulte Permitir criação de ponto de acesso a blobs. A configuração pode demorar alguns minutos a fazer efeito.

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

Sintoma: A configuração existe e o seu teste de ligação passa, mas as leituras através do ponto de acesso de blob falham. No portal Azure, uma mensagem diz que as definições de rede da conta de armazenamento podem estar a bloquear o acesso. Outros clientes normalmente recebem código 403 de estado 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 contentores 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 Ativado de todas as redes, adicione a rede virtual do cliente ou o endereço IP em Ativado de redes virtuais e endereços IP selecionados, ou ligue-se através de um endpoint privado para a conta de armazenamento. Para mais informações, consulte Considerações de rede e Definir a regra predefinida de acesso à rede pública.

Teste de ligação falha

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

Causa e resolução:

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

BlobAccessPointConfigurationNameNotFound

Sintoma: A criação de um ponto de acesso blob falha com código 409 de estado 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 do ponto de acesso do blob.

BlobAccessPointConfigurationUniqueIdMismatch

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

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

Resolução: Obtenha novamente a configuração e utilize o seu atual uniqueId valor.

OperationNotSupportedForBlobAccessPoints

Sintoma: Um pedido para escrever, atualizar ou eliminar um blob falha com código 409 de estado e código OperationNotSupportedForBlobAccessPointsde erro .

Causa: Os blobs num ponto de acesso a blobs são só de leitura. Este erro é esperado.

Resolução: Não é necessária nenhuma ação. Para escrever dados, escreva-os diretamente na sua fonte de dados ou utilize um contentor normal.

BlobAccessPointDisabled

Sintoma: As leituras através de um ponto de acesso de blob falham com o código de estado 409 e o 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. Consulte Desativar ou ativar uma configuração.

BlobAccessPointConfigError

Sintoma: As leituras através de um ponto de acesso blob falham com o código de estado 409 e o código de erro BlobAccessPointConfigError.

Causa: A configuração que o ponto de acesso do blob utiliza foi eliminada.

Resolução: Não pode reconectar o ponto de acesso do blob. Elimine-o, crie uma nova configuração se necessário e, em seguida, crie um novo ponto de acesso blob. Consulte Criar um ponto de acesso blob.

BlobAccessPointAuthError

Sintoma:Listar Blobs, Obter Propriedades do Blob e Obter pedidos de Blob para um ponto de acesso a Blob falham com o código 409de estado , código BlobAccessPointAuthErrorde erro , e a mensagem "BlobAccessPoint retornou um erro de autenticação." O teste de ligação falha com código TestConnectionFailurede erro .

Causa: A sua fonte de dados rejeitou o pedido que o Armazenamento do Azure assinou com as credenciais na configuração. Por exemplo, o ID da chave de acesso ou a chave de acesso secreta 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ê a partir do ponto de acesso do blob não estão envolvidas. A sua fonte de dados devolveu o código 403de estado , mas o Armazenamento do Azure devolve 409 porque a configuração precisa de ser corrigida.

Resolução:

  1. Verifique o ID da chave de acesso, a chave de acesso secreta e a região de assinatura na sua fonte de dados. Se os registos apresentarem o pedido rejeitado, o código de erro indica 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 eliminado.
    AccessDenied A chave de acesso não tem permissão sobre o bucket.

    Se trabalhar com um fornecedor da origem de dados, dê-lhes a hora UTC do pedido falhado para que a possam localizar nos seus registos.

  2. Atualize as credenciais na configuração. Introduza o ID da chave de acesso e a chave de acesso secreta em conjunto. Consulte “Atualizar credenciais”.

  3. Teste a conexão. Consulte Test the connection.

Erros 403 ao ler dados

Sintoma: As leituras através de um ponto de acesso a blob falham com o código de estado 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 a bloquear 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. Consulte Autorização do acesso aos pontos de acesso de blobs. Para causas de rede, consulte Falhas nas leituras devido às definições de rede.

Os cabeçalhos dos pontos de acesso blob estão em falta

Sintoma: Get Container Properties ou List Containers não retorna os cabeçalhos ou campos dos pontos de acesso do blob.

Causa: O pedido utiliza um x-ms-version anterior a 2026-12-06.

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

Os pontos de acesso Blob não aparecem no portal Azure

Sintoma: Não consegue encontrar pontos de acesso Blob para a sua conta de armazenamento no portal Azure.

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

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

Informações a incluir num pedido de suporte

Se não conseguir resolver um problema, abra um pedido de suporte e inclua a seguinte informação:

  • A hora do pedido 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 pedidos de dados, ou o x-ms-correlation-request-id cabeçalho para pedidos de gestão.
  • O corpo de resposta completo, com segredos removidos.