调用 CreateTransitRouterPeerAttachment 接口，创建一个跨地域连接。

调试

API Explorer

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

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action String 必选示例值：CreateTransitRouterPeerAttachment

接口名称。当前 API 的名称为CreateTransitRouterPeerAttachment。

Version String 必选示例值：2020-04-01

接口版本。当前 API 的版本为2020-04-01。

Bandwidth Integer 可选示例值：10

跨地域连接的带宽，单位为Mbps。

带宽最大值不能超过指定中转路由器带宽包剩余未分配的带宽上限。

Tags.N.Key String 可选示例值：k1

跨地域连接用户标签的标签键。

长度限制为1～128个字符。

大小写敏感，不能以volc:或sys:的任意大小写组合开头。

不能以空格开头或结尾。

允许包含字母、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（-）和@。

说明

同一资源的标签键不允许重复。

不传入该参数或该参数不传入数值时，默认为空。

Tags.N.Value String 可选示例值：v1

跨地域连接用户标签的标签值。

长度限制为0～255个字符。

大小写敏感，不能以空格开头或结尾。

允许包含字母、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（-）和@。

说明

如果传入该参数，则必须先传入Tags.N.Key。

TransitRouterAttachmentName String 可选示例值：tr-attachment

跨地域连接的名称。

必须以字母、数字或中文开头，可包含字母、数字、中文和以下特殊字符：点号（.）、下划线（_）和短横线（-）。

长度限制为1 ~ 128个字符。

不传入该参数或该参数不传入数值时，默认为中转路由器实例的ID。

Description String 可选示例值：This peer attachment is used for test.

跨地域连接描述。

必须以字母、数字或中文开头，可包含字母、数字、中文和以下特殊字符：英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。

长度限制为0 ~ 255个字符。

不传入该参数或该参数不传入数值时，默认为空字符串。

TransitRouterId String 必选示例值：tr-7qthudw0ll6jmc****

本端中转路由器实例的ID。

PeerTransitRouterId String 必选示例值：tr-q3wuhuumlho9r****

对端中转路由器实例的ID。您可以调用DescribeTransitRouters接口获取中转路由器实例的ID。

PeerTransitRouterRegionId String 必选示例值：cn-beijing

对端中转路由器实例所属地域的ID。您可以参考地域介绍获取地域ID。

TransitRouterBandwidthPackageId String 可选示例值：tr-bp-qw2u6ur8lhe2t****

中转路由器带宽包的ID。您可以调用DescribeTransitRouters接口获取中转路由器实例的ID。

传入该参数时必须传入参数Bandwidth，未传入该参数时无需传入参数Bandwidth。

ClientToken String 可选示例值：test-client-token

客户端Token，用于保证请求的幂等性。

该参数值由客户端自动生成，确保不同请求的取值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。

取值仅支持ASCII字符，最大不超过64个字符。

未指定该参数值时，不进行幂等校验。

PeerTransitRouterOwnerId String 可选示例值：2100****63

对端中转路由器实例所属账号的ID。

BandwidthType String 可选示例值：BandwidthPackage

跨地域连接的带宽分配方式。

BandwidthPackage（默认值）：从带宽包分配。

CloudDataTransfer：通过云数据传输服务按流量计费。

LineOperator String 可选示例值：ChinaUnicom

跨境带宽包线路的运营商。跨境互通时，该参数必选。

ChinaUnicom：中国联通。

ChinaTelecom：中国电信。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

TransitRouterAttachmentId String 示例值：tr-attach-12w7hruhlhlrd****

