CbsClient (tencentcloud-sdk-java 3.0.10 API)

java.lang.Object
- com.tencentcloudapi.common.AbstractClient
- - com.tencentcloudapi.cbs.v20170312.CbsClient

public class CbsClient
extends AbstractClient

字段概要
- 从类继承的字段 com.tencentcloudapi.common.AbstractClient
  gson, HTTP_RSP_OK, SDK_VERSION

构造器概要

构造器
构造器和说明
`CbsClient(Credential credential, String region)` 构造client
`CbsClient(Credential credential, String region, ClientProfile profile)` 构造client

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`ApplySnapshotResponse`	`ApplySnapshot(ApplySnapshotRequest req)` 本接口（ApplySnapshot）用于回滚快照到原云硬盘。
`AttachDisksResponse`	`AttachDisks(AttachDisksRequest req)` 本接口（AttachDisks）用于挂载云硬盘。
`CreateDisksResponse`	`CreateDisks(CreateDisksRequest req)` 本接口（CreateDisks）用于创建云硬盘。
`CreateSnapshotResponse`	`CreateSnapshot(CreateSnapshotRequest req)` 本接口（CreateSnapshot）用于对指定云盘创建快照。
`DeleteSnapshotsResponse`	`DeleteSnapshots(DeleteSnapshotsRequest req)` 本接口（DeleteSnapshots）用于删除快照。
`DescribeDiskConfigQuotaResponse`	`DescribeDiskConfigQuota(DescribeDiskConfigQuotaRequest req)` 本接口（DescribeDiskConfigQuota）用于查询云硬盘配额。
`DescribeDisksResponse`	`DescribeDisks(DescribeDisksRequest req)` 本接口（DescribeDisks）用于查询云硬盘列表。
`DescribeInstancesDiskNumResponse`	`DescribeInstancesDiskNum(DescribeInstancesDiskNumRequest req)` 本接口（DescribeInstancesDiskNum）用于查询实例已挂载云硬盘数量。
`DescribeSnapshotsResponse`	`DescribeSnapshots(DescribeSnapshotsRequest req)` 本接口（DescribeSnapshots）用于查询快照的详细信息。
`DetachDisksResponse`	`DetachDisks(DetachDisksRequest req)` 本接口（DetachDisks）用于解挂云硬盘。
`InquiryPriceCreateDisksResponse`	`InquiryPriceCreateDisks(InquiryPriceCreateDisksRequest req)` 本接口（InquiryPriceCreateDisks）用于创建云硬盘询价。
`InquiryPriceRenewDisksResponse`	`InquiryPriceRenewDisks(InquiryPriceRenewDisksRequest req)` 本接口（InquiryPriceRenewDisks）用于续费云硬盘询价。
`InquiryPriceResizeDiskResponse`	`InquiryPriceResizeDisk(InquiryPriceResizeDiskRequest req)` 本接口（InquiryPriceResizeDisk）用于扩容云硬盘询价。
`ModifyDiskAttributesResponse`	`ModifyDiskAttributes(ModifyDiskAttributesRequest req)` 本接口（ModifyDiskAttributes）用于修改云硬盘属性。
`ModifyDisksRenewFlagResponse`	`ModifyDisksRenewFlag(ModifyDisksRenewFlagRequest req)` 本接口（ModifyDisksRenewFlag）用于修改云硬盘续费标识，支持批量修改。
`ModifySnapshotAttributeResponse`	`ModifySnapshotAttribute(ModifySnapshotAttributeRequest req)` 本接口（ModifySnapshotAttribute）用于修改指定快照的属性。
`RenewDiskResponse`	`RenewDisk(RenewDiskRequest req)` 本接口（RenewDisk）用于续费云硬盘。
`ResizeDiskResponse`	`ResizeDisk(ResizeDiskRequest req)` 本接口（ResizeDisk）用于扩容云硬盘。
`TerminateDisksResponse`	`TerminateDisks(TerminateDisksRequest req)` 本接口（TerminateDisks）用于退还云硬盘。

