Welcome to Tencent Cloud Cloud Block Storage (CBS).
CBS is a highly available, highly reliable, low-cost, customizable network block storage device. For more information, see CBS Product Overview.
You can use the APIs described in this documentation to perform cloud disk and snapshot actions, such as creating an elastic cloud disk, creating a snapshot, or rolling back a snapshot. For a complete list of actions, see API Overview.
All CBS APIs in this section have been upgraded to API 3.0. Future CBSfeatures will also be added here. We recommend using API 3.0.
Legacy APIs remain available, but will not be updated. For more information, please see CBS API Overview (legacy).
The following table introduces some commonly used terms in CBS to quickly familiarize you with the cloud disk and snapshot services.
|CBS||Cloud Block Storage||Distributed block storage independently developed by Tencent Cloud. CBS includes cloud disks purchased with CVMs and elastic cloud disks purchased separately. For more information, see CBS Product Overview.|
|Elastic Cloud Disk||Elastic Cloud Disk||A cloud disk that was purchased separately from the CVM and has an independent billing cycle. It can be mounted and unmounted to different CVMs. It cannot be simultaneously mounted to multiple CVMs.|
|Snapshot||Cloud Disk Snapshot||Used to save a copy of a cloud disk at a specific point in time. You can use the snapshot to restore the cloud disk to the point in time when the snapshot was created.|
These parameters are used for pagination control.
Limitindicates the maximum number of entries returned at a time, and
Offsetindicates the offset value. If the number of results exceeds the value of
Limit, the number of returned results will be equal to the value of
For example, if
Offsetis set to 0 and
Limitis set to 20, the 0th to 19th entries are returned; if
Offsetis set to 20 and
Limitis set to 20, the 20th to 39th entries are returned; if
Offsetis set to 40 and
Limitis set to 20, the 40th to 59th entries are returned.
Format for inputting multiple parameters at a time. If a parameter is in such a format, you can specify multiple values for the parameter. For example:
Nstarts from 0.
The following steps describes how to use an elastic cloud disk via API:
The following steps describes how to use cloud disk snapshots via APIs:
See CBS Use Limits for cloud disks and snapshots use limits. For limits on specific parameters, see the descriptions of output parameters in related API documents.