You need to enable JavaScript to run this app.
导航
ModifyTransitRouterPeerAttachmentAttributes
最近更新时间:2024.11.15 10:03:30首次发布时间:2023.09.12 10:21:32

调用 ModifyTransitRouterPeerAttachmentAttributes 接口,修改跨地域连接的名称、描述、带宽及关联的带宽包。

调试

请求参数

名称类型是否必选示例值描述
ActionStringModifyTransitRouterPeerAttachmentAttributes要执行的操作,取值为ModifyTransitRouterPeerAttachmentAttributes。
VersionString2020-04-01API版本信息,当前版本为2020-04-01。
TransitRouterAttachmentIdStringtr-attach-7qthudw0ll6jmc****跨地域连接的ID。您可以调用DescribeTransitRouterPeerAttachments接口获取跨地域连接的ID。

TransitRouterAttachmentName

String

tr-attachment

跨地域连接的名称。

  • 必须以字母、数字或中文开头,可包含字母、数字、中文和以下特殊字符:点号(.)、下划线(_)和短横线(-)。
  • 长度限制为1 ~ 128个字符。
  • 不传入该参数或该参数不传入数值时,表示保持原有名称不变。

TransitRouterBandwidthPackageId

String

tr-bp-qw2u6ur8lhe2t****

中转路由器带宽包的ID。您可以调用DescribeTransitRouterBandwidthPackages接口获取中转路由器带宽包的ID。
传入该参数时必须传入参数Bandwidth,未传入该参数时无需传入参数Bandwidth

Bandwidth

Integer

2

跨地域连接的带宽,单位为Mbps。
带宽最大值不能超过指定中转路由器带宽包剩余未分配的带宽上限。

Description

String

This peer attachment is used for test.

跨地域连接的描述信息。

  • 必须以字母、数字或中文开头,可包含字母、数字、中文和以下特殊字符:英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。)。
  • 长度限制为0 ~ 255个字符。
  • 不传入该参数或该参数不传入数值时,表示保持原有描述不变。

返回参数

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

请求示例

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

返回示例

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

错误码

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

HttpCode错误码错误信息描述
400InvalidDescription.MalformedThe specified description is malformed.指定的描述格式不合法。请修复描述格式后重试。
400InvalidDescription.MalformedThe specified description is malformed. Ensure the maximum length of description is 255.指定的描述格式不合法。描述长度不能超过255个字符。
400InvalidName.MalformedThe specified name is malformed.指定的名称格式不合法。请修复名称格式后重试。
400InvalidName.MalformedThe specified name is malformed. Ensure the maximum length of name is 128.指定的名称格式不合法。名称长度不能超过128个字符。
400InvalidTransitRouter.InvalidStatusThe specified Transit Router is not in the correct status for the request.指定的中转路由器所处状态无法响应该请求。
400InvalidTransitRouterAttachment.InvalidStatusThe specified Transit Router Attachment is not in the correct status for the request.指定的网络实例连接所处状态无法响应该请求。
400LimitExceeded.InterRegionBandwidthThe specified inter region bandwidth exceeds the available bandwidth of the bandwidth package.指定的域间带宽大小超出带宽包可分配的带宽。
400LimitExceeded.InterRegionBandwidthThe specified peer attachment bandwidth exceeds the lower limit.指定的带宽大小超出域间带宽最小限制。
400LimitExceeded.PhysicalLineBandwidthYou’ve reached the bandwidth limit on the number of physical line.已达到物理线路可分配带宽上限。
400UnsupportedOperation.ExpiredStatusThe request on the specified bandwidth package is denied because the bandwidth package is expired.指定带宽包已过期,不支持当前操作。
400InvalidTransitRouterPeerAttachment.PeerTransitRouterInvalidStatusThe specified peer Transit Router is not in the correct status for the request.指定的对端中转路由器所处状态无法响应该请求。
400InvalidTransitRouterBandwidthPackage.InvalidStatusThe specified TransitRouter bandwidth package is being operated now.指定的带宽包所处状态无法响应该请求,请稍后重试。
400MissingParameterThe specified peer attachment with a bandwidth package assigned to it, needs to allocate an inter region bandwidth parameter.跨地域连接指定了带宽包,请分配跨域带宽。
400InvalidRegionId.ConflictThe LocalRegionId or PeerRegionId of peer attachment are different from bandwidth package.指定的带宽包和跨地域连接的互通地域不一致。
404InvalidInterRegionBandwidth.NotFoundThe specified inter region bandwidth does not exist.指定的跨域带宽不存在。
404InvalidTransitRouterAttachment.NotFoundThe specified Transit Router attachment does not exist.指定的网络实例连接不存在。
404InvalidTransitRouterBandwidthPackage.NotFoundThe specified bandwidth package id does not exist.指定的带宽包不存在。
409InvalidParameter.ParameterConflictCannot set the bandwidth when peer attachment has not associated bandwidth package.跨地域连接未加入带宽包,不支持设置跨地域带宽。