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アドレスを取得できます。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | 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 エラーセンター」をご参照ください。