弹性网卡申请内网 IP
最近更新时间: 2024-10-18 10:38:45
1. 接口描述
接口请求域名： vpc.api3.fincloud.tencent.cn。
本接口（AssignPrivateIpAddresses）用于弹性网卡申请内网 IP。
- 一个弹性网卡支持绑定的IP地址是有限制的，更多资源限制信息详见弹性网卡使用限制。
- 可以指定内网IP地址申请，内网IP地址类型不能为主IP，主IP已存在，不能修改，内网IP必须要弹性网卡所在子网内，而且不能被占用。
- 在弹性网卡上申请一个到多个辅助内网IP，接口会在弹性网卡所在子网网段内返回指定数量的辅助内网IP。
默认接口请求频率限制：100次/秒。
接口更新时间：2020-03-30 20:53:40。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：AssignPrivateIpAddresses |
| Version | 是 | 否 | String | 公共参数，本接口取值：2017-03-12 |
| Region | 是 | 否 | String | 公共参数，详见产品支持的地域列表(TODO) |
| NetworkInterfaceId | 是 | 否 | String | 弹性网卡实例ID，例如：eni-m6dyj72l。 |
| PrivateIpAddresses | 否 | 否 | Array of PrivateIpAddressSpecification | 指定的内网IP信息，单次最多指定10个。与SecondaryPrivateIpAddressCount至少提供一个。 |
| SecondaryPrivateIpAddressCount | 否 | 否 | Uint64 | 新申请的内网IP地址个数，与PrivateIpAddresses至少提供一个。内网IP地址个数总和不能超过配额数，详见<a href="/document/product/576/18527">弹性网卡使用限制</a>。 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| PrivateIpAddressSet | PrivateIpAddressSpecification | 此参数对外不可见。 内网IP详细信息。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidParameterValue.Malformed | |
| ResourceNotFound | |
| ResourceInsufficient |