弹性网卡退还内网 IP

最近更新时间:2019-08-09 15:13:37

我的收藏

1. 接口描述

本接口(UnassignPrivateIpAddresses)用于弹性网卡退还内网 IP。 接口请求域名:vpc.api.qcloud.com
退还弹性网卡上的辅助内网 IP,接口自动解关联弹性公网 IP。不能退还弹性网卡的主辅助内网 IP。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 UnassignPrivateIpAddresses。
参数名称
必选
类型
描述
vpcId
String
弹性网卡对应的私用网络 ID,例如 vpc-7t9nf3pu
networkInterfaceId
String
弹性网卡 ID,例如 eni-m6dyj72l
privateIpAddress.n
Array
要退换的辅助内网 IP 地址数组,例如 privateIpAddress.0=10.0.0.2

3. 输出参数

参数名称
类型
描述
code
Int
错误码。0: 成功, 其他值: 失败
message
String
错误信息
taskId
Int
任务 ID,操作结果可以用 taskId 查询,详见 查询任务执行结果接口

4. 错误码表

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见 VPC 错误码
错误码
描述
InvalidVpc.NotFound
无效的 VPC,VPC 资源不存在。请再次核实您输入的资源信息是否正确,可通过 DescribeVpcEx 接口查询 VPC
InvalidNetworkInterface.NotFound
无效的弹性网卡,弹性网卡资源不存在。请再次核实您输入的资源信息是否正确,可通过 DescribeNetworkInterfaces 接口查询弹性网卡
InvalidPrivateip.IsPrimary
主 IP 不能解绑

5. 示例

输入
https://vpc.api.qcloud.com/v2/index.php?Action=UnassignPrivateIpAddresses
&<公共请求参数>
&vpcId=vpc-7t9nf3pu
&networkInterfaceId=eni-m6dyj72l
&privateIpAddress.0=10.0.0.2
输出
{
"code": 0,
"message": "",
"codeDesc": "Success",
"data":
{
"taskId": 16284
}
}