AssignIpv6Addresses - Elastic Compute Service - Alibaba Cloud ドキュメントセンター

Elastic Network Interface (ENI) に 1 つ以上の IPv6 アドレスを割り当てます。

操作説明

Elastic Network Interface (ENI) が属する vSwitch の CIDR ブロックから IPv6 アドレスを指定するか、自動作成する IPv6 アドレスの数を指定できます。以下の点にご注意ください:

ENI が属する vSwitch で IPv6 が有効になっている必要があります。詳細については、既存の vSwitch に対して IPv6 CIDR ブロックを有効にするを参照してください。
ENI は Active (使用可能) または InUse ステータスである必要があります。
プライマリ ENI を操作する場合、ENI がアタッチされているインスタンスは Running または Stopped ステータスである必要があります。
単一の ENI に割り当てることができる IPv6 アドレスの数は、ENI がアタッチされているインスタンスのインスタンスタイプによって異なります。
- ENI が Active (使用可能) ステータスの場合、最大 10 個の IPv6 アドレスを割り当てることができます。
- ENI がインスタンスにアタッチされている場合、割り当てることができる IPv6 アドレスの数はインスタンスタイプによって制限されます。詳細については、インスタンスファミリーを参照してください。
この操作の呼び出しに成功すると、割り当てられた IPv6 アドレス情報を応答から取得できます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:AssignIpv6Addresses

create

*NetworkInterface

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	ENI のリージョン ID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。	cn-hangzhou
NetworkInterfaceId	string	必須	ENI の ID。	eni-bp1iqejowblx6h8j****
Ipv6AddressCount	integer	任意	ENI にランダムに生成する IPv6 アドレスの数。有効な値: 1～10。説明この操作を呼び出す際は、`Ipv6Addresses.N` パラメーターまたは `Ipv6AddressCount` パラメーターのいずれかをセットする必要がありますが、両方を同時にセットすることはできません。	1
Ipv6Address	array	任意	ENI に割り当てる 1 つ以上の IPv6 アドレス。最大 10 個の IPv6 アドレスをセットできます。N の有効な値: 1～10。例: Ipv6Address.1=2001:db8:1234:1a00::**** 説明この操作を呼び出す際は、`Ipv6Addresses.N` パラメーターまたは `Ipv6AddressCount` パラメーターのいずれかをセットする必要がありますが、両方を同時にセットすることはできません。	2001:db8:1234:1a00::****
	string	任意	ネットワークインターフェースに割り当てる 1 つ以上の IPv6 アドレス。最大 10 個の IPv6 アドレスをセットできます。N の有効な値: 1～10。例: Ipv6Address.1=2001:db8:1234:1a00::**** 説明この操作を呼び出す際は、`Ipv6Addresses.N` パラメーターまたは `Ipv6AddressCount` パラメーターのいずれかをセットする必要がありますが、両方を同時にセットすることはできません。	2001:db8:1234:1a00::****
Ipv6Prefix	array	任意	ENI に割り当てる 1 つ以上の IPv6 プレフィックス。N の有効な値: 1～10。説明 ENI に IPv6 プレフィックスを設定するには、Ipv6Prefix.N パラメーターまたは Ipv6PrefixCount パラメーターのいずれかを設定する必要がありますが、両方を同時に設定することはできません。
	string	任意	ネットワークインターフェースに割り当てる 1 つ以上の IPv6 プレフィックス。N の有効な値: 1～10。説明 ENI に IPv6 プレフィックスをセットするには、Ipv6Prefix.N パラメーターまたは Ipv6PrefixCount パラメーターのいずれかをセットする必要がありますが、両方を同時にセットすることはできません。	2001:db8:1234:1a00:****::/80
Ipv6PrefixCount	integer	任意	ENI に割り当てる IPv6 プレフィックスの数。有効な値: 1～10。説明 ENI に 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

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。