Release Notes
Announcements
Domain name for API request: vpc.intl.tencentcloudapi.com.
This API is used to convert a common public IP into an Elastic IP (EIP for short).
A maximum of 10 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: TransformAddress. |
| Version | Yes | String | Common Params. The value used for this API: 2017-03-12. |
| Region | Yes | String | Common Params. For more information, please see the list of regions supported by the product. |
| InstanceId | Yes | String | The ID of the instance with a common public IP to be operated on, such as ins-11112222. You can query the instance ID by logging into the CVM console. You can also obtain the parameter value from the InstanceId field in the returned result of the API DescribeInstances. |
| Parameter Name | Type | Description |
|---|---|---|
| TaskId | Integer | The async task ID. You can use the DescribeTaskResult API to query the task status. |
| AddressId | String | The unique ID after converting to EIP |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
This example shows you how to convert a public IP to an EIP.
POST / HTTP/1.1
Host: vpc.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: TransformAddress
<Common request parameters>
{
"InstanceId": "ins-3ea0qeu6"
}{
"Response": {
"AddressId": "eip-fk2gmm9s",
"TaskId": 345732,
"RequestId": "070889cb-a42a-40a0-ac50-293ef36e0dfc"
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| AddressQuotaLimitExceeded | The account quota is reached. Each Tencent Cloud account can create up to 20 EIPs in each region. |
| AddressQuotaLimitExceeded.DailyAllocate | The maximum number of requests is reached. The maximum number of requests made by a Tencent Cloud account per day in each region equals to two times the quota. |
| FailedOperation.TaskFailed | Task execution failed. |
| InvalidAddressId.Blocked | The specified EIP is in blocked status. When the EIP is in blocked status, it cannot be bound. You must first unblock it. |
| InvalidInstance.NotSupported | This instance is not supported. |
| InvalidInstanceId.AlreadyBindEip | The specified instance has already been bound to an EIP. You must unbind the current EIP first before binding another EIP. |
| InvalidInstanceId.NotFound | Invalid instance ID. The specified instance ID does not exist. |
| InvalidParameterValue.InstanceHasNoWanIP | The instance does not have a public IP. |
| InvalidParameterValue.InstanceIdMalformed | Incorrect instance ID. |
| InvalidParameterValue.InstanceNoWanIP | Request failed: this instance does not have a WanIP (public IP). |
| InvalidParameterValue.InvalidInstanceState | Operation failed: the status of the instance does not allow this operation. |
| LimitExceeded.MonthlyAddressRecoveryQuota | Ran out of the monthly quota of chances to retrieve IPs. |
| OperationDenied.AddressInArrears | The specified public IP is isolated. |
| OperationDenied.MutexTaskRunning | Mutually exclusive tasks are executing. |
| UnsupportedOperation.AddressStatusNotPermit | This operation is not supported by the IP address status. |
| UnsupportedOperation.InvalidAddressInternetChargeType | This operation is not allowed under the network billing mode of the IP address. |
文档反馈