为一个实例设置续费类型，包括自动续费、手动续费、到期不续费

使用说明 #

1. 使用此接口设置自动续费时，仅支持续费符合续费规则的包年包月实例或包月预留实例券
2. 续费规则可参考续费规则概览--费用中心-火山引擎，机器学习平台暂不支持OpenAPI设置自动续费
3. 已到期、即将关停/已关停实例，仅支持设置为手动续费
4. 预留实例券到期后不支持设置续费类型
5. 包年包月实例到期回收后不支持设置续费类型，退订关停实例不支持设置续费类型

注意事项 #

1. 单账号QPS上限为30
2. 子用户使用该接口时，应具备BillingCenterFullAccess或BillingCenterRenewAccess权限策略

请求参数 #

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

返回参数 #

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

请求示例 #

POST /?Action=SetRenewalType&Version=2022-01-01 HTTP/1.1
Host: billing.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250311T063207Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250311/cn-beijing/billing/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "InstanceID": "ins123",
  "Product": "ecs",
  "RenewType": "AutoRenewal",
  "RenewalDurationUnit": "Year",
  "RenewalDuration": 1,
  "RenewalTimes": 1,
  "SetRenewalRelatedInstance": true,
  "ClientToken": "t12345ghfj"
}

返回示例 #

{
  "ResponseMetadata": {
    "RequestId": "2025031114175308612821124786FDF9",
    "Action": "SetRenewalType",
    "Version": "2022-01-01",
    "Service": "billing",
    "Region": "cn-beijing"
  },
  "Result": {
    "SuccessInstanceList": [
      {
        "InstanceID": "b",
        "Product": "Z4yIpYlR"
      }
    ]
  }
}

错误码 #

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。