1. Interface Description
Interface request domain name: vpc.api3.convergecloud.com.
This API (TransformAddress) is used to translate an instance's regular public IP into an EIP.
- The platform limits the number of times to unbind EIP and re-allocate regular public IPs per day per user per region (see EIP Product Introduction). The above quota can be obtained through the API [DescribeAddressQuota](../Elastic IP APIs/DescribeAddressQuota).
Default interface request rate limit: 10 times per second.
Interface update time: 2025-09-17 12:06:11.
The interface only verifies the signature but does not authenticate.
2. Input Parameters
The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.
| Parameter name | Required | Allow NULL | Type | Description |
|---|---|---|---|---|
| Action | Yes | No | String | Public parameter, The value of this interface: TransformAddress |
| Version | Yes | No | String | Public parameter, The value of this interface: 2017-03-12 |
| Region | No | No | String | Public parameter,Regional information A list of supported geographies is available through the DescribeRegions interface |
| InstanceId | Yes | No | String | The instance ID with the public IP address to be operated on. The instance ID is in the format ins-jrkzpvgt. You can retrieve it by logging in to the Console or through the InstanceId returned by the DescribeInstances API.Example: ins-3ea0qeu6 |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| TaskId | Int64 | Task ID Example: 21 |
| AddressId | String | Resource ID Example: eip-s6c9f6r7 |
| RequestId | String | Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem. |
4. Error Code
The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.
| Error Code | Description |
|---|---|
| InvalidInstanceId.NotFound | Invalid instance ID. The specified instance ID does not exist. |
| AddressQuotaLimitExceeded | Insufficient account quota. Each account can create up to 20 EIPs in each region. |
| AddressQuotaLimitExceeded.DailyAllocate | Insufficient purchase attempts. The number of daily subscriptions for each account in each region is twice the quota. |
| InvalidInstance.NotSupported | The instance is not supported. |