华为云计算 云知识 申请弹性公网IPCreatePublicip

普惠上云 2核2G2M云服务器

38元/年

云服务器新品 X实例-4核8G5M

288元/年

GeminiDB Redis 4GB 游戏广告

19元/年

网站搭建 买3年送2年

1元/天

申请弹性公网IPCreatePublicip
时间: 2023-10-12 15:27:27
API网关 云计算
猜你想看：
华为云耀L实例 实时语音识别 云服务器配置 CDN是什么意思 视频点播加速 什么是云桌面

 

功能介绍

申请EIP，支持IPv4和IPv6。 弹性公网IP （ Elastic IP ）提供独立的 公网IP 资源，包括公网IP地址与公网出口带宽服务。可以与弹性 云服务器 、 裸金属服务器 、虚拟IP、 弹性负载均衡 、 NAT网关 等资源灵活地绑定及解绑。拥有多种灵活的计费方式，可以满足各种业务场景的需要。

调试

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

URI

POST /v1/{project_id}/publicips

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取项目ID请参见获取项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

bandwidth

是

CreatePublicipBandwidthOption object

带宽对象

enterprise_project_id

否

String

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

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

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

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

缺省值：0

最小长度：0

最大长度：36

publicip

是

CreatePublicipOption object

弹性公网IP对象
表3 CreatePublicipBandwidthOption

参数

是否必选

参数类型

描述

charge_mode

否

String

  • 功能说明：按流量计费还是按带宽计费。

  • 取值范围：bandwidth，traffic，不填或者为空时默认是bandwidth。其中IPv6国外默认是bandwidth，国内默认是traffic。

缺省值：bandwidth

枚举值：

  • bandwidth

  • traffic

id

否

String

  • 功能说明：带宽ID,创建WHOLE类型带宽的EIP时可以指定之前的共享带宽创建

  • 取值范围：WHOLE类型的带宽ID

最大长度：36

name

否

String

  • 功能说明：带宽名称

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

  • 约束：如果share_type是PER，该参数必须带,如果share_type是WHOLE并且id有值，该参数会忽略。

最小长度：1

最大长度：64

share_type

是

String

  • 功能说明：带宽类型

  • 取值范围：PER，WHOLE（PER为独占带宽，WHOLE是共享带宽）。

  • 约束：该字段为WHOLE时，必须指定带宽ID。

枚举值：

  • WHOLE

  • PER

size

否

Integer

  • 功能说明：带宽大小

  • 取值范围：默认1Mbit/s~2000Mbit/s（具体范围以各区域配置为准，请参见控制台对应页面显示）。

  • 约束：share_type是PER，该参数必须带，如果share_type是WHOLE并且id有值，该参数会忽略。

  • 注意：调整带宽时的最小单位会根据带宽范围不同存在差异。

    • 小于等于300Mbit/s：默认最小单位为1Mbit/s。

    • 300Mbit/s~1000Mbit/s：默认最小单位为50Mbit/s。

    • 大于1000Mbit/s：默认最小单位为500Mbit/s。
表4 CreatePublicipOption

参数

是否必选

参数类型

描述

ip_address

否

String

  • 功能说明：希望申请到的EIP的地址，不指定时由系统自动分配

  • 约束：必须为IPv4地址格式，且必须在可用地址池范围内

最大长度：15

type

是

String

  • 功能说明：EIP的类型

  • 取值范围：5_bgp（全动态BGP），5_sbgp（静态BGP），5_youxuanbgp（优选BGP）

    • 华南-广州：5_bgp、5_sbgp

    • 华东-上海一：5_bgp、5_sbgp

    • 华东-上海二：5_bgp、5_sbgp

    • 华北-北京一：5_bgp、5_sbgp

    • 中国-香港：5_bgp、5_youxuanbgp

    • 亚太-曼谷：5_bgp

    • 亚太-新加坡：5_bgp

    • 非洲-约翰内斯堡：5_bgp

    • 西南-贵阳一：5_sbgp

    • 华北-北京四：5_bgp、5_sbgp

    • 拉美-圣地亚哥：5_bgp

    • 拉美-圣保罗一：5_bgp

    • 拉美-墨西哥城一：5_bgp

    • 拉美-布宜诺斯艾利一：5_bgp

    • 拉美-利马一：5_bgp

    • 拉美-圣地亚哥二： 5_bgp

  • 约束：

    • 必须是系统具体支持的类型。

    • publicip_id为IPv4端口，所以"type"字段未给定时，默认为5_bgp。

ip_version

否

Integer

  • 功能说明：弹性公网IP的版本

  • 取值范围：4、6，ipv6表示开启NAT64能力

  • 约束：

    • 必须是系统具体支持的类型

    • 不填或空字符串时，默认创建ipv4

缺省值：4

枚举值：

  • 4

  • 6

alias

否

String

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

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

最大长度：64

port_id

否

String

  • 功能说明：端口id

  • 约束：必须是存在的端口id，如果该端口不存在或端口已绑定EIP则会提示出错。

最小长度：36

最大长度：36

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

publicip

PublicipCreateResp object

弹性公网IP对象
表6 PublicipCreateResp

参数

参数类型

描述

bandwidth_size

