全部產品
Search

搜尋本產品

    Elastic Compute Service：AssignIpv6Addresses

    文件中心

    Elastic Compute Service：AssignIpv6Addresses

    更新時間：Sep 04, 2026

    為彈性網卡分配一個或多個 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 指定的參數 EniId 無效。
    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. 指定的虛擬交換器處於 pending 狀態，無法刪除。
    400 InvalidParameter.Conflict %s 參數衝突。
    400 InvalidOperation.EniOperationConflict The previous ENI operation is still in progress. Please try again later. 目前操作衝突，請稍等一段時間後重試。
    400 TaskConflict The operation is too frequent, please wait a moment and try again. EIP 操作過於頻繁。
    400 RangeExceede.Ipv6NotInReserved The specified IPv6 is not in the reserved segment and this operation is not allowed. IPv6 不在預留區段，不允許執行該操作。
    400 InvalidOperation.Ipv6InUse The target IPv6 is occupied and cannot be allocated. Please replace it and try again. 目標 IPv6 已被佔用不可分配，請更換後重試。
    500 InvalidOperation.RegionNotSupportIpPrefix The current region does not support ip prefix. 該地域不支援分配 IP 前綴。
    403 InvalidUserType.NotSupported %s 無效的使用者類型。
    403 Abs.InvalidAccount.NotFound %s 該帳號未找到或者 AccessKey 已過期。
    403 MissingParameter %s
    403 Forbedden.NotSupportRAM %s RAM 模式下不支援此類操作。
    403 Forbbiden.SubUser %s 子使用者未被授權執行此類操作。
    403 InvalidOperation.InvalidEniType %s 目前網卡類型，不允許此操作。
    403 MaxEniIpv6IpsCountExceeded %s 該彈性網路介面掛載的 IPv6 個數達到上限。
    403 InvalidIp.IpUnassigned %s 指定的 IP 未被分配。
    403 InvalidIp.IpRepeated %s 指定的 IP 重複。
    403 InvalidIp.IpAssigned %s 指定的 IP 已被分配。
    403 InvalidIp.Address %s 指定的 IP 位址無效。
    403 InvalidOperation.EniCountExceeded %s
    403 InvalidOperation.Ipv4CountExceeded %s IPv4 數量達到上限，導致該操作無效。
    403 InvalidOperation.Ipv6CountExceeded %s IPv6 數量達到上限，導致該操作無效。
    403 InvalidOperation.Ipv6NotSupport %s IPv6 不支援目前操作。
    403 InvalidOperation.Ipv4NotSupport %s
    403 InvalidVSwitch.Ipv6NotTurnOn %s 您目前使用的交換器未啟用 IPv6 功能，請先啟用此功能後重試。
    403 InvalidParam.IpAssign %s
    403 InvalidVSwitchId.IpInvalid %s 指定的私網 IP 無效。
    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. IP 前綴無效，不是 CIDR 格式。
    403 InvalidIp.IpPrefixMaskIllegal The ip prefix mask is illegal. IP 前綴遮罩非法。
    403 InvalidIp.IpPrefixMaskInvalid The ip prefixes mask %s is illegal which must be between %s and %s. IP 前綴遮罩非法，不在有效範圍內。
    403 InvalidIp.IpPrefixMaskNotSame The ip prefixes %s are illegal which mask must be same. IP 前綴遮罩不相同。
    403 InvalidIp.IpPrefixMustInReserveSegment The ip prefix must in vswitch reserve segment. IP 首碼無效，不在交換器的預留地址段內。
    403 InvalidIp.IpPrefixNotAvailable The ip prefix is/are not available. IP 前綴非空閒。
    403 InvalidIp.IpPrefixNotStrict The ip prefix must be strict cidr format. IP 前綴無效，不是嚴格的 CIDR。
    403 InvalidVSwitchId.IpPrefixNotEnough The specified vSwitch has not enough ip prefix. 指定的交換器內 IP 前綴數量不足。
    403 InvalidOperation.EniAssociateWithBindedEip The specified eni has associate with binded eip. 該彈性網卡已綁定直通 Eip，無法分配 Ipv6。
    404 InvalidEniId.NotFound %s
    404 MaxEniIpv6IpsCountExceeded The ipv6 address count exceed limitation.
    404 InvalidOperation.VSwitchIpv6Disabled The specified VSwitch does not support Ipv6 feature. 指定的交換器不支援 IPv6。
    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. 指定的私網 IP 無效。
    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. 指定的交換器沒有可用的預留段。

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

    變更歷史

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