專線網關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 錯誤碼發生變更 | 查看變更詳情 |