Welcome to Tencent Cloud Block Storage (CBS).
CBS is a highly available, reliable, economical, and customizable network block storage service. For more information, see Overview.
You can use the APIs in this document to perform various operations on cloud disks and snapshots, such as creating elastic cloud disks, creating snapshots, and rolling back snapshots. For supported operations, see API Overview.
You need to fully understand the concepts in Overview, Creating Cloud Disk, and Price Overview before using these APIs.
To quickly familiarize you with cloud disk and snapshot services, some common terms are explained in the following table:
|CBS||Cloud Block Storage (CBS) is Tencent Cloud's proprietary distributed block storage service, including cloud disks purchased along with CVM instances and elastic cloud disks purchased separately. For more information, see Overview.|
|Elastic cloud disk||An elastic cloud disk is purchased separately rather than along with a CVM instance. It has an independent (billing) lifecycle and can be freely mounted and unmounted across CVM instances. It cannot be mounted to multiple CVM instances at the same time though.|
|Snapshot||A snapshot saves a copy of the data in a cloud disk at a certain time. You can use it to restore the cloud disk to the time point.|
These parameters are used for paging control.
Limitindicates the maximum number of entries returned at a time, and
Offsetis the offset value. If the number of results exceeds the
Limit, the number of returned results equals to the value of
For example, if Offset=0&Limit=20, the 0th to 20th entries are returned; if Offset=20&Limit=20, the 20th to 40th entries are returned; if Offset=40&Limit=20, the 40th to 60th entries are returned, and so on.
Format for inputting multiple parameters at a time. The format below indicates that multiple parameters can be input at the same time:
and so on (starting from the subscript 0).
To use an elastic cloud disk through APIs, you need to complete the following three steps:
To use a cloud disk snapshot through APIs, you need to complete the following two steps:
For the limits of cloud disks and snapshots, see Use Limits. For specific parameter restrictions, see the descriptions of output parameters in the API documentation.