Vaciado de un clúster de base de datos de Amazon Neptune con la API de restablecimiento rápido

En primer lugar, se genera un token que, a continuación, se puede utilizar para restablecer la base de datos. El objetivo de este paso es evitar que alguien restablezca por error una base de datos.

Para ello, debe enviar una solicitud HTTP POST al punto de conexión /system de la instancia de escritor del clúster de base de datos para especificar la acción initiateDatabaseReset.

El comando curl con el tipo de contenido JSON sería:

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

O bien, con el tipo de contenido 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 solicitud initiateDatabaseReset devuelve el token de restablecimiento en su respuesta JSON, tal y como se indica a continuación:

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

El token sigue siendo válido durante una hora (60 minutos) después de su emisión.

Si envía la solicitud a una instancia de lector o al punto de conexión de estado, Neptune lanzará una ReadOnlyViolationException.

Si envía varias solicitudes initiateDatabaseReset, solo el último token generado será válido para el segundo paso, en el que realmente realiza el restablecimiento.

Si el servidor se reinicia justo después de la solicitud initiateDatabaseReset, el token generado deja de ser válido y tendrá que enviar una nueva solicitud para obtener uno nuevo.

A continuación, envíe una solicitud performDatabaseReset con el token que ha recibido de initiateDatabaseReset a punto de conexión /system de la instancia de escritor del clúster de base de datos. De este modo, se eliminan todos los datos del clúster de base de datos.

El comando curl con el tipo de contenido JSON es:

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

O bien, con el tipo de contenido 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 solicitud devuelve una respuesta JSON. Si se acepta la solicitud, la respuesta es:

{
  "status" : "200 OK"
}

Si el token que envió no coincide con el que se emitió, la respuesta tendrá el siguiente aspecto:

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

Si se acepta la solicitud y comienza el restablecimiento, el servidor se reinicia y elimina los datos. No puede enviar ninguna otra solicitud al clúster de base de datos mientras se está restableciendo.

Configure las variables de entorno AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY correctamente (y también AWS_SECURITY_TOKEN si utiliza una credencial temporal).

Una solicitud initiateDatabaseReset tiene este aspecto:

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

Una solicitud performDatabaseReset tiene este aspecto:

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