查询用户带宽包列表信息

更新时间：2025-08-21

描述

查询用户账户下所有带宽包的信息。
支持按带宽包的id、name、bindType进行查询。
返回结果是多重查询条件的交集。
结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定。

请求结构

Plain Text

1GET /v{version}/eipbp?marker={marker}&maxKeys={maxKeys}&id={id}&name={name}&bindType={bindType} HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必须	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
marker	String	否	Query参数	批量获取列表的查询的起始位置，是一个由系统生成的字符串
maxKeys	int	否	Query参数	每页包含的最大数量，最大数量不超过1000。缺省值为1000
id	String	否	Query参数	要查询的带宽包id
name	String	否	Query参数	要查询的带宽包名称
bindType	String	否	Query参数	要查询的带宽包所绑定的资源的类型，"eip"（弹性公网EIP）或"eipgroup"（共享带宽）
type	String	否	Query参数	带宽包的类型，包括BandwidthPackage（带宽包）和AccelerationPackage（跨境加速包），默认全选

返回状态码

成功返回200，失败返回见错误码。

返回头域

除公共头域外，无其他特殊头域

返回参数

参数名称	类型	描述
bpList	List <BandwidthPackage>	包含查询结果的列表
marker	String	标记查询的起始位置，若结果列表为空，此项不存在
isTruncated	boolean	true表示后面还有数据，false表示已经是最后一页
nextMarker	String	获取下一页所需要传递的marker值。当isTruncated为false时，该域不出现
maxKeys	int	每页包含的最大数量

请求示例

Plain Text

1GET /v1/eipbp?marker=bw-IyWRnII7&maxKeys=2 HTTP/1.1
2Host: eip.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02

响应示例

Plain Text

1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Thu, 16 Mar 2017 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6{
7    "nextMarker": "bw-IyWRn123",
8    "marker": "bw-IyWRnII7",
9    "maxKeys": 2,
10    "isTruncated": true,
11    "bpList": [
12        {
13          "name":"bp_1",
14          "id":"bw-IyWRnII7",
15          "bindType":"eip",
16          "bandwidthInMbps":"15",
17          "instanceId":"ip-xefrn257",
18          "eips":[
19              "10.23.54.23"
20          ],
21          "createTime":"2019-08-03T20:38:43Z",
22          "autoReleaseTime":"2019-08-23T12:38:43Z",
23          “type”:"BandwidthPackage",
24          "region":"bj"
25        },
26        {
27          "name":"bp_2",
28          "id":"bw-IyWRnIqw",
29          "bindType":"eipgroup",
30          "bandwidthInMbps":"30",
31          "instanceId":"eg-xsdqn76f",
32          "eips":[
33              "10.23.96.96",
34              "10.23.96.97",
35              "10.23.96.98",
36              "10.23.96.99"
37          ],
38          "createTime":"2019-08-03T20:38:43Z"，
39          "autoReleaseTime":"2019-09-23T12:38:43Z",
40          “type”:"BandwidthPackage",
41          "region":"bj"
42        }
43    ]
44}

BandwidthPackage

参数名称	类型	描述
name	String	带宽包名称
id	String	带宽包id
bindType	String	带宽包所绑定的资源的类型，"eip"（弹性公网EIP）或"eipgroup"（共享带宽）
bandwidthInMbps	int	带宽包的带宽值
instanceId	String	带宽包绑定资源的id
eips	List <String>	若bindType为"eip"，只包含一个eip地址；若bindType为"eipgroup"，则包含共享带宽下的全部eip地址
createTime	String	带宽包创建时间
autoReleaseTime	String	带宽包的自动释放时间,若未设置则同所绑定资源的到期时间一致
type	String	带宽包的类型，BandwidthPackage（带宽包）或 AccelerationPackage（跨境加速包）

region｜String｜带宽包所属区域

调整带宽包带宽

查询带宽包详情

弹性公网IP EIP

弹性公网IP EIP

查询用户带宽包列表信息

BandwidthPackage