Esvaziar um cluster de banco de dados do Amazon Neptune usando a API de redefinição rápida

Primeiro, você gera um token que pode ser usado para realizar a redefinição do banco de dados. Essa etapa tem como objetivo ajudar a impedir que redefinam acidentalmente um banco de dados.

Você faz isso enviando uma solicitação HTTP POST ao endpoint /system na instância de gravador do cluster de banco de dados para especificar a ação initiateDatabaseReset.

O comando curl usando o tipo de conteúdo JSON seria:

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

Ou, usando o tipo de conteúdo 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 '

A solicitação initiateDatabaseReset exibe o token de redefinição na resposta JSON, da seguinte forma:

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

O token permanece válido por uma hora (sessenta minutos) após a emissão.

Se você enviar a solicitação a uma instância de leitor ou ao endpoint de status, o Neptune lançará um ReadOnlyViolationException.

Se você enviar várias solicitações initiateDatabaseReset, somente o token mais recente gerado será válido para a segunda etapa, na qual você realmente executará a redefinição.

Se o servidor for reiniciado logo após a solicitação initiateDatabaseReset, o token gerado se tornará inválido e você precisará enviar uma nova solicitação para obter um novo token.

Depois, você envia uma solicitação performDatabaseReset com o token recebido de volta de initiateDatabaseReset ao endpoint /system na instância de gravador do cluster de banco de dados. Isso exclui todos os dados do cluster de banco de dados.

O comando curl usando o tipo de conteúdo JSON é:

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

Ou, usando o tipo de conteúdo 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'

A solicitação gera uma resposta JSON. Se a solicitação for aceita, a resposta será:

{
  "status" : "200 OK"
}

Se o token que você enviou não corresponder ao que foi emitido, a resposta será a seguinte:

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

Se a solicitação for aceita e a redefinição começar, o servidor será reiniciado e excluirá os dados. Você não pode enviar nenhuma outra solicitação ao cluster de banco de dados enquanto ele está sendo redefinido.

Defina as variáveis de ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY corretamente (e também AWS_SECURITY_TOKEN se você estiver usando uma credencial temporária).

Uma solicitação initiateDatabaseReset tem a seguinte aparência:

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

Uma solicitação performDatabaseReset tem a seguinte aparência:

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