調用ConvertNatPublicIpToEip將一臺專有網絡VPC類型ECS實例的公網IP地址(PublicIP)轉化為彈性公網IP(EIP)。
接口說明
公網 IP 地址轉換為 EIP 后,EIP 將單獨計費。請確保您已充分了解 EIP 的計費方式。
調用該接口時,ECS 實例必須滿足以下條件:
-
狀態為已停止(
Stopped
)或者運行中(Running
)。 -
沒有綁定 EIP。
-
沒有未生效的變更配置任務。
-
公網帶寬不能為 0 Mbit/s。
-
包年包月實例的公網帶寬計費方式必須為
按使用流量
計費,而按固定帶寬
計費方式的公網 IP 不支持轉化為彈性公網 IP。按量付費實例則不受該規則影響。更多信息,請參見轉換公網帶寬計費方式。 -
專有網絡 VPC 類型的包年包月 ECS 實例 24 小時內不會到期。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceId | string | 是 | 需要轉化公網 IP 的實例 ID。 | i-bp171jr36ge2ulvk**** |
RegionId | string | 是 | 實例所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
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的報錯 |
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 | 指定的實例不存在,請確認參數 InstanceId 是否正確。 |
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 | IncorrectInstanceStatus | The special instance status not support this operate! | - |
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 | InvalidInstance.IpAddressMissing | %s | 指定實例沒有配置公網IP,具體信息請參見錯誤信息%s占位符的實際返回結果。您可以調用DescribeInstances查詢指定實例的狀態。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2023-10-10 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |