すべてのプロダクト
Search

このプロダクト

    :AssignIpv6Addresses

    ドキュメントセンター

    :AssignIpv6Addresses

    最終更新日:Jul 08, 2025

    elastic network interface (ENI) に1つ以上のIPv6アドレスを割り当てます。

    説明

    ENIが関連付けられているvSwitchのCIDRブロック内でIPv6アドレスを指定することも、自動的に割り当てるIPv6アドレスの数を指定することもできます。 次の项目に注意してください。

    • ENIが関連付けられているvSwitchに対してIPv6を有効にする必要があります。 詳細については、「vSwitch で IPv6 を有効にする」をご参照ください。

    • ENIは、Available (Available) またはBound (InUse) の状態である必要があります。

    • プライマリENIがバインドされているElastic Compute Service (ECS) インスタンスは、Running (Running) またはStopped (Stopped) 状態である必要があります。

    • ENIに割り当てることができるIPv6アドレスの最大数は、インスタンスタイプごとに異なります。

      • ENIがAvailable (Available) 状態の場合、最大10個のIPv6アドレスを割り当てることができます。

      • ENIがすでにECSインスタンスにバインドされている場合、ENIに割り当てることができるIPv6アドレスの最大数は、インスタンスタイプに基づいて決定されます。 詳細については、「インスタンスファミリーの概要」をご参照ください。

    • 操作が呼び出された後、応答からENIに割り当てられたIPv6アドレスを取得できます。

    デバッグ

    OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

    リクエストパラメーター

    パラメーター

    データ型

    必須／任意

    例

    説明

    操作

    String

    必須

    AssignIpv6Addresses

    実行する操作です。 値をAssignIpv6Addressesに設定します。

    RegionId

    String

    必須

    cn-hangzhou

    ENIのリージョンID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

    NetworkInterfaceId

    String

    必須

    eni-bp1iqejowblx6h8j ****

    ENI の ID。

    Ipv6AddressCount

    Integer

    任意

    1

    ENIに対してランダムに生成するIPv6アドレスの数。 有効な値: 1 ~ 10。

    説明

    Ipv6Addresses.NまたはIpv6AddressCountを指定する必要がありますが、両方を指定する必要はありません。

    Ipv6Address.N

    String

    任意

    2001:db8:1234:1a00::****

    ENIに割り当てるIPv6アドレスN。 Nの有効値: 1〜10。

    例: Ipv6Address.1=2001:db8:1234:1a00::****

    説明

    Ipv6Addresses.NまたはIpv6AddressCountを指定する必要がありますが、両方を指定する必要はありません。

    レスポンスパラメーター

    パラメーター

    データ型

    例

    説明

    RequestId

    String

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    リクエストの ID です。

    NetworkInterfaceId

    String

    eni-bp1iqejowblx6h8j ****

    ENI の ID。

    Ipv6Sets

    文字列の配列

    2001:db8:1234:1a00::****

    ENIに割り当てられた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 ****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明

    400

    UnsupportedParameter

    %s

    指定されたパラメーターがサポートされていない場合に返されるエラーメッセージ。

    400

    InvalidParameter

    %s

    指定されたパラメーターが無効な場合に返されるエラーメッセージ。

    400

    InvalidInstanceID.Malformed

    %s

    指定された InstanceId パラメーターが無効な場合に返されるエラーメッセージ。

    400

    MissingParameter

    %s

    必要なパラメーターが指定されていない場合に返されるエラーメッセージ。

    400

    InvalidParams.EniId

    %s

    指定されたNetworkInterfaceIdパラメーターが無効な場合に返されるエラーメッセージ。

    400

    InvalidOperation.InvalidEcsState

    %s

    現在のインスタンスのステータスで該当の操作がサポートされていない場合に返されるエラーメッセージ。

    400

    InvalidOperation.InvalidEniState

    %s

    ENIが現在の状態では操作がサポートされていない場合に返されるエラーメッセージ。

    400

    InvalidPrivateIpAddress.Duplicated

    Specified private IP address is duplicated.

    指定されたプライベート IP アドレスが既に使用されている場合に返されるエラーメッセージ。 別の IP アドレスをお試しください。

    403

    InvalidUserType.NotSupported

    %s

    アカウントが操作をサポートしていない場合に返されるエラーメッセージ。

    403

    InvalidUserType.NotSupported

    %s

    Alibaba Cloudアカウントが存在しない場合、またはAccessKeyペアの有効期限が切れた場合に返されるエラーメッセージ。

    403

    Forbedden.NotSupportRAM

    %s

    RAMユーザーがこの操作を実行する権限がない場合に返されるエラーメッセージ。

    403

    Forbbiden.SubUser

    %s

    このリソースを管理する権限がない場合に返されるエラーメッセージ。 権限付与については、対応するAlibaba Cloudアカウントの所有者にお問い合わせください。

    403

    InvalidOperation.InvalidEniType

    %s

    ENIタイプが操作をサポートしていない場合に返されるエラーメッセージ。

    403

    MaxEniIpv6IpsCountExceeded

    %s

    ENI に割り当てることができる IPv6 アドレスの最大数に達したときに返されるエラーメッセージ。

    403

    InvalidIp.IpUnassigned

    %s

    指定されたIPアドレスが割り当てられていない場合に返されるエラーメッセージ。

    403

    InvalidIp.IpRepeated

    %s

    指定された ID アドレスが既に存在している場合に返されるエラーメッセージ。

    403

    InvalidIp.IpAssigned

    %s

    指定された IP アドレスが既に割り当てられている場合に返されるエラーメッセージ。

    403

    InvalidIp.Address

    %s

    指定された IPv6 アドレスが無効な場合に返されるエラーメッセージ。

    403

    InvalidOperation.Ipv4CountExceeded

    %s

    IPv4 アドレスが最大数に達した場合に返されるエラーメッセージ。

    403

    InvalidOperation.Ipv6CountExceeded

    %s

    IPv6 アドレスが最大数に達した場合に返されるエラーメッセージ。

    403

    InvalidOperation.Ipv6NotSupport

    %s

    IPv6アドレスが現在の操作をサポートしていない場合に返されるエラーメッセージ。

    403

    InvalidVSwitch.Ipv6NotTurnOn

    %s

    現在のvSwitchでIPv6機能が有効になっていない場合に返されるエラーメッセージ。 機能を有効にして、もう一度お試しください。

    403

    InvalidVSwitchId.IpInvalid

    %s

    指定されたプライベート IP アドレスが無効な場合に返されるエラーメッセージ。

    403

    Forbidden.RegionId

    %s

    現在のリージョンでサービスが使用できない場合に返されるエラーメッセージ。

    403

    InvalidOperation.EniServiceManaged

    %s

    操作が無効な場合に返されるエラーメッセージ。

    403

    SecurityGroupInstanceLimitExceed

    %s

    セキュリティグループに追加できるインスタンスの最大数に達した場合に返されるエラーメッセージ。

    404

    InvalidEniId.NotFound

    %s

    指定されたNetworkInterfaceIdパラメーターが存在しない場合に返されるエラーメッセージ。

    エラーコードリストについては、「API エラーセンター」をご参照ください。