將一台Virtual Private Cloud類型ECS執行個體的公網IP地址(PublicIP)轉化為Elastic IP Address(EIP)。
介面說明
介面說明
公網 IP 位址轉換為 EIP 後,EIP 將單獨計費。請確保您已充分瞭解 EIP 的計費方式。
調用該介面時,ECS 執行個體必須滿足以下條件:
-
狀態為已停止(
Stopped)或者運行中(Running)。 -
沒有綁定 EIP。
-
沒有未生效的變更配置任務。
-
公網頻寬不能為 0 Mbit/s。
-
訂用帳戶執行個體的公網頻寬計費方式必須為
按使用流量計費,而按固定頻寬計費方式的公網 IP 不支援轉化為彈性公網 IP。隨用隨付執行個體則不受該規則影響。更多資訊,請參見轉換公網頻寬計費方式。 -
Virtual Private Cloud 類型的訂用帳戶 ECS 執行個體 24 小時內不會到期。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ecs:ConvertNatPublicIpToEip |
update |
*Instance
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| InstanceId |
string |
是 |
需要轉化公網 IP 的執行個體 ID。 |
i-bp171jr36ge2ulvk**** |
| RegionId |
string |
是 |
執行個體所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。 |
cn-hangzhou |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
樣本
正常返回樣本
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
異常返回樣本
JSON格式
{
"RequestId":"B154D309-F3E1-4AB7-BA94-FEFCA8B89001"
}
錯誤碼
|
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的報錯 |
| 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 | 指定的執行個體不存在,請確認參數 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 | 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查詢指定執行個體的狀態。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。