Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1441397379.2 KB

Deletes an Amazon FSx backup. After deletion, the backup no longer exists, and its data is gone.

The DeleteBackup call returns instantly. The backup won't show up in later DescribeBackups calls.

The data in a deleted backup is also deleted and can't be recovered by any means.

post/#X-Amz-Target=AWSSimbaAPIService_v20180301.DeleteBackup

Headers

X-Amz-Target'AWSSimbaAPIService_v20180301.DeleteBackup' required

Request body

BackupIdstring required

The ID of the backup that you want to delete.

ClientRequestTokenstring

A string of up to 63 ASCII characters that Amazon FSx uses to ensure idempotent deletion. This parameter is automatically filled on your behalf when using the CLI or SDK.

Response

Success

BackupIdstring

The ID of the backup that was deleted.

Lifecycle'AVAILABLE' | 'CREATING' | 'TRANSFERRING' | 'DELETED' | 'FAILED' | 'PENDING' | 'COPYING'

The lifecycle status of the backup. If the <code>DeleteBackup</code> operation is successful, the status is <code>DELETED</code>.

Example response

{
  "BackupId": "backup-03e3c82e0183b7b6b",
  "Lifecycle": "DELETED"
}