1. 接口描述
本接口(AttachClassicLinkVpc)用于私有网络和基础网络设备互通。
接口请求域名:vpc.api.qcloud.com
1) 私有网络和基础网络设备必须在同一个地域。
2) 私有网络和基础网络的区别详见 VPC 产品文档-管理基础网络。
2. 输入参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。其中,此接口的 Action 字段为 AttachClassicLinkVpc。
参数名称 | 是否必选 | 类型 | 描述 |
---|---|---|---|
vpcId | 是 | String | 系统分配的私有网络 ID,支持升级前的 vpcId,也支持升级后的 unVpcId,例如:vpc-dgd44d。 |
instanceIds.n | 是 | Array | 基础网络云服务器 ID,例如:instanceIds.0=ins-5d8a23rs,可通过云 API 接口 DescribeInstances查询。 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
code | Int | 公共错误码, 0表示成功,其他值表示失败。详见错误码页面的 公共错误码 。 |
message | String | 模块错误信息描述,与接口相关。 |
taskId | Int | 任务 ID,操作结果可以用 taskId 查询,详见 查询任务执行结果接口。 |
4. 错误码表
以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见 VPC 错误码。
错误码 | 描述 |
---|---|
InvalidInstance.NotFound | 云服务器不存在,请核实您填写的 instanceId 是否正确,查询 VPC 下云服务器详见 查看云服务器实例列表。 |
InvalidVpc.NotFound | 无效的 VPC,VPC 资源不存在,请再次核实您输入的资源信息是否正确。 |
InstanceLimitExceeded | 指定区域 VPC 与基础网络互通设备数量已到上限,如果需要绑定更多基础网络设备,请联系客服申请。更多VPC资源限制信息详见 VPC 使用限制。 |
InvalidVpc.NotFound | 无效的 VPC。VPC 资源不存在,请再次核实您输入的资源信息是否正确。 |
InstanceAlreadyLinked | 基础网络云服务器已经绑定到另一个 VPC,一个基础网络云服务器只能和一个 VPC 互通,更多vpc资源限制信息详见 VPC 使用限制。 |
5. 示例
输入
https://vpc.api.qcloud.com/v2/index.php?Action=AttachClassicLinkVpc &<公共请求参数> &vpcId=vpc-2ari9m7h &instanceIds.0=ins-df454d
输出
{
"code": 0,
"message": "",
"taskId":135254
}