文档首页/ 弹性公网IP EIP/ API参考/ GEIP API/ 全域弹性公网IP/ 批量创建全域弹性公网IP
更新时间：2024-04-26 GMT+08:00
查看PDF
分享

批量创建全域弹性公网IP

功能介绍

批量创建全域弹性公网IP

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v3/{domain_id}/global-eips/batch-create

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

是

String

最小长度：5

最大长度：32

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户的Token，如何获取用户Token请参见获取用户Token
表3 请求Body参数

参数

是否必选

参数类型

描述

global_eip

是

global_eip object

批量创建全域弹性公网IP请求体对象
表4 global_eip

参数

是否必选

参数类型

描述

name

否

String

  • 功能说明：全域弹性公网IP名称

  • 取值范围：0-64，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）

最小长度：0

最大长度：64

description

否

String

  • 功能说明：用户自定义的资源描述

  • 约束：

    • 值的长度最大512字符，由数字、字母、中文、_(下划线)、-（中划线）、.（点）组成。

最小长度：0

最大长度：512

geip_pool_name

是

String

全域弹性公网IP池子名称

最小长度：1

最大长度：64

access_site

是

String

接入点信息

最小长度：1

最大长度：64

internet_bandwidth_info

是

internet_bandwidth_info object

全域公网带宽对象

count

否

Integer

批创个数

最小值：1

最大值：9999

tags

否

Array of tags objects

全域弹性公网IP标签

enterprise_project_id

否

String

  • 企业项目ID。最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。

  • 创建全域弹性公网IP时，给全域弹性公网IP绑定企业项目ID。

  • 不指定该参数时，默认值是 0

  • 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。

最小长度：1

最大长度：36
表5 internet_bandwidth_info

参数

是否必选

参数类型

描述

id

否

String

全域公网带宽的ID

最小长度：32

最大长度：36

ingress_size

否

Integer

全域公网带宽大小（入云方向）

charge_mode

否

String

计费模式

最小长度：1

最大长度：36

size

否

Integer

全域公网带宽大小（出云方向）

name

否

String

  • 功能说明：全域弹性公网IP名称

  • 取值范围：1-64，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）

最小长度：1

最大长度：64

tags

否

Array of tags objects

全域弹性公网IP标签

type

否

String

全域公网带宽类型

缺省值：standard

最小长度：1

最大长度：64
表6 tags

参数

是否必选

参数类型

描述

key

是

String

  • 功能说明：标签名称

  • 约束：

    • 同一资源的key值不能重复，创建的预定义标签如果与已有的预定义标签完全相同，则会覆盖已有的预定义标签。

    • 键的长度最大36字符，由英文字母、数字、下划线、中划线、中文字符组成。

    • 单个资源最多可以添加20个标签。

最小长度：1

最大长度：36

value

是

String

  • 功能说明：标签值

  • 约束：

    • 值的长度最大43字符，由英文字母、数字、下划线、点、中划线、中文字符组成。

最小长度：0

最大长度：43
表7 tags

参数

是否必选

参数类型

描述

key

是

String

  • 功能说明：标签名称

  • 约束：

    • 同一资源的key值不能重复，创建的预定义标签如果与已有的预定义标签完全相同，则会覆盖已有的预定义标签。

    • 键的长度最大36字符，由英文字母、数字、下划线、中划线、中文字符组成。

    • 单个资源最多可以添加20个标签。

最小长度：1

最大长度：36

value

是

String

  • 功能说明：标签值

  • 约束：

    • 值的长度最大43字符，由英文字母、数字、下划线、点、中划线、中文字符组成。

最小长度：0

最大长度：43

响应参数

状态码： 202

表8 响应Header参数

参数

参数类型

描述

X-Request-Id

-

本次请求编号
表9 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

global_eips

Array of BatchCreateGlobalEipJob objects

响应对象
表10 BatchCreateGlobalEipJob

参数

参数类型

描述

id

String

全域弹性公网IP的ID

name

String

  • 功能说明：全域弹性公网IP名称

  • 取值范围：1-64，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）

最小长度：1

最大长度：64

job_id

String

请求完成的job id

请求示例

批量创建两个按带宽计费，大小为50的全域弹性公网IP

POST https://{Endpoint}/v3/{domain_id}/global-eips/batch-create

{
  "global_eip" : {
    "access_site" : "cn-south-odin",
    "geip_pool_name" : "cn-south-odin",
    "count" : 2,
    "internet_bandwidth_info" : {
      "name" : "bandwidth-981s",
      "charge_mode" : "bandwidth",
      "size" : 50,
      "type" : "standard"
    },
    "name" : "geip-981s"
  }
}

响应示例

状态码： 202

Accepted

{
  "request_id" : "246b2e2529c6add3af8d177079f0ff4e",
  "global_eips" : [ {
    "id" : "4a92ceb7-51da-4179-827b-e5f7acc9436c",
    "name" : "eip-981s-0001",
    "job_id" : "42e7b614-ced2-458e-8573-bcd3ce66ad7e"
  }, {
    "id" : "dad6a045-c939-456c-92f2-3c41b0750260",
    "name" : "eip-981s-0002",
    "job_id" : "e75ea60a-7ab6-4b08-a36c-77f984e85314"
  } ]
}

状态码

状态码

描述

202

Accepted

错误码

请参见错误码。

父主题： 全域弹性公网IP

相关文档