AssignIpv6Addresses - Elastic Compute Service

為彈性網路介面分配一個或多個 IPv6 位址。

介面說明

您可以指定彈性網路介面所屬交換機下 CIDR 的 IPv6 位址，也可以指定 IPv6 位址數量自動建立 IPv6 位址。您需要注意：

彈性網路介面所屬的交換機必須開通了 IPv6。更多資訊，請參見為已有交換機開通 IPv6 網段。
彈性網路介面必須處於可用（Available）或已附加（InUse）狀態。
操作主網路卡時，網路卡附加的執行個體必須處於執行中（Running）或已停止（Stopped）狀態。
單個網路卡能夠分配的 IPv6 位址數量和網路卡附加的執行個體規格有關。
- 如果彈性網路介面處於可用（Available）狀態，最多可以分配 10 個 IPv6 位址。
- 如果彈性網路介面附加到執行個體上，能夠分配的 IPv6 位址數將受到執行個體規格限制。更多資訊，請參見執行個體規格族。
成功呼叫該介面後，您可以從返回結果中取得已分配的 IPv6 位址資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ecs:AssignIpv6Addresses

create

*NetworkInterface

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	彈性網路介面所在地域的 ID。您可以呼叫 DescribeRegions 查看最新的阿里雲地域列表。	cn-hangzhou
NetworkInterfaceId	string	是	彈性網路介面 ID。	eni-bp1iqejowblx6h8j****
Ipv6AddressCount	integer	否	為彈性網路介面指定隨機產生的 IPv6 位址數量。取值範圍：1~10。說明呼叫該介面時，您必須設定 `Ipv6Addresses.N` 參數或者 `Ipv6AddressCount` 參數的其中一個，但不能同時設定這兩個參數。	1
Ipv6Address	array	否	為彈性網路介面指定一個或多個 IPv6 位址。支援設定最多 10 個 IPv6 位址，即 N 的取值範圍：1~10。取值示例：Ipv6Address.1=2001:db8:1234:1a00::**** 說明呼叫該介面時，您必須設定 `Ipv6Addresses.N` 參數或者 `Ipv6AddressCount` 參數的其中一個，但不能同時設定這兩個參數。	2001:db8:1234:1a00::****
	string	否	為彈性網路介面指定一個或多個 IPv6 位址。支援設定最多 10 個 IPv6 位址，即 N 的取值範圍：1~10。取值示例：Ipv6Address.1=2001:db8:1234:1a00::**** 說明呼叫該介面時，您必須設定 `Ipv6Addresses.N` 參數或者 `Ipv6AddressCount` 參數的其中一個，但不能同時設定這兩個參數。	2001:db8:1234:1a00::****
Ipv6Prefix	array	否	為彈性網路介面指定一個或多個 IPv6 前綴。N 的取值範圍：1~10。說明如果您需要為彈性網路介面設定 IPv6 前綴，則必須設定 Ipv6Prefix.N 或者 Ipv6PrefixCount 的其中一個，但不能同時設定這兩個參數。
	string	否	為彈性網路介面指定一個或多個 IPv6 前綴。N 的取值範圍：1~10。說明如果您需要為彈性網路介面設定 IPv6 前綴，則必須設定 Ipv6Prefix.N 或者 Ipv6PrefixCount 的其中一個，但不能同時設定這兩個參數。	2001:db8:1234:1a00:****::/80
Ipv6PrefixCount	integer	否	為彈性網路介面指定一個或多個 IPv6 前綴。取值範圍：1~10。說明如果您需要為彈性網路介面設定 IPv6 前綴，則必須設定 Ipv6Prefix.N 或者 Ipv6PrefixCount 的其中一個，但不能同時設定這兩個參數。	1
ClientToken	string	否	保證請求冪等性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元，且不能超過 64 個字元。更多資訊，請參見如何保證冪等性。	123e4567-e89b-12d3-a456-426655440000

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
NetworkInterfaceId	string	彈性網路介面 ID。	eni-bp1iqejowblx6h8j****
Ipv6Sets	object
Ipv6Address	array	彈性網路介面已分配的 IPv6 位址。
	string	彈性網路介面已分配的 IPv6 位址。	2001:db8:1234:1a00::****
