私有网络

产品文档

私有网络

createElasticIps

描述

创建一个或者多个弹性公网IP

请求方式

POST

请求地址

https://vpc.jdcloud-api.com/v1/regions/{regionId}/elasticIps/

名称 类型 是否必需 默认值 描述
regionId String True Region ID

请求参数

名称 类型 是否必需 默认值 描述
maxCount Integer True 购买弹性ip数量;取值范围:[1,100]
elasticIpAddress String False 指定弹性ip地址进行创建,当申请创建多个弹性ip时,必须为空
elasticIpSpec ElasticIpSpec True 弹性ip规格
userTags Tag[ ] False 用户标签
ipType String False 弹性ip类型,取值:standard(标准公网IP),edge(边缘公网IP),默认为standard

Tag

名称 类型 是否必需 默认值 描述
key String True Tag键
value String True Tag值

ElasticIpSpec

名称 类型 是否必需 默认值 描述
bandwidthMbps Integer True 弹性公网IP的限速(单位:Mbps),取值范围为[1-200]
provider String True IP线路信息。当IP类型为标准公网IP时,取值为bgp或no_bgp,cn-north-1:bgp;cn-south-1:bgp;cn-east-1:bgp;cn-east-2:bgp。当IP类型为边缘公网IP时,其值可通过调用describeEdgeIpProviders、获取不同边缘节点的边缘公网IP线路信息
chargeSpec ChargeSpec False 计费配置。边缘公网IP支持包年包月、按配置;标准公网IP支持包年包月、按配置、按流量

ChargeSpec

名称 类型 是否必需 默认值 描述
chargeMode String False postpaid_by_duration 计费模式,取值为:prepaid_by_duration,postpaid_by_usage或postpaid_by_duration,prepaid_by_duration表示预付费,postpaid_by_usage表示按用量后付费,postpaid_by_duration表示按配置后付费,默认为postpaid_by_duration.请参阅具体产品线帮助文档确认该产品线支持的计费类型
chargeUnit String False 预付费计费单位,预付费必填,当chargeMode为prepaid_by_duration时有效,取值为:month、year,默认为month
chargeDuration Integer False 预付费计费时长,预付费必填,当chargeMode取值为prepaid_by_duration时有效。当chargeUnit为month时取值为:1~9,当chargeUnit为year时取值为:1、2、3
autoRenew Boolean False True=:OPEN——开通自动续费、False=CLOSE—— 不开通自动续费,默认为CLOSE
buyScenario String False 统一活动凭证。此参数暂未启用,无须指定且指定无效。

返回参数

名称 类型 描述
result Result 返回结果

Result

名称 类型 描述
elasticIpIds String[ ] 弹性公网IP ID列表
requestId String 请求ID

返回码

返回码 描述
200 Successful operation
400 Invalid param 'xxx'
401 Unauthenticated user pin 'xxx'
500 Unknown server error
503 Service unavailable

请求示例

调用方法、签名算法及公共请求参数请参考京东云OpenAPI公共说明

  • 请求示例: 创建一个弹性公网ip

POST

  /v1/regions/cn-north-1/elasticIps/
    {
           "maxCount":1,
           "elasticIpSpec":{
               "bandwidthMbps":1,
               "provider" :"bgp"
           }
       }

返回示例

{
    "requestId": "67174ffe-c056-491d-935d-6b4f7c33b4d9", 
    "result": {
        "elasticIpIds": [
            "fip-xcgb8fva97"
        ]
    }
}
更新时间:2022-04-19 17:47:53
feedback