You need to enable JavaScript to run this app.
导航
缓存数据库 Redis 版
  • 文档首页
    • /
  • 缓存数据库 Redis 版

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 个月。
ClientTokenString否WbiAlPqJM6tMoSOYhT****用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，大小写敏感且不超过 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****"
     }
}

错误码

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