华为云计算 云知识 共享带宽插入弹性公网IPAddPublicipsIntoSharedBandwidth

新客秒杀 2核2G 3M L实例

68元/年

普惠上云 领千元上云礼券

立即前往

企业专享 X实例 4核8G 5M

888元/年

热门域名 1元 随心购

1元/年起

共享带宽插入弹性公网IPAddPublicipsIntoSharedBandwidth
时间: 2023-10-16 15:49:25
猜你想看：
实时语音识别 云服务器配置 CDN是什么意思 视频点播加速 什么是云桌面

 

功能介绍

共享带宽插入EIP。

接口约束

在共享带宽中批量插入EIP时，一次可批量操作100个EIP。

调试

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

URI

POST /v2.0/{project_id}/bandwidths/{bandwidth_id}/insert

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

bandwidth_id

是

String

带宽唯一标识

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

bandwidth

是

AddPublicipsIntoSharedBandwidthOption object

带宽对象
表3 AddPublicipsIntoSharedBandwidthOption

参数

是否必选

参数类型

描述

publicip_info

是

Array of InsertPublicipInfo objects

  • 功能说明：要插入共享带宽的EIP信息或者IPv6端口

  • 约束：WHOLE类型的带宽支持多个EIP或者IPv6端口，跟租户的配额相关，默认一个共享带宽的配额为20
表4 InsertPublicipInfo

参数

是否必选

参数类型

描述

publicip_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

publicip_id

是

String

  • 功能说明：带宽对应的EIP或者IPv6端口PORT的唯一标识

最大长度：36

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

bandwidth

BandwidthRespInsert object

带宽对象
表6 BandwidthRespInsert

参数

参数类型

描述

bandwidth_type

String

  • 功能说明：带宽类型，共享带宽默认为share。

  • 取值范围：share，bgp，sbgp等。

    • share：共享带宽

    • bgp：动态bgp

    • sbgp：静态bgp

最小长度：1

最大长度：36

charge_mode

String

  • 功能说明：按流量计费,按带宽计费还是按增强型95计费。

  • 取值范围：bandwidth（按带宽计费），traffic（按流量计费），95peak_plus（按增强型95计费），不返回或者为空时表示是bandwidth。

  • 约束：只有共享带宽支持95peak_plus（按增强型95计费），按增强型95计费时需要指定保底百分比，默认是20%。

枚举值：

  • bandwidth

  • traffic

  • 95peak_plus

id

String

  • 功能说明：带宽唯一标识

最大长度：36

name

String

  • 功能说明：带宽名称

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

最小长度：1

最大长度：64

publicip_info

Array of PublicipInfoResp objects

  • 功能说明：带宽对应的 弹性公网IP 信息

  • 约束：WHOLE类型的带宽支持多个弹性 公网IP ，PER类型的带宽只能对应一个弹性公网IP

billing_info

String

  • 功能说明：账单信息，如果billinginfo不为空，说明是包周期的带宽

最小长度：0

最大长度：255

share_type

String

  • 功能说明：带宽类型，标识是否是共享带宽

  • 取值范围：WHOLE，PER

    • WHOLE表示共享带宽

    • PER表示独享带宽

枚举值：

  • WHOLE

  • PER

size

Integer

  • 功能说明：带宽大小。

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

tenant_id

String

功能说明：用户所属租户ID

最大长度：36

ent erp rise_project_id

String

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

  • 创建共享带宽时，给共享带宽绑定企业项目ID。

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

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

最大长度：36

status

String

  • 功能说明：带宽的状态

  • 取值范围：

    • FREEZED：冻结

    • NORMAL：正常

枚举值：

  • FREEZED

  • NORMAL

enable_bandwidth_rules

Boolean

  • 功能说明：是否开启企业级qos

  • 取值范围：true/false

rule_quota

Integer

  • 功能说明：带宽支持的最大分组规则数。

最小值：0

最大值：1024

bandwidth_rules

Array of BandWidthRules objects

  • 功能说明：带宽规则对象
