調(diào)用ConvertNatPublicIpToEip將一臺專有網(wǎng)絡(luò)VPC類型ECS實例的公網(wǎng)IP地址（PublicIP）轉(zhuǎn)化為彈性公網(wǎng)IP（EIP）。
接口說明
公網(wǎng) IP 地址轉(zhuǎn)換為 EIP 后，EIP 將單獨計費。請確保您已充分了解 EIP 的計費方式。
調(diào)用該接口時，ECS 實例必須滿足以下條件：
-
狀態(tài)為已停止（
Stopped）或者運行中（Running）。 -
沒有綁定 EIP。
-
沒有未生效的變更配置任務(wù)。
-
公網(wǎng)帶寬不能為 0 Mbit/s。
-
包年包月實例的公網(wǎng)帶寬計費方式必須為
按使用流量計費，而按固定帶寬計費方式的公網(wǎng) IP 不支持轉(zhuǎn)化為彈性公網(wǎng) IP。按量付費實例則不受該規(guī)則影響。更多信息，請參見轉(zhuǎn)換公網(wǎng)帶寬計費方式。 -
專有網(wǎng)絡(luò) VPC 類型的包年包月 ECS 實例 24 小時內(nèi)不會到期。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| ecs:ConvertNatPublicIpToEip | update | *Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId} |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 是 | 需要轉(zhuǎn)化公網(wǎng) IP 的實例 ID。 | i-bp171jr36ge2ulvk**** |
| RegionId | string | 是 | 實例所屬的地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
返回參數(shù)
示例
正常返回示例
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 | 您當(dāng)前的操作無效，由于您指定的實例已經(jīng)預(yù)約了變更操作。 |
| 403 | InvalidEndTime.OperateNotSupport | %s | 該實例狀態(tài)不支持此操作。 |
| 403 | InvalidInstanceStatus.Released | %s | 該操作無效，請檢查實例狀態(tài)是否正確。 |
| 403 | IncorrectInstanceStatus | %s | 當(dāng)前實例的狀態(tài)不支持此操作。 |
| 403 | OperationDenied | %s | 拒絕操作。 |
| 403 | InvalidInstance.ZeroBandwidth | %s | - |
| 403 | InvalidInternetChargeType.ValueNotSupported | %s | 暫不支持指定的網(wǎng)絡(luò)計費方式，請確認(rèn)相關(guān)參數(shù)是否正確。 |
| 403 | InvalidInstanceId.NotFound | %s | 指定的實例不存在，請確認(rèn)參數(shù) InstanceId 是否正確。 |
| 403 | MaxEIPQuotaExceeded | The number of EIP exceeds the limit per region. | EIP數(shù)量超過了當(dāng)前地域可設(shè)置的最大值。 |
| 403 | Forbidden.InvalidPublicBandwidth | The specified instance public bandwidth is less than 1M. | 實例公網(wǎng)帶寬數(shù)據(jù)不合法。 |
| 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. | 賬號余額不足，請您先充值再進(jìn)行該操作。 |
| 403 | Forbidden.RiskControl | This operation is forbidden by Aliyun RiskControl system. | 該操作被風(fēng)險控制系統(tǒng)禁止。 |
| 403 | UnsupportedPublicIpWithIsp | %s | - |
| 404 | InvalidInstance.IpAddressMissing | %s | 指定實例沒有配置公網(wǎng)IP，具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。您可以調(diào)用DescribeInstances查詢指定實例的狀態(tài)。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2023-10-10 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |