查询带宽列表ListBandwidths_带宽_弹性公网IPAPI-华为云

华为云计算云知识查询带宽列表ListBandwidths

开年采购季抽奖赢万元免单

立即前往

续费同价 L实例 2核2G 4M

98元/年

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

198元/年

热门域名 1元随心购

1元/年起

查询带宽列表ListBandwidths

时间: 2023-10-16 15:58:09

猜你想看：

实时语音识别云服务器配置 CDN是什么意思视频点播加速什么是云桌面

功能介绍

查询带宽列表。

调试

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

URI

GET /v1/{project_id}/bandwidths

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取项目ID请参见获取项目ID

表2 Query参数
参数	是否必选	参数类型	描述
marker	否	String	功能说明：取值为上一页数据的最后一条记录的id，为空时为查询第一页最大长度：36
limit	否	Integer	功能说明：每页返回的个数取值范围：0~intmax 最小值：0
enterprise_project_id	否	String	功能说明：企业项目ID。可以使用该字段过滤某个企业项目下的EIP。取值范围：最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。“0”表示默认企业项目。若需要查询当前用户所有企业项目绑定的弹性公网IP ，请传参all_granted_eps。关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。
share_type	否	String	功能说明：带宽类型，标识是否是共享带宽取值范围：WHOLE，PER WHOLE：共享带宽 PER：独享带宽枚举值： WHOLE PER

请求参数

无

响应参数

状态码： 200

表3 响应Body参数
参数	参数类型	描述
bandwidths	Array of BandwidthResp objects	带宽列表对象

表4 BandwidthResp
参数	参数类型	描述
bandwidth_type	String	功能说明：带宽类型，共享带宽默认为share。取值范围：share，bgp，sbgp等。 share：共享带宽 bgp：动态bgp sbgp：静态bgp 最小长度：1 最大长度：36
billing_info	String	功能说明：账单信息，如果billinginfo不为空，说明是包周期的带宽最小长度：0 最大长度：255
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类型的带宽支持多个EIP，PER类型的带宽只能对应一个EIP
share_type	String	功能说明：共享带宽类型，标识是否是共享带宽取值范围：PER，WHOLE（PER为独占带宽，WHOLE是共享带宽）。枚举值： WHOLE PER
size	Integer	功能说明：带宽大小取值范围：默认1Mbit/s~2000Mbit/s（具体范围以各区域配置为准，请参见控制台对应页面显示）。
tenant_id	String	功能说明：用户所属租户ID 最大长度：36
enterprise_project_id	String	企业项目ID。最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。创建弹性公网IP时，给弹性公网IP绑定企业项目ID。不指定该参数时，默认值是 0 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。最大长度：36
status	String	功能说明：带宽的状态取值范围： FREEZED：冻结 NORMAL：正常枚举值： FREEZED NORMAL
enable_bandwidth_rules	Boolean	功能说明：是否开启企业级qos 取值范围：true/false，该字段仅在上海1局点返回
rule_quota	Integer	功能说明：带宽支持的最大分组规则数。（该字段仅在上海1局点返回）最小值：0 最大值：1024
bandwidth_rules	Array of BandWidthRules objects	功能说明：带宽规则对象（该字段仅在上海1局点返回）
created_at	String	功能说明：资源创建时间，UTC时间格式： yyyy-MM-ddTHH:mm:ss
updated_at	String	功能说明：资源更新时间，UTC时间格式： yyyy-MM-ddTHH:mm:ss
public_border_group	String	功能说明：表示中心站点资源或者边缘站点资源取值范围： center、边缘站点名称约束：共享带宽只能绑定与该字段相同的publicip 最小长度：1 最大长度：64

表5 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

表6 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

请求示例

GET https://{Endpoint}/v1/{project_id}/bandwidths?limit=3&marker=4779ab1c-7c1a-44b1-a02e-93dfc361b32d

响应示例

状态码： 200

GET和PUT操作正常返回

{
  "bandwidths" : [ {
    "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c",
    "enterprise_project_id" : "0",
    "billing_info" : "CS1712121146TSQOJ:0616e2a5dc9f4985ba52ea8c0c7e273c:southchina:35f2b308f5d64441a6fa7999fbcd4321",
    "size" : 5,
    "share_type" : "PER",
    "bandwidth_type" : "bgp",
    "publicip_info" : [ {
      "publicip_id" : "80d5b82e-43b9-4f82-809a-37bec5793bd4",
      "ip_version" : 4,
      "publicip_type" : "5_bgp",
      "publicip_address" : "161.xx.xx.10"
    } ],
    "name" : "ddddd",
    "charge_mode" : "bandwidth",
    "enable_bandwidth_rules" : false,
    "rule_quota" : 0,
    "bandwidth_rules" : [ ],
    "id" : "a79fd11a-047b-4f5b-8f12-99c178cc780a",
    "status" : "NORMAL"
  }, {
    "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c",
    "enterprise_project_id" : "0",
    "size" : 6,
    "share_type" : "PER",
    "bandwidth_type" : "bgp",
    "publicip_info" : [ {
      "publicip_id" : "6285e7be-fd9f-497c-bc2d-dd0bdea6efe0",
      "ip_version" : 4,
      "publicip_type" : "5_bgp",
      "publicip_address" : "161.xx.xx.9"
    } ],
    "name" : "22212",
    "enable_bandwidth_rules" : false,
    "rule_quota" : 0,
    "bandwidth_rules" : [ ],
    "charge_mode" : "bandwidth",
    "id" : "3fa5b383-5a73-4dcb-a314-c6128546d855",
    "status" : "NORMAL"
  }, {
    "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c",
    "enterprise_project_id" : "0",
    "size" : 5,
    "share_type" : "PER",
    "bandwidth_type" : "bgp",
    "publicip_info" : [ {
      "publicip_id" : "4ca21961-8e52-4ff4-b9c5-af2dcc2c7b50",
      "ip_version" : 4,
      "publicip_type" : "5_bgp",
      "publicip_address" : "161.xx.xx.13"
    } ],
    "name" : "2222",
    "enable_bandwidth_rules" : false,
    "rule_quota" : 0,
    "bandwidth_rules" : [ ],
    "charge_mode" : "bandwidth",
    "id" : "f54e0df7-422d-4ab6-8d65-fd436151479c",
    "status" : "NORMAL"
  } ]
}

状态码

状态码	描述
200	GET和PUT操作正常返回

错误码

请参见错误码。

上一篇：查询弹性伸缩策略和伸缩实例配额ShowPolicyAndInstanceQuota 下一篇：DevOps实践与转型路径

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

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

弹性公网IP EIP

最新文章

更多内容

7*24

备案

专业服务

退订

建议反馈

售前咨询热线