Codici e messaggi di errore del motore basato su grafi

Gli endpoint di Amazon Neptune restituiscono gli errori standard per Gremlin e SPARQL quando si verificano.

Gli stessi endpoint possono anche restituire gli errori specifici per Neptune. In questa sezione vengono illustrati i messaggi di errore, i codici e le azioni consigliate per Neptune.

Nota

Questi errori sono solo per gli endpoint del cluster database Neptune. Servono APIs per creare e modificare le risorse di Neptune con AWS l'SDK AWS CLI e presentano una serie diversa di errori comuni. Per informazioni su questo tipo di errori, vedi Codici e messaggi di errore dell'API di gestione del cluster di database.

Formato errore del motore del grafo

I messaggi di errore di Neptune restituiscono un codice di errore HTTP pertinente e una risposta in 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."
}

Errori di query del motore del grafo

La tabella riportata di seguito contiene il codice di errore, il messaggio e lo stato HTTP.

Indica inoltre se è possibile riprovare a eseguire la richiesta. Generalmente, è possibile inviare una nuova richiesta se un nuovo tentativo può avere un esito positivo.

Codice di errore del servizio di Neptune	Stato HTTP	Va bene riprovare?	Messaggio
AccessDeniedException	403	No	Errore di autenticazione o autorizzazione.
BadRequestException	400	No	Non è stato possibile completare la richiesta.
BadRequestException	400	No	La dimensione della richiesta supera il valore massimo consentito di 157286400 byte.
CancelledByUserException	500	Sì	L'elaborazione della richiesta è stata annullata da un client autorizzato.
ConcurrentModificationException	500	Sì	La richiesta di elaborazione non è riuscita a causa di un conflitto di modifica. Il client deve ripetere la richiesta.
ConstraintViolationException	400	Sì	Durante l'esecuzione della richiesta, il motore di query ha rilevato che non è possibile completare alcune operazioni senza violare alcuni vincoli sull'integrità dei dati, ad esempio la persistenza dei vertici di input e di output durante l'aggiunta di un edge. Queste condizioni si verificano in genere se vengono apportate modifiche simultanee al grafico e sono comunque transitorie. Il client deve ripetere la richiesta.
FailureByQueryException	500	Sì	La chiamata fail () ha causato il fallimento dell'elaborazione della richiesta.
InternalFailureException	500	Sì	L'elaborazione della richiesta non è andata a buon fine.
InvalidNumericDataException	400	No	Uso non valido di dati numerici che non possono essere rappresentati nella dimensione di archiviazione a 64 bit.
InvalidParameterException	400	No	È stato fornito un out-of-range valore or non valido per alcuni parametri di input o una sintassi non valida in un file RDF fornito.
MalformedQueryException	400	No	La richiesta è stata respinta perché contiene una query sintatticamente errata oppure perché non supera la convalida aggiuntiva.
MemoryLimitExceededException	500	Sì	L'elaborazione della richiesta non è andata a buon fine a causa della mancanza di memoria, tuttavia si potrà riprovare quando il server sarà meno occupato.
MethodNotAllowedException	405	No	La richiesta è stata respinta perché il metodo HTTP scelto non è supportato dall'endpoint utilizzato.
MissingParameterException	400	No	Un parametro richiesto per l'operazione specificata non è stato fornito.
QueryLimitExceededException	500	Sì	L'elaborazione della richiesta non è andata a buon fine a causa della mancanza di una risorsa limitata, tuttavia si potrà riprovare quando il server sarà meno occupato.
QueryLimitException	400	No	Le dimensioni della query superano il limite di sistema.
QueryTooLargeException	400	No	La richiesta è stata respinta perché il testo è troppo lungo.
ReadOnlyViolationException	400	No	La richiesta è stata respinta perché in violazione di alcune limitazioni di sola lettura, ad esempio la designazione di una replica in modalità di sola lettura.
ThrottlingException	500	Sì	La velocità delle richieste supera il throughput massimo consentito. OK riprovare.
TimeLimitExceededException	500	Sì	L'elaborazione della richiesta è scaduta.
TooManyRequestsException	429	Sì	La frequenza delle richieste supera il throughput massimo. OK riprovare.
UnsupportedOperationException	400	No	La richiesta utilizza una caratteristica o una configurazione attualmente non supportata.

Errori di autenticazione IAM

Questi errori sono specifici del cluster con l'autenticazione IAM abilitata.

La tabella riportata di seguito contiene il codice di errore, il messaggio e lo stato HTTP.

Codice di errore del servizio di Neptune	Stato HTTP	Messaggio
Policy/Utente IAM non corretto	403	Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
Regione errata o mancante	403	La credenziale deve appartenere a una regione valida, non a ''. region
Nome del servizio errato o mancante	403	Le credenziali devono essere definite per il servizio corretto: "neptune-db".
Intestazione host errata o mancante / Firma non valida	403	La firma di richiesta che abbiamo calcolato non corrisponde alla firma che hai fornito. Controlla la tua chiave di accesso AWS segreta e il metodo di firma. Per informazioni dettagliate, consulta la documentazione del servizio. L'intestazione host è mancante o il nome host non è corretto.
X-Amz-Security-Token mancante	403	“x-amz-security-token” è designato come SignedHeader, ma non è presente nella richiesta HTTP
Intestazione autorizzazione mancante	403	La richiesta non include l'intestazione di autorizzazione richiesta o il formato non è corretto.
Token di autenticazione mancante	403	Token di autenticazione mancante.
Data precedente	403	Firma scaduta: ora 20181011T213907Z è precedente a 20181011T213915Z (20181011T214415Z-5 min.)
Data futura	403	Firma non ancora attuale: 20500224T213559Z è ancora successiva a 20181108T225925Z (20181108T225425Z+5 min.)
Formato della data non corretto	403	La data deve essere nel formato di base ISO 8601. Ho ricevuto 'date'. Per informazioni, consulta https://en.wikipedia.org/wiki/ISO_8601.
Chiave di accesso o token di sessione sconosciuto/mancante	403	Il token di sicurezza incluso nella richiesta non è valido.
Chiave segreta sconosciuta/mancante	403	La firma di richiesta che abbiamo calcolato non corrisponde alla firma che hai fornito. Controlla la tua chiave di accesso AWS segreta e il metodo di firma. Per informazioni dettagliate, consulta la documentazione del servizio. L'intestazione host è mancante o il nome host non è corretto.
TooManyRequestsException	429	La frequenza delle richieste supera il throughput massimo. OK riprovare.