CreateSnapshot

Description

The local snapshot feature is replaced by the instant aaccess feature. The following section describes the related parameters:

• If you have used local snapshots before December 14, 2020, you can use the Category or InstantAccess parameter. Take note of the following items:
  • The Category and InstantAccess parameters cannot be specified at the same time.
  • If neither of the Category and InstantAccess parameters is specified, normal snapshots are created.

• If you have not used local snapshots before December 14, 2020, you can use only the InstantAccess parameter, and cannot use the Category parameter.

In the following scenarios, you cannot create snapshots for a disk:

• The number of manual snapshots (also called user-created snapshots) of the disk has reached 256.
• A snapshot is being created for the disk.
• The instance to which the disk is attached has never been started.
• The instance to which the disk is attached is not in the Stopped (Stopped) or Running (Running) state.
• If the response contains {"OperationLocks": {"LockReason" : "security"}} when you query information of the instance, the instance is locked for security reasons and all operations are prohibited on the instance.

When you create a snapshot, take note of the following items:

• About 1 hour after an instance is created or the system disk of an instance is replaced, you can create a snapshot for a disk that is attached to the instance. After a data disk is attached to an instance, you must wait for a period of time before you can create a snapshot. The amount of time to wait depends on the volume of data stored on the disk.
• If a snapshot is being created, you cannot call the CreateImage operation to create a custom image from this snapshot.
• If the disk for which you want to create a snapshot is attached to an ECS instance, do not change the instance status while a snapshot is being created.
• You can create snapshots for a disk that is in the Expired (Expired) state. If the release time scheduled for a disk in the Expired state arrives when a snapshot is being created for the disk, the snapshot is in the Creating (Creating) state and is deleted when the disk is released.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=CreateSnapshot
&DiskId=d-bp1s5fnvk4gn2tws0****
&SnapshotName=testSnapshotName
&Description=testDescription
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&<Common request parameters>

Sample success responses

XML format

<CreateSnapshotResponse>
          <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
          <SnapshotId>s-bp17441ohwka0yuh****</SnapshotId>
</CreateSnapshotResponse>

JSON format

{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
    "SnapshotId": "s-bp17441ohwka0yuh****"
}

Error codes

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