Vider un cluster de bases de données Amazon Neptune à l'aide de l'API de réinitialisation rapide

Tout d'abord, générez un jeton que vous pourrez ensuite utiliser pour réinitialiser la base de données. Cette étape vise à empêcher quiconque de réinitialiser accidentellement une base de données.

Pour ce faire, envoyez une demande HTTP POST au point de terminaison /system de l'instance d'enregistreur du cluster de bases de données afin de spécifier l'action initiateDatabaseReset.

Voici la commande curl qui utilise le type de contenu JSON :

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

Ou celle qui utilise le type de contenu 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 demande initiateDatabaseReset renvoie le jeton de réinitialisation dans sa réponse JSON, comme suit :

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

Le jeton reste valide pendant une heure (60 minutes) après son émission.

Si vous envoyez la demande à une instance de lecteur ou au point de terminaison de statut, Neptune génère une exception ReadOnlyViolationException.

Si vous envoyez plusieurs demandes initiateDatabaseReset, seul le dernier jeton généré est valide pour la deuxième étape, étape au cours de laquelle vous effectuez réellement la réinitialisation.

Si le serveur redémarre juste après la demande initiateDatabaseReset, le jeton généré n'est plus valide, et vous devez envoyer une nouvelle demande pour obtenir un nouveau jeton.

Ensuite, envoyez une demande performDatabaseReset avec le jeton que vous avez obtenu via initiateDatabaseReset au point de terminaison /system de l'instance d'enregistreur du cluster de bases de données. Cette action supprime toutes les données du cluster de bases de données.

Voici la commande curl qui utilise le type de contenu JSON :

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

Ou celle qui utilise le type de contenu 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 demande renvoie une réponse JSON. Si la demande est acceptée, la réponse est la suivante :

{
  "status" : "200 OK"
}

Si le jeton que vous avez envoyé ne correspond pas à celui qui a été émis, la réponse est la suivante :

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

Si la demande est acceptée et que la réinitialisation commence, le serveur redémarre et supprime les données. Vous ne pouvez pas envoyer d'autres demandes au cluster de bases de données pendant sa réinitialisation.

Définissez correctement les variables d'environnement AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY (ainsi qu'AWS_SECURITY_TOKEN si vous utilisez des informations d'identification temporaires).

Une demande initiateDatabaseReset se présente comme suit :

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

Une demande performDatabaseReset se présente comme suit :

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