You need to enable JavaScript to run this app.
导航
ModifyDBInstanceChargeType
最近更新时间:2023.12.07 21:15:15首次发布时间:2022.07.05 11:50:28

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

请求类型

异步请求。

注意事项

  • 实例状态需为运行中
  • 按量计费实例会按秒产生费用,结算周期为小时,系统会在每个整点(以 UTC+8 时间为准)结算一次费用。请确保账号余额充足以免发生欠费导致实例关停。更多详情,请参见转按量计费

请求参数

名称类型是否必选示例值描述

InstanceIds

Array of String

["redis-cn02he8bhzsji****","redis-cn02j292it8lc****"]

实例 ID。您可以调用 DescribeDBInstances 接口查询目标地域下所有 Redis 实例的基本信息,包括实例 ID。

说明

  • 支持同时传入多个实例 ID 批量转为包年包月。多个实例 ID 间用英文逗号(,)分隔。
  • 最多支持同时传入 100 个实例,实例 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 个月。
ClientTokenStringWbiAlPqJM6tMoSOYhT****用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,大小写敏感且不超过 127 个 ASCII 字符。

返回数据

名称类型示例值描述
OrderNOStringOrder710938814817460****订单 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": "Order710938814817460****"
     }
}

错误码

更多详情,请参见错误码