调用 AssignIpv6Addresses 接口，为指定网卡（主网卡/辅助网卡）分配私网IPv6地址。
说明
IPv6功能正在邀测中，暂仅支持完成 企业认证 的账号申请试用，如需试用，请联系客户经理。
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | AssignIpv6Addresses | 要执行的操作，取值为AssignIpv6Addresses 。 |
| Version | String | 是 | 2020-04-01 | API版本信息，当前版本为2020-04-01。 |
NetworkInterfaceId | String | 是 | eni-bp1fg655nh68xyz9**** | 网卡的ID。 |
Ipv6AddressCount | Integer | 否 | 2 | 为网卡分配私网IPv6地址的数量。传入该参数系统会自动从网卡所属子网中，分配相应数量的空闲IP地址作为网卡的私网IPv6地址。 说明 参数 |
Ipv6Address.N | String | 否 | Ipv6Address.1=2408:4008:55b:XXXX:XXXX:922:96c4:e0&Ipv6Address.2=2408:4008:55b:XXXX:XXXX:5eb5:eadc:cda1 | 为网卡指定私网IPv6地址。
说明 参数 |
参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 0ED8D006-F706-4D23-88ED-E11ED28D**** | 请求ID。 |
| NetworkInterfaceId | String | eni-bp1fg655nh68xyz9**** | 网卡ID。 |
| Ipv6Set | Array | ["2408:4008:55b:XXXX:XXXX:922:96c4:e0","2408:4008:55b:XXXX:XXXX:5eb5:eadc:cda1"] | IPv6地址列表。 |
GET /?Action=AssignIpv6Addresses&Version=2020-04-01&NetworkInterfaceId=eni-bp1fg655nh68xyz9****&Ipv6AddressCount=2 HTTP/1.1 Host: open.volcengineapi.com Service: vpc Region: cn-beijing
{ "ResponseMetadata": { "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****", "Action": "AssignIpv6Addresses", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result": { "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****", "NetworkInterfaceId": "eni-bp1fg655nh68xyz9****", "Ipv6Set": [ "2408:4008:55b:XXXX:XXXX:922:96c4:e0", "2408:4008:55b:XXXX:XXXX:5eb5:eadc:cda1" ] } }
此处仅展示当前API的错误码，更多错误码请参见公共错误码。
HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InsufficientIpInSubnet | The specified subnet does not contain enough free private IP addresses to fulfill your request. | 指定子网下可用IP不足。 |
| 400 | InvalidEni.InvalidStatus | The specified elastic network interface is not in the correct status for the request. | 指定的弹性网卡所处的状态无法响应该请求。 |
| 400 | InvalidEni.InvalidType | The type of specified elastic network interface is illegal for the request. | 指定类型的弹性网卡无法响应该请求。 |
| 400 | InvalidEniIp.Malformed | The specified elastic network interface ip is malformed. If you are specifying an IP of an elastic network interface, ensure it must fall into the range of the CIDR block of the subnet to which the elastic network interface belongs to. | 指定的弹性网卡IP不合法。请确保网卡IP必须从属于所在子网的网段。 |
| 400 | InvalidInstance.InvalidStatus | The specified instance is not in the correct status for the request. | 指定的ECS实例所处的状态无法响应该请求。 |
| 400 | InvalidIpv6.Malformed | The specified IPv6 address is malformed. | 指定的IPv6地址不合法。 |
| 400 | InvalidParameter.EnableIpv6 | The EnableIpv6 parameter is currently not supported. | 当前不支持EnableIpv6请求参数。 |
| 400 | InvalidPrivateIp.Malformed | The specified private ip is malformed. | 指定的私网IP不合法。 |
| 400 | InvalidSubnet.DisableIpv6 | Specified subnet disable IPv6. | 子网尚未开启IPv6。 |
| 400 | LimitExceeded.Ipv6AddressesPerEni | You've reached the limit on the number of IPv6 addresses per ENI that you can assign. | 已达到网卡可分配的IPv6地址的数量上限。 |
| 400 | LimitExceeded.PrivateIpsPerEni | You've reached the limit on the number of private IPs per ENI that you can assign. | 已达到网卡可分配的辅助IP的数量上限。 |
| 400 | QuotaExceeded.SecurityGroupIp | The number of IP addresses bound to the security group exceeded quota. | 已达到安全组可绑定IP地址的数量上限。 |
| 403 | Forbidden | You are not authorized to perform operations on the specified elastic network interface. The specified elastic network interface is a service-managed elastic network interface. | 无权限对指定弹性网卡进行操作。指定的弹性网卡为云产品托管的弹性网卡。 |
| 404 | InvalidEniId.NotFound | The specified elastic network interface does not exist. | 指定的弹性网卡不存在。 |
| 409 | InvalidIpAddress.InUse | The specified IP address is in use. | 指定的IP地址已被占用。 |
| 409 | InvalidParameter.ParameterConflict | The parameters for IP address number and IP addresses cannot be specified at the same time. | 该请求不允许同时传入IP地址数量以及IP地址。 |