Deletes a secret and all of its versions. You can specify a recovery window during which you can restore the secret. The minimum recovery window is 7 days. The default recovery window is 30 days. Secrets Manager attaches a DeletionDate
stamp to the secret that specifies the end of the recovery window. At the end of the recovery window, Secrets Manager deletes the secret permanently.
See https://www.paws-r-sdk.com/docs/secretsmanager_delete_secret/ for full documentation.
secretsmanager_delete_secret(
SecretId,
RecoveryWindowInDays = NULL,
ForceDeleteWithoutRecovery = NULL
)
[required] The ARN or name of the secret to delete.
For an ARN, we recommend that you specify a complete ARN rather than a partial ARN. See Finding a secret from a partial ARN.
The number of days from 7 to 30 that Secrets Manager waits before
permanently deleting the secret. You can't use both this parameter and
ForceDeleteWithoutRecovery
in the same call. If you don't use either,
then by default Secrets Manager uses a 30 day recovery window.
Specifies whether to delete the secret without any recovery window. You
can't use both this parameter and RecoveryWindowInDays
in the same
call. If you don't use either, then by default Secrets Manager uses a 30
day recovery window.
Secrets Manager performs the actual deletion with an asynchronous background process, so there might be a short delay before the secret is permanently deleted. If you delete a secret and then immediately create a secret with the same name, use appropriate back off and retry logic.
If you forcibly delete an already deleted or nonexistent secret, the
operation does not return ResourceNotFoundException
.
Use this parameter with caution. This parameter causes the operation to
skip the normal recovery window before the permanent deletion that
Secrets Manager would normally impose with the RecoveryWindowInDays
parameter. If you delete a secret with the ForceDeleteWithoutRecovery
parameter, then you have no opportunity to recover the secret. You lose
the secret permanently.