Creates a snapshot for a disk.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateSnapshot

The operation that you want to perform. Set the value to CreateSnapshot.

DiskId String Yes d-bp18kjxg9ebrhsgi****

The ID of the disk.

RegionId String Yes cn-hangzhou

The region ID of the simple application server to which the disk is attached.

SnapshotName String Yes test-SnapshotName

The name of the snapshot. The name must be 2 to 50 characters in length. It must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), periods (.),and hyphens (-).

ClientToken String No 123e4567-e89b-12d3-a456-426655440000

The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but make sure that it is unique among different requests. The ClientToken value can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.

Response parameters

Parameter Type Example Description
RequestId String 20758A-585D-4A41-A9B2-28DA8F4F534F

The ID of the request.

SnapshotId String s-bp16oazlsold4dks****

The ID of the snapshot.

Examples

Sample requests

https://swas.cn-hangzhou.aliyuncs.com/?Action=CreateSnapshot
&DiskId=d-bp18kjxg9ebrhsgi****
&SnapshotName=test-SnapshotName
&<Common request parameters>

Sample success responses

XML format

<CreateSnapshotResponse>
      <SnapshotId>s-bp16oazlsold4dks****</SnapshotId>
      <RequestId>20758A-585D-4A41-A9B2-28DA8F4F534F</RequestId>
</CreateSnapshotResponse>

JSON format

{
    "SnapshotId": "s-bp16oazlsold4dks****",
    "RequestId": "20758A-585D-4A41-A9B2-28DA8F4F534F"
}

Error codes

HTTP status code Error code Error message Description
400 InvalidRemark.ValueNotSupported The specified parameter Remark is invalid. The error message returned because the specified snapshot remarks are invalid.
403 SnapshotLimitExceed The maximum number of snapshots in an instance is exceeded. The error message returned because the maximum number of snapshots that can be created for the simple application server is reached.
404 InvalidDiskId.NotFound The specified DiskId does not exist. The error message returned because the specified DiskId parameter does not exist.
500 InternalError An error occurred while processing your request. The error message returned because an internal error has occurred. Try again later. If the error persists, submit a ticket.
400 InvalidRemark.Duplicate The specified Remark already exists. The error message returned because the specified snapshot remarks already exist.
400 IncorrectStatus The state of the disk or instance does not currently support snapshot creation. The error message returned because the operation is not supported while the disk or the simple application server is in the current state.
403 IncorrectDiskStatus.CreatingSnapshot A snapshot is being created in the specified disk. Please try again later. The error message returned because another snapshot is being created for the disk. Wait until the snapshot is created and try again.
400 InvalidSnapshotName.ValueNotSupported The specified SnapshotName is invalid. The error message returned because the specified SnapshotName parameter is invalid.
400 InvalidSnapshotName.Duplicate The specified SnapshotName already exists. The error message returned because the specified snapshot name already exists.

For a list of error codes, visit the API Error Center.