SetLoadBalancerRenewal--负载均衡-火山引擎

文档中心

立即注册

导航

SetLoadBalancerRenewal

最近更新时间：2024.10.22 14:18:07首次发布时间：2022.03.01 08:57:47

调用 SetLoadBalancerRenewal 接口，设置包年包月负载均衡实例的续费类型。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	SetLoadBalancerRenewal	要执行的操作，取值为SetLoadBalancerRenewal。
Version	String	是	2020-04-01	API版本信息，当前版本为：2020-04-01。
LoadBalancerId	String	是	clb-bp1b6c719dfa08ex****	CLB实例ID。您可以调用DescribeLoadBalancers接口，查询CLB实例ID。
RenewType	Integer	是	2	CLB实例的续费类型。取值如下： 1：手动续费 2：自动续费
RenewPeriodTimes	Integer	否	1	单次自动续费的时长，单位为月。当参数`RenewType`取2时，本参数有效。取值包括1～3，6和12，默认值为1。
RemainRenewTimes	Integer	否	-1	自动续费的次数。当参数`RenewType`取2时，本参数有效。取值包括-1和1～100，默认值为-1，表示自动续费无限次。

返回参数

名称	类型	示例值	描述
RequestId	String	20210811152539010225146063030****	请求ID。

请求示例

GET /?Action=SetLoadBalancerRenewal&Version=2020-04-01&LoadBalancerId=clb-bp1b6c719dfa08ex****&RenewType=2 HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
Service: clb

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20210811152539010225146063030****",
        "Action": "SetLoadBalancerRenewal",
        "Version": "2020-04-01",
        "Service": "clb",
        "Region": "cn-beijing"
    }, 
    "Result": {
        "RequestId": "20210811152539010225146063030****"
    }
}

错误码

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

HttpCode	错误码	错误信息	描述
400	InvalidLoadBalancer.InvalidStatus	The specified LoadBalancer is not in the correct status for the request.	指定的负载均衡所处状态无法响应该请求。
400	InvalidLoadBalancer.UnSupportAction	The specified LoadBalancer does not support this action.	指定的负载均衡不支持当前操作。
400	InvalidRemainRenewTimes.Malformed	The specified RemainRenewTimes is malformed.	指定的 RemainRenewTimes 参数格式不合法。
400	InvalidRenewPeriodTimes.Malformed	The specified RenewPeriodTimes is malformed.	指定的 RenewPeriodTimes 参数格式不合法。
400	InvalidRenewType.Malformed	The specified RenewType is malformed.	指定的 RenewType 参数格式不合法。
400	OrderError.OrderPay	Failed to create order and pay.	下单支付失败。
400	UnsupportedOperation.AccountArrears	The request on the specified instance is denied due to the account in arrears status.	因账户处于欠费状态，对于该实例的操作请求被拒绝。
403	InvalidResourceType.ServcieManaged	The specified ResourceType is managed by a service.	指定的资源是服务托管资源。
404	InvalidLoadBalancer.NotFound	The specified LoadBalancer does not exist.	指定的负载均衡不存在。
412	InvalidLoadBalancer.InvalidBillingType	The specified LoadBalancer is not in the correct BillingType for the request.	指定的负载均衡所处计费类型无法响应该请求。