Erros de API
Erros Comuns Retornados por Todos os Serviços
A tabela a seguir lista as falhas comuns retornadas por todos os serviços do Oracle Cloud Infrastructure.
| Código do Status HTTP | Código do Erro | Descrição | Nova Tentativa |
|---|---|---|---|
| 400 | CannotParseRequest |
A solicitação está formatada incorretamente. | Não. |
| 400 | InvalidParameter
|
Um parâmetro é inválido ou está formatado incorretamente. | Não. |
| 400 | LimitExceeded
|
Para atender a essa solicitação, é preciso exceder o limite definido pela Oracle para essa tenancy desse tipo de recurso. | Não. |
| 400 | MissingParameter
|
Um parâmetro obrigatório está ausente. | Não. |
| 400 | QuotaExceeded
|
Esta solicitação excede a cota definida pelo administrador deste compartimento para esse recurso. | Não. |
| 400 | RelatedResourceNot AuthorizedOrNotFound
|
Um recurso especificado no corpo da solicitação não foi encontrado, ou você não tem autorização para acessar esse recurso. |
Não. |
| 401 | NotAuthenticated
|
As informações de autenticação necessárias não foram fornecidas ou estavam incorretas. |
Não. |
| 403 | NotAllowed
|
Esta operação deve ser direcionada para a região home. | Não. |
| 403 | NotAuthorized
|
Você não tem autorização para atualizar um ou mais dos campos incluídos nesta solicitação. | Não. |
| 403 | SignUpRequired
|
Essa operação requer aceitação antes de ser chamada. | Não. |
| 404 | InvalidParameter |
Um componente de caminho dinâmico é inválido ou é sintaticamente válido, mas não é permitido. | Não. |
| 404 | NotAuthorizedOrNotFound
|
Um recurso especificado pelo URI (caminho ou parâmetros de consulta) da solicitação não foi encontrado, ou você não tem autorização para acessar esse recurso. Para obter mais informações, consulte Código de Status HTML 404. | Não. |
| 404 | NotFound
|
Não há operação suportada no caminho do URI e no método HTTP especificado na solicitação. | Não. |
| 404 | NamespaceNotFound
|
Você não tem autorização para executar esta solicitação ou não foi possível encontrar o recurso solicitado. | Não. |
| 405 | MethodNotAllowed
|
O recurso de destino não suporta o método HTTP. | Não. |
| 409 | Conflict
|
O estado solicitado para o recurso está em conflito com o estado atual. Esse estado não é temporário. | Não. |
| 409 | ExternalServerIncorrectState
|
O servidor está em um estado incorreto e expirou, retornou uma resposta inválida ou está inacessível. | Sim, com backoff. Consulte a descrição do erro para obter as ações necessárias antes de tentar novamente. |
| 409 | IncorrectState
|
O estado solicitado para o recurso está em conflito com o estado atual, mas em algum tempo ele estará no estado correto. | Sim, com backoff. Consulte a descrição do erro para obter as ações necessárias antes de tentar novamente. |
| 409 | InvalidatedRetryToken
|
O token de nova tentativa fornecido foi usado em uma solicitação anterior que resultou em uma atualização do sistema, mas uma operação subsequente invalidou o token. Isso pode acontecer, por exemplo, nos casos em que uma entidade criada com o mesmo token foi excluída. Se a alteração de estado do sistema associada a essa solicitação tiver de ser executada mais uma vez, tente-a novamente usando outro token. | Não. |
| 409 | ResourceLocked
|
O recurso solicitado está bloqueado. Isso geralmente ocorre porque o recurso está em uso ativo ou porque a modificação do recurso fará com que outro recurso pare de funcionar. | Não. |
| 409 | NotAuthorizedOrResourceAlreadyExists
|
Você não tem autorização para executar essa solicitação, ou o recurso que está tentando criar já existe. Esse código de erro só é retornado por operações de criação. Ele é retornado em vez do código de erro NotAuthorizedOrNotFound, que é mais genérico. |
Não. |
| 412 | NoEtagMatch
|
A ETag especificada na solicitação não corresponde à ETag do recurso. | Não. |
| 413 | PayloadTooLarge
|
A entidade de solicitação é maior que os limites definidos pelo servidor. | Não. |
| 422 | UnprocessableEntity
|
O payload está sintaticamente correto, mas semanticamente inválido. | Não. |
| 429 | TooManyRequests
|
Você emitiu muitas solicitações para as APIs do Oracle Cloud Infrastructure em um período muito curto. | Sim, com backoff. |
| 431 | RequestHeaderFieldsTooLarge
|
Os cabeçalhos HTTP da solicitação são muito grandes. A solicitação pode ser reenviada após a redução do tamanho dos cabeçalhos da solicitação. | Não. |
| 500 | InternalServerError
|
Erro interno do servidor. | Sim, com backoff. |
| 501 | MethodNotImplemented
|
O alvo da solicitação HTTP não reconhece o método HTTP. | Não. |
| 503 | ExternalServerUnreachable
|
Não foi possível estabelecer uma conexão com um sistema externo necessário para atender à solicitação. | Sim, com backoff. |
| 503 | ExternalServerTimeout
|
Uma conexão com um sistema externo necessário para atender à solicitação expirou antes de uma resposta ser recebida. | Sim, com backoff. |
| 503 | ExternalServerInvalidResponse
|
Uma conexão com um sistema externo necessário para atender à solicitação resultou em uma resposta inaceitável. | Sim, com backoff. |
| 503 | ServiceUnavailable
|
O serviço está indisponível no momento. | Sim, com backoff. |
Detalhes do Erro da API e Diagnóstico e Solução de Problemas
Esta seção contém informações detalhadas e sugestões de diagnóstico e solução de problemas para códigos de erro de Status do HTTP.
Códigos de Erro 400 de Status do HTTP
InvalidParameter
Descrição
O valor de um parâmetro é inválido ou está formatado incorretamente.
Diagnóstico e Solução de Problemas
- Consulte a documentação da API REST relativa à operação e verifique os parâmetros da solicitação, para ver se há erros de digitação ou formatos incorretos, e corrija a solicitação.
MissingParameter
Descrição
Um parâmetro obrigatório está ausente
Diagnóstico e Solução de Problemas
- A solicitação está sem um parâmetro necessário para esta API. Consulte a documentação da API REST relativa à operação e corrija a solicitação.
QuotaExceeded
Descrição
Esta solicitação excede a cota definida pelo administrador deste compartimento para esse recurso.
Diagnóstico e Solução de Problemas
- A cota definida pelo administrador nesse compartimento para esse recurso seria excedida caso essa solicitação fosse atendida. Verifique a cota do recurso e solicite um aumento para a cota ou remova os recursos não utilizados, se necessário. Para saber mais sobre cotas, consulte: Visão Geral de Cotas de Compartimento.
LimitExceeded
Descrição
Para atender a essa solicitação, é preciso exceder o limite definido pela Oracle para essa tenancy desse tipo de recurso.
Diagnóstico e Solução de Problemas
O limite definido pela Oracle nessa tenancy para esse tipo de recurso seria excedido caso essa solicitação fosse atendida. Verifique o limite no nível da tenancy para esse recurso e solicite um aumento de limite na tenancy ou remova recursos não usados e reenvie a solicitação. Para entender mais sobre seus limites de serviço do OCI e como solicitar um aumento de limite, consulte Limites de Serviço.CannotParseRequest
Descrição
A solicitação está formatada incorretamente.
Diagnóstico e Solução de Problemas
A solicitação para a maioria das operações que utilizam um corpo deve ser formatada como JSON. Consulte a documentação da API REST da operação para confirmar se a operação usa JSON, e, em caso afirmativo, confirmar se você está especificando um JSON válido no corpo da solicitação.InvalidStorageTier
Descrição
A solicitação está usando uma Camada de Armazenamento inválida.
Diagnóstico e Solução de Problemas
O parâmetro storageTier fornecido não está correto. Consulte a documentação da API REST relativa à operação e corrija a solicitação.Códigos de Erro 401 de Status do HTTP
NotAuthenticated
Descrição
As informações de autenticação necessárias não foram fornecidas ou estavam incorretas.
Diagnóstico e Solução de Problemas
Há várias coisas que podem acionar esse código de erro:
- Informações de autenticação não encontradas ou incorretas.
- Verifique se todas as informações necessárias (OCID do tenant, OCID do usuário, impressão digital e chave privada) foram fornecidas e são precisas.
- Verifique se
private_key_pathestá apontando para sua chave privada e não para a chave pública correspondente - Verifique se os pares de chaves públicas/privadas que você está usando estão no formato correto.
- Verifique se a conta de usuário faz parte de um grupo com as permissões apropriadas para executar as ações no plano que você está executando
- Verifique se sua tenancy foi inscrita na região de destino do seu plano
- Verifique se foi feito o upload da chave pública correspondente à impressão digital do usuário pelo qual você está fazendo a solicitação. Para obter mais informações, consulte Chaves e OCIDs Necessários.
- Diferença de Clock. Esse código de status será retornado se o clock do cliente estiver desalinhado em mais de cinco (5) minutos em relação ao clock do servidor. Para obter mais informações, consulte Diferença Máxima Permitida para o Clock do Cliente.
- Erro de assinatura da solicitação da API. Este código de status será retornado se uma informação obrigatória estiver faltando ou estiver malformada no cabeçalho de Autorização. Para obter mais informações, consulte Assinaturas das Solicitações.
Códigos de Erro 403 de Status do HTTP
SignUpRequired
Descrição
Essa operação requer aceitação para que possa ser chamada.
Diagnóstico e Solução de Problemas
Certifique-se de que o usuário está inscrito neste recurso. Caso contrário, entre em contato com o suporte e inscreva-se neste serviço.NotAllowed
Descrição
Esta operação deve ser direcionada para a região home.
Diagnóstico e Solução de Problemas
Esta operação deve ser direcionada para a região home. Atualize o código-fonte para fornecer as informações corretas da região.NotAuthorized
Descrição
Você não tem autorização para atualizar um ou mais dos campos incluídos nesta solicitação.
Diagnóstico e Solução de Problemas
Verifique a solicitação e remova todos os campos não autorizados. Para saber mais sobre permissões, consulte a Referência de Políticas.Códigos de Erro 404 de Status do HTTP
NamespaceNotFound
Descrição
Um recurso especificado pelo URI (caminho ou parâmetros de consulta) da solicitação não foi encontrado, ou você não tem autorização para acessar esse recurso.
Diagnóstico e Solução de Problemas
O recurso não foi encontrado ou o chamador não está autorizado a executar a operação solicitada no recurso, para um recurso especificado por meio do URI de solicitação para operações GET (obtenção de lista ou entidade única), UPDATE e DELETE. Verifique se o recurso solicitado realmente existe e se você tem acesso a ele. Para saber mais sobre permissões, consulte a Referência de Políticas.NotFound
Descrição
Não há operação suportada no caminho do URI e no método HTTP especificado na solicitação.
Diagnóstico e Solução de Problemas
Os componentes de caminho estático não existem ou você não está autorizado a acessá-los. Verifique a solicitação e atualize o componente de caminho estático.NotAuthorizedOrNotFound
Descrição
Um recurso especificado pelo URI (caminho ou parâmetros de consulta) da solicitação não foi encontrado, ou você não tem autorização para acessar esse recurso.
Diagnóstico e Solução de Problemas
O recurso não foi encontrado ou o chamador não está autorizado a executar a operação solicitada no recurso, para um recurso especificado por meio do URI de solicitação para operações GET (obtenção de lista ou entidade única), UPDATE e DELETE. Verifique se o recurso solicitado realmente existe e se você tem acesso a ele. Para saber mais sobre permissões, consulte a Referência de Políticas.InvalidParameter
Descrição
Um parâmetro especificado no caminho é inválido ou é sintaticamente válido, mas não é permitido.
Diagnóstico e Solução de Problemas
Verifique os parâmetros da solicitação para ver se há erros de digitação ou formatos incorretos. Consulte a documentação da API REST relativa à operação e corrija a solicitação.Códigos de Erro 405 de Status do HTTP
MethodNotAllowed
Descrição
O recurso de destino não suporta o método HTTP usado.
Diagnóstico e Solução de Problemas
O método HTTP na solicitação (por exemplo, PUT, POST, DELETE ou GET) não é permitido pelo recurso de destino. Verifique se o método HTTP pretendido está especificado corretamente e verifique a documentação da API REST da operação para confirmar se você está usando o método HTTP correto.Códigos de Erro 409 de Status do HTTP
NotAuthorizedOrResourceAlreadyExists
Descrição
Você não tem autorização para executar essa solicitação, ou o recurso que está tentando criar já existe. Esse código de erro só é retornado por operações de criação. Ele é retornado em vez do código de erro NotAuthorizedOrNotFound, que é mais genérico.
Diagnóstico e Solução de Problemas
- Se a solicitação for criar um recurso, verifique se o recurso já não existe e se o usuário que está chamando está autorizado a criar esse tipo de recurso neste compartimento.
- Verifique se o usuário está em um grupo que tem as permissões para trabalhar com recursos em um compartimento. Para saber mais sobre permissões, consulte a Referência de Políticas.
InvalidatedRetryToken
Descrição
O token de nova tentativa fornecido foi usado em uma solicitação anterior que resultou em uma atualização do sistema, mas uma operação subsequente invalidou o token. Isso pode acontecer nos casos em que uma entidade criada com o mesmo token foi excluída. Se a alteração de estado do sistema associada a essa solicitação precisar ser executada novamente, use outro token.
Diagnóstico e Solução de Problemas
Verifique o código-fonte e se o token de nova tentativa é usado corretamente.ExternalServerIncorrectState
Descrição
O servidor está em um estado incorreto e expirou, retornou uma resposta inválida ou está inacessível.
Diagnóstico e Solução de Problemas
Tente o seguinte:
- Verifique a mensagem de erro para obter mais detalhes. Talvez você precise reiniciar o servidor e garantir que ele esteja acessível pelos serviços da Oracle.
- Verifique os logs de erro em seu servidor para obter informações úteis.
- Seu servidor pode ter sofrido um problema temporário. Aguarde um momento e repita a solicitação.
- Se a solicitação ainda falhar, entre em contato com o suporte técnico da OCI e inclua o opc-request-id a partir da solicitação ou resposta HTTP com falha.
IncorrectState
Descrição
O estado solicitado para o recurso está em conflito com o estado atual, mas em algum tempo ele estará no estado correto.
Diagnóstico e Solução de Problemas
Tente o seguinte:
- Verifique as dependências do recurso. Um recurso não poderá ser excluído se ainda estiver sendo usado por outros recursos.
- Tente a solicitação novamente mais tarde ou atualize o código para aguardar o estado correto ser atingido antes de executar essa ação. Algumas operações exigem que o recurso esteja em um determinado estado (por exemplo, em execução).
Conflito
Descrição
O estado solicitado para o recurso está em conflito com o estado atual. Esse estado não é temporário.
Diagnóstico e Solução de Problemas
Verifique o estado do recurso solicitado e tente novamente.ResourceLocked
Descrição
O recurso solicitado está bloqueado. Isso geralmente ocorre porque o recurso está em uso ativo ou porque a modificação do recurso fará com que outro recurso pare de funcionar.
Diagnóstico e Solução de Problemas
Verifique o recurso para obter detalhes sobre o bloqueio. Você pode chamar uma API para remover o bloqueio no recurso ou pode passar um parâmetro para a API para ignorar o bloqueio e executar a operação solicitada.
Se o bloqueio foi colocado no recurso por um serviço externo, talvez você não consiga remover o bloqueio. Por exemplo, os administradores nas tenancies principais podem criar cotas bloqueadas em uma tenancy secundária, e os administradores na tenancy secundária não podem alterar as cotas.
Alguns bloqueios especificam um recurso relacionado no qual você deve excluir o recurso relacionado para remover o bloqueio neste recurso.
Códigos de Erro 412 de Status do HTTP
NoEtagMatch
Descrição
A ETag especificada no campo if-match da solicitação não corresponde à ETag do recurso.
Diagnóstico e Solução de Problemas
Corrija a ETag na solicitação se isso não for esperado. Para obter mais informações sobre ETags, consulte a documentação de Etag.
Códigos de Erro 413 de Status do HTTP
PayloadTooLarge
Descrição
A entidade de solicitação é maior que os limites definidos pelo servidor.
Diagnóstico e Solução de Problemas
Tente enviar uma solicitação menor.
Códigos de Erro 422 de Status do HTTP
UnprocessableEntity
Descrição
O payload está sintaticamente correto, mas semanticamente inválido.
Diagnóstico e Solução de Problemas
O serviço não pode processar a solicitação. Verifique a solicitação e reformate, se necessário.
Códigos de Erro 429 de Status do HTTP
TooManyRequests
Descrição
Você expediu muitas solicitações para as APIs do Oracle Cloud Infrastructure muito rapidamente.
Diagnóstico e Solução de Problemas
Isso é causado por muitas solicitações dentro de um pequeno período. Se o serviço tiver mecanismos de limitação, muitas solicitações dentro de um curto período resultarão na rejeição de algumas solicitações. Tente adicionar alguns atrasos entre as solicitações para evitar esse erro.
Códigos de Erro 431 de Status do HTTP
RequestHeaderFieldsTooLarge
Descrição
Os cabeçalhos HTTP na solicitação são muito longos.
Diagnóstico e Solução de Problemas
A solicitação pode ser reenviada após a redução do tamanho dos cabeçalhos da solicitação.
Códigos de Erro 500 de Status do HTTP
InternalServerError
Descrição
Erro interno do servidor.
Diagnóstico e Solução de Problemas
Por motivos desconhecidos, houve falha no serviço ao processar a solicitação. Em geral, esse é um problema do serviço, possivelmente por causa de uma interrupção temporária do serviço ou um bug. Tente enviar a mesma solicitação novamente. Se a nova tentativa ainda falhar, entre em contato com o suporte técnico do OCI e inclua o opc-request-id da solicitação ou resposta HTTP que falhou em sua mensagem.
Códigos de Erro 501 de Status do HTTP
MethodNotImplemented
Descrição
O alvo da solicitação HTTP não reconhece o método HTTP.
Diagnóstico e Solução de Problemas
O método HTTP na solicitação não está implementado no serviço. Consulte a documentação da API REST relativa à operação e atualize a solicitação para usar o método HTTP correto para a operação.