ModifyDBInstanceChargeType--缓存数据库 Redis 企业版-火山引擎

文档中心

立即注册

导航

ModifyDBInstanceChargeType

最近更新时间：2025.11.25 10:09:23首次发布时间：2025.11.25 10:09:23

调用 ModifyDBInstanceChargeType 接口修改目标 Redis 企业版实例的计费类型。

请求类型

异步请求。

注意事项

实例状态需为运行中（Running）。
当前仅支持将按量计费实例改为包年包月实例。
将按量计费的实例转为包年包月后，暂不支持再将包年包月实例转回按量计费。转变前请仔细考虑，避免资源浪费。更多详情，请参见转包年包月。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceIds	String[]	是	["redis-cn02he8bhzsji**","redis-cn02j292it8lc**"]	实例 ID。说明支持同时传入多个实例 ID 批量转为包年包月。多个实例 ID 间用英文逗号（,）分隔。最多支持同时传入 100 个实例，实例 ID 不允许重复。您可以调用 DescribeDBInstances 接口查询目标地域下所有 Redis 实例的基本信息，包括实例 ID。
ChargeType	String	是	PrePaid	修改后的实例计费类型，取值范围如下： `PrePaid`：包年包月（也称预付费）。 `PostPaid`：按量计费（也称后付费）。说明当前仅支持将按量计费改为包年包月，故取值为 `PrePaid`。关于计费类型的更多信息，请参见计费类型。
PurchaseMonths	Integer	否	1	购买时长。单位：月。取值范围如下：按月购买：`1`，`2`，`3`，`4`，`5`，`6`，`7`，`8`，`9`。按年购买：`12`，`24`，`36`。说明若该参数留空，默认购买时长为 1 个月。仅当 `ChargeType` 取值为 `PrePaid` 时，该参数生效。
AutoRenew	Boolean	否	false	是否开启自动续费，取值范围如下： `false`（默认值）：不开启自动续费。 `true`：开启自动续费。说明仅当 `ChargeType` 取值为 `PrePaid` 时，该参数生效。选择 `true` 开启自动续费后，系统默认续费时长为 1 个月。
ClientToken	String	否	WbiAlPqJM6tMoSOYhT****	用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，大小写敏感且不超过 127 个 ASCII 字符。

返回参数

参数	类型	示例值	描述
OrderNO	String	Order702856788643751****	订单 ID。

示例

请求示例

POST https://redis.cn-beijing.volcengineapi.com/?Action=ModifyDBInstanceChargeType&Version=2020-12-07 HTTP/1.1
Host: redis.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/Redis/request,SignedHeaders=content-type;host;x-date,Signature=****
{
    "InstanceIds": [
        "redis-cn02he8bhzsji****",
        "redis-cn02j292it8lc****"
    ],
    "ChargeType": "PrePaid",
    "PurchaseMonths": 1,
    "AutoRenew": false
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202206151735060102252431180652****",
        "Action": "ModifyDBInstanceChargeType",
        "Version": "2020-12-07",
        "Service": "Redis",
        "Region": "cn-beijing"
    },
    "Result": {
        "OrderNO": "Order702856788643751****"
    }
}

错误码

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