Ipv6PrefixSets	object
Ipv6Prefix	array	彈性網路介面已分配的 IPv6 前綴集合。
	string	彈性網路介面已分配的 IPv6 前綴。	2001:db8:1234:1a00:****::/80

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
400	UnsupportedParameter	%s
400	InvalidParameter	%s
400	InvalidInstanceID.Malformed	%s
400	MissingParameter	%s
400	InValidParameter	%s
400	InvalidParams.EniId	%s
400	InvalidOperation.InvalidEcsState	%s
400	InvalidOperation.InvalidEniState	%s
400	InvalidPrivateIpAddress.Duplicated	Specified private IP address is duplicated.
400	IncorrectVSwitchStatus	The current status of vSwitch does not support this operation.
400	InvalidParameter.Conflict	%s
400	InvalidOperation.EniOperationConflict	The previous ENI operation is still in progress. Please try again later.
500	InvalidOperation.RegionNotSupportIpPrefix	The current region does not support ip prefix.
403	InvalidUserType.NotSupported	%s
403	Abs.InvalidAccount.NotFound	%s
403	MissingParameter	%s
403	Forbedden.NotSupportRAM	%s
403	Forbbiden.SubUser	%s
403	InvalidOperation.InvalidEniType	%s
403	MaxEniIpv6IpsCountExceeded	%s
403	InvalidIp.IpUnassigned	%s
403	InvalidIp.IpRepeated	%s
403	InvalidIp.IpAssigned	%s
403	InvalidIp.Address	%s
403	InvalidOperation.EniCountExceeded	%s
403	InvalidOperation.Ipv4CountExceeded	%s
403	InvalidOperation.Ipv6CountExceeded	%s
403	InvalidOperation.Ipv6NotSupport	%s
403	InvalidOperation.Ipv4NotSupport	%s
403	InvalidVSwitch.Ipv6NotTurnOn	%s
403	InvalidParam.IpAssign	%s
403	InvalidVSwitchId.IpInvalid	%s
403	Forbidden.RegionId	%s
403	InvalidOperation.EniServiceManaged	%s
403	SecurityGroupInstanceLimitExceed	%s
403	InvalidOperation.HighPerformanceTrafficModeEniNotSupport	%s
403	InvalidOperation.EniTypeNotSupport	The member eni does not support ipv6.
403	InvalidIp.IpPrefixIllegal	The ip prefixes %s is/are illegal.
403	InvalidIp.IpPrefixMaskIllegal	The ip prefix mask is illegal.
403	InvalidIp.IpPrefixMaskInvalid	The ip prefixes mask %s is illegal which must be between %s and %s.
403	InvalidIp.IpPrefixMaskNotSame	The ip prefixes %s are illegal which mask must be same.
403	InvalidIp.IpPrefixMustInReserveSegment	The ip prefix must in vswitch reserve segment.
403	InvalidIp.IpPrefixNotAvailable	The ip prefix is/are not available.
403	InvalidIp.IpPrefixNotStrict	The ip prefix must be strict cidr format.
403	InvalidVSwitchId.IpPrefixNotEnough	The specified vSwitch has not enough ip prefix.
404	InvalidEniId.NotFound	%s
404	MaxEniIpv6IpsCountExceeded	The ipv6 address count exceed limitation.
404	InvalidOperation.VSwitchIpv6Disabled	The specified VSwitch does not support Ipv6 feature.
404	InvalidOperation.EnableIpv6Failed	The specified VSwitch does not support Ipv6 feature.
404	InvalidIp.IpAssigned	The specified ipv6 has already been allocated.
404	InvalidVSwitchId.IpInvalid	The specified ipv6 does not match VSwitch cidr scope.
404	InvalidOperation.HasIpv6RouteEntry	The specified eni has been pointed to the next hop of the route.
404	InvalidOperation.VSwitchCidrReservationNotExist	The specified vSwitch has no cidr reservation.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。