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 エラーセンター」をご参照ください。