从类继承的方法 com.tencentcloudapi.common.AbstractClient
getClientProfile, getCredential, getRegion, internalRequest, setClientProfile, setCredential, setRegion

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - CbsClient
```
public CbsClient(Credential credential,
                 String region)
```
    构造client
    
    参数:
    
    credential - 认证信息实例
    
    region - 产品地域
  - CbsClient
```
public CbsClient(Credential credential,
                 String region,
                 ClientProfile profile)
```
    构造client
    
    参数:
    
    credential - 认证信息实例
    
    region - 产品地域
    
    profile - 配置实例
- 方法详细资料
  - ApplySnapshot
```
public ApplySnapshotResponse ApplySnapshot(ApplySnapshotRequest req)
                                    throws TencentCloudSDKException
```
    本接口（ApplySnapshot）用于回滚快照到原云硬盘。仅支持回滚到原云硬盘上。对于数据盘快照，如果您需要复制快照数据到其它云硬盘上，请使用[CreateDisks](/document/product/362/16312)接口创建新的弹性云盘，将快照数据复制到新购云盘上。用于回滚的快照必须处于NORMAL状态。快照状态可以通过[DescribeSnapshots](/document/product/362/15647)接口查询，见输出参数中SnapshotState字段解释。如果是弹性云盘，则云盘必须处于未挂载状态，云硬盘挂载状态可以通过[DescribeDisks](/document/product/362/16315)接口查询，见Attached字段解释；如果是随实例一起购买的非弹性云盘，则实例必须处于关机状态，实例状态可以通过[DescribeInstancesStatus](/document/product/213/15738)接口查询。
    
    参数:
    
    req - ApplySnapshotRequest
    
    返回:
    
    ApplySnapshotResponse
    
    抛出:
    
    TencentCloudSDKException
  - AttachDisks
```
public AttachDisksResponse AttachDisks(AttachDisksRequest req)
                                throws TencentCloudSDKException
```
    本接口（AttachDisks）用于挂载云硬盘。支持批量操作，将多块云盘挂载到同一云主机。如果多个云盘存在不允许挂载的云盘，则操作不执行，以返回特定的错误码返回。本接口为异步接口，当挂载云盘的请求成功返回时，表示后台已发起挂载云盘的操作，可通过接口[DescribeDisks](/document/product/362/16315)来查询对应云盘的状态，如果云盘的状态由“ATTACHING”变为“ATTACHED”，则为挂载成功。
    
    参数:
    
    req - AttachDisksRequest
    
    返回:
    
    AttachDisksResponse
    
    抛出:
    
    TencentCloudSDKException
  - CreateDisks
```
public CreateDisksResponse CreateDisks(CreateDisksRequest req)
                                throws TencentCloudSDKException
```
    本接口（CreateDisks）用于创建云硬盘。预付费云盘的购买会预先扣除本次云盘购买所需金额，在调用本接口前请确保账户余额充足。本接口支持传入数据盘快照来创建云盘，实现将快照数据复制到新购云盘上。本接口为异步接口，当创建请求下发成功后会返回一个新建的云盘ID列表，此时云盘的创建并未立即完成。可以通过调用[DescribeDisks](/document/product/362/16315)接口根据DiskId查询对应云盘，如果能查到云盘，且状态为'UNATTACHED'或'ATTACHED'，则表示创建成功。
    
    参数:
    
    req - CreateDisksRequest
    
    返回:
    
    CreateDisksResponse
    
    抛出:
    
    TencentCloudSDKException
  - CreateSnapshot