表7 BandWidthRules

参数

参数类型

描述

id

String

  • 功能说明：带宽规则ID

最大长度：36

name

String

  • 功能说明：带宽规则名称

最小长度：0

最大长度：64

admin_state_up

Boolean

  • 功能说明：配置状态，为False时配置不生效。

egress_size

Integer

  • 功能说明：出网带宽最大值，单位Mbps

  • 取值范围[0,n]，其中n为所属带宽的带宽大小（size字段）。0表示设置为最大带宽

最小值：0

缺省值：0

egress_guarented_size

Integer

  • 功能说明：出网保障带宽大小，单位Mbps

  • 取值范围[0,x]，其中x为所属带宽剩余的保障额

最小值：0

缺省值：0

publicip_info

Array of PublicipInfoResp objects

  • 功能说明：带宽对应的弹性公网IP信息

  • 约束：WHOLE类型的带宽支持多个弹性公网IP，PER类型的带宽只能对应一个弹性公网IP
表8 PublicipInfoResp

参数

参数类型

描述

publicip_address

String

  • 功能说明：功能说明：EIP或者IPv6端口的地址

最大长度：15

publicip_id

String

  • 功能说明：带宽对应的EIP或者IPv6端口的唯一标识

最大长度：36

publicip_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

publicipv6_address

String

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

最大长度：39

ip_version

Integer

  • 功能说明：IP版本信息

  • 取值范围：

    • 4：IPv4

    • 6：开启NAT64能力

枚举值：

  • 4

  • 6

请求示例

将id为d91b0028-6f6b-4478-808a-297b75b6812a、1d184b2c-4ec9-49b5-a3f9-27600a76ba3f的弹性公网IP插入共享带宽，支持多个弹性公网IP插入共享带宽。

{
  "bandwidth" : {
    "publicip_info" : [ {
      "publicip_id" : "d91b0028-6f6b-4478-808a-297b75b6812a",
      "publicip_type" : "5_dualStack"
    }, {
      "publicip_id" : "1d184b2c-4ec9-49b5-a3f9-27600a76ba3f"
    } ]
  }
}

响应示例

状态码： 200

POST操作正常返回

{
  "bandwidth" : {
    "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c",
    "billing_info" : "CS1712121146TSQOJ:0616e2a5dc9f4985ba52ea8c0c7e273c:southchina:35f2b308f5d64441a6fa7999fbcd4321",
    "size" : 10,
    "share_type" : "WHOLE",
    "bandwidth_type" : "share",
    "publicip_info" : [ {
      "publicip_id" : "d91b0028-6f6b-4478-808a-297b75b6812a",
      "ip_version" : 4,
      "publicip_type" : "5_dualStack",
      "publicip_address" : "::ffff:192.168.89.9"
    }, {
      "publicip_id" : "1d184b2c-4ec9-49b5-a3f9-27600a76ba3f",
      "ip_version" : 4,
      "publicip_type" : "5_bgp",
      "publicip_address" : "99.xx.xx.82"
    } ],
    "name" : "bandwidth123",
    "enable_bandwidth_rules" : false,
    "rule_quota" : 0,
    "bandwidth_rules" : [ ],
    "charge_mode" : "bandwidth",
    "id" : "3fa5b383-5a73-4dcb-a314-c6128546d855"
  }
}

状态码

状态码

描述

200

POST操作正常返回

错误码

请参见错误码。

 

上一篇：客户原声：自助报税产品如何解决代账难题？ 下一篇：通过协议转换网关实现泛协议设备接入华为云物联网平台

弹性公网IP EIP 

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

 

产品详情立即注册特惠活动
 
[免费体验中心]免费领取体验产品，快速开启云上之旅免费

猜你喜欢

最新文章

云服务器0元领取 | 免费体验云产品
共享带宽插入弹性公网IPAddPublicipsIntoSharedBandwidth

您找到想要的内容了吗?

是的 没有

意见反馈

0/200

提交 取消

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

更多内容

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