使用快速重設 API 清空 Amazon Neptune 資料庫叢集

首先，您會產生一個記號，然後可以將其用來執行資料庫重設。此步驟旨在協助防止任何人意外重設資料庫。

您可以透過將 HTTP POST 請求傳送至資料庫叢集的寫入器執行個體上的 /system 端點，來指定 initiateDatabaseReset 動作以執行此操作。

使用 JSON 內容類型的 curl 命令是：

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

或者，使用 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 '

initiateDatabaseReset 請求會在其 JSON 回應中傳回重設記號，如下所示：

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

記號在發出後，有效期為一小時 (60 分鐘)。

如果您將請求傳送到讀取器執行個體或狀態端點，Neptune 將擲回 ReadOnlyViolationException。

如果您傳送多個 initiateDatabaseReset 請求，則只有最新產生的記號對第二個步驟有效，而您實際上在這個步驟中執行重設。

如果伺服器在您的 initiateDatabaseReset 請求之後立即重新啟動，則產生的記號將變成無效，並且您需要傳送新請求以取得新記號。

接下來，您會將 performDatabaseReset 請求與您從 initiateDatabaseReset 取回的記號一起傳送至資料庫叢集的寫入器執行個體上的 /system 端點。這會從資料庫叢集中刪除所有資料。

使用 JSON 內容類型的 curl 命令是：

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

或者，使用 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'

請求會傳回 JSON 回應。如果接受請求，則回應是：

{
  "status" : "200 OK"
}

如果您傳送的記號與發出的記號不符，則回應如下所示：

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

如果接受請求且開始重設，則伺服器會重新啟動並刪除資料。重設時，您無法將任何其他請求傳送至資料庫叢集。

正確設定 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY 環境變數 (如果您使用的是臨時憑證，也會設定 AWS_SECURITY_TOKEN）。

initiateDatabaseReset 請求看起來像這樣：

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

performDatabaseReset 請求看起來像這樣：

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