GrantInstanceToCen--云企业网-火山引擎

文档中心

立即注册

导航

GrantInstanceToCen

最近更新时间：2024.07.24 11:44:41首次发布时间：2022.04.28 07:28:31

调用 GrantInstanceToCen 接口，将本账号的网络实例授权给指定账号的云企业网实例。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数名称	类型	是否必选	示例值	描述
Action	String	是	GrantInstanceToCen	要执行的操作，取值为GrantInstanceToCen。
Version	String	是	2020-04-01	API版本信息，当前版本为2020-04-01。
InstanceRegionId	String	是	cn-beijing	网络实例所在的地域。
InstanceType	String	是	VPC	网络实例的类型，取值如下： VPC：私有网络。 DCGW：专线网关。
InstanceId	String	是	vpc-uf6o8d1dj8sjwxi6o****	待授权的网络实例的ID。您可以调用 DescribeVpcs 接口，查询“VPC”类型网络实例的ID。您可以调用 DescribeDirectConnectGateways 接口，查询“DCGW”类型网络实例的ID。
CenOwnerId	String	是	210000****	对方账号。您可以调用 DescribeCens 接口，查询账号ID。
CenId	String	是	cen-7qthudw0ll6jmc****	对方账号云企业网实例的ID。您可以调用 DescribeCens 接口，查询CEN实例ID。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

GET /?Action=GrantInstanceToCen&Version=2020-04-01&CenId=cen-7qthudw0ll6jmc****&CenOwnerId=210000****&InstanceId=vpc-uf6o8d1dj8sjwxi6o****&InstanceType=VPC&InstanceRegionId=cn-beijing HTTP/1.1
Host: open.volcengineapi.com
Service: cen
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202111161611080102121461940900****",
        "Action": "GrantInstanceToCen",
        "Version": "2020-04-01",
        "Service": "cen",
        "Region": "cn-beijing"
    },
    "Result": {}
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HttpCode	错误码	错误信息	描述
400	InvalidCenOwnerId.Malformed	The specified CenOwnerId is malformed.	指定的云企业网实例所属账号ID不合法。
400	InvalidCenAttachedInstance.Malformed	The specified instance type is malformed.	指定的网络实例类型不支持。
400	InvalidCenAttachedInstance.DcgwInvalidStatus	Specified direct connect gateway has been frozen.	指定的专线网关已经被冻结。
400	LimitExceeded.GrantVpcToCen	You've reached the limit on the number of CENs that a VPC can grant to.	已达到指定私有网络可授权的云企业网实例数量上限。
400	LimitExceeded.GrantDCGWToCen	You've reached the limit on the number of CENs that a DCGW can grant to.	已达到指定专线网关可授权的云企业网实例数量上限。
404	InvalidCen.NotFound	The specified CEN does not exist.	指定的云企业网实例不存在。
404	InvalidVpcId.NotFound	The specified VPC ID does not exist in this region.	指定的地域内该私有网络不存在。
404	InvalidDcgwId.NotFound	The specified DCGW ID does not exist in this region.	指定的地域内该专线网关不存在。
404	InvalidCenRegion.NotFound	The specified region does not exist.	指定的地域不存在。
409	InvalidCen.InvalidStatus	The specified CEN instance is not in the correct status for the request.	指定的云企业网实例所处的状态无法响应该请求，请稍后再试。
409	InvalidGrantInstance.Conflict	The specified instance has been granted.	指定的网络实例已完成授权。
409	InvalidGrantInstanceAccount.Conflict	The specified granted account is equal to the login account, please change the account to grant.	指定的授权账号与当前账号相同，请更换账号授权。