ConvertNatPublicIpToEip は、 Virtual Private Cloud (VPC) タイプのインスタンスのパブリック IP (NatPublicIp) を Elastic IP (EIP) に変更します。
説明
この操作を使用する場合は、次の点を考慮してください。
- 指定されたインスタンスのネットワークタイプは、VPC でなければなりません。
- 指定されたインスタンスのステータスは、停止済み (
Stopped
) または 実行中 (Running
) である必要があります。 - ECS インスタンスにパブリック IP
NatPublicIp
が割り当てられていない場合、ECS インスタンスのアウトバウンド帯域幅を 0 Mbps より大きくする必要があります。 - 指定されたインスタンスに EIP を既にバインドしている場合、この操作は失敗します。
- 指定された ECS インスタンスで、設定変更が進行中の場合、この操作は失敗します。
- 指定されたインスタンスが 24 時間以内に期限切れになる場合、この操作は失敗します。
- パブリック IP の
NatPublicIp
が EIP に変更されると、EIP サービスの使用が請求されます。詳細については、EIP ドキュメント「課金概要」をご参照ください。
リクエストパラメーター
名前 | 型 | 必須かどうか | 説明 |
---|---|---|---|
Action | String | はい | 実行する操作。値:ConvertNatPublicIpToEip |
RegionId | String | はい | リージョン ID。詳細については、DescribeRegions API を使用して、最新のリージョンリストを取得してください。 |
InstanceId | String | はい | ターゲット ECS インスタンスの ID。 |
レスポンスパラメーター
例
リクエストの例
https://ecs.aliyuncs.com/?Action=ConvertNatPublicIpToEip&RegionId=cn-hangzhou&InstanceId=i-test&<共通リクエストパラメーター>
レスポンスの例
XML 形式
JSON 形式
<ConvertNatPublicIpToEipResponse> <RequestId>B154D309-F3E1-4AB7-BA94-FEFCA8B89001</RequestId></ConvertNatPublicIpToEipResponse>
{ “RequestId”:”B154D309-F3E1-4AB7-BA94-FEFCA8B89001”}
エラーコード
このインタフェースに固有のエラーコードは、次の通りです。詳細については、「API のエラーセンター」をご参照ください 。
エラーコード | エラーメッセージ | HTTP ステータスコード | 説明 |
---|---|---|---|
InvalidRegionId.Malformed | The specified RegionId is invalid. | 400 | 指定された RegionId が存在しないか、指定されたリージョンにアクセスする許可がありません。 |
InvalidEndTime.Malformed | The specified instance expires in the next 24 hours. | 403 | 指定されたインスタンスは 24 時間以内に期限切れになります。 |
InvalidInstanceId.PlanedChange | The instance has incomplete changes. | 403 | 指定された ECS インスタンスに進行中の設定変更タスクが存在します。 |
InvalidInstanceStatus.Released | The specified instance has been released. | 403 | 指定されたインスタンスはリリースされました。 |
IncorrectInstanceStatus | The instance status does not support this operation. The instance may be expired, upgrading, starting, or locked. | 404 | 指定されたインスタンスは、 停止済み (Stopped ) または 実行中 (Running ) のステータスでなければなりません。 |
InstanceTypeNotSupported | The specified instance is a subscription instance with a specified bandwidth. | 404 | 指定されたインスタンスは、指定された帯域幅のサブスクリプションインスタンスです。 |
InvalidInstance.ZeroBandwidth | The public network bandwidth for the specified instance is zero. That is, this instance does not have a public IP. | 404 | ECS インスタンスのアウトバウンド帯域幅は、0 Mbps より大きくなければなりません。 |
InvalidInstanceId.NotFound | The specified instance does not exist, or does not belong to you. | 404 | 指定されたインスタンスが存在しないか、正しく設定されていません。 |
OperationDenied | The network type of the specified instance is not VPC. | 404 | 指定されたインスタンスは VPC タイプでなければなりません。 |