SetTransitRouterBandwidthPackageRenewal--中转路由器-火山引擎

文档中心

立即注册

导航

SetTransitRouterBandwidthPackageRenewal

最近更新时间：2024.11.15 10:03:30首次发布时间：2024.07.09 08:42:37

调用 SetTransitRouterBandwidthPackageRenewal 接口，设置包年包月类型中转路由器带宽包的续费类型。

调试

API Explorer

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

去调试

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	SetTransitRouterBandwidthPackageRenewal	要执行的操作，取值为SetTransitRouterBandwidthPackageRenewal。
Version	String	是	2020-04-01	API版本信息，当前版本为2020-04-01。
TransitRouterBandwidthPackageId	String	是	tr-bp-bp1o94dp5****	中转路由器带宽包的ID。您可以调用DescribeTransitRouterBandwidthPackages接口，查询中转路由器带宽包ID。
RenewType	String	是	Auto	中转路由器带宽包的续费类型。取值如下： Manual：手动续费。 Auto：自动续费。 NoRenew：不续费。
RenewPeriod	Integer	否	1	单次自动续费的时长，单位为月。取值包括1～3，6和12，默认值为1。说明当`RenewType`配置为Auto时生效。
RemainRenewTimes	Integer	否	1	自动续费的次数。取值包括-1和1～100，默认值为-1，表示自动续费无限次。说明当`RenewType`配置为Auto时生效。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

GET /?Action=SetTransitRouterBandwidthPackageRenewal&Version=2020-04-01&TransitRouterBandwidthPackageId=tr-bp-qw2u6ur8lhe2t****&RenewType=Auto&RenewPeriod=0&RemainRenewTimes=2 HTTP/1.1
Host: open.volcengineapi.com
Service: transitrouter
Region: cn-guangzhou

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20240627153631147123166106783354",
    "Action": "SetTransitRouterBandwidthPackageRenewal",
    "Version": "2020-04-01",
    "Service": "transitrouter",
    "Region": "cn-guangzhou"
  },
  "Result": {}
}

错误码

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

HttpCode	错误码	错误信息	描述
400	InvalidTransitRouterBandwidthPackage.RenewTypeMalformed	The specified RenewType is invalid.	指定的续费类型无效。
400	InvalidTransitRouterBandwidthPackage.RemainRenewTimesMalformed	The specified RemainRenewTimes is invalid.	指定的自动续费剩余次数无效。
400	InvalidTransitRouterBandwidthPackage.RenewPeriodMalformed	The specified RenewPeriod is invalid.	指定的续费周期无效。
400	InvalidTransitRouterBandwidthPackage.ModifyRenewalSettings	Modify renewal settings failed.	修改自动续费配置失败。
400	UnsupportedOperation.PrepaidInstanceRequired	The specified request is denied because the bandwidth package is not a prepaid bandwidth package.	指定的带宽包不是预付费带宽包，不支持当前操作。
404	InvalidTransitRouterBandwidthPackage.NotFound	The specified bandwidth package id does not exist.	指定的带宽包不存在。