Integer

  • 功能说明：带宽大小，单位为Mbit/s。

create_time

String

  • 功能说明：EIP申请时间（UTC时间）

id

String

  • 功能说明：EIP唯一标识

最大长度：36

public_ip_address

String

  • 功能说明：IPv4时是申请到的EIP地址，IPv6时是IPv6地址对应的IPv4地址

最大长度：15

status

String

  • 功能说明：EIP的状态

  • 取值范围：

    • FREEZED：冻结

    • BIND_ERROR：绑定失败

    • BINDING：绑定中

    • PENDING_DELETE：释放中

    • PENDING_CREATE：创建中

    • NOTIFYING：创建中

    • NOTIFY_DELETE：释放中

    • PENDING_UPDATE：更新中

    • DOWN：未绑定

    • ACTIVE：绑定

    • ELB：绑定ELB

    • VPN：绑定VPN

    • ERROR：失败

枚举值：

  • FREEZED

  • BIND_ERROR

  • BINDING

  • PENDING_DELETE

  • PENDING_CREATE

  • NOTIFYING

  • NOTIFY_DELETE

  • PENDING_UPDATE

  • DOWN

  • ACTIVE

  • ELB

  • VPN

  • ERROR

tenant_id

String

  • 功能说明：项目ID

最大长度：36

type

String

  • 功能说明：EIP的类型

  • 取值范围：5_bgp（全动态BGP），5_sbgp（静态BGP），5_youxuanbgp（优选BGP）

    • 华南-广州：5_bgp、5_sbgp

    • 华东-上海一：5_bgp、5_sbgp

    • 华东-上海二：5_bgp、5_sbgp

    • 华北-北京一：5_bgp、5_sbgp

    • 中国-香港：5_bgp、5_youxuanbgp

    • 亚太-曼谷：5_bgp

    • 亚太-新加坡：5_bgp

    • 非洲-约翰内斯堡：5_bgp

    • 西南-贵阳一：5_sbgp

    • 华北-北京四：5_bgp、5_sbgp

    • 拉美-圣地亚哥：5_bgp

    • 拉美-圣保罗一：5_bgp

    • 拉美-墨西哥城一：5_bgp

    • 拉美-布宜诺斯艾利一：5_bgp

    • 拉美-利马一：5_bgp

    • 拉美-圣地亚哥二： 5_bgp

  • 约束：

    • 必须是系统具体支持的类型。

    • publicip_id为IPv4端口，所以"type"字段未给定时，默认为5_bgp。

最大长度：36

public_ipv6_address

String

  • 功能说明：IPv4时无此字段，IPv6时为申请到的EIP地址

最大长度：39

ip_version

Integer

  • 功能说明：IP版本信息，取值范围是4和6，IPv6为开启NAT64能力

枚举值：

  • 4

  • 6

enterprise_project_id

String

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

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

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

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

最大长度：36

alias

String

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

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

最大长度：64

请求示例

  • 创建IPv4 EIP独享带宽。

    {
  "bandwidth" : {
    "size" : 10,
    "share_type" : "PER",
    "name" : "bandwidth123"
  },
  "publicip" : {
    "ip_version" : 4,
    "type" : "5_bgp"
  }
}

  • 创建IPv6 EIP独享带宽。

    {
  "bandwidth" : {
    "size" : 5,
    "share_type" : "WHOLE",
    "name" : "bandwidth123"
  },
  "publicip" : {
    "ip_version" : 6,
    "type" : "5_bgp"
  }
}

响应示例

状态码： 200

POST操作正常返回

{
  "publicip" : {
    "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c",
    "bandwidth_size" : 0,
    "public_ip_address" : "161.xx.xx.7",
    "ip_version" : 4,
    "create_time" : "2015-07-16 04:10:52",
    "id" : "f588ccfa-8750-4d7c-bf5d-2ede24414706",
    "type" : "5_bgp",
    "status" : "PENDING_CREATE"
  }
}

状态码

状态码

描述

200

POST操作正常返回

错误码

请参见错误码。

 

上一篇：云原生的技术趋势 下一篇：企业如何用好AI，以华为云通用AI解决方案为思考出发点

弹性公网IP EIP

弹性公网IP（Elastic IP）提供独立的公网IP资源，包括公网IP地址与公网出口带宽服务。可以与弹性云服务器、裸金属服务器、虚拟IP、弹性负载均衡、NAT网关等资源灵活地绑定及解绑。拥有多种灵活的计费方式，可以满足各种业务场景的需要

动态BGP带宽：￥23.00/M/月起

立即购买共享流量包价格计算器1对1咨询
智能客服
 

猜你喜欢

最新文章

云服务器0元领取 | 免费体验云产品
申请弹性公网IPCreatePublicip

您找到想要的内容了吗?

是的 没有

意见反馈

0/200

提交 取消

提交成功！非常感谢您的反馈，我们会继续努力做到更好 反馈提交失败！请稍后重试！
推荐产品
相关专题

更多内容

怎么制作一个网站 商标注册流程及费用 Email注册网站 免费网站申请域名 新用户优惠 华为折扣券哪里领 云服务器代金券 文字识别平台 NPM镜像下载 Manjaro镜像下载