调用 AssignIpv6Addresses 接口，为指定网卡（主网卡/辅助网卡）分配私网IPv6地址。 :::tip IPv6功能正在邀测中，暂仅支持完成 [企业认证](https://www.volcengine.com/docs/6261/64937) 的账号申请试用，如需试用，请联系客户经理。 ::: ## 调试 ## 请求参数 |参数名称 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Action |String |是 |AssignIpv6Addresses |要执行的操作，取值为AssignIpv6Addresses 。 | |Version |String |是 |2020\-04\-01 |API版本信息，当前版本为2020\-04\-01。 | |NetworkInterfaceId |String |是 |eni\-bp1fg655nh68xyz9\*\*\*\* |网卡的ID。|\ | | | | |您可以调用 [DescribeNetworkInterfaces](https://www.volcengine.com/docs/6401/70761) 接口，查询网卡的ID。 | |Ipv6AddressCount |Integer |否 |2 |为网卡分配私网IPv6地址的数量。传入该参数系统会自动从网卡所属子网中，分配相应数量的空闲IP地址作为网卡的私网IPv6地址。|\ | | | | |:::tip|\ | | | | |参数`Ipv6Address.N`和`Ipv6AddressCount`二者必须传入且只能传入一个。|\ | | | | ||\ | | | | |:::| |Ipv6Address.N |String |否 |Ipv6Address.1=2408:4008:55b:XXXX:XXXX:922:96c4:e0&Ipv6Address.2=2408:4008:55b:XXXX:XXXX:5eb5:eadc:cda1 |为网卡指定私网IPv6地址。|\ | | | | ||\ | | | | |* 参数 \- N：表示私网IPv6地址的序号，取值范围由网卡状态决定。|\ | | | | | * 当网卡处于未挂载（Available）状态时，取值范围为1~10。|\ | | | | | * 当网卡处于已挂载（InUse）状态时，N的取值范围受到实例规格限制，更多详情请参见[实例规格介绍](https://www.volcengine.com/docs/6396/70840)。|\ | | | | |* 多个私网IPv6地址之间用&分隔。|\ | | | | |* 指定的私网IPv6地址必须为网卡所属子网中的空闲私网IPv6地址。|\ | | | | ||\ | | | | |:::tip|\ | | | | |参数`Ipv6Address.N`和`Ipv6AddressCount`二者必须传入且只能传入一个。|\ | | | | ||\ | | | | |:::| ## 返回数据 |参数名称 |类型 |示例值 |描述 | |---|---|---|---| |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地址列表。 | ## 请求示例 ```Plain Text GET /?Action=AssignIpv6Addresses&Version=2020-04-01&NetworkInterfaceId=eni-bp1fg655nh68xyz9****&Ipv6AddressCount=2 HTTP/1.1 Host: open.volcengineapi.com Service: vpc Region: cn-beijing ``` ## 返回示例 ```Plain Text { "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的错误码，更多错误码请参见[公共错误码](https://www.volcengine.com/docs/6401/70814)。 |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地址。 |

私有网络