すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:ConvertNatPublicIpToEip

最終更新日:Aug 12, 2026

VPC タイプの ECS インスタンスのパブリック IP アドレス (PublicIP) を EIP に変換します。

操作説明

操作の説明

パブリック IP アドレスが EIP に変換されると、EIP は個別に課金されます。EIP の課金方法 を十分にご確認ください。

この操作を呼び出す際、ECS インスタンスは以下の条件を満たしている必要があります。

  • インスタンスが Stopped (Stopped) または Running (Running) 状態であること。

  • インスタンスに EIP が関連付けられていないこと。

  • インスタンスに保留中の構成変更ノードがないこと。

  • パブリック帯域幅が 0 Mbit/s でないこと。

  • サブスクリプションインスタンスの場合、パブリック帯域幅の支払い方法は pay-by-traffic である必要があります。pay-by-bandwidth 支払い方法のパブリック IP アドレスは EIP に変換できません。従量課金インスタンスはこの制限の対象ではありません。詳細については、「ネットワークトラフィックの課金方法の変換」をご参照ください。

  • VPC タイプのサブスクリプション ECS インスタンスが 24 時間以内に有効期限切れにならないこと。

今すぐお試しください

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

update

*Instance。

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

InstanceId

string

必須

パブリック IP アドレスを変換するインスタンスの ID。

i-bp171jr36ge2ulvk****

RegionId

string

必須

インスタンスのリージョン ID。最新のリージョンリストをクエリするには、 DescribeRegions を呼び出せます。

cn-hangzhou

レスポンスフィールド

フィールド

型

説明

例

object

RequestId

string

リクエスト ID

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 OperationDenied.CloudboxNotSupport This operation is denied, because the specified ECS instance which is in the Cloudbox dose not support PublicIp or Eip.
400 InvalidParameter.CloudboxNotSupported %s
400 OperationDenied.DedicatedRegionNotSupported This operation is denied, because the specified ECS instance which is in the dedicated region dose not support PublicIp or Eip. この API オペレーションは専用クラウドではサポートされていません。
400 AccountInArrears The account is in arrears. アカウントに支払い遅延があります。
403 InvalidInstanceId.PlanedChange %s 指定されたインスタンスにはすでにスケジュールされたスペック変更があるため、この操作は無効です。
403 InvalidEndTime.OperateNotSupport %s 現在のインスタンスステータスでは、この操作はサポートされていません。
403 InvalidInstanceStatus.Released %s 操作が無効です。インスタンスステータスが正しいかどうかを確認してください。
403 IncorrectInstanceStatus %s インスタンスステータスが当該操作をサポートしていないため、操作は許可されません。
403 OperationDenied %s
403 InvalidInstance.ZeroBandwidth %s
403 InvalidInternetChargeType.ValueNotSupported %s
403 InvalidInstanceId.NotFound %s 指定されたインスタンス ID が無効です。
403 MaxEIPQuotaExceeded The number of EIP exceeds the limit per region. EIP の数が現在のリージョンで設定可能な最大値を超えています。
403 Forbidden.InvalidPublicBandwidth The specified instance public bandwidth is less than 1M. インスタンスのパブリック帯域幅データが無効です。
403 InvalidInstance.OverduePayment The special instance due to overdue payment,this operation is not supported. 現在の操作は支払い遅延に関連付けられています。新しいインスタンスを作成するか、連絡先に問い合わせて発行を解決してください。
403 EIPMaxBandwidthExceeded The bandwidth of instance exceeds the limitation of EIP in this region.
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
403 Forbidden.RiskControl This operation is forbidden by Aliyun RiskControl system. この操作はリスクガバナンスシステムによって禁止されています。
403 UnsupportedPublicIpWithIsp %s
404 InvalidInstanceId.NotFound %s
404 InvalidInstance.IpAddressMissing %s 指定されたインスタンスにパブリック IP アドレスがありません。詳細については、エラーメッセージ内の %s プレースホルダーの実際の戻り結果を参照してください。DescribeInstances を呼び出して、指定されたインスタンスのステータスをクエリできます。
409 OperationConflict Request was denied due to conflict with a previous request,please try again later. リクエストされたリソースが以前のリクエストと競合しています。
409 TokenProcessing The previous token request is still processing. Please try again later.

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

変更履歴

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