网络实例连接的ID

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	IdempotentParameterMismatch	Arguments on this idempotent request are inconsistent with arguments used in previous request(s).	此幂等请求的参数与前一个请求中使用的参数不一致。
400	InstanceCreateOrderError	Failed to create cdt instance order.	下单失败。
400	InvalidBandwidthType.NotSupported	The specified bandwidth type is not supported.	指定的带宽分配方式不支持。
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	InvalidInterRegionBandwidth.Existed	The specified inter region bandwidth existed.	指定的跨域带宽已经存在。
400	InvalidLineOperator.MissMatchBandwidthType	The specified line operator does not match the bandwidth type.	指定的运营商与带宽分配方式不匹配。
400	InvalidLocalRegionId.Conflict	The specified LocalRegionId and PeerRegionId are the same.	指定的本端地域和对端地域相同。
400	InvalidName.Malformed	The specified name is malformed.	指定的名称格式不合法。请修复名称格式后重试。
400	InvalidName.Malformed	The specified name is malformed. Ensure the maximum length of name is 128.	指定的名称格式不合法。名称长度不能超过128个字符。
400	InvalidParameter.ClientTokenMalformed	The specified parameter ClientToken is malformed.	指定的参数ClientToken格式不合法，长度不能超过64个ASCII字符。
400	InvalidPeerTransitRouter.InvalidBusinessStatus	The request is denied because the specified peer Transit Router is shut down due to arrears.	指定的对端中转路由器欠费关停，不支持当前操作。
400	InvalidRegionId.Conflict	The LocalRegionId or PeerRegionId of peer attachment are different from bandwidth package.	指定的带宽包和跨地域连接的互通地域不一致。
400	InvalidTag.Disorder	The specified index order of tag is malformed.	指定标签的索引顺序参数格式不合法。
400	InvalidTagKey.Malformed	The specified parameter tag key is invalid.	标签键不合法。
400	InvalidTagValue.Malformed	The specified parameter tag value is invalid.	标签值不合法。
400	InvalidTransitRouter.InvalidBusinessStatus	The request is denied because the specified Transit Router is shut down due to arrears.	指定的中转路由器欠费关停，不支持当前操作。
400	InvalidTransitRouter.InvalidStatus	The specified Transit Router is not in the correct status for the request.	指定的中转路由器所处状态无法响应该请求。
400	InvalidTransitRouterBandwidthPackage.InvalidStatus	The specified TransitRouter bandwidth package is being operated now.	指定的带宽包所处状态无法响应该请求，请稍后重试。
400	InvalidTransitRouterBandwidthPackageId.MissMatchBandwidthType	The specified bandwidth package ID does not match the bandwidth type.	指定的带宽包ID与带宽分配方式不匹配。
400	InvalidTransitRouterPeer.InvalidAccount	The specified granted account is equal to the login account, please change the account to grant.	指定的授权账号与当前账号相同，请更换账号授权。
400	InvalidTransitRouterPeerAttachment.PeerRegionIdConfict	The peer region id of the specified attachment conflicts with current region.	指定网络实例连接的对端区域必须和当前区域不同。
400	InvalidTransitRouterPeerAttachment.PeerRegionNotSupported	The specified peer region does not support to create peer attachment.	指定的对端地域不支持创建跨地域连接。
400	InvalidTransitRouterPeerAttachment.PeerRegionTypeConflicts	The region type of specified peer region conflicts with the local region type.	指定的对端地域类型与当前地域类型冲突。
400	InvalidTransitRouterPeerAttachment.PeerTransitRouterInvalidStatus	The specified peer Transit Router is not in the correct status for the request.	指定的对端中转路由器所处状态无法响应该请求。
400	InvalidTransitRouterPeerAttachment.SharedTransitRouter	The specified peer Transit Router is shared instance, and does not support to create peer attachment.	指定的对端中转路由器是共享实例，不支持创建跨地域连接。
400	InvalidTransitRouterRouteTableAssociation.TransitRouterMismatch	The specified route table and attachment do not belong to one same Transit Router.	指定的路由表所属的中转路由器和网络实例连接挂载的中转路由器不一致。
400	InvalidTransitRouterRouteTablePropagation.ASNConflict	Peer Transit Router ASN conflicts with local Transit Router ASN.	对端中转路由器的ASN号与当前实例相同，无法创建路由学习。
400	LimitExceeded.CDTBandwidth	You've reached the maximum bandwidth limit.	已达到单个账号可创建的CDT带宽上限。
400	LimitExceeded.InterRegionBandwidth	The specified inter region bandwidth exceeds the available bandwidth of the bandwidth package.	指定的域间带宽大小超出带宽包可分配的带宽。
400	LimitExceeded.InterRegionBandwidth	The specified peer attachment bandwidth exceeds the lower limit.	指定的带宽大小超出域间带宽最小限制。
400	LimitExceeded.PhysicalLineBandwidth	You’ve reached the bandwidth limit on the number of physical line.	已达到物理线路可分配带宽上限。
400	LimitExceeded.Tags	You've reached the limit on the number of tags that you can operate at a time.	已达到单次可操作标签数量的上限。
400	MissingParameter	The specified peer attachment with a bandwidth type assigned to it, needs to allocate an inter region bandwidth parameter.	跨地域连接指定按带宽包计费或按流量计费类型，请分配跨域带宽。
400	QuotaExceeded.InterRegionPeerAttachment	You've reached the maximum number of inter region attachments that one transit router can have.	已达到单个中转路由器可创建的跨地域连接上限。
400	QuotaExceeded.PeerTransitRouterAttachment	You've reached the maximum number of attachments that one Transit Router can have in the peer region.	指定的对端中转路由器已达到单个中转路由器可创建的网络实例上限。
400	QuotaExceeded.TransitRouterAttachment	You've reached the maximum number of attachments that one Transit Router can have.	已达到单个中转路由器可创建的网络实例上限。
400	UnsupportedOperation.ExpiredStatus	The request on the specified bandwidth package is denied because the bandwidth package is expired.	指定带宽包已过期，不支持当前操作。
400	UnsupportedOperation.OverdueStatus	The request on the specified bandwidth package is denied because the bandwidth package is shut down due to arrears.	指定带宽包欠费关停，不支持当前操作。
400	UnsupportedOperation	The request on the specified instance is denied due to the account in arrears status.	因账户处于欠费状态，对于该实例的操作请求被拒绝。
403	Forbidden.CreateTransitRouterPeerAttachment	You are not authorized to create peer attachment on Transit Router.	无权限创建跨域网络实例连接，请开通跨域网络实例连接的白名单。
403	Forbidden.CrossBorderApprovalNotApplied	You cannot create cross-border resources because you have not applied for cross-border audit yet.	未提交跨境资质审核，无法创建跨境资源。
403	Forbidden.CrossBorderApprovalPending	The specified request is denied because your cross-border audit application is pending approval.	您提交的跨境申请仍在审核中，请等待业务资质审核通过后，再创建跨境资源。
403	Forbidden.CrossBorderApprovalRejected	You cannot create cross-border resources because your cross-border audit application has been rejected.	跨境资质审核被拒绝，无法创建跨境资源。
403	Forbidden.CrossBorderUserFrozen	The specified request is denied because your account has been frozen for cross-border. Please wait for the Service Provider to unfreeze it.	您的账号当前处于跨境封停状态，请等待运营商解封后再进行操作。
403	Forbidden.EnablePeerTransitRouterRouteTablePropagation	You are not authorized to enable peer attachment route table propagation.	无权限开启跨地域连接的路由学习功能，请开通白名单。
403	Forbidden.NoPermissionToOperate	You are not authorized to operate the specified resource.	无权限操作指定的资源。
403	Forbidden.TransitRouterIPv6	You are not authorized to use ipv6 on Transit Router.	未开通中转路由器IPv6功能，不支持该操作。
404	InvalidPeerTransitRouter.NotFound	The specified peer Transit Router does not exist.	指定的对端中转路由器不存在。
404	InvalidPeerTransitRouterRouteTable.NotFound	The specified route table of peer Transit Router does not exist.	指定的对端中转路由器路由表不存在。
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	指定的地域不存在。
404	InvalidTransitRouter.NotFound	The specified Transit Router does not exist.	指定的中转路由器不存在。
404	InvalidTransitRouterBandwidthPackage.NotFound	The specified bandwidth package id does not exist.	指定的带宽包不存在。
404	InvalidTransitRouterRouteTable.NotFound	The specified route table does not exist.	指定的中转路由器路由表不存在。
409	InvalidParameter.ParameterConflict	Cannot set the bandwidth when peer attachment has not associated bandwidth package or bandwidth type.	跨地域连接未加入带宽包, 不支持设置跨地域带宽。
409	InvalidTransitRouterAttachment.Conflict	The specified instance has already been attached to the Transit Router.	指定的网络实例已加入指定的中转路由器，不支持重复操作。
412	IdempotentProcessing	The request uses the same client token as a previous one that is still in process.	幂等请求处理中。