AI 助理
备案控制台
文档
输入文档关键字查找
首页 高速通道 开发参考 API参考（专线网关） API目录 CreateExpressConnectRouterAssociation - 专线网关（ECR）关联资源

CreateExpressConnectRouterAssociation - 专线网关（ECR）关联资源

更新时间：
产品详情
相关技术圈
我的收藏

专线网关ECR（Express Connect Router）关联专有网络（VPC）或者转发路由器（TR）。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
expressconnectrouter:CreateExpressConnectRouterAssociationcreate
  • ExpressConnectRouter
    acs:expressconnectrouter::{#accountId}:expressconnectrouter/{#EcrId}
    无
无

请求参数

名称类型必填描述示例值
EcrIdstring是

专线网关实例 ID。

ecr-mezk2idmsd0vx2****
AssociationRegionIdstring是

关联资源所属的地域。

cn-hangzhou
TransitRouterOwnerIdlong否

转发路由器实例所属阿里云账号（主账号）ID。默认值为当前登录的阿里云账号 ID。

说明 如果您要加载跨账号的网络实例，本参数必填。
189159362009****
TransitRouterIdstring否

转发路由器 ID。

tr-2ze4i71c6be454e2l****
CenIdstring否

云企业网实例 ID。

cen-of3o1the3i4gwb****
VpcOwnerIdlong否

VPC 实例所属阿里云账号（主账号）ID。默认为当前登录的阿里云账号 ID。

说明 如果您要加载跨账号的网络实例，本参数必填。
132193271328****
VpcIdstring否

VPC 实例 ID。

vpc-bp1h37fchc6jmfyln****
AllowedPrefixesarray否

允许的前缀路由列表。

AllowedPrefixestring否

允许的前缀路由。

192.0.20.**/**
CreateAttachmentboolean否

ECR 绑定 TR 时是否发起关联。取值：

  • true：不需要在转发路由器侧发起关联。
  • false：需要在转发路由器侧发起关联。
true
DryRunboolean否

是否只预检此次请求。取值：

  • true：发送检查请求，不会修改服务资源。

  • false（默认值）：发送正常请求。

false
ClientTokenstring否

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

从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

说明 若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。
02fb3da4-130e-11e9-8e44-00****

返回参数

名称类型描述示例值
object

RpcResponse

RequestIdstring

请求 ID。

05130E79-588D-5C40-A718-C4863A59****
Successboolean

是否调用成功。取值：

  • True：成功。
  • False：失败。
True
Codestring

判断调用是否成功。返回值为 200 表示加载成功，返回其他值表示加载失败，失败原因参见错误码。

200
Messagestring

操作返回信息。

OK
HttpStatusCodeinteger

HTTP 状态码。

200
DynamicCodestring

动态错误码。

IllegalParamFormat.EcrId
DynamicMessagestring

动态错误信息，用于替换返回参数 ErrMessage 错误信息中的%s。

说明 如果 ErrMessage 返回The Value of Input Parameter %s is not valid，且 DynamicMessage 返回 DtsJobId，则表示所传入的请求参数 DtsJobId 不合法。
The param format of EcrId **** is illegal.
AccessDeniedDetailstring

访问被拒绝详细信息。

Authentication is failed for ****
AssociationIdstring

专线网关与 VPC 或 TR 的关联 ID。

ecr-assoc-9p2qxx5phpca2m****

示例

正常返回示例

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错误码错误信息描述
400IncorrectStatus.EcrEcr Status does not allow current operation.专线网关实例状态不允许当前操作。目前有其它操作正在执行或者专线网关实例正在被删除，请求稍后再试
400OperationDenied.ForceDeletingThe current instance is being deleted.您当前操作被拒绝，专线网关实例正在被强制删除，请稍后再试
400UnsupportedRegionFeature not supported in specified region.指定的地域当前不支持专线网关功能。
400QuotaExceeded.VpcCountPerEcrThe number of VPC bound to the ECR exceeds the quota.单个专线网关实例可绑定的VPC数量已达到配额上限，请联系您的商务经理申请更大的配额数量
400QuotaExceeded.TrCountPerEcrThe number of TR bound to the ECR exceeds the quota.单个专线网关实例可绑定的TR数量已达到配额上限，请联系您的商务经理申请更大的配额数量
400IllegalParamFormat.AllowedPrefixesThe prefix parameter format is invalid. Procedure.指定的前缀路由网段格式错误。
400OperationDenied.NotGrantedByNodeOwnerThe node owner is not authorized.您当前操作被拒绝，专线网关产品未授权
400OperationFailed.CdtNotOpenedThe Cdt function is disabled.当前操作失败，未开启阿里云数据传输功能
400OperationFailed.CdtCrossBoarderNotOpenedThe Cdt cross-border transmission function is disabled.当前操作失败，未开启阿里云数据跨境传输功能
400OperationFailed.CrossBorderNotAllowedThere is no qualification for creating cross-border links.操作失败，当前企业不具备创建跨境链路权限，请联系您的商务经理添加此权限。
400ResourceNotFound.CenIdCenId not found.Cen实例不存在
400ResourceNotFound.TrIdTRId not found.TR实例不存在
400Conflict.ASNOfVBRASN already used by other VBR.当前VBR BgpGroup localAsn与ECR asn不一致，请调整一致后重新绑定。
400MissingParam.%sThe param of %s is missing.请求参数未填写，请核对对应的参数后重试。
400IllegalParamFormat.%sThe param format of %s is illegal.参数格式非法
400IllegalParamFormat.CenIdThe format of the entered Cen instance ID is incorrect.当前输入的Cen实例ID格式不正确
400OperationDenied.CrossBidAssociatingCross-border binding of resources is subject to compliance constraints.您当前的绑定资源涉及跨中国站点资源和海外站点资源互通，受限于合规约束请联系您的商务经理沟通处理。
400ExclusiveParam.TransitRouterIdAndVpcIdA private network instance cannot be bound to a forwarding router instance at the same time.专有网络实例与转发路由器实例无法同时绑定，请调整后选择其中一个实例进行绑定
400IllegalParamSize.AllowedPrefixesThe number of prefix routes exceeded the quota.您当前输入的前缀路由数量超过配额，请申请扩容。
400OperationDenied.CrossAccountAttachingIf the forwarding router is bound to another account, perform this operation on the same account.当前操作被拒绝，绑定其他账号转发路由器时，需在该账号做此操作
400OperationDenied.AttachmentInCurrentRegionExistedOnly one forwarding router can be bound to an area.当前操作被拒绝，专线网关实例在同一区域内只支持绑定一个转发路由器
400Conflict.LockThere are other unfinished operations.您当前有其他未完成的操作，请稍后重试
400OperationFailed.CallingVpcYaochiThe system is abnormal. Please try again later. 操作失败，系统内部异常，请稍后重试，若重试仍失败请联系您的商务经理获取帮助。
400ResourceAlreadyExist.TransitRouterIdThe specified resource of transit router already exists.指定的 TR 资源已经关联到专线网关 ECR, 请核对后重试。
400ResourceAlreadyExist.VpcIdThe specified resource of VpcId already exists.指定的 VPC 资源已经关联到专线网关 ECR, 请核对后重试。
404ResourceNotFound.EcrIdEcrId not found.ECR实例不存在

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-10-17OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
2024-09-11OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
2024-06-28OpenAPI 描述信息更新、OpenAPI 错误码发生变更查看变更详情
2024-03-28OpenAPI 错误码发生变更查看变更详情
上一篇：DescribeExpressConnectRouterRouteEntries - 查询专线网关（ECR）的路由条目下一篇：CreateExpressConnectRouter - 新建专线网关（ECR）
文档推荐