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

文档中心

立即注册

导航

ModifyDBInstanceChargeType

最近更新时间：2024.07.18 22:55:10首次发布时间：2022.07.05 11:50:28

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

请求类型

异步请求。

注意事项

实例状态需为运行中（Running）。
按量计费实例会按秒产生费用，结算周期为小时，系统会在每个整点（以 UTC+8 时间为准）结算一次费用。请确保账号余额充足以免发生欠费导致实例关停。更多详情，请参见转按量计费。
实例计费类型转换为按量付费时，系统会先按照非七天无理由退订退款规则计算实例的剩余价值（余款会按之前的支付方式原路退回），计费类型转换成功后，会立刻按照按量计费实例进行计费。更多关于非七天无理由退订退款规则详情，请参见非七天无理由退订规则。

请求参数

参数	类型	是否必选	示例值	描述
InstanceIds	String[]	是	["redis-cn02he8bhzsji**","redis-cn02j292it8lc**"]	实例 ID。说明支持同时传入多个实例 ID 批量转为包年包月。多个实例 ID 间用英文逗号（,）分隔。最多支持同时传入 100 个实例，实例 ID 不允许重复。您可以调用 DescribeDBInstances 接口查询目标地域下所有 Redis 实例的基本信息，包括实例 ID。
ChargeType	String	是	PrePaid	修改后的实例计费类型，取值范围如下： `PrePaid`：包年包月（也称预付费）。 `PostPaid`：按量计费（也称后付费）。关于计费类型的更多信息，请参见计费类型。
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.volcengineapi.com/?Action=ModifyDBInstanceChargeType&Version=2020-12-07 HTTP/1.1
Host: redis.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****"
     }
}

错误码

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