Compartilhar via


Códigos de erro comuns da API REST

Uma operação em qualquer um dos serviços de Armazenamento do Azure pode retornar os seguintes códigos de erro:

Código do erro Código de status HTTP Mensagem do usuário
NoAuthenticationInformation Não autorizado (401) Houve uma falha do servidor ao autenticar a solicitação. Consulte as informações no cabeçalho www-authenticate.
InvalidAuthenticationInfo Não autorizado (401) Houve uma falha do servidor ao autenticar a solicitação. Consulte as informações no cabeçalho www-authenticate.
AccountAlreadyExists Conflito (409) A conta especificada já existe.
AccountBeingCreated Conflito (409) A conta especificada está no processo de criação.
AccountIsDisabled Proibido (403) A conta especificada está desabilitada.
AccountProtectedFromDeletion Conflito (409) Os contêineres <containerName> de conta <accountName> têm <have legal hold\locked immutability policy>.
AuthenticationFailed Proibido (403) Houve uma falha do servidor ao autenticar a solicitação. Verifique se o valor do cabeçalho Authorization foi formado corretamente e inclui a assinatura.
ConditionHeadersNotSupported BadRequest (400) Não há suporte para cabeçalhos de condição.
ConditionNotMet Sem modificação (304) A condição especificada em cabeçalhos condicionais não foi atendida para uma operação de leitura.
ConditionNotMet Falha na Pré-condição (412) A condição especificada em cabeçalhos condicionais não foi atendida para uma operação de gravação.
EmptyMetadataKey Solicitação incorreta (400) A chave para um dos pares chave de metadados-valor está vazio.
InsufficientAccountPermissions Proibido (403) As operações de leitura estão desabilitadas no momento.
InsufficientAccountPermissions Proibido (403) As operações de gravação não são permitidas.
InsufficientAccountPermissions Proibido (403) A conta que está sendo acessada não tem permissões suficientes para executar essa operação.
InternalError Erro interno do servidor (500) O servidor encontrou um erro interno. Tente novamente a solicitação.
InvalidAuthenticationInfo Solicitação incorreta (400) As informações de autenticação não foram fornecidas no formato correto. Verifique o valor do cabeçalho Authorization.
InvalidHeaderValue Solicitação incorreta (400) O valor fornecido para um dos cabeçalhos HTTP não estava no formato correto.
InvalidHttpVerb Solicitação incorreta (400) O verbo HTTP especificado não foi reconhecido pelo servidor.
InvalidInput Solicitação incorreta (400) Uma das entradas de solicitação não é válida.
InvalidMd5 Solicitação incorreta (400) O valor MD5 especificado na solicitação é inválido. O valor MD5 deve ter 128 bits e codificado por Base64.
InvalidMetadata Solicitação incorreta (400) Os metadados especificados são inválidos. Ele inclui caracteres que não são permitidos.
InvalidQueryParameterValue Solicitação incorreta (400) Um valor inválido foi especificado para um dos parâmetros de consulta no URI de solicitação.
InvalidRange Intervalo solicitado não satisfatório (416) O intervalo especificado não é válido para o tamanho atual do recurso.
InvalidResourceName Solicitação incorreta (400) O nome do recurso especificado contém caracteres inválidos.
InvalidUri Solicitação incorreta (400) O URI solicitado não representa nenhum recurso no servidor.
InvalidXmlDocument Solicitação incorreta (400) O XML especificado não é sintaticamente válido.
InvalidXmlNodeValue Solicitação incorreta (400) O valor fornecido para um dos nós XML no corpo da solicitação não estava no formato correto.
KeyVaultAccessTokenCannotBeAcquired Proibido (403) Não é possível adquirir um token de acesso para o cofre de chaves de Microsoft Entra usando a identidade desse recurso.
KeyVaultEncryptionKeyNotFound Proibido (403) A chave do cofre de chaves não foi encontrada para desembrulhar a chave de criptografia.
KeyVaultVaultNotFound Proibido (403) O cofre do cofre de chaves não foi encontrado.
Md5Mismatch Solicitação incorreta (400) O valor MD5 especificado na solicitação não correspondeu ao valor MD5 calculado pelo servidor.
MetadataTooLarge Solicitação incorreta (400) O tamanho dos metadados especificados excede o tamanho máximo permitido.
MissingContentLengthHeader Comprimento Obrigatório (411) O cabeçalho Content-Length não foi especificado.
MissingRequiredQueryParameter Solicitação incorreta (400) Um parâmetro de consulta necessário não foi especificado para esta solicitação.
MissingRequiredHeader Solicitação incorreta (400) Um cabeçalho HTTP necessário não foi especificado.
MissingRequiredXmlNode Solicitação incorreta (400) Um nó XML necessário não foi especificado no corpo da solicitação.
MultipleConditionHeadersNotSupported Solicitação incorreta (400) Não há suporte para vários cabeçalhos de condição.
OperationTimedOut Erro interno do servidor (500) A operação não pôde ser concluída dentro do tempo permitido ou do número máximo de tentativas possível. A operação pode ou não ter sido bem-sucedida no lado do servidor. Consulte o estado do servidor antes de tentar novamente a operação.
OutOfRangeInput Solicitação incorreta (400) Uma das entradas da solicitação está fora do intervalo.
OutOfRangeQueryParameterValue Solicitação incorreta (400) Um parâmetro de consulta especificado no URI de solicitação está fora do intervalo.
RequestBodyTooLarge Entidade de solicitação muito grande (413) O tamanho do corpo da solicitação excede o tamanho máximo permitido.
ResourceTypeMismatch Conflito (409) O tipo de recurso especificado não corresponde ao tipo do recurso existente.
RequestUrlFailedToParse Solicitação incorreta (400) Não foi possível analisar a URL na solicitação.
ResourceAlreadyExists Conflito (409) O recurso especificado já existe.
ResourceNotFound Não encontrado (404) O recurso especificado não existe.
ServerBusy Serviço não disponível (503) Atualmente, o servidor não pode receber solicitações. Tente novamente a sua solicitação.
ServerBusy Serviço não disponível (503) A entrada está acima do limite da conta.
ServerBusy Serviço não disponível (503) A saída está acima do limite da conta.
ServerBusy Serviço não disponível (503) As operações por segundo estão acima do limite da conta.
UnsupportedHeader Solicitação incorreta (400) Não há suporte para um dos cabeçalhos HTTP especificados na solicitação.
UnsupportedXmlNode Solicitação incorreta (400) Não há suporte para um dos nós XML especificados no corpo da solicitação.
UnsupportedQueryParameter Solicitação incorreta (400) Não há suporte para um dos parâmetros de consulta especificados no URI de solicitação.
UnsupportedHttpVerb Método não permitido (405) O recurso não oferece suporte ao verbo HTTP especificado.

Confira também

Códigos de erro do Armazenamento de Blobs
Códigos de erro do Armazenamento de Filas
Códigos de erro do Armazenamento de Tabelas
Arquivos do Azure códigos de erro
Solucionar problemas de operações de API
Enumeração HttpStatusCode
Referência de API REST do Armazenamento do Azure