Leeren eines Amazon-Neptune-DB-Clusters über die Fast-Reset-API

Zunächst generieren Sie ein Token, mit dem Sie dann die Datenbankzurücksetzung ausführen können. Dieser Schritt soll verhindern, dass eine Datenbank versehentlich zurückgesetzt wird.

Hierzu senden Sie eine HTTP POST-Anforderung an den Endpunkt /system auf der Writer-Instance Ihres DB-Clusters, um die Aktion initiateDatabaseReset anzugeben.

Der curl-Befehl, der den JSON-Inhaltstyp verwendet, wäre:

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

Oder mit dem Inhaltstyp 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 '

Die Anforderung initiateDatabaseReset gibt das Zurücksetzungs-Token in der JSON-Antwort wie folgt zurück:

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

Das Token bleibt nach der Ausgabe eine Stunde (60 Minuten) gültig.

Wenn Sie die Anforderung an eine Reader-Instance oder an den Statusendpunkt senden, gibt Neptune eine ReadOnlyViolationException aus.

Wenn Sie mehrere initiateDatabaseReset-Anforderungen senden, ist nur das zuletzt generierte Token für den zweiten Schritt gültig, in dem Sie die Zurücksetzung tatsächlich durchführen.

Wenn der Server direkt nach Ihrer initiateDatabaseReset-Anforderung neu gestartet wird, wird das generierte Token ungültig und Sie müssen eine neue Anforderung senden, um ein neues Token zu erhalten.

Als Nächstes senden Sie eine performDatabaseReset-Anforderung mit dem Token, das Sie von initiateDatabaseReset erhalten haben, an den Endpunkt /system auf der Writer-Instance Ihres DB-Clusters. Dies löscht alle Daten aus Ihrem DB-Cluster.

Der Befehl curl, der den JSON-Inhaltstyp verwendet, wäre:

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

Oder mit dem Inhaltstyp 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'

Die Anforderung gibt eine JSON-Antwort zurück. Wenn die Anforderung akzeptiert wird, lautet die Antwort:

{
  "status" : "200 OK"
}

Wenn das von Ihnen gesendete Token nicht mit dem ausgegebenen Token übereinstimmt, sieht die Antwort wie folgt aus:

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

Wenn die Anforderung akzeptiert wird und die Zurücksetzung beginnt, startet der Server neu und löscht die Daten. Sie können während der Zurücksetzung keine weiteren Anforderungen an den DB-Cluster senden.

Legen Sie die Umgebungsvariablen AWS_ACCESS_KEY_ID und AWS_SECRET_ACCESS_KEY korrekt fest (ebenfalls AWS_SECURITY_TOKEN, wenn Sie temporäre Anmeldeinformationen verwenden).

Eine initiateDatabaseReset-Anforderung sieht wie folgt aus:

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

Eine performDatabaseReset-Anforderung sieht wie folgt aus:

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