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

文档中心

立即注册

导航

ModifyTransitRouterBandwidthPackageAttributes

最近更新时间：2024.11.15 10:03:30首次发布时间：2023.09.12 10:21:32

调用 ModifyTransitRouterBandwidthPackageAttributes 接口，修改指定中转路由器带宽包的基本信息。

调试

API Explorer

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

去调试

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	ModifyTransitRouterBandwidthPackageAttributes	要执行的操作，取值为ModifyTransitRouterBandwidthPackageAttributes。
Version	String	是	2020-04-01	API版本信息，当前版本为2020-04-01。
TransitRouterBandwidthPackageId	String	是	tr-bp-4c2zaavbvh5f42****	中转路由器带宽包的ID。您可以调用DescribeTransitRouterBandwidthPackages接口获取带宽包ID。
TransitRouterBandwidthPackageName	String	否	trbp-test	中转路由器带宽包的名称。必须以字母、数字或中文开头，可包含字母、数字、中文和以下特殊字符：点号 (.) 、下划线 (_) 和短划线 (-) 。长度限制为1 ~ 128个字符。不传入该参数或该参数不传入数值时，表示保持原有配置不变。
Description	String	否	namedesc	中转路由器带宽包的描述。必须以字母、数字或中文开头，可包含字母、数字、中文和以下特殊字符：英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。长度限制为0 ~ 255个字符。不传入该参数或该参数不传入数值时，表示保持原有配置不变。
Bandwidth	Integer	否	2	中转路由器带宽包的带宽峰值。取值范围为2 ~ 10000，单位为Mbps。

返回参数

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

请求示例

GET /?Action=ModifyTransitRouterBandwidthPackageAttributes&Version=2020-04-01&TransitRouterId=tr-7qthudw0ll6jmc****&Bandwidth=3 HTTP/1.1
Host: open.volcengineapi.com
Service: transitrouter
Region: cn-guangzhou

返回示例

{
    "ResponseMetadata": {
        "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****",
        "Action": "ModifyTransitRouterBandwidthPackageAttributes",
        "Version": "2020-04-01",
        "Service": "transitrouter",
        "Region": "cn-guangzhou"
    },
    "Result": {}
}

错误码

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

HttpCode	错误码	错误信息	描述
400	FailedOperation	Failed to obtain TransitRouter bandwidth package billing information.	获取带宽包计费信息失败。
400	InvalidDescription.Malformed	The specified description is malformed.	指定的描述格式不合法，请修复描述格式后重试。
400	InvalidDescription.Malformed	The specified description is malformed. Ensure the maximum length of description is 255.	指定的描述格式不合法，描述长度不能超过255个字符。
400	InvalidName.Malformed	The specified name is malformed. Ensure the maximum length of name is 128.	指定的名称格式不合法，名称长度不能超过128个字符。
400	InvalidName.Malformed	The specified name is malformed.	指定的名称格式不合法，请修复名称格式后重试。
400	InvalidTransitRouterBandwidthPackage.InvalidStatus	The specified TransitRouter bandwidth package is being operated now.	指定的带宽包所处状态无法响应该请求，请稍后重试。
400	LimitExceeded.BandwidthOfBandwidthPackage	The specified bandwidth exceeds the bandwidth limit of Transit Router bandwidth package.	指定的带宽超出带宽包取值范围。
400	OrderError	Failed to create an order.	下单失败。
400	UnsupportedOperation	The payment failed due to the account balance is not enough for this order.	账户余额不足，订单支付失败。
400	UnsupportedOperation.ExpiredStatus	The request on the specified bandwidth package is denied because the bandwidth package is expired.	指定带宽包已过期，不支持当前操作。
400	InvalidTransitRouterBandwidthPackage.BandwidthNotEnough	Specified bandwidth is not enough for current inter region bandwidths.	指定的带宽值无法满足当前域间带宽使用。
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.ActionOnPocPackage	The specified request is denied because the type of bandwidth package is POC.	指定的带宽包为测试带宽包，暂不支持此操作。
404	InvalidTransitRouterBandwidthPackage.NotFound	The specified bandwidth package id does not exist.	指定的带宽包不存在。