AttachCenChildInstance - 将网络实例加载到云企业网实例中

调用AttachCenChildInstance接口将网络实例加载到云企业网实例中。

接口说明

云企业网支持加载跨账号的网络实例,在加载跨账号的网络实例前,云企业网实例需要先获得跨账号的网络实例授权:

  • 跨账号专有网络实例授权,请参见 GrantInstanceToCen
  • 跨账号云连接网实例授权,请参见 GrantInstanceToCbn
  • 跨账号边界路由器实例授权功能默认不开放,如需使用,请联系客户经理申请。

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
CenIdstring

云企业网实例的 ID。

cen-7qthudw0ll6jmc****
ChildInstanceIdstring

指定待加载的网络实例的 ID。

vpc-bp18sth14qii3pnvx****
ChildInstanceTypestring

网络实例的类型,取值:

  • VPC:专有网络。

  • VBR:边界路由器。

  • CCN:云连接网。

VPC
ChildInstanceRegionIdstring

网络实例所在的地域。

您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-hangzhou
ChildInstanceOwnerIdlong

网络实例所属的阿里云账号 ID(主账号)。

说明 如果您要加载跨账号的网络实例,本参数必填。
1688000000000000

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

A278B8A6-A5B8-4FDE-9F70-95F0F6A1D68A

示例

正常返回示例

JSON格式

{
  "RequestId": "A278B8A6-A5B8-4FDE-9F70-95F0F6A1D68A"
}

错误码

HTTP status code错误码错误信息描述
400Forbbiden.AttachChildInstanceAcrossBidOperation is invalid, please apply for cross-bid attaching.-
400IncorrectStatus.VpcSwitchOperation is failed because some virtual switch is modifying within the same VPC.当前Vswitch的状态不支持该操作,请稍后重试。
400Forbbiden.CloudBoxVSwitchExistThe operation is not allowed because of cloud box vswitch existed.存在云盒的vswitch,无法绑定
400OperationFailed.InvalidVpcStatusOperation is failed because the child-instance is configuring.-
400OperationFailed.InvalidTransitRouterOperation failed because the transit router is not supported.由于转发路由表不支持该操作,该操作失败.
400OperationUnsupported.CenFullLevelCEN full level does not support vpn bgp.Full模式的CEN不支持VPN Bpg。
400IncorrectStatus.VpcRouteTableThe VPC route table is not in a desired state.该操作相关的VPC路由表不处于稳态,无法操作,请稍后重试。
400InvalidOperation.VbrAttachedToEcrVBR has alreay attached to ECR.VBR已经绑定了ECR。
400OperationUnsupported.VpcRoutePropagationSourceThe operation on this VPC route propagation source is not supported.不支持对此VPC路由传播源的操作。
400InvalidStatus.ResourceStatusThe resource is not in a valid state for the attachment operation.当前资源状态不支持该操作,请稍后重试。
400IncorrectStatus.TransitRouterThe status of TransitRouter is incorrect.当前TransitRouter的状态不支持该操作,请稍后重试。
400InvalidParameterInvalid parameter.参数不合法。
400UnauthorizedThe AccessKeyId is unauthorized.账号无权限操作。
403Forbidden.AttachChildInstanceThe attached VBR on some access device models are not supported. Please submit a ticket to continue using this VBR on CEN.该VBR无法加载到云企业网中,请提交工单进行处理。
404Bid.NotFoundNot found childInstance Bid by specified AliUid.bid不存在。
404Operation.FailedAndTryAgainFail to get customer label by the specified aliUid.-
409InvalidOperation.ChildInstanceRIAlreadyExistOperation is invalid because the child-instance has already been attached to Express Connect.-
409Forbbiden.AttachChildInstanceAcrossUidOperation is invalid because the child-instance is not authorized to CEN.加载失败,请先在对应网络实例中对该CEN授权,再尝试加载。
409InvalidOperation.ChildInstanceAlreadyAttachedOperation is invalid because the child-instance has already been attached to another CEN.操作失败,该网络实例已被加载到其他云企业网中。
409InvalidOperation.CenAlreadyAutoPubilshRouteToInstanceOperation is invalid because other cen has already auto published route to this instance.存在其他Cen向该实例传播路由,无法支持当前操作。

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

变更历史

变更时间变更内容概要操作
2024-07-10OpenAPI 错误码发生变更查看变更详情
2023-03-15OpenAPI 错误码发生变更查看变更详情