To connect network instances across regions, such as virtual private clouds (VPCs), virtual border routers (VBRs), and IPsec-VPN connections that are connected to transit routers, you must create an inter-region connection between the network instances that you want to connect. You can call the CreateTransitRouterPeerAttachment operation to create an inter-region connection on an Enterprise Edition transit router.
Operation description
-
Enterprise Edition transit routers allow you to allocate bandwidth resources to inter-region connections by using the following methods:
-
Allocate bandwidth resources from a bandwidth plan:
You must purchase a bandwidth plan, and then allocate bandwidth resources from the bandwidth plan to inter-region connections. For more information about how to purchase a bandwidth plan, see CreateCenBandwidthPackage .
-
Use pay-by-data-transfer bandwidth resources:
You can set a maximum bandwidth value for an inter-region connection. Then, you are charged for the amount of data transfer over the connection. For more information, see Inter-region data transfer.
-
-
CreateTransitRouterPeerAttachment is an asynchronous operation. After a request is sent, the system returns a request ID and runs the task in the background. You can call the ListTransitRouterPeerAttachments operation to query the status of an inter-region connection.
- If the inter-region connection is in the Attaching state, the inter-region connection is being created. In this case, you can query the connection but cannot perform other operations on the connection.
- If the inter-region connection is in the Attached state, the inter-region connection is created.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
ClientToken | string | No | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The client token can contain only ASCII characters. Note
If you do not specify this parameter, the system automatically uses the request ID as the client token. The request ID may be different for each request.
| 02fb3da4-130e-11e9-8e44-001**** |
CenId | string | No | The ID of the Cloud Enterprise Network (CEN) instance. | cen-j3jzhw1zpau2km**** |
TransitRouterId | string | No | The ID of the local Enterprise Edition transit router. | tr-bp1su1ytdxtataupl**** |
RegionId | string | No | The ID of the region where the local Enterprise Edition transit router is deployed. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
TransitRouterAttachmentName | string | No | The name of the inter-region connection. The name can be empty or 1 to 128 characters in length, and cannot start with http:// or https://. | testname |
TransitRouterAttachmentDescription | string | No | The description of the inter-region connection. This parameter is optional. If you enter a description, it must be 1 to 256 characters in length, and cannot start with http:// or https://. | testdesc |
PeerTransitRouterId | string | Yes | The ID of the peer transit router. | tr-m5eq27g6bndum7e88**** |
PeerTransitRouterRegionId | string | No | The ID of the region where the peer transit router is deployed. | cn-qingdao |
AutoPublishRouteEnabled | boolean | No | Specifies whether to enable the local Enterprise Edition transit router to automatically advertise the routes of the inter-region connection to the peer transit router. Valid values:
| false |
Bandwidth | integer | No | The bandwidth value of the inter-region connection. Unit: Mbit/s.
| 2 |
CenBandwidthPackageId | string | No | The ID of the bandwidth plan that you want to associate with the inter-region connection. Note
If you set BandwidthType to DataTransfer, you can skip this parameter.
| cenbwp-3xrxupouolw5ou**** |
DryRun | boolean | No | Specifies whether to perform a dry run. Default values:
| false |
BandwidthType | string | No | The method that is used to allocate bandwidth to the inter-region connection. Valid values:
| BandwidthPackage |
Tag | array<object> | No | The information about the tags. You can specify at most 20 tags in each call. | |
object | No | The tags. | ||
Key | string | No | The tag key. The tag key cannot be an empty string. The tag key can be up to 64 characters in length and cannot start with You can specify at most 20 tag keys. | tag_A1 |
Value | string | No | The tag value. The tag value can be 0 to 128 characters in length, and cannot start with Each tag key must have a unique tag value. You can specify at most 20 tag values in each call. | value_A1 |
DefaultLinkType | string | No | The default line type. Valid values: Platinum and Gold. Platinum is supported only when BandwidthType is set to DataTransfer. | Gold |
Response parameters
Examples
Sample success responses
JSON
format
{
"TransitRouterAttachmentId": "tr-attach-nwkiqfvw22qesz****",
"RequestId": "59422BF5-BAAD-4CFD-9019-9557BD3ACFA3"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | OperationUnsupported.TransitRouterRegionId | The specified TransitRouterRegion does not support the operation. | - |
400 | NoPermission.AliyunServiceRolePolicyForCEN | You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission. | The error message returned because you do not have the permissions to create the service-linked role whose role name is AliyunServiceRolePolicyForCEN and service name is cen.aliyuncs.com. You must acquire the ram:CreateServiceLinkedRole permission before you can create the service-linked role. |
400 | InvalidTransitRouterId.NotFound | TransitRouterId is not found. | The error message returned because the ID of the transit router does not exist. |
400 | IllegalParam.PeerTransitRouterId | PeerTransitRouterId is illegal. | The error message returned because the ID of the peer transit router is invalid. |
400 | OperationUnsupported.TransitRouterId | TransitRouterId is unsupported. | The error message returned because Basic Edition transit routers do not support the operation. |
400 | MissingParam.Bandwidth | The parameter Bandwidth is mandatory. | The error message returned because no bandwidth value is specified. You must specify a bandwidth value. |
400 | IllegalParam.Bandwidth | Bandwidth is illegal. | The error message returned because the specified bandwidth plan ID is invalid. |
400 | Forbbiden.TransitRouterServiceNotOpen | The user has not open transit router service. | The error message returned because the transit router is disabled. Enable the transit router and try again. |
400 | OperationUnsupported.TransitRouterType | The specified TransitRouterType does not support the operation. | The error message returned because this operation is not supported by the specified type of transit router. |
400 | OperationUnsupported.BandwidthType | The specified BandwidthType does not support the operation. | The error message returned because this operation is not supported by the specified bandwidth type. |
400 | InvalidCenId.NotFound | CenId is not found. | The error message returned because the specified CEN instance does not exist. |
400 | IllegalParam.BandwidthType | BandwidthType is illegal. | The error message returned because the specified bandwidth plan type is invalid. |
400 | MissingParam.CenIdOrRegionId | Either CenId or RegionId must be specified. | The error message returned because the CenId or RegionId parameter is not set. |
400 | OperationUnsupported.BandwidthHS | This bandwidth limit can only be set in China-AsiaPacific-HS | - |
400 | OperationUnsupported.CenFullLevel | CEN full level does not support TransitRouter | The error message returned because CEN instances of the Full type do not support Enterprise Edition transit routers. |
400 | OperationUnsupported.CloudDataTransferService | CCN region not support cloud data transfer service. | The error message returned because the Cloud Data Transfer (CDT) service is not supported in the region of the CCN instance. |
400 | InvalidPeerTransitRouterId.NotFound | The specified PeerTransitRouterId is not found. | The error message returned because the specified peer transit router ID (PeerTransitRouterId) does not exist. |
400 | IllegalParam.RegionId | RegionId is illegal. | The error message returned because the specified region is invalid. |
400 | IllegalParam.PeerRegionId | PeerRegionId is illegal. | The error message returned because the specified peer region ID (PeerRegionId) is invalid. |
400 | IllegalParam.TransitRouterRegionId | TransitRouterRegionId is illegal. | The error message returned because the specified transit router region ID (TransitRouterRegionId) is invalid. |
400 | InvalidOperation.CenInstanceStatus | The CEN instance is not in a valid state for the operation. | - |
400 | IncorrectStatus.TransitRouter | The status of TransitRouter is incorrect. | The error message returned because the status of the transit router does not support this operation. Try again later. |
400 | InvalidOperation.BwpNotAssociated | Operation is invalid because a bandwidth package corresponding to the geographic span is not associated. | The error message returned because this operation is not supported when no bandwidth plan is applied to the specified region. |
400 | InvalidOperation.BwpBusinessStatus | The CBN bandwidth package is not in a valid business state for the operation. | The error message returned because this operation is not supported when the specified bandwidth plan is in an unstable state. |
400 | IllegalParam.CenBandwidthPackageId | Parameter CenBandwidthPackageId is illegal. | The error message returned because the specified bandwidth plan ID (CenBandwidthPackageId) is invalid. |
400 | InvalidOperation.BwpBandwidthExceeded | Operation is invalid because the total bandwidth limit has exceeded that of the bandwidth package. | The error message returned because the specified bandwidth value exceeds the maximum bandwidth value of the bandwidth plan. |
400 | ParameterIllegal.CdtDefaultLinkTypeOnlySupportPlatinumOrGold | DataTransfer only support Platinum and Gold. | DataTransfer only support Platinum and Gold. |
400 | ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold | Cen bandwidthPackage only support Gold. | Cen bandwidthPackage only support Gold. |
400 | ParameterIllegal.CdtDefaultLinkTypeOnlySupportGold | CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version. | CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version. |
400 | OperationNotAllowed.DefaultLinkTypeOnlySupportGold | Operation is not allowed because this user can only set default link type to Gold. | This user can only set the default link type to Gold. |
400 | OperationInvalid.UserCanNotBuyCrossBorderBwp | According to the laws and regulations of the operator and mainland China, you are currently not eligible to purchase or renew a cross-border bandwidth package. Please contact online customer service or your business manager for consultation. | According to the laws and regulations of the operator and mainland China, you are currently not eligible to purchase or renew a cross-border bandwidth package. Please contact online customer service or your business manager for consultation. |
400 | OperationInvalid.IdentityRegistrationStatusNotSupport | Real name registration of enterprises required. | Since you have selected a certain region of "Mainland China" in the "Region" or "Opposite Region" , you must complete the enterprise real name registration before subscription. Please refer to the documentation on enterprise real name registration for details. |
400 | InvalidOperation.OnlyOneRegionSupportIpv6 | Peer Attachment is only allowed when both regions support IPv6 or do not support IPv6 at all. | Peer Attachment is only allowed when both regions support IPv6 or do not support IPv6 at all. |
400 | InvalidOperation | Operation is invalid. | The error message returned because the operation is invalid. |
400 | InvalidParameter | Invalid parameter. | The error message returned because the parameter is set to an invalid value. |
400 | Unauthorized | The AccessKeyId is unauthorized. | The error message returned because you do not have the permissions to perform this operation. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2024-06-11 | The Error code has changed | View Change Details |
2024-05-17 | The Error code has changed | View Change Details |
2023-12-20 | The Error code has changed | View Change Details |
2023-12-13 | The Error code has changed | View Change Details |
2023-12-06 | The Error code has changed. The request parameters of the API has changed | View Change Details |
2023-11-03 | The Error code has changed | View Change Details |
2023-10-18 | The Error code has changed. The request parameters of the API has changed | View Change Details |
2023-10-18 | The Error code has changed. The request parameters of the API has changed | View Change Details |
2023-01-04 | The Error code has changed | View Change Details |
2022-12-22 | The Error code has changed | View Change Details |