1 つまたは複数のセカンダリプライベート IP アドレスを ENI に割り当てます。 ENI をホストする VSwitch の CIDR ブロック内でプライベート IP アドレスを指定できます。 または、ECS のプライベート IP アドレスの数を指定して、それらを自動的に割り当てることができます。

説明

  • IP アドレスを割り当てる ENI は、[利用可能] (Available) または [使用中] (InUse) ステータスでなければなりません。
  • プライマリ ENI で操作を実行する場合、ENI が接続されているインスタンスは [実行中] (Running) または [停止済み] (Stopped) ステータスである必要があります。
  • ENI が [利用可能] ステータスの場合、最大 10 個のセカンダリプライベート IP アドレスを ENI に割り当てることができます。 ENI がインスタンスに接続されている場合、ENI に割り当てることができるプライベート IP アドレスの数は、インスタンスタイプの影響を受けます。 詳細については、「インスタンスタイプファミリー」をご参照ください。

デバッグ

API Explorer を使用してデバッグを実行できます。 API Explorer では、さまざまな操作を行って API の使用を簡素化することができます。 たとえば、API の呼び出し、SDK サンプルコードの動的な生成、API の迅速な取得をすることができます。

リクエストパラメーター

パラメーター名 データ型 必須/任意 例 説明
NetworkInterfaceId String 必須 eni-myeni

ENI の ID。

RegionId String 必須 cn-hangzhou

ECS インスタンスが配置されているリージョンの ID。 DescribeRegions を呼び出して、Alibaba Cloud の最新のリージョンを表示できます。

Action String 任意 AssignPrivateIpAddresses

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

PrivateIpAddress.N RepeatList 任意 172.17. XX.XXX

ENI をホストする VSwitch の CIDR ブロックから選択された 1 つまたは複数のセカンダリプライベート IP アドレス。 N の有効な値：

  • ENI が [利用可能] ステータスの場合：1～10。
  • ENI が [使用中] ステータスの場合：インスタンスタイプに依存します。 詳細については、「インスタンスタイプファミリー」をご参照ください。

PrivateIpAddress.N パラメーターまたは SecondaryPrivateIpAddressCount パラメーターのいずれかを指定して、セカンダリプライベート IP アドレスを割り当てる必要があります。

SecondaryPrivateIpAddressCount Integer 任意 1

ECS インスタンスによって割り当てられるプライベート IP アドレスの指定された数。

レスポンスパラメーター

パラメーター名 データ型 例 説明
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエストの ID。

例

リクエストの例

https://ecs.aliyuncs.com/?Action=AssignPrivateIpAddresses
&NetworkInterfaceId=eni-myeni
&RegionId=cn-hangzhou 
&PrivateIpAddress. 1=172.17. XX.XXX
&SecondaryPrivateIpAddressCount=1
&<Common request parameters>

成功したレスポンスの例

XML 形式 

<AssignPrivateIpAddressesResponse>
  <RequestId>04F0F334-1335-436C-A1D7-6C044FE70008</RequestId>
</AssignPrivateIpAddressesResponse>

JSON 形式 

{
	"RequestId":"04F0F334-1335-436C-A1D7-6C044FE70008"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
403 InvalidUserType.NotSupported %s アカウントタイプがサポートされていない場合に返されるエラーメッセージ。
403 Abs.InvalidAccount.NotFound %s 指定された Alibaba Cloud アカウントが存在しないか、AccessKey の有効期限が切れた場合に返されるエラーメッセージ。
403 MissingParameter %s 必須パラメーターが指定されていない場合に返されるエラー メッセージ。
403 Forbidden.NotSupportRAM %s RAM ユーザーがこの操作の実行を許可されていない場合に返されるエラーメッセージ。
400 UnsupportedParameter %s パラメーターがサポートされていない場合に返されるエラーメッセージ。
403 Forbidden.SubUser %s RAM ユーザーがこのリソースでの操作の実行を許可されていない場合に返されるエラーメッセージ。
400 InvalidParameter %s パラメーターの形式が無効な場合に返されるエラーメッセージ。
400 InvalidInstanceID.Malformed %s インスタンス ID の形式が無効な場合に返されるエラーメッセージ。
400 InvalidOperation.InvalidEcsState %s インスタンス状態でプライベート IP アドレスをリリースできない場合に返されるエラーメッセージ。
400 InvalidOperation.InvalidEniState %s ENI 状態でプライベート IP アドレスをリリースできない場合に返されるエラーメッセージ。
400 InvalidOperation.DetachPrimaryEniNotAllowed %s プライマリ ENI をインスタンスから切り離せない場合に返されるエラーメッセージ。
404 InvalidEcsId.NotFound %s 指定されたインスタンス ID が存在しない場合に返されるエラーメッセージ。
404 InvalidEniId.NotFound %s 指定された ENI ID が存在しない場合に返されるエラーメッセージ。
404 InvalidVSwitchId.NotFound %s 指定された VSwitch ID が存在しない場合に返されるエラーメッセージ。
404 InvalidSecurityGroupId.NotFound %s 指定されたセキュリティグループ ID が存在しない場合に返されるエラーメッセージ。
403 EniPerInstanceLimitExceeded %s ENI の数が指定したインスタンスタイプの上限を超えた場合に返されるエラーメッセージ。
403 InvalidOperation.AvailabilityZoneMismatch %s 指定された VSwitch、ENI、およびインスタンスが同じゾーンにない場合に返されるエラーメッセージ。
403 InvalidOperation.VpcMismatch %s 指定された ENI とセキュリティグループが同じ VPC に属さない場合に返されるエラーメッセージ。
403 SecurityGroupInstanceLimitExceed %s 指定されたセキュリティグループ内のインスタンスの数が上限を超えた場合に返されるエラーメッセージ。
403 InvalidSecurityGroupId.NotVpc %s 指定されたセキュリティグループが VPC 接続されていない場合に返されるエラーメッセージ。
403 InvalidOperation.InvalidEniType %s ENI タイプがサポートされていない場合に返されるエラーメッセージ。
404 InvalidInstanceId.NotFound %s 指定されたインスタンスが存在しない場合に返されるエラーメッセージ。
403 InvalidVSwitchId.IpNotEnough %s 指定された VSwitch の IP アドレスが不十分な場合に返されるエラーメッセージ。
403 InvalidVSwitchId.IpInvalid %s 指定されたプライベート IP アドレスが無効な場合に返されるエラーメッセージ。
403 InvalidIp.IpAssigned %s 指定された IP アドレスが既に割り当てられている場合に返されるエラーメッセージ。
403 Operation.Conflict %s 操作が競合する場合に返されるエラーメッセージ。 もう一度お試しください。
400 Forbidden.RegionId %s この関数がリージョンでサポートされていない場合に返されるエラーメッセージ。
400 InvalidAction %s 操作が無効な場合に返されるエラーメッセージ。

エラーコードの表示