將一台網路類型為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。 |