创建弹性公网IP

最近更新时间:2018-10-26 15:01:34

1. 接口描述

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

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

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

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

注意:本接口支持金融区地域。由于金融区和非金融区是隔离不互通的,因此当公共参数 Region 为金融区地域(例如 ap-shanghai-fsi)时,需要同时指定带金融区地域的域名,最好和 Region 的地域保持一致,例如:vpc.ap-shanghai-fsi.tencentcloudapi.com 。

2. 输入参数

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

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:AllocateAddresses
Version String 公共参数,本接口取值:2017-03-12
Region String 公共参数,详见产品支持的地域列表
AddressCount Integer 申请 EIP 数量,默认值为1。

3. 输出参数

参数名称 类型 描述
AddressSet Array of String 申请到的 EIP 的唯一 ID 列表。
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 创建弹性公网IP

输入示例

https://vpc.tencentcloudapi.com/?Action=AllocateAddresses
&AddressCount=1
&<公共请求参数>

输出示例

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

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

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

命令行工具

6. 错误码

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

错误码 描述
AddressQuotaLimitExceeded 账户配额不足,每个腾讯云账户每个地域下最多可创建 20 个 EIP。
AddressQuotaLimitExceeded.DailyAllocate 申购次数不足,每个腾讯云账户每个地域每天申购次数为配额数*2 次。