

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Mensagens de erro e códigos do mecanismo gráfico
<a name="errors-engine-codes"></a>

Os endpoints do Amazon Neptune geram os erros padrão para Gremlin e SPARQL quando encontrados. 

Os erros específicos do Neptune também podem ser gerados pelos mesmos endpoints. Esta seção documenta as mensagens de erro, os códigos e as ações recomendadas do Neptune.

**nota**  
Esses erros são relativos somente aos endpoints do cluster de banco de dados do Neptune. O APIs para criar e modificar recursos do Neptune com AWS o SDK AWS CLI e ter um conjunto diferente de erros comuns. Para obter mais informações sobre esses erros, consulte [Códigos e mensagens de erro da API de gerenciamento do cluster de banco de dados](CommonErrors.md).

## Formato de erro do mecanismo de gráfico
<a name="errors-format"></a>

As mensagens de erro do Neptune geram um código de erro HTTP relevante e uma resposta em formato JSON.

```
HTTP/1.1 400 Bad Request
x-amzn-RequestId: LDM6CJP8RMQ1FHKSC1RBVJFPNVV4KQNSO5AEMF66Q9ASUAAJG
Content-Type: application/x-amz-json-1.0
Content-Length: 465
Date: Thu, 15 Mar 2017 23:56:23 GMT

{
    "requestId": "{{0dbcded3-a9a1-4a25-b419-828c46342e47}}",
    "code": "{{ReadOnlyViolationException}}",
    "detailedMessage": "{{The request is rejected because it violates some read-only restriction, such as a designation of a replica as read-only.}}"
}
```

## Erros de consulta do mecanismo de gráfico
<a name="errors-query"></a>

A tabela a seguir contém o código de erro, a mensagem e o status HTTP.

Ela também indica se é aceitável repetir a solicitação. No geral, é aceitável repetir a solicitação se ela puder ser bem-sucedida em uma nova tentativa. 


| Código de erro do serviço do Neptune | Status HTTP | Ok para tentar novamente? | Mensagem | 
| --- |--- |--- |--- |
| AccessDeniedException | 403 | Não | Falha de autenticação ou autorização. | 
| BadRequestException | 400 | Não |  solicitação não pôde ser concluída. | 
| BadRequestException | 400 | Não | O tamanho da solicitação excede o valor máximo permitido de 157286400 bytes. | 
| CancelledByUserException | 500 | Sim | O processamento da solicitação foi cancelado por um cliente autorizado. | 
| ConcurrentModificationException | 500 | Sim | Houve falha no processamento da solicitação devido a um conflito de modificação. O cliente deve repetir a solicitação. | 
| ConstraintViolationException | 400 | Sim | O mecanismo de consulta descobriu, durante a execução da solicitação, que a conclusão de alguma operação é impossível sem violar algumas restrições de integridade dos dados, como a persistência de vértices de entrada e saída ao adicionar uma borda. Essas condições são normalmente observadas se houver modificações simultâneas no gráfico, e são transitórias. O cliente deve repetir a solicitação. | 
| FailureByQueryException  | 500 | Sim | A chamada fail() fez com que o processamento da solicitação falhasse. O cliente pode repetir a solicitação presumindo que se espera que a lógica da consulta seja bem-sucedida em uma tentativa posterior. Como resultado, a opção de tentar novamente será específica da consulta. | 
| InternalFailureException | 500 | Não | O processamento da solicitação falhou. | 
| InvalidNumericDataException | 400 | Não | Uso inválido de dados numéricos que não podem ser representados no tamanho de armazenamento de 64 bits. | 
| InvalidParameterException | 400 | Não | Um out-of-range valor OR inválido foi fornecido para algum parâmetro de entrada ou sintaxe inválida em um arquivo RDF fornecido. | 
| MalformedQueryException | 400 | Não | A solicitação foi rejeitada porque ela contém uma consulta que está sintaticamente incorreta ou não envia validação adicional. | 
| MemoryLimitExceededException | 500 | Sim | O processamento da solicitação não foi bem-sucedido devido à falta de memória, mas pode ser repetido quando o servidor estiver menos ocupado. | 
| MethodNotAllowedException | 405 | Não | A solicitação foi rejeitada pois o método HTTP escolhido não é compatível com o endpoint usado. | 
| MissingParameterException | 400 | Não | Um parâmetro obrigatório para a ação especificada não foi fornecido. | 
| QueryLimitExceededException | 500 | Sim | Houve falha no processamento da solicitação devido à falta de um recurso limitado, mas poderá ser repetido quando o servidor estiver menos ocupado. | 
| QueryLimitException | 400 | Não | O tamanho da consulta excede o limite do sistema. | 
| QueryTooLargeException | 400 | Não | A solicitação foi rejeitada pois seu corpo é muito grande. | 
| ReadOnlyViolationException | 400 | Não | A solicitação foi rejeitada porque viola alguma restrição de somente leitura, como uma designação de uma réplica como somente leitura. | 
| ThrottlingException | 500 | Sim | A taxa de solicitações excede a taxa de transferência máxima. OK para tentar novamente. | 
| TimeLimitExceededException | 500 | Talvez | O processamento da solicitação expirou. | 
| TooManyRequestsException | 429 | Sim | A taxa de solicitações excede a taxa de transferência máxima. OK para tentar novamente. | 
| UnsupportedOperationException | 400 | Não | A solicitação usa um recurso ou construção incompatível no momento. | 

