將一台網路類型為Virtual Private Cloud的ECS執行個體的公網 IP(NatPublicIp)轉化為Elastic IP Address(EIP)。

描述

調用該介面時,您需要注意:

  • 僅支援VPC網路類型的ECS執行個體。
  • 僅支援狀態為 已停止Stopped)或者 運行中Running)的ECS執行個體。
  • 不支援公網頻寬為0 Mbps的執行個體,此時該ECS執行個體沒有分配公網IP(NatPublicIp)。
  • 不支援已經綁定了EIP的ECS執行個體。
  • 不支援有未生效的變更配置任務ECS執行個體。
  • 不支援即將在24小時內到期的ECS執行個體。
  • 公網IP(NatPublicIp)轉換為EIP後,EIP將單獨計費,EIP的計費方式參閱文檔 隨用隨付

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:ConvertNatPublicIpToEip
RegionId String 執行個體所屬的地域ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
InstanceId String 需要轉化公網IP的執行個體ID。

返回參數

全是公共返回參數。參閱 公共返回參數

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=ConvertNatPublicIpToEip
&RegionId=cn-hangzhou
&InstanceId=i-test
&<公共請求參數>
返回樣本

XML 格式

<ConvertNatPublicIpToEipResponse>
    <RequestId>B154D309-F3E1-4AB7-BA94-FEFCA8B89001</RequestId>
</ConvertNatPublicIpToEipResponse>
JSON 格式
{
   "RequestId":"B154D309-F3E1-4AB7-BA94-FEFCA8B89001"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidRegionId.Malformed The specified RegionId is invalid. 400 指定的 RegionId 不存在或者未授權。
InvalidEndTime.Malformed The specified instance is about to expire within 24 hours. 403 執行個體即將在24小時內到期,不能變更公網IP。
InvalidInstanceId.PlanedChange The instance has uncompleted changes. 403 執行個體有未生效的變更配置任務。
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)的ECS執行個體。
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 執行個體公網頻寬為0 Mbps,此時該執行個體無公網IP。
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。