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

文档中心

立即注册

导航

RenewTransitRouterBandwidthPackage

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

调用 RenewTransitRouterBandwidthPackage 接口，续期跨域带宽包。

调试

API Explorer

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

去调试

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	RenewTransitRouterBandwidthPackage	要执行的操作，取值为RenewTransitRouterBandwidthPackage。
Version	String	是	2020-04-01	API版本信息，当前版本为2020-04-01。
TransitRouterBandwidthPackageId	String	是	tr-bp-bp1o94dp5****	中转路由器带宽包的ID。您可以调用DescribeTransitRouterBandwidthPackages接口，查询中转路由器带宽包ID。
PeriodUnit	String	否	Month	中转路由器带宽包的计费周期。取值如下： Month（默认值）：按月计费。 Year：按年计费。
Period	Integer	否	1	中转路由器带宽包的购买时长，默认值为1。取值如下：当`PeriodUnit`取值为“Month”时，取值为1～9，12，24和36。当`PeriodUnit`取值为“Year”时，取值为1～3。

返回参数

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

请求示例

GET /?Action=RenewTransitRouterBandwidthPackage&Version=2020-04-01&TransitRouterBandwidthPackageId=tr-bp-qw2u6ur8lhe2t****%0A&PeriodUnit=Month&Period=1 HTTP/1.1
Host: open.volcengineapi.com
Service: transitrouter
Region: cn-guangzhou

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2024062715311618200419005956CC0F",
    "Action": "RenewTransitRouterBandwidthPackage",
    "Version": "2020-04-01",
    "Service": "transitrouter",
    "Region": "cn-guangzhou"
  },
  "Result": {}
}

错误码

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

HttpCode	错误码	错误信息	描述
400	FailedOperation	Failed to obtain TransitRouter bandwidth package billing information.	获取带宽包计费信息失败。
400	OrderError	Failed to create an order.	下单失败。
400	InvalidTransitRouterBandwidthPackage.PeriodMalformed	The specified Period is invalid.	指定的购买时长无效。
400	InvalidTransitRouterBandwidthPackage.InvalidStatus	The specified TransitRouter bandwidth package is being operated now.	指定的带宽包所处状态无法响应该请求，请稍后重试。
400	UnsupportedOperation	The payment failed due to the account balance is not enough for this order.	账户余额不足，订单支付失败。
400	InvalidTransitRouterBandwidthPackage.PeriodUnitMalformed	The specified PeriodUnit is invalid.	指定的计费周期无效。
400	InvalidTransitRouterCrossBorderBandwidthPackage.FrozenStatus	The specified request is denied because your account has been frozen for cross-border. Please wait for the Service Provider to unfreeze it.	您的账号当前处于跨境封停状态，请等待运营商解封后再进行操作。
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.	指定的带宽包不存在。