创建弹性公网IP

1. 接口描述

接口请求域名： vpc.tencentcloudapi.com 。

本接口 (AllocateAddresses) 用于申请一个或多个弹性公网IP（简称 EIP）。

• EIP 是专为动态云计算设计的静态 IP 地址。借助 EIP，您可以快速将 EIP 重新映射到您的另一个实例上，从而屏蔽实例故障。
• 您的 EIP 与腾讯云账户相关联，而不是与某个实例相关联。在您选择显式释放该地址，或欠费超过24小时之前，它会一直与您的腾讯云账户保持关联。
• 一个腾讯云账户在每个地域能申请的 EIP 最大配额有所限制，可参见 EIP 产品简介，上述配额可通过 DescribeAddressQuota 接口获取。

默认接口请求频率限制：10次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 创建加速IP

需开通Anycast公网加速白名单

输入示例

POST / HTTP/1.1
Host: vpc.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: AllocateAddresses
<公共请求参数>

{
    "AddressCount": 1,
    "AddressType": "AnycastEIP"
}

输出示例

{
    "Response": {
        "AddressSet": [
            "eip-m44ku5d2"
        ],
        "TaskId": "61531428",
        "RequestId": "6EF60BEC-0242-43AF-BB20-270359FB54A7"
    }
}

示例2 创建常规IP

创建常规IP。

输入示例

POST / HTTP/1.1
Host: vpc.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: AllocateAddresses
<公共请求参数>

{
    "AddressCount": 1
}

输出示例

{
    "Response": {
        "AddressSet": [
            "eip-m44ku5d2"
        ],
        "TaskId": "61531421",
        "RequestId": "6EF60BEC-0242-43AF-BB20-270359FB54A7"
    }
}

示例3 创建静态单线IP

需开通静态单线IP白名单

输入示例

POST / HTTP/1.1
Host: vpc.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: AllocateAddresses
<公共请求参数>

{
    "AddressCount": 1,
    "InternetServiceProvider": "CTCC"
}

输出示例

{
    "Response": {
        "AddressSet": [
            "eip-m44ku5d2"
        ],
        "TaskId": "61531429",
        "RequestId": "6EF60BEC-0242-43AF-BB20-270359FB54A7"
    }
}

示例4 申请EIP失败

幂等请求失败，更新幂等参数。

输入示例

POST / HTTP/1.1
Host: vpc.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: AllocateAddresses
<公共请求参数>

{
    "ClientToken": "b8fcdf80-248a-4095-bfa3-7f59df1aec"
}

输出示例

{
    "Response": {
        "Error": {
            "Code": "UnsupportedOperation.DeliveryFailed",
            "Message": "发货失败，请更新`ClientToken`并重试。"
        },
        "RequestId": "8e176c15-f087-4816-a270-306cf87229a6"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。