You need to enable JavaScript to run this app.
导航

AssignIpv6Addresses

最近更新时间2024.01.10 10:41:31

首次发布时间2023.03.03 08:08:42

调用 AssignIpv6Addresses 接口,为指定网卡(主网卡/辅助网卡)分配私网IPv6地址。

说明

IPv6功能正在邀测中,如需调用该接口,请提交工单或联系客户经理申请。

调试

请求参数

参数名称
类型
是否必选
示例值
描述
ActionStringAssignIpv6Addresses要执行的操作,取值为AssignIpv6Addresses 。
VersionString2020-04-01API版本信息,当前版本为2020-04-01。

NetworkInterfaceId

String

eni-bp1fg655nh68xyz9****

网卡的ID。
您可以调用 DescribeNetworkInterfaces 接口,查询网卡的ID。

Ipv6AddressCount

Integer

2

为网卡分配私网IPv6地址的数量。传入该参数系统会自动从网卡所属子网中,分配相应数量的空闲IP地址作为网卡的私网IPv6地址。

说明

参数Ipv6Address.NIpv6AddressCount二者必须传入且只能传入一个。

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的取值范围受到实例规格限制,更多详情请参见实例规格介绍
  • 多个私网IPv6地址之间用&分隔。
  • 指定的私网IPv6地址必须为网卡所属子网中的空闲私网IPv6地址。

说明

参数Ipv6Address.NIpv6AddressCount二者必须传入且只能传入一个。

返回数据

参数名称
类型
示例值
描述
RequestIdString0ED8D006-F706-4D23-88ED-E11ED28D****请求ID。
NetworkInterfaceIdStringeni-bp1fg655nh68xyz9****网卡ID。
Ipv6SetArray["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
ServiceName: 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
错误码
错误信息
描述
400InvalidEni.InvalidStatusThe specified elastic network interface is not in the correct status for the request.指定的弹性网卡所处的状态无法响应该请求。
400InvalidEni.InvalidTypeThe type of specified elastic network interface is illegal for the request.指定类型的弹性网卡无法响应该请求。
400InvalidEniIp.MalformedThe 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必须从属于所在子网的网段。
400InvalidInstance.InvalidStatusThe specified instance is not in the correct status for the request.指定的ECS实例所处的状态无法响应该请求。
400InvalidIpv6.MalformedThe specified IPv6 address is malformed.指定的IPv6地址不合法。
400InvalidParameter.EnableIpv6The EnableIpv6 parameter is currently not supported.当前不支持EnableIpv6请求参数。
400InvalidPrivateIp.MalformedThe specified private ip is malformed.指定的私网IP不合法。
400InvalidSubnet.DisableIpv6Specified subnet disable IPv6.子网尚未开启IPv6。
400LimitExceeded.Ipv6AddressesPerEniYou've reached the limit on the number of IPv6 addresses per ENI that you can assign.已达到网卡可分配的IPv6地址的数量上限。
400LimitExceeded.PrivateIpsPerEniYou've reached the limit on the number of private IPs per ENI that you can assign.已达到网卡可分配的辅助IP的数量上限。
400QuotaExceeded.SecurityGroupIpThe number of IP addresses bound to the security group exceeded quota.已达到安全组可绑定IP地址的数量上限。
403ForbiddenYou are not authorized to perform operations on the specified elastic network interface. The specified elastic network interface is a service-managed elastic network interface.无权限对指定弹性网卡进行操作。指定的弹性网卡为云产品托管的弹性网卡。
404InvalidEniId.NotFoundThe specified elastic network interface does not exist.指定的弹性网卡不存在。
409InvalidIpAddress.InUseThe specified IP address is in use.指定的IP地址已被占用。
409InvalidParameter.ParameterConflictThe parameters for IP address number and IP addresses cannot be specified at the same time.该请求不允许同时传入IP地址数量以及IP地址。