```
public CreateSnapshotResponse CreateSnapshot(CreateSnapshotRequest req)
                                      throws TencentCloudSDKException
```
    本接口（CreateSnapshot）用于对指定云盘创建快照。只有具有快照能力的云硬盘才能创建快照。云硬盘是否具有快照能力可由[DescribeDisks](/document/product/362/16315)接口查询，见SnapshotAbility字段。可创建快照数量限制见[产品使用限制](https://cloud.tencent.com/doc/product/362/5145)。
    
    参数:
    
    req - CreateSnapshotRequest
    
    返回:
    
    CreateSnapshotResponse
    
    抛出:
    
    TencentCloudSDKException
  - DeleteSnapshots
```
public DeleteSnapshotsResponse DeleteSnapshots(DeleteSnapshotsRequest req)
                                        throws TencentCloudSDKException
```
    本接口（DeleteSnapshots）用于删除快照。快照必须处于NORMAL状态，快照状态可以通过[DescribeSnapshots](/document/product/362/15647)接口查询，见输出参数中SnapshotState字段解释。支持批量操作。如果多个快照存在无法删除的快照，则操作不执行，以返回特定的错误码返回。
    
    参数:
    
    req - DeleteSnapshotsRequest
    
    返回:
    
    DeleteSnapshotsResponse
    
    抛出:
    
    TencentCloudSDKException
  - DescribeDiskConfigQuota
```
public DescribeDiskConfigQuotaResponse DescribeDiskConfigQuota(DescribeDiskConfigQuotaRequest req)
                                                        throws TencentCloudSDKException
```
    本接口（DescribeDiskConfigQuota）用于查询云硬盘配额。
    
    参数:
    
    req - DescribeDiskConfigQuotaRequest
    
    返回:
    
    DescribeDiskConfigQuotaResponse
    
    抛出:
    
    TencentCloudSDKException
  - DescribeDisks
```
public DescribeDisksResponse DescribeDisks(DescribeDisksRequest req)
                                    throws TencentCloudSDKException
```
    本接口（DescribeDisks）用于查询云硬盘列表。可以根据云硬盘ID、云硬盘类型或者云硬盘状态等信息来查询云硬盘的详细信息，不同条件之间为与(AND)的关系，过滤信息详细请见过滤器`Filter`。如果参数为空，返回当前用户一定数量（`Limit`所指定的数量，默认为20）的云硬盘列表。
    
    参数:
    
    req - DescribeDisksRequest
    
    返回:
    
    DescribeDisksResponse
    
    抛出:
    
    TencentCloudSDKException
  - DescribeInstancesDiskNum
```
public DescribeInstancesDiskNumResponse DescribeInstancesDiskNum(DescribeInstancesDiskNumRequest req)
                                                          throws TencentCloudSDKException
```
    本接口（DescribeInstancesDiskNum）用于查询实例已挂载云硬盘数量。支持批量操作，当传入多个云服务器实例ID，返回结果会分别列出每个云服务器挂载的云硬盘数量。
    
    参数:
    
    req - DescribeInstancesDiskNumRequest
    
    返回:
    
    DescribeInstancesDiskNumResponse
    
    抛出:
    
    TencentCloudSDKException
  - DescribeSnapshots
```
public DescribeSnapshotsResponse DescribeSnapshots(DescribeSnapshotsRequest req)
                                            throws TencentCloudSDKException
```
    本接口（DescribeSnapshots）用于查询快照的详细信息。根据快照ID、创建快照的云硬盘ID、创建快照的云硬盘类型等对结果进行过滤，不同条件之间为与(AND)的关系，过滤信息详细请见过滤器`Filter`。如果参数为空，返回当前用户一定数量（`Limit`所指定的数量，默认为20）的快照列表。
    
    参数:
    
    req - DescribeSnapshotsRequest
    
    返回:
    
    DescribeSnapshotsResponse
    
    抛出:
    
    TencentCloudSDKException
  - DetachDisks
```
public DetachDisksResponse DetachDisks(DetachDisksRequest req)
                                throws TencentCloudSDKException
```
    本接口（DetachDisks）用于解挂云硬盘。支持批量操作，解挂挂载在同一主机上的多块云盘。如果多块云盘存在不允许解挂载的云盘，则操作不执行，以返回特定的错误码返回。本接口为异步接口，当请求成功返回时，云盘并未立即从主机解挂载，可通过接口[DescribeDisks](/document/product/362/16315)来查询对应云盘的状态，如果云盘的状态由“ATTACHED”变为“UNATTACHED”，则为解挂载成功。
    
    参数:
    
    req - DetachDisksRequest
    
    返回:
    
    DetachDisksResponse
    
    抛出:
    
    TencentCloudSDKException
  - InquiryPriceCreateDisks
```
public InquiryPriceCreateDisksResponse InquiryPriceCreateDisks(InquiryPriceCreateDisksRequest req)
                                                        throws TencentCloudSDKException
```
    本接口（InquiryPriceCreateDisks）用于创建云硬盘询价。支持查询创建多块云硬盘的价格，此时返回结果为总价格。
    
    参数:
    
    req - InquiryPriceCreateDisksRequest
    
    返回:
    
    InquiryPriceCreateDisksResponse
    
    抛出:
    
    TencentCloudSDKException
  - InquiryPriceRenewDisks
```
public InquiryPriceRenewDisksResponse InquiryPriceRenewDisks(InquiryPriceRenewDisksRequest req)
                                                      throws TencentCloudSDKException
```
    本接口（InquiryPriceRenewDisks）用于续费云硬盘询价。只支持查询预付费模式的弹性云盘续费价格。支持与挂载实例一起续费的场景，需要在[DiskChargePrepaid](/document/product/362/15669#DiskChargePrepaid)参数中指定CurInstanceDeadline，此时会按对齐到实例续费后的到期时间来续费询价。支持为多块云盘指定不同的续费时长，此时返回的价格为多块云盘续费的总价格。
    
    参数:
    
    req - InquiryPriceRenewDisksRequest
    
    返回:
    
    InquiryPriceRenewDisksResponse
    
    抛出:
    
    TencentCloudSDKException
  - InquiryPriceResizeDisk
```
public InquiryPriceResizeDiskResponse InquiryPriceResizeDisk(InquiryPriceResizeDiskRequest req)
                                                      throws TencentCloudSDKException
```
    本接口（InquiryPriceResizeDisk）用于扩容云硬盘询价。只支持预付费模式的云硬盘扩容询价。
    
    参数:
    
    req - InquiryPriceResizeDiskRequest
    
    返回:
    
    InquiryPriceResizeDiskResponse
    
    抛出:
    
    TencentCloudSDKException
  - ModifyDiskAttributes
```
public ModifyDiskAttributesResponse ModifyDiskAttributes(ModifyDiskAttributesRequest req)
                                                  throws TencentCloudSDKException
```
    本接口（ModifyDiskAttributes）用于修改云硬盘属性。只支持修改弹性云盘的项目ID。随云主机创建的云硬盘项目ID与云主机联动。可以通过[DescribeDisks](/document/product/362/16315)接口查询，见输出参数中Portable字段解释。 “云硬盘名称”仅为方便用户自己管理之用，腾讯云并不以此名称作为提交工单或是进行云盘管理操作的依据。支持批量操作，如果传入多个云盘ID，则所有云盘修改为同一属性。如果存在不允许操作的云盘，则操作不执行，以特定错误码返回。
    
    参数:
    
    req - ModifyDiskAttributesRequest
    
    返回:
    
    ModifyDiskAttributesResponse
    
    抛出:
    
    TencentCloudSDKException
  - ModifyDisksRenewFlag
```
public ModifyDisksRenewFlagResponse ModifyDisksRenewFlag(ModifyDisksRenewFlagRequest req)
                                                  throws TencentCloudSDKException
```
    本接口（ModifyDisksRenewFlag）用于修改云硬盘续费标识，支持批量修改。
    
    参数:
    
    req - ModifyDisksRenewFlagRequest
    
    返回:
    
    ModifyDisksRenewFlagResponse
    
    抛出:
    
    TencentCloudSDKException
  - ModifySnapshotAttribute
```
public ModifySnapshotAttributeResponse ModifySnapshotAttribute(ModifySnapshotAttributeRequest req)
                                                        throws TencentCloudSDKException
```
    本接口（ModifySnapshotAttribute）用于修改指定快照的属性。当前仅支持修改快照名称及将非永久快照修改为永久快照。 “快照名称”仅为方便用户自己管理之用，腾讯云并不以此名称作为提交工单或是进行快照管理操作的依据。
    
    参数:
    
    req - ModifySnapshotAttributeRequest
    
    返回:
    
    ModifySnapshotAttributeResponse
    
    抛出:
    
    TencentCloudSDKException
  - RenewDisk
```
public RenewDiskResponse RenewDisk(RenewDiskRequest req)
                            throws TencentCloudSDKException
```
    本接口（RenewDisk）用于续费云硬盘。只支持预付费的云硬盘。云硬盘类型可以通过[DescribeDisks](/document/product/362/16315)接口查询，见输出参数中DiskChargeType字段解释。支持与挂载实例一起续费的场景，需要在[DiskChargePrepaid](/document/product/362/15669#DiskChargePrepaid)参数中指定CurInstanceDeadline，此时会按对齐到子机续费后的到期时间来续费。续费时请确保账户余额充足。可通过[DescribeAccountBalance](/document/product/378/4397)接口查询账户余额。
    
    参数:
    
    req - RenewDiskRequest
    
    返回:
    
    RenewDiskResponse
    
    抛出:
    
    TencentCloudSDKException
  - ResizeDisk
```
public ResizeDiskResponse ResizeDisk(ResizeDiskRequest req)
                              throws TencentCloudSDKException
```
    本接口（ResizeDisk）用于扩容云硬盘。只支持扩容弹性云盘。云硬盘类型可以通过[DescribeDisks](/document/product/362/16315)接口查询，见输出参数中Portable字段解释。随云主机创建的云硬盘需通过[ResizeInstanceDisks](/document/product/213/15731)接口扩容。本接口为异步接口，接口成功返回时，云盘并未立即扩容到指定大小，可通过接口[DescribeDisks](/document/product/362/16315)来查询对应云盘的状态，如果云盘的状态为“EXPANDING”，表示正在扩容中，当状态变为“UNATTACHED”，表示扩容完成。
    
    参数:
    
    req - ResizeDiskRequest
    
    返回:
    
    ResizeDiskResponse
    
    抛出:
    
    TencentCloudSDKException
  - TerminateDisks
```
public TerminateDisksResponse TerminateDisks(TerminateDisksRequest req)
                                      throws TencentCloudSDKException
```
    本接口（TerminateDisks）用于退还云硬盘。不再使用的云盘，可通过本接口主动退还。本接口支持退还预付费云盘和按小时后付费云盘。按小时后付费云盘可直接退还，预付费云盘需符合退还规则。支持批量操作，每次请求批量云硬盘的上限为50。如果批量云盘存在不允许操作的，请求会以特定错误码返回。
    
    参数:
    
    req - TerminateDisksRequest
    
    返回:
    
    TerminateDisksResponse
    
    抛出:
    
    TencentCloudSDKException

类 CbsClient

字段概要

从类继承的字段 com.tencentcloudapi.common.AbstractClient

构造器概要

方法概要

从类继承的方法 com.tencentcloudapi.common.AbstractClient

从类继承的方法 java.lang.Object

构造器详细资料

CbsClient

CbsClient

方法详细资料

ApplySnapshot

AttachDisks

CreateDisks

CreateSnapshot

DeleteSnapshots

DescribeDiskConfigQuota

DescribeDisks

DescribeInstancesDiskNum

DescribeSnapshots

DetachDisks

InquiryPriceCreateDisks

InquiryPriceRenewDisks

InquiryPriceResizeDisk

ModifyDiskAttributes

ModifyDisksRenewFlag

ModifySnapshotAttribute

RenewDisk

ResizeDisk

TerminateDisks