tencent cloud

Feedback

CreateSnapshot

Last updated: 2022-01-19 10:54:33

1. API Description

Domain name for API request: cbs.tencentcloudapi.com.

This API (CreateSnapshot) is used to create a snapshot of a specified cloud disk.

  • Snapshots can only be created for cloud disks with the snapshot capability. To check whether a cloud disk has the snapshot capability, see the SnapshotAbility field returned by the API DescribeDisks.
  • For the number of snapshots that can be created, please see Product Usage Restriction.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
This document describes the parameters for Signature V1. It's recommended to use the V3 signature, which provides higher security. Note that for Signature V3, the common parameters need to be placed in the HTTP Header. See details.

Parameter Name Required Type Description
Action Yes String Common parameter. The value used for this API: CreateSnapshot.
Version Yes String Common parameter. The value used for this API: 2017-03-12.
Region Yes String Common parameter. For more information, please see the list of regions supported by the product.
DiskId Yes String ID of the cloud disk, for which a snapshot needs to be created. It can be queried via the API DescribeDisks.
SnapshotName No String Snapshot name. If it is left empty, the new snapshot name is "Not named" by default.
Deadline No Timestamp ISO8601 Expiration time of the snapshot. It must be in UTC ISO-8601 format, eg. 2022-01-08T09:47:55+00:00. The snapshot will be automatically deleted when it expires

3. Output Parameters

Parameter Name Type Description
SnapshotId String ID of the new snapshot.
RequestId String The unique request ID, which is returned for each request. RequestId is required for locating a problem.

4. Example

Example1 Creating a snapshot

Input Example

https://cbs.tencentcloudapi.com/?Action=CreateSnapshot
&DiskId=disk-lzrg2pwi
&SnapshotName=snap_201711301015
&Deadline=2022-01-08T09:47:55+00:00
&<Common request parameters>

Output Example

{
  "Response": {
    "SnapshotId": "snap-gybrif0z",
    "RequestId": "1bd35eca-0c9a-6e0b-938a-5a1f80511c19"
  }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
InsufficientSnapshotQuota Insufficient snapshot quota.
InternalError.ComponentError Dependent component request failed. Please contact customer service.
InternalError.ResourceOpFailed The operation performed on the resource failed. For error message, see the "Message" field in error description. Try again later or contact customer service.
InvalidAccount.InsufficientBalance Insufficient account balance
InvalidDisk.Busy The cloud disk is busy. Try again later.
InvalidDisk.NotSupportSnapshot The cloud disk does not have the snapshot capability.
InvalidDisk.NotSupported Indicates that the operation is not supported for the cloud disk.
InvalidDisk.SnapshotCreating A snapshot is being created for the cloud disk. Try again later.
InvalidDisk.TypeError Invalid cloud disk type.
InvalidDiskId.NotFound The ‘DiskId’ entered does not exist.
LimitExceeded.InstanceAttachedDisk Number of instances mounted to cloud disk exceeds the limit.
MissingParameter Missing parameter.
ResourceBusy The resource is busy. Try again later.
ResourceInUse Occupied resource.
ResourceInUse.DiskRollbacking The cloud disk is being rolled back. Please try again later.
ResourceInsufficient.OverQuota Quota insufficient.
ResourceNotFound.NotFound The resource is not found.
ResourceUnavailable.NotSupported The resource does not support this operation.
ResourceUnavailable.SnapshotCreating Unable to use: the snapshot is being created
ResourceUnavailable.TooManyCreatingSnapshot Too many snapshots created on entire network.
UnsupportedOperation.DiskEncrypt Disk is encrypted.
Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support