ModifyDBInstanceChargeType--云数据库 veDB MySQL 版-火山引擎

文档中心

立即注册

导航

ModifyDBInstanceChargeType

最近更新时间：2025.06.06 10:13:01首次发布时间：2023.11.14 14:16:24

调用 ModifyDBInstanceChargeType 接口修改 veDB MySQL 实例的计费类型。

前提条件

实例目前没有待执行的配置变更事件，可在计划内事件列表通过实例 ID 搜索查看，操作步骤请参见查看事件列表。

注意事项

变更包年包月实例的存储计费类型不支持通过调用 API 操作，仅支持通过控制台操作，具体操作请参见修改存储计费类型。

请求类型

异步请求。

请求参数

名称	类型	是否必选	示例值	描述
InstanceId	String	是	vedbm-dfaa2zic****	实例 ID。批量变更实例计费类型时，多个实例 ID 之间使用英文逗号（,）分隔。说明在批量变更场景中，仅可选择计算计费类型与存储计费类型均相同的实例进行批量变更实例计费类型操作，且最多支持同时选择 50 个实例。
ChargeType	String	是	PrePaid	计算计费类型，取值： `PostPaid`（按量计费）：表示将包年包月实例变更为按量计费实例。 `PrePaid`（包年包月）：表示将按量计费实例变更为包年包月实例。
StorageChargeType	String	否	PostPaid	存储计费类型，取值： `PostPaid`：按量计费（后付费）。 `PrePaid`：包年包月（预付费）。说明当 `ChargeType` 取值为 `PostPaid` 时，该参数只能取值为 `PostPaid`。当`ChargeType` 取值为 `PrePaid`时，该参数可选择取值为 `PostPaid` 或 `PrePaid`（默认）。
PrePaidStorageGB	Integer	否	100	选择存储空间大小。实例规格不同，支持的存储空间大小不同，详情请参见产品规格。不传入该参数时，存储空间大小默认为`当前已使用空间`+`15GB`。自定义存储空间大小时，建议选择大于当前已使用的存储空间大小，若小于已使用的存储空间大小，超出的部分将按量计费。同理，在批量修改实例计费类型时，建议选择大于当前所有实例中已使用的最大存储空间，若小于已使用的最大存储空间，部分实例超出的容量将按量计费。说明当 `ChargeType` 取值为 `PrePaid` 时，参数必填。
AutoRenew	Boolean	否	false	预付费场景下是否自动续费。取值： `true`：自动续费。 `false`：不自动续费。说明当 `ChargeType` 取值为 `PrePaid` 时，参数必填。
PeriodUnit	String	否	Month	预付费场景下的购买周期。 `Month`：包月。 `Year`：包年。说明当 `ChargeType` 取值为 `PrePaid` 时，参数必填。
Period	Integer	否	1	预付费场景下的购买时长。说明当 `ChargeType` 取值为 `PrePaid` 时，参数必填。

返回参数

名称	类型	示例值	描述
InstanceId	String	vedbm-dfaa2zic****	实例 ID。
OrderNO	String	Order728156369167322****	订单 ID。

请求示例

单个实例转包年包月。

POST /?Action=ModifyDBInstanceChargeType&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: vedbm.cn-beijing.volcengineapi.com
X-Date: 20230828T084117Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkOD******/20230828/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=6a593bf5f59e7c1109fb205c739d1cff4c672fe2d251963f4d48c87******

{
    "InstanceId":"vedbm-dfaa2zic****",
    "ChargeType":"PrePaid",
    "Period":1,
    "AutoRenew":false,
    "PeriodUnit":"Month"
}

批量转包年包月。

POST /?Action=ModifyDBInstanceChargeType&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: vedbm.cn-beijing.volcengineapi.com
X-Date: 20230828T084117Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkOD******/20230828/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=6a593bf5f59e7c1109fb205c739d1cff4c672fe2d251963f4d48c87******

{
    "InstanceId":"vedbm-pzfq2zif****,vedbm-dfaa2zic****",
    "ChargeType":"PrePaid",
    "Period":1,
    "AutoRenew":false,
    "PeriodUnit":"Month"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230922162644526CE9EB684703C1F9E4",
        "Action": "ModifyDBInstanceChargeType",
        "Version": "2022-01-01",
        "Service": "vedbm",
        "Region": "cn-beijing"
    },
    "Result": {
        "InstanceId": "vedbm-dfaa2zic****",
        "OrderNO": "Order728156369167322****"
    }
}

错误码

更多详情，请参见错误码。