調用AttachCenChildInstance接口將網絡實例加載到云企業網實例中。
接口說明
云企業網支持加載跨賬號的網絡實例，在加載跨賬號的網絡實例前，云企業網實例需要先獲得跨賬號的網絡實例授權：
- 跨賬號專有網絡實例授權，請參見 GrantInstanceToCen 。
- 跨賬號云連接網實例授權，請參見 GrantInstanceToCbn 。
- 跨賬號邊界路由器實例授權功能默認不開放，如需使用，請聯系客戶經理申請。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| cen:AttachCenChildInstance | update | *CenInstance acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}*virtualborderrouter acs:vpc:*:{#accountId}:virtualborderrouter/{#virtualborderrouterId}*VPC acs:vpc:*:{#accountId}:vpc/{#vpcId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| CenId | string | 是 | 云企業網實例的 ID。 | cen-7qthudw0ll6jmc**** |
| ChildInstanceId | string | 是 | 指定待加載的網絡實例的 ID。 | vpc-bp18sth14qii3pnvx**** |
| ChildInstanceType | string | 是 | 網絡實例的類型，取值：
| VPC |
| ChildInstanceRegionId | string | 是 | 網絡實例所在的地域。 您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-hangzhou |
| ChildInstanceOwnerId | long | 否 | 網絡實例所屬的阿里云賬號 ID（主賬號）。 說明
如果您要加載跨賬號的網絡實例，本參數必填。
| 1688000000000000 |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "A278B8A6-A5B8-4FDE-9F70-95F0F6A1D68A"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | Forbbiden.AttachChildInstanceAcrossBid | Operation is invalid, please apply for cross-bid attaching. | - |
| 400 | IncorrectStatus.VpcSwitch | Operation is failed because some virtual switch is modifying within the same VPC. | 當前Vswitch的狀態不支持該操作，請稍后重試。 |
| 400 | Forbbiden.CloudBoxVSwitchExist | The operation is not allowed because of cloud box vswitch existed. | 存在云盒的vswitch，無法綁定 |
| 400 | OperationFailed.InvalidVpcStatus | Operation is failed because the child-instance is configuring. | - |
| 400 | OperationFailed.InvalidTransitRouter | Operation failed because the transit router is not supported. | 由于轉發路由表不支持該操作，該操作失敗. |
| 400 | OperationUnsupported.CenFullLevel | CEN full level does not support vpn bgp. | Full模式的CEN不支持VPN Bpg。 |
| 400 | IncorrectStatus.VpcRouteTable | The VPC route table is not in a desired state. | 該操作相關的VPC路由表不處于穩態，無法操作，請稍后重試。 |
| 400 | InvalidOperation.VbrAttachedToEcr | VBR has alreay attached to ECR. | VBR已經綁定了ECR。 |
| 400 | OperationUnsupported.VpcRoutePropagationSource | The operation on this VPC route propagation source is not supported. | 不支持對此VPC路由傳播源的操作。 |
| 400 | InvalidStatus.ResourceStatus | The resource is not in a valid state for the attachment operation. | 當前資源狀態不支持該操作，請稍后重試。 |
| 400 | IncorrectStatus.TransitRouter | The status of TransitRouter is incorrect. | 當前TransitRouter的狀態不支持該操作，請稍后重試。 |
| 400 | IllegalParam.RegionId | The specified RegionId is illegal. | 參數中指定的Region不合法。 |
| 400 | InvalidParameter | Invalid parameter. | 參數不合法。 |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | 賬號無權限操作。 |
| 403 | Forbidden.AttachChildInstance | The attached VBR on some access device models are not supported. Please submit a ticket to continue using this VBR on CEN. | 該VBR無法加載到云企業網中，請提交工單進行處理。 |
| 404 | Bid.NotFound | Not found childInstance Bid by specified AliUid. | bid不存在。 |
| 404 | Operation.FailedAndTryAgain | Fail to get customer label by the specified aliUid. | - |
| 409 | InvalidOperation.ChildInstanceRIAlreadyExist | Operation is invalid because the child-instance has already been attached to Express Connect. | - |
| 409 | Forbbiden.AttachChildInstanceAcrossUid | Operation is invalid because the child-instance is not authorized to CEN. | 加載失敗，請先在對應網絡實例中對該CEN授權，再嘗試加載。 |
| 409 | InvalidOperation.ChildInstanceAlreadyAttached | Operation is invalid because the child-instance has already been attached to another CEN. | 操作失敗，該網絡實例已被加載到其他云企業網中。 |
| 409 | InvalidOperation.CenAlreadyAutoPubilshRouteToInstance | Operation is invalid because other cen has already auto published route to this instance. | 存在其他Cen向該實例傳播路由，無法支持當前操作。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-07-10 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-03-15 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |