Svuotamento di un cluster database Amazon Neptune utilizzando l'API di ripristino rapido

Genera anzitutto un token da utilizzare successivamente per eseguire il ripristino del database. Questo passaggio ha lo scopo di impedire che qualcuno ripristini accidentalmente un database.

A tale scopo, invia una richiesta HTTP POST all'endpoint /system sull'istanza di scrittura del cluster database per specificare l'azione initiateDatabaseReset.

Il comando curl che utilizza il tipo di contenuto JSON sarebbe:

curl -X POST \
  -H 'Content-Type: application/json' \
      https://your_writer_instance_endpoint:8182/system \
  -d '{ "action" : "initiateDatabaseReset" }'

Oppure, utilizzando il tipo di contenuto x-www-form-urlencoded:

curl -X POST \
  -H 'Content-Type: application/x-www-form-urlencoded' \
      https://your_writer_instance_endpoint:8182/system \
  -d 'action=initiateDatabaseReset '

La richiesta initiateDatabaseReset restituisce il token di ripristino nella sua risposta JSON, ovvero:

{
  "status" : "200 OK",
  "payload" : {
    "token" : "new_token_guid"
  }
}

Il token rimane valido per un'ora (60 minuti) dopo l'emissione.

Se invii la richiesta a un'istanza reader o all'endpoint dello stato, Neptune genererà un'eccezione ReadOnlyViolationException.

Se invii più richieste initiateDatabaseReset, solo l'ultimo token generato sarà valido per il secondo passaggio, in cui eseguirai effettivamente il ripristino.

Se il server si riavvia subito dopo la richiesta initiateDatabaseReset, il token generato non è più valido e devi inviare una nuova richiesta per ottenerne uno nuovo.

Successivamente, devi inviare una richiesta performDatabaseReset con il token ricevuto da initiateDatabaseReset all'endpoint /system sull'istanza di scrittura del cluster database. In questo modo vengono eliminati tutti i dati dal cluster database.

Il comando curl che utilizza il tipo di contenuto JSON è:

curl -X POST \
  -H 'Content-Type: application/json' \
      https://your_writer_instance_endpoint:8182/system \
  -d '{
        "action" : "performDatabaseReset",
        "token" : "token_guid"
      }'

Oppure, utilizzando il tipo di contenuto x-www-form-urlencoded:

curl -X POST \
  -H 'Content-Type: application/x-www-form-urlencoded' \
      https://your_writer_instance_endpoint:8182/system \
  -d 'action=performDatabaseReset&token=token_guid'

La richiesta restituisce una risposta JSON. Se la richiesta viene accettata, la risposta è:

{
  "status" : "200 OK"
}

Se il token che hai inviato non corrisponde a quello emesso, la risposta è simile alla seguente:

{
  "code" : "InvalidParameterException",
  "requestId":"token_guid",
  "detailedMessage" : "System command parameter 'token' : 'token_guid' does not match database reset token"
}

Se la richiesta viene accettata e il ripristino ha inizio, il server si riavvia ed elimina i dati. Non è possibile inviare altre richieste al cluster database durante il ripristino.

Imposta correttamente le variabili di ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY (e anche AWS_SECURITY_TOKEN se stai usando credenziali temporanee).

Una richiesta initiateDatabaseReset è simile a questa:

awscurl -X POST --service neptune-db "$SYSTEM_ENDPOINT" \
  -H 'Content-Type: application/json' --region us-west-2 \
  -d '{ "action" : "initiateDatabaseReset" }'

Una richiesta performDatabaseReset è simile a questa:

awscurl -X POST --service neptune-db "$SYSTEM_ENDPOINT" \
  -H 'Content-Type: application/json' --region us-west-2 \
  -d '{ "action" : "performDatabaseReset" }'