インスタンスにパブリック IP アドレスを割り当てます。

説明

この操作を呼び出すときは、次のことに注意してください。

  • インスタンスにパブリック IP アドレスを割り当てる前、インスタンスは [実行中] (Running) または [停止済み] (Stopped) ステータスである必要があります。
  • Elastic IP (EIP) でバインドされた VPC 接続インスタンスにパブリック IP アドレスを割り当てることはできません。
  • インスタンスに割り当てることができるパブリック IP アドレスは 1 つだけです。 インスタンスにパブリック IP アドレスがある場合、AllocatedAlready エラーメッセージが返されます。
  • インスタンスの再起動( RebootInstance )またはインスタンスの起動( StartInstance )後、新しいパブリック IP アドレスが有効になります。
  • インスタンスが セキュリティ上の理由のためにロック (OperationLocks パラメーターが "LockReason": "security") されている場合、パブリック IP アドレスをインスタンスに割り当てることはできません。

EIP をインスタンスにバインドすることもできます。 詳細については、 「 AssociateEipAddress」をご参照ください。

デバッグ

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

リクエストパラメーター

パラメーター名 必須/任意 説明
InstanceId String 必須 i-instance1

IP アドレスが割り当てられるインスタンスの ID。

Action String 任意 AllocatePublicIpAddress

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

IpAddress String 任意 10.1.149.159

インスタンスのパブリック IP アドレス。

VlanId String 任意 100

VLAN ID。

レスポンスパラメーター

パラメーター名 データ型 説明
IpAddress String 10.1.149.159

インスタンスのパブリック IP アドレス。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエストの ID 。

リクエストの例

https://ecs.aliyuncs.com/?Action=AllocatePublicIpAddress
&InstanceId=i-instance1
&<Common request parameters>

レスポンスの成功例

XML 形式

<AllocatePublicIpAddressResponse>
  <RequestId>F2EF6A3B-E345-46B9-931E-0EA094818567</RequestId>
   <IpAddress>10.1.149.159</IpAddress>
</AllocatePublicIpAddressResponse>

JSON 形式

{
	"RequestId": "F2EF6A3B-E345-46B9-931E-0EA094818567",
	"IpAddress": "10.1.149.159"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
404 InvalidVlanId. NotFound The VlanId provided does not exist in our records. 指定された VLAN が存在しない場合に返されるエラーメッセージ。
403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). インスタンスのサブスクリプションの有効期限が切れたときに返されるエラーメッセージ。 先に進む前にサブスクリプションを更新する必要があります。
404 InvalidIpAddress. NotFound The specified IP is not in the specified vlan. 指定された IP アドレスが 指定された VLAN にない場合に返されるエラーメッセージ。
403 AllocatedAlready There is an IpAddress allocated already for the specified instance. 指定された IP アドレスを既に IP アドレスを持つインスタンスに割り当てようとした場合に返されるエラーメッセージ。
400 OperationDenied Specified operation is denied as your instance is in VPC. 指定された操作が VPC 接続インスタンスをサポートしていない場合に返されるエラーメッセージ。
400 AllocateIpInvalidInstanceBandwidth OperationDenied The InternetMaxBandwidthOut of the specified instance cannot be less than 0. インターネット帯域幅が 0 未満の場合に返されるエラーメッセージ。
400 OperationDenied The specified parameter "VlanId" is not valid or vlan has not enough IP address. 指定された VLAN ID が無効であるか、VLAN 内の IP アドレスの数が上限に達した場合に返されるエラーメッセージ。
403 NAT_PUBLIC_IP_BINDING_FAILED Binding nat public ip failed パブリック IP アドレスをインスタンスにバインドできない場合に返されるエラーメッセージ。
403 NAT_PUBLIC_IP_ALLOCATE_FAILED Nat public ip binding failed. ECS がパブリック IP アドレスをインスタンスに割り当てることができない場合に返されるエラーメッセージ。

エラーコードの表示