Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Motore dataplane Neptune, ripristino rapido e struttura generale APIs **Operazioni del motore:** + [GetEngineStatus (azione)](#GetEngineStatus) + [ExecuteFastReset (azione)](#ExecuteFastReset) **Strutture delle operazioni del motore:** + [QueryLanguageVersion (struttura)](#QueryLanguageVersion) + [FastResetToken (struttura)](#FastResetToken) ## GetEngineStatus (azione)         Il nome AWS CLI per questa API è:. `get-engine-status` Recupera lo stato del database a grafo sull'host. Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [GetEngineStatusneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getenginestatus): IAM in quel cluster. **Richiesta** + *Nessun parametro della richiesta.* **Risposta** + **dbEngineVersion**: una stringa di tipo `string` (una stringa con codifica UTF-8). Imposta la versione del motore Neptune in esecuzione sul cluster database. Se è stata applicata una patch manualmente a questa versione del motore dopo il rilascio, il numero della versione ha il prefisso `Patch-`. + **dfeQueryEngine**: una stringa di tipo `string` (una stringa con codifica UTF-8). Da impostare su `enabled` se il motore DFE è completamente abilitato o su `viaQueryHint` (impostazione predefinita) se il motore DFE viene utilizzato solo con query per le quali il suggerimento `useDFE` è impostato su `true`. + **features**: un array di mappa con coppie chiave-valore in cui:     Ogni chiave è una stringa di tipo `string` (una stringa con codifica UTF-8).     Ogni valore è un documento di tipo `document` (un contenuto aperto indipendente dal protocollo rappresentato da un modello di dati simile a JSON). Contiene informazioni sullo stato delle funzionalità abilitate nel cluster database. + **gremlin**: un oggetto [QueryLanguageVersion](#QueryLanguageVersion). Contiene informazioni sul linguaggio di query Gremlin disponibile nel cluster. In particolare, contiene un campo di versione che specifica la versione corrente utilizzata dal motore. TinkerPop + **labMode**: un array di mappa con coppie chiave-valore in cui:     Ogni chiave è una stringa di tipo `string` (una stringa con codifica UTF-8).     Ogni valore è una stringa di tipo `string` (una stringa con codifica UTF-8). Contiene le impostazioni della modalità Lab utilizzate dal motore. + **opencypher**: un oggetto [QueryLanguageVersion](#QueryLanguageVersion). Contiene informazioni sul linguaggio di query openCypher disponibile nel cluster. In particolare, contiene un campo version che specifica la versione corrente di operCypher utilizzata dal motore. + **role**: una stringa di tipo `string` (una stringa con codifica UTF-8). Impostato su `reader` se l'istanza è una replica di lettura o su `writer` se è l'istanza principale. + **rollingBackTrxCount**: un numero intero di tipo `integer` (numero intero a 32 bit con segno). Se alcune transazioni vengono ripristinate, questo campo contiene il numero di transazioni. Se non ne esistono, il campo non viene visualizzato. + **rollingBackTrxEarliestStartTime**: una stringa di tipo `string` (una stringa con codifica UTF-8). Impostato sull'ora di inizio della transazione più recente in fase di ripristino. Se non è stato eseguito il rollback di alcuna transazione, il campo non viene visualizzato. + **settings**: un array di mappa con coppie chiave-valore in cui:     Ogni chiave è una stringa di tipo `string` (una stringa con codifica UTF-8).     Ogni valore è una stringa di tipo `string` (una stringa con codifica UTF-8). Contiene informazioni sulle impostazioni correnti sul cluster database. Ad esempio, contiene impostazione attuale per il timeout delle query del cluster (`clusterQueryTimeoutInMs`). + **sparql**: un oggetto [QueryLanguageVersion](#QueryLanguageVersion). Contiene informazioni sul linguaggio di query SPARQL disponibile nel cluster. In particolare, contiene un campo version che specifica la versione corrente di SPARQL utilizzata dal motore. + **startTime**: una stringa di tipo `string` (una stringa con codifica UTF-8). Impostato sull’ora UTC in cui è iniziato il processo del server corrente. + **status**: una stringa di tipo `string` (una stringa con codifica UTF-8). Impostato su `healthy` se l'istanza non presenta problemi. Se l'istanza è in fase di ripristino dopo un arresto anomalo o un riavvio e ci sono transazioni attive in esecuzione dall'ultimo arresto del server, lo stato è impostato su `recovery`. **Errori** + [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException) + [InternalFailureException](data-api-dp-errors.md#InternalFailureException) + [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException) + [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException) + [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException) + [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException) + [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException) + [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException) ## ExecuteFastReset (azione)         Il nome AWS CLI per questa API è:. `execute-fast-reset` La REST API di ripristino rapido consente di ripristinare un grafo Neptune in modo veloce e semplice, rimuovendo tutti i relativi dati. La procedura di ripristino rapido di Neptune prevede due fasi. Per prima cosa, occorre chiamare `ExecuteFastReset` con `action` impostato su `initiateDatabaseReset`. Viene così restituito un token UUID da includere quando si chiama di nuovo `ExecuteFastReset` con `action` impostato su `performDatabaseReset`. Consulta [Svuotamento di un cluster database Amazon Neptune utilizzando l'API di ripristino rapido](https://docs.aws.amazon.com/neptune/latest/userguide/manage-console-fast-reset.html). Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [ResetDatabaseneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#resetdatabase): IAM in quel cluster. **Richiesta** + **action** (nella CLI: `--action`): *Obbligatorio:* un'azione di tipo `string` (una stringa con codifica UTF-8). L'azione di ripristino rapido. Uno dei seguenti valori: + **`initiateDatabaseReset`**: questa azione genera un token unico necessario per eseguire effettivamente il ripristino rapido. + **`performDatabaseReset`**: questa azione utilizza il token generato dall'azione `initiateDatabaseReset` per eseguire effettivamente il ripristino rapido. + **token** (nella CLI: `--token`): una stringa di tipo `string` (una stringa con codifica UTF-8). Il token per avviare il ripristino rapido. **Risposta** + **payload**: un oggetto [FastResetToken](#FastResetToken). Il parametro `payload` viene restituito solo dall'azione `initiateDatabaseReset` e contiene il token univoco da utilizzare con l'azione `performDatabaseReset` per eseguire il ripristino. + **status**: *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8). Il parametro `status` viene restituito solo per l'azione `performDatabaseReset` e indica se la richiesta di ripristino rapido è accettata o meno. **Errori** + [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException) + [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException) + [AccessDeniedException](data-api-dp-errors.md#AccessDeniedException) + [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException) + [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException) + [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException) + [ServerShutdownException](data-api-dp-errors.md#ServerShutdownException) + [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException) + [MethodNotAllowedException](data-api-dp-errors.md#MethodNotAllowedException) + [ReadOnlyViolationException](data-api-dp-errors.md#ReadOnlyViolationException) + [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException) + [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException) + [MissingParameterException](data-api-dp-errors.md#MissingParameterException) ## *Strutture delle operazioni del motore:* ## QueryLanguageVersion (struttura) Struttura per esprimere la versione del linguaggio di query. **Campi** + **version**: *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8). La versione del linguaggio di query. ## FastResetToken (struttura) Una struttura contenente il token utilizzato per avviare un ripristino rapido. **Campi** + **token**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8). Un UUID generato dal database durante l'azione `initiateDatabaseReset` e poi utilizzato da `performDatabaseReset` per reimpostare il database.