专线网关ECR（Express Connect Router）关联专有网络（VPC）或者转发路由器（TR）。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| expressconnectrouter:CreateExpressConnectRouterAssociation | create | *ExpressConnectRouter acs:expressconnectrouter::{#accountId}:expressconnectrouter/{#EcrId} |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| EcrId | string | 是 | 专线网关实例 ID。 | ecr-mezk2idmsd0vx2**** |
| AssociationRegionId | string | 是 | 关联资源所属的地域。 | cn-hangzhou |
| TransitRouterOwnerId | long | 否 | 转发路由器实例所属阿里云账号（主账号）ID。默认值为当前登录的阿里云账号 ID。 说明
如果您要加载跨账号的网络实例，本参数必填。
| 189159362009**** |
| TransitRouterId | string | 否 | 转发路由器 ID。 | tr-2ze4i71c6be454e2l**** |
| CenId | string | 否 | 云企业网实例 ID。 | cen-of3o1the3i4gwb**** |
| VpcOwnerId | long | 否 | VPC 实例所属阿里云账号（主账号）ID。默认为当前登录的阿里云账号 ID。 说明
如果您要加载跨账号的网络实例，本参数必填。
| 132193271328**** |
| VpcId | string | 否 | VPC 实例 ID。 | vpc-bp1h37fchc6jmfyln**** |
| AllowedPrefixes | array | 否 | 允许的前缀路由列表。 | |
| AllowedPrefixe | string | 否 | 允许的前缀路由。 | 192.0.20.0/24 |
| CreateAttachment | boolean | 否 | ECR 绑定 TR 时是否发起关联。取值：
| true |
| DryRun | boolean | 否 | 是否只预检此次请求。取值：
| false |
| ClientToken | string | 否 | 客户端 Token，用于保证请求的幂等性。 从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。 说明
若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。
| 02fb3da4-130e-11e9-8e44-00**** |
| AllowedPrefixesMode | string | 否 | 前缀路由模式，取值：
| MatchMode |
| Description | string | 否 | 关联资源的描述信息。 | test |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "05130E79-588D-5C40-A718-C4863A59****",
"Success": true,
"Code": "200",
"Message": "OK",
"HttpStatusCode": 200,
"DynamicCode": "IllegalParamFormat.EcrId\n",
"DynamicMessage": "The param format of EcrId **** is illegal.\n",
"AccessDeniedDetail": "Authentication is failed for ****\n",
"AssociationId": "ecr-assoc-9p2qxx5phpca2m****"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | IncorrectStatus.Ecr | Ecr Status does not allow current operation. | 专线网关实例状态不允许当前操作。目前有其它操作正在执行或者专线网关实例正在被删除，请求稍后再试 |
| 400 | OperationDenied.ForceDeleting | The current instance is being deleted. | 您当前操作被拒绝，专线网关实例正在被强制删除，请稍后再试 |
| 400 | UnsupportedRegion | Feature not supported in specified region. | 指定的地域当前不支持专线网关功能。 |
| 400 | QuotaExceeded.VpcCountPerEcr | The number of VPC bound to the ECR exceeds the quota. | 单个专线网关实例可绑定的VPC数量已达到配额上限，请联系您的商务经理申请更大的配额数量 |
| 400 | QuotaExceeded.TrCountPerEcr | The number of TR bound to the ECR exceeds the quota. | 单个专线网关实例可绑定的TR数量已达到配额上限，请联系您的商务经理申请更大的配额数量 |
| 400 | IllegalParamFormat.AllowedPrefixes | The prefix parameter format is invalid. Procedure. | 指定的前缀路由网段格式错误。 |
| 400 | OperationDenied.NotGrantedByNodeOwner | The node owner is not authorized. | 您当前操作被拒绝，专线网关产品未授权 |
| 400 | OperationFailed.CdtNotOpened | The Cdt function is disabled. | 当前操作失败，未开启阿里云数据传输功能 |
| 400 | OperationFailed.CdtCrossBoarderNotOpened | The Cdt cross-border transmission function is disabled. | 当前操作失败，未开启阿里云数据跨境传输功能 |
| 400 | OperationFailed.CrossBorderNotAllowed | There is no qualification for creating cross-border links. | 操作失败，当前企业不具备创建跨境链路权限，请联系您的商务经理添加此权限。 |
| 400 | ResourceNotFound.CenId | CenId not found. | Cen实例不存在 |
| 400 | ResourceNotFound.TrId | TRId not found. | TR实例不存在 |
| 400 | Conflict.ASNOfVBR | ASN already used by other VBR. | 当前VBR BgpGroup localAsn与ECR asn不一致，请调整一致后重新绑定。 |
| 400 | MissingParam.%s | The param of %s is missing. | 请求参数未填写，请核对对应的参数后重试。 |
| 400 | IllegalParamFormat.%s | The param format of %s is illegal. | 参数格式非法 |
| 400 | IllegalParamFormat.CenId | The format of the entered Cen instance ID is incorrect. | 当前输入的Cen实例ID格式不正确 |
| 400 | OperationDenied.CrossBidAssociating | Cross-border binding of resources is subject to compliance constraints. | 您当前的绑定资源涉及跨中国站点资源和海外站点资源互通，受限于合规约束请联系您的商务经理沟通处理。 |
| 400 | ExclusiveParam.TransitRouterIdAndVpcId | A private network instance cannot be bound to a forwarding router instance at the same time. | 专有网络实例与转发路由器实例无法同时绑定，请调整后选择其中一个实例进行绑定 |
| 400 | IllegalParamSize.AllowedPrefixes | The number of prefix routes exceeded the quota. | 您当前输入的前缀路由数量超过配额，请申请扩容。 |
| 400 | OperationDenied.CrossAccountAttaching | If the forwarding router is bound to another account, perform this operation on the same account. | 当前操作被拒绝，绑定其他账号转发路由器时，需在该账号做此操作 |
| 400 | OperationDenied.AttachmentInCurrentRegionExisted | Only one forwarding router can be bound to an area. | 当前操作被拒绝，专线网关实例在同一区域内只支持绑定一个转发路由器 |
| 400 | Conflict.Lock | There are other unfinished operations. | 您当前有其他未完成的操作，请稍后重试 |
| 400 | OperationFailed.CallingVpcYaochi | The system is abnormal. Please try again later. | 操作失败，系统内部异常，请稍后重试，若重试仍失败请联系您的商务经理获取帮助。 |
| 400 | ResourceAlreadyExist.TransitRouterId | The specified resource of transit router already exists. | 指定的 TR 资源已经关联到专线网关 ECR, 请核对后重试。 |
| 400 | ResourceAlreadyExist.VpcId | The specified resource of VpcId already exists. | 指定的 VPC 资源已经关联到专线网关 ECR, 请核对后重试。 |
| 404 | ResourceNotFound.EcrId | EcrId not found. | ECR实例不存在 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-11-01 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2024-10-17 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
| 2024-09-11 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
| 2024-06-28 | OpenAPI 描述信息更新、OpenAPI 错误码发生变更 | 查看变更详情 |
| 2024-03-28 | OpenAPI 错误码发生变更 | 查看变更详情 |