云服务器 ECS：AssignIpv6Addresses

接口说明

您可以指定弹性网卡所属交换机下CIDR的IPv6地址，也可以指定IPv6地址数量自动创建IPv6地址。您需要注意：

• 弹性网卡所属的交换机必须开通了IPv6。更多信息，请参见为已有交换机开通IPv6网段。
• 弹性网卡必须处于可用（Available）或已附加（InUse）状态。
• 操作主网卡时，网卡附加的实例必须处于运行中（Running）或已停止（Stopped）状态。
• 单个网卡能够分配的IPv6地址数量和网卡附加的实例规格有关。
  • 如果弹性网卡处于可用（Available）状态，最多可以分配10个IPv6地址。
  • 如果弹性网卡附加到实例上，能够分配的IPv6地址数将受到实例规格限制。更多信息，请参见实例规格族。
• 成功调用该接口后，您可以从返回结果中获取已分配的IPv6地址信息。

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=AssignIpv6Addresses
&NetworkInterfaceId=eni-bp1iqejowblx6h8j****
&RegionId=cn-hangzhou
&Ipv6Address.1=2001:db8:1234:1a00::****
&Ipv6Address.2=2001:db8:1234:1a01::****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<AssignIpv6AddressesResponse>
    <Ipv6Sets>
        <Ipv6Address>2001:db8:1234:1a00::****</Ipv6Address>
        <Ipv6Address>2001:db8:1234:1a01::****</Ipv6Address>
    </Ipv6Sets>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <NetworkInterfaceId>eni-bp1iqejowblx6h8j****</NetworkInterfaceId>
</AssignIpv6AddressesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Ipv6Sets" : {
    "Ipv6Address" : [ "2001:db8:1234:1a00::****", "2001:db8:1234:1a01::****" ]
  },
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "NetworkInterfaceId" : "eni-bp1iqejowblx6h8j****"
}

错误码

访问错误中心查看更多错误码。