All Products
Search
Document Center

Security Center:DeleteBackupSnapshot

Last Updated:May 22, 2025

Deletes a backup snapshot that is created for anti-ransomware.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RetainLatestSnapshotbooleanNo

Specifies whether to retain the latest snapshot. Valid values:

  • true
  • false
true
BackupSnapshotListarray<object>No

The backup snapshots.

objectNo

The information about the backup snapshot.

SnapshotIdstringYes

The ID of the snapshot that you want to delete.

Note You can call the DescribeSnapshots operation to query the ID.
s-000f9p6r5trm6u4dc1iq
ClientIdstringYes

The ID of the Cloud Backup client.

Note You can call the DescribeSnapshots operation to query the ID.
c-000a4h33w14ka8xagb2s
VaultIdstringYes

The ID of the backup vault that is used in the restoration task.

Note You can call the DescribeSnapshots operation to query the ID.
v-0004vhwcs2pmacfzrzt5
SourceTypestringYes

The type of the data source. Valid values:

  • ECS_FILE: Elastic Compute Service (ECS) files.
  • OSS: Object Storage Service (OSS) buckets.
  • NAS: File Storage NAS (NAS) file systems.
  • OTS_TABLE: Tablestore instances.
ECS_FILE
InstanceIdstringYes

The ID of the server.

i-j6cj8vyajp1fo4atxkae
RegionIdstringYes

The region in which Security Center is deployed. Valid values:

  • cn-hangzhou: China (Hangzhou).
  • ap-southeast-1: Singapore.
  • cn-beijing: China (Beijing).
cn-beijing
BackupRegionIdListarrayNo

The regions for backup.

stringNo

The region.

cn-hangzhou

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

7BC55C8F-226E-5AF5-9A2C-2EC43864****

Examples

Sample success responses

JSONformat

{
  "RequestId": "7BC55C8F-226E-5AF5-9A2C-2EC43864****"
}

Error codes

HTTP status codeError codeError messageDescription
400CannotDeleteLatestSnapshotCan not delete latest snapshot.Can not delete latest snapshot.
403NoPermissioncaller has no permissionYou are not authorized to do this operation.
500ServerErrorServerError-

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-09-25The Error code has changedView Change Details