金山云-文档中心-实例自动续费

SetRenewal（为实例批量设置自动续费策略）

此接口支持为实例批量设置自动续费策略。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	SetRenewal	系统规定参数。取值：SetRenewal。
Version	String	是	2020-08-31	系统规定参数。取值2020-08-31
InstanceIds	String	是	d9394af-814a-40b3-80b1-45636f770551	实例ID，支持批量设置最多100个包年包月实例，多个实例ID以英文逗号分隔。
RenewStrategy	int	是	0	续费策略。 0，手动续费； 1 自动续费
RenewDuration	int	否	12	续费周期（月）。当 RenewStrategy 为自动续费时必传，取值 1,2,3,6,12,24,36

返回数据

名称	类型	示例	描述
RequestId	String	9f7cbbcb-cad9-4cd6-9c90-5b27e39b21b1	请求ID
success	boolean	true	业务结果状态
Error	Object		处理失败时返回，具体参考示例

示例

请求示例

curl -X POST \
'http://trade.api.ksyun.com/?Action=SetRenewal&Version=2020-08-31' \
-H 'authorization: xxx, SignedHeaders=content-type;host;x-amz-date, Signature=xxx' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-H 'host: trade.api.ksyun.com' \
-H 'x-amz-date: 20170720T022802Z'
-D 'instanceIds=xxx&renewStrategy=xxx&renewDuration=xxx'

成功返回示例

{
    "RequestId": "9f7cbbcb-cad9-4cd6-9c90-5b27e39b21b1",
    "success": true
}

失败返回示例

{
    "Error": {
        "Code": "InvalidParameterValue",
        "Message": "续费时长不合法"
    },
    "RequestId": "21b0e61b-4979-45d5-b8ce-258a23753163",
    "success": false
}