tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Documentation

RenewDisk

Last updated: 2020-02-06 13:12:02
This document is currently invalid. Please refer to the documentation page of the product.

    1. API Description

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

    This API (RenewDisk) is used to renew a cloud disk.

    • Only prepaid (monthly subscription) cloud disks are supported. The type of the cloud disk can be queried using DescribeDisks, and is specified in the DiskChargeType output parameter.
    • You can renew a cloud disk together with the associated CVM instance. By specifying CurInstanceDeadline in DiskChargePrepaid parameter, the cloud disk will be renewed according to the expiry time of the associated CVM.

    Default request rate limit: 20/sec.

    Note: This API supports finance AZs. As finance AZs and non-finance AZs are isolated, when accessing the services in a finance AZ (with the common parameter Region specifying a financial availability zone), it is necessary to specify a domain name with the finance AZ, preferably in the same region as specified in Region.

    2. Input Parameters

    The list below contains only the API request parameters and certain common parameters. For the complete common parameter list, see Common Request Parameters.

    Parameter Name Required Type Description
    Action Yes String Common parameter. The value used for this API: RenewDisk
    Version Yes String Common parameter. The value used for this API: 2017-03-12
    Region Yes String Common parameter. For more information, see List of Regions supported by the product.
    DiskId Yes String ID of the cloud disk, which can be queried via the API DescribeDisks.

    3. Output Parameters

    Parameter Name Type Description
    RequestId String Unique ID of the request. Each request returns a unique ID. The RequestId is required to troubleshoot issues.

    4. Samples

    Sample 1. Renewing a Cloud Disk for One Month and Enabling Auto-Renewal

    Input Sample Code

    https://cbs.tencentcloudapi.com/?Action=RenewDisk
&DiskId=disk-
&DiskChargePrepaid.Period=1
&DiskChargePrepaid.RenewFlag=NOTIFY_AND_AUTO_RENEW
&<Common request parameters>

    Output Sample Code

    {
  "Response": {
    "RequestId": "6e2e5089-244a-4102-d347-5a1f8058b1db"
  }
}

    Sample 2. Renewing an instance together with the cloud disks mounted to it, making the cloud disk expiration time the same as that of the instance.

    The current expiration time of the instance is: 2018-03-30 20:15:03, which needs to be renewed for one month. You can call this API to renew the prepaid cloud disk mounted on the instance to make its expiration time the same as that of the instance and enable the auto renewal for the cloud disk.

    Input Sample Code

    https://cbs.tencentcloudapi.com/?Action=RenewDisk
&DiskId=disk-
&DiskChargePrepaid.Period=1
&DiskChargePrepaid.CurInstanceDeadline=2018-03-30 20:15:03
&DiskChargePrepaid.RenewFlag=NOTIFY_AND_AUTO_RENEW
&<Common request parameters>

    Output Sample Code

    {
  "Response": {
    "RequestId": "55db49cf-b9d7-da27-825b-5a02ba6884ca",
    "DiskPrice": {
      "DiscountPrice": 9.0,
      "OriginalPrice": 9.0
    }
  }
}

    5. Resources for Developers

    API Explorer

    This tool allows online call, signature authentication, SDK code generation and quick search of APIs to greatly improve the efficiency of using TencentCloud APIs.

    6. Error Codes

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

    Error Code Description
    InvalidDisk.Busy The cloud disk is busy. Try again later.
    InvalidDisk.NotPortable Non-elastic cloud disks are not supported.
    InvalidDiskId.NotFound The DiskId does not exist.
    InvalidParameterValue Invalid parameter value. Parameter value is in an incorrect format or is not supported.
    MissingParameter Missing parameter. A required parameter is missing in the request.
    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    Privacy PolicyLegalCookie Policy