**Importante**  
A repetição ou não de um erro geralmente envolve nuances importantes relacionadas à natureza da falha, à carga de trabalho e aos padrões de erro observados. Para obter orientação detalhada sobre o desenvolvimento de uma estratégia prática de repetição, consulte[Tratamento de exceções e novas tentativas](transactions-exceptions.md).

## Erros de autenticação do IAM
<a name="errors-iam-auth"></a>

Esses erros são específicos de cluster que possui autenticação do IAM habilitada.

A tabela a seguir contém o código de erro, a mensagem e o status HTTP.


| Código de erro do serviço do Neptune | Status HTTP | Mensagem | 
| --- |--- |--- |
| Política/usuário do IAM incorreta | 403 | Você não tem acesso suficiente para executar esta ação. | 
| Região incorreta ou ausente | 403 | A credencial deve ter como escopo uma região válida, não ''. {{region}} | 
| Nome do serviço incorreto ou ausente | 403 | A credencial deve ter como escopo para serviço correto: 'neptune-db". | 
| Assinatura inválida/cabeçalho de host incorreto ou ausente | 403 | A assinatura da solicitação que calculamos não corresponde à assinatura que você forneceu. Verifique sua chave de acesso AWS secreta e o método de assinatura. Consulte a documentação do serviço para obter mais detalhes. Cabeçalho de host está ausente ou o nome do host está incorreto. | 
| X-Amz-Security-Token ausente | 403 | 'x-amz-security-token' é chamado de SignedHeader, mas não existe na solicitação HTTP | 
| Cabeçalho de autorização ausente | 403 | A solicitação não incluía o cabeçalho de autorização necessário ou estava mal formada. | 
| Token de autenticação ausente | 403 | Token de autenticação ausente. | 
| Data Antiga | 403 | Assinatura expirada: agora {{20181011T213907Z}} é anterior a {{20181011T213915Z}} ({{20181011T214415Z}}-{{5 min}}.) | 
| Data Futura | 403 | Assinatura ainda não atualizada: ainda {{20500224T213559Z}} é posterior a {{20181108T225925Z}} ({{20181108T225425Z}}\+{{5 min}}.) | 
| Formato da data incorreto | 403 | A data deve ser em 'formato básico' ISO-8601. Tenho '{{date}}'. Consulte [https://en.wikipedia.org/wiki/ISO_8601](https://en.wikipedia.org/wiki/ISO_8601). | 
| Token da sessão ou chave de acesso ausente/desconhecido | 403 | O token de segurança incluído na solicitação é inválido.  | 
| Chave secreta desconhecida/ausente | 403 | A assinatura da solicitação que calculamos não corresponde à assinatura que você forneceu. Verifique sua chave de acesso AWS secreta e o método de assinatura. Consulte a documentação do serviço para obter mais detalhes. Cabeçalho de host está ausente ou o nome do host está incorreto. | 
| TooManyRequestsException | 429 | A taxa de solicitações excede a taxa de transferência máxima. OK para tentar novamente. | 