弹性公网IPEIP

    申请EIP

    • 申请一个EIP,可用于绑定到任意BLB实例或BCC实例。
    • 创建EIP需要实名认证,若未通过实名认证可以前往百度智能云官网控制台中的安全认证下的实名认证中进行认证。

    请求结构

    POST /v{version}/eip?clientToken={clientToken} HTTP/1.1
    Host: eip.bj.baidubce.com
    Authorization: authorization string
    
    {
        "name": name,
        "bandwidthInMbps": bandwidthInMbps,
        "billing":{
            "paymentTiming": paymentTiming,
            "billingMethod": billingMethod,
            "reservation":{
                "reservationLength": reservationLength,
                "reservationTimeUnit": reservationTimeUnit
            }
        },
        "tags":[
        {
          "tagKey": tagKey,
          "tagValue": tagValue
        }
    }
        

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1。
    clientToken String Query参数 幂等性Token,详见幂等性
    bandwidthInMbps int RequestBody参数 公网带宽,单位为Mbps。对于预付费以及按使用带宽计费的后付费EIP,限制为为1~200之间的整数(代表带宽上限);对于按使用流量计费的后付费EIP,限制为1~200之间的整数(代表允许的带宽流量峰值)
    billing Billing RequestBody参数 订单信息。
    name String RequestBody参数 长度1~65个字节,字母开头,可包含字母数字-_/.字符。若不传该参数,服务会自动生成name。
    tags List<TagModel> RequestBody参数 待创建的标签键值对列表。
    autoRenewTimeUnit String RequestBody参数 支持创建 EIP同时开通自动续费,取值为 month 获 year (默认 month)。
    autoRenewTime int RequestBody参数 支持创建 EIP同时开通自动续费,根据autoRenewTimeUnit的取值有不同的范围,month 为1到9,year 为1到3。

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    参数名称 类型 描述
    eip string 分配的EIP地址

    请求示例,后付费按流量计费

    POST /v1/eip?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
    HOST eip.bj.baidubce.com
    Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
    
    {
        "name":"eip-for-test",
        "bandwidthInMbps": 1,
        "billing":{
            "paymentTiming":"Postpaid",
            "billingMethod":"ByTraffic"
        }
    }

    请求示例,预付费

    POST /v1/eip?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
    HOST eip.bj.baidubce.com
    Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
    
    {
        "name":"eip-for-test",
        "bandwidthInMbps": 1,
        "billing":{
            "paymentTiming":"Prepaid",
            "reservation":{
                "reservationLength":1,
                "reservationTimeUnit":"Month"
            }
        }
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Wed, 10 Apr 2016 08:26:52 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS
    
    {
        "eip":"180.181.3.133"
    }
    上一篇
    API规格
    下一篇
    EIP带宽扩缩容