tencent cloud



最后更新时间:2022-08-31 15:03:58

    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:

    Term Description
    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.

    Request and response parameters

    • Limit and Offset

      These parameters are used for paging control. Limit indicates the maximum number of entries returned at a time, and Offset is the offset value. If the number of results exceeds the Limit, the number of returned results equals to the value of Limit.

      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.

    • Ids.N

      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).

    Getting Started with APIs

    To use an elastic cloud disk through APIs, you need to complete the following three steps:

    1. Create an elastic cloud disk by using the CreateDisks API.
    2. Mount the elastic cloud disk to the specified CVM instance by using the AttachDisks API. Note: Mounting here refers to assigning the elastic cloud disk to the specified CVM instance, which is equivalent to hot-plugging a disk to the instance.
    3. Log in to the CVM instance to initialize the elastic cloud disk. When using the newly created elastic cloud disk for the first time, you need to perform a series of operations such as partitioning and formatting. For detailed directions, see Initializing Data Disk (Windows CVM) and Initializing Cloud Disk (At or Above 2 TB). Note that partitioning is not necessary on Linux, so you can directly format the disk.

    To use a cloud disk snapshot through APIs, you need to complete the following two steps:

    1. Create a snapshot for the specified cloud disk through the CreateSnapshot API.
    2. Roll back the cloud disk snapshot as needed to the specified cloud disk through the ApplySnapshot API.


    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.





    7x24 电话支持