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

Elastic Network Interface (ENI) に 1 つ以上のセカンダリプライベート IP アドレスを割り当てます。ENI が属する vSwitch から使用可能なプライベート IP アドレスを指定するか、プライベートエンドポイントアドレスの数を指定してプライベート IP アドレスを自動的に割り当てることができます。

操作説明

Available または InUse 状態の ENI のみがサポートされています。
プライマリ ENI を操作する場合、ENI がアタッチされているインスタンスは Running または Stopped 状態である必要があります。
ENI が Available 状態の場合、最大 49 個のセカンダリプライベート IP アドレスを割り当てることができます。ENI がインスタンスにアタッチされた後、割り当て可能なセカンダリプライベート IP アドレスの数はインスタンスタイプによって制限されます。詳細については、インスタンスファミリーを参照してください。
この操作を呼び出した後、割り当てられたセカンダリプライベート IP アドレス情報を応答から取得できます。

今すぐお試しください

この 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:AssignPrivateIpAddresses

create

*NetworkInterface

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	ENI のリージョン ID。 DescribeRegions を呼び出して、Alibaba Cloud リージョンの最新リストをクエリできます。	cn-hangzhou
RegionId	string	必須	ENI の ID。	cn-hangzhou
NetworkInterfaceId	string	必須	vSwitch の使用可能な IP アドレスから自動的に割り当てるプライベート IP アドレスの数。セカンダリプライベート IP アドレスを割り当てる場合、PrivateIpAddress.N と SecondaryPrivateIpAddressCount の両方を同時に指定することはできません。	eni-bp67acfmxazb4p****
SecondaryPrivateIpAddressCount	integer	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認してください。ClientToken の値には ASCII 文字のみを含めることができ、64 文字を超えることはできません。詳細については、べき等性の確保方法を参照してください。	1
ClientToken	string	任意	ENI が属する vSwitch の使用可能な IP アドレスから選択された 1 つ以上のセカンダリプライベート IP アドレス。N の有効な値: ENI が Available (`Available`) 状態の場合: 1～32。 ENI が `InUse` 状態の場合: インスタンスタイプによって制限されます。詳細については、インスタンスファミリーを参照してください。セカンダリプライベート IP アドレスを割り当てる場合、PrivateIpAddress.N と SecondaryPrivateIpAddressCount の両方を同時に指定することはできません。	123e4567-e89b-12d3-a456-426655440000
PrivateIpAddress	array	任意	ENI に割り当てる 1 つ以上の IPv4 プレフィックス。N の有効な値: 1～10。説明 ENI に IPv4 プレフィックスを設定するには、Ipv4Prefix.N パラメーターまたは Ipv4PrefixCount パラメーターのいずれかを指定する必要がありますが、両方を同時に指定することはできません。	10.1..
	string	任意	ネットワークインターフェースに割り当てる 1 つ以上の IPv4 プレフィックス。N の有効な値: 1～10。説明 ENI に IPv4 プレフィックスを設定するには、Ipv4Prefix.N パラメーターまたは Ipv4PrefixCount パラメーターのいずれかを指定する必要がありますが、両方を同時に指定することはできません。	10.1..
Ipv4Prefix	array	任意	ENI に割り当てるランダムに生成された IPv4 プレフィックスの数。有効な値: 1～10。説明 ENI に IPv4 プレフィックスを設定するには、Ipv4Prefix.N パラメーターまたは Ipv4PrefixCount パラメーターのいずれかを指定する必要がありますが、両方を同時に指定することはできません。
	string	任意	ENI に割り当てる IPv4 プレフィックス N。N の有効値：1～10。説明 ENI に IPv4 プレフィックスを割り当てるには、Ipv4Prefix.N または Ipv4PrefixCount パラメーターのいずれかを指定する必要がありますが、両方を指定することはできません。	192.168../28
Ipv4PrefixCount	integer	任意	ENI に対してランダムに生成される IPv4 プレフィックスの数。有効値：1～10。説明 ENI に IPv4 プレフィックスを割り当てるには、Ipv4Prefix.N または Ipv4PrefixCount パラメーターのいずれかを指定する必要がありますが、両方を指定することはできません。	1

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
AssignedPrivateIpAddressesSet	object	セカンダリプライベート IP アドレスが割り当てられたネットワークインターフェースの情報。
NetworkInterfaceId	string	ネットワークインターフェースの ID。	eni-bp125p95hhdhn3ot****
PrivateIpSet	object
PrivateIpAddress	array	ENI に割り当てられたセカンダリプライベート IP アドレス。
	string	ENI に割り当てられたセカンダリプライベート IP アドレス。	192.168..
