堡垒机不提供为实例设置自动续费的接口。您可以通过调用阿里云交易和账单管理API提供的SetRenewal接口为堡垒机实例设置自动续费。
背景信息
阿里云交易和账单管理API是一套通用的管理阿里云资源的接口,可以用于查询服务价格、管理实例、获取账单信息等。关于阿里云交易和账单管理API支持的所有接口,请参见API概览。
您可以调用阿里云交易和账单管理API提供的SetRenewal接口,为堡垒机实例设置自动续费。关于该接口的调用方式,请参见请求结构。
下文介绍了调用SetRenewal接口为堡垒机实例设置自动续费的请求方法和示例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SetRenewal | 要执行的操作。取值:SetRenewal。 |
InstanceIDs | String | 是 | bastionhost-cn-**** | 要设置的实例ID。多个ID用半角逗号(,)分隔,仅支持包年包月实例,最大不超过100个。 |
RenewalStatus | String | 是 | AutoRenewal | 续费状态,取值:
|
RenewalPeriod | Integer | 否 | 1 | 设置实例自动续费时长。取值:
说明 当RenewalStatus取值为AutoRenewal时,RenewalPeriod为必填参数。 |
RenewalPeriodUnit | String | 否 | M | 自动续费周期单位,取值:
说明 当RenewalStatus取值为AutoRenewal时,RenewalPeriodUnit为必填参数。 |
ProductCode | String | 否 | bastionhost | 产品代码。 堡垒机产品代码为bastionhost。 |
ProductType | String | 否 | bastionhost | 产品类型。 堡垒机产品类型为bastionhost。 |
SubscriptionType | String | 否 | Subscription | 付费类型。 堡垒机需设置为Subscription,表示预付费类型。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | Success | 本次请求的状态码。 |
Message | String | Successful! | Code对应的状态码信息。 |
RequestId | String | 6000EE23-274B-4E07-A697-FF2E999520A4 | 本次请求的ID。 |
Success | Boolean | true | 本次请求是否成功。 |
示例
请求示例
http(s)://[Endpoint]/?Action=SetRenewal
&InstanceIDs=bastionhost-cn-****
&RenewalStatus=AutoRenewal
&RenewalPeriod=1
&RenewalPeriodUnit=M
&<公共请求参数>
正常返回示例
XML
格式
<SetRenewalResponse>
<Message>Successful!</Message>
<RequestId>6000EE23-274B-4E07-A697-FF2E999520A4</RequestId>
<Success>true</Success>
<Code>Success</Code>
</SetRenewalResponse>
JSON
格式
{
"Message": "Successful!",
"RequestId": "6000EE23-274B-4E07-A697-FF2E999520A4",
"Success": true,
"Code": "Success"
}