Ipv4PrefixSet	object
Ipv4Prefixes	array	割り当てられた IPv4 プレフィックスの詳細。
	string	割り当てられた IPv4 プレフィックス。	192.168../28

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "AssignedPrivateIpAddressesSet": {
    "NetworkInterfaceId": "eni-bp125p95hhdhn3ot****",
    "PrivateIpSet": {
      "PrivateIpAddress": [
        "192.168.**.**"
      ]
    },
    "Ipv4PrefixSet": {
      "Ipv4Prefixes": [
        "192.168.**.**/28"
      ]
    }
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	Throttling	Request was denied due to request throttling.
400	InvalidOperation.Unsupported	%s
400	UnsupportedParameter	%s
400	InvalidParameter	%s
400	InvalidInstanceID.Malformed	%s
400	InvalidOperation.InvalidEcsState	%s
400	InvalidOperation.InvalidEniState	%s
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s
400	MissingParameter	%s
400	Forbidden.RegionId	%s
400	InvalidAction	%s
400	InvalidPrivateIpAddress.Duplicated	Specified private IP address is duplicated.
400	InvalidPrivateIpAddress.Malformed	%s
400	InvalidSecondaryPrivateIpAddressCount.Malformed	%s
400	InvalidParameter.Conflict	%s
400	InvalidOperation.InstanceNotSupportMulitipleIp	Assigning private ip for instance in cloud box is unsupported.
400	IncorrectVSwitchStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created Available", but current state is "%s".
400	QuotaExceeded.PrivateIpAddress	There are not enough private IPs in the specified VSwitch.
400	InvalidStatus.InstanceIsMigrating	The ECS which ENI is attached to is migrating. Please try again later.
400	InvalidEniId.Malformed	The specified parameter "NetworkInterfaceId" is not valid. Ensure you provide the full ENI id in the form eni-xxx.
400	InvalidVSwitch.IllegalStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created", but current state is "%s".
500	InvalidOperation.RegionNotSupportIpPrefix	The current region does not support IP prefix feature.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
500	InvalidParameter.PrivateIpCount	The current privateIpCount is not in the range 1.0 through 100.0.
403	InvalidUserType.NotSupported	%s
403	Abs.InvalidAccount.NotFound	%s
403	MissingParameter	%s
403	Forbidden.NotSupportRAM	%s
403	Forbidden.SubUser	%s
403	MaxEniCountExceeded	%s
403	EniPerInstanceLimitExceeded	%s
403	InvalidOperation.AvailabilityZoneMismatch	%s
403	InvalidOperation.VpcMismatch	%s
403	SecurityGroupInstanceLimitExceed	%s
403	InvalidSecurityGroupId.NotVpc	%s	参数SecurityGroupId无效，该安全组的网络类型不是专有网络。
403	InvalidOperation.InvalidEniType	%s
403	InvalidVSwitchId.IpNotEnough	%s
403	InvalidVSwitchId.IpInvalid	%s
403	InvalidIp.IpAssigned	%s
403	MaxEniPrivateIpsCountExceeded	%s
403	Operation.Conflict	%s
403	InvalidOperation.Ipv4CountExceeded	%s
403	InvalidOperation.EniServiceManaged	%s
403	InvalidIp.IpRepeated	%s
403	InvalidIp.IpPrefixIllegal	The ip prefixes %s is/are illegal.
403	InvalidIp.IpPrefixMaskIllegal	The current IP prefix mask is illegal.
403	InvalidIp.IpPrefixMaskNotSame	The IP prefixes %s are illegal.The IP prefix mask must be the same.
403	InvalidIp.IpPrefixNotAvailable	The IP prefix is not available.
403	InvalidIp.IpPrefixNotStrict	The IP prefix "%s" must be strict CIDR format.
403	InvalidVSwitchId.IpPrefixNotEnough	The specified VSwitch does not have enough IP prefixes.
403	InvalidIp.IpPrefixMaskInvalid	The IP prefixes mask "%s" is illegal.Ensure the mask is between %s and %s.
403	InvalidIp.IpPrefixMustInReserveSegment	The IP prefix must be in VSwitch reserved segment. Ensure you create reserved segment for the VSwitch.
404	InvalidEcsId.NotFound	%s
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s
404	InvalidSecurityGroupId.NotFound	%s
404	InvalidInstanceId.NotFound	%s
404	InvalidOperation.VSwitchCidrReservationNotExist	The specified VSwitch does not have CIDR reservation.

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

変更履歴

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