文档首页 > > 开发指南> 常见操作> 带宽> 查询带宽列表

查询带宽列表

分享
更新时间: 2019/10/30 GMT+08:00

场景描述

根据不同条件查询带宽列表信息。

  • 列表详情中包括共享带宽和独享带宽。
  • 通过IAM服务获取到的Token有效期为24小时,需要同一个Token鉴权时,可以先将Token缓存,避免频繁调用。

涉及API

当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。

  • IAM获取token的API
  • VPC查询带宽列表的API

参数说明及响应详细信息参考《虚拟私有云API参考》“查询带宽列表”章节。

具体步骤

  1. Token认证,具体操作请参考Token认证
  2. 发送“GET https://VPC的Endpoint/v1/{project_id}/bandwidths”。其中project_id为项目ID。
  3. 在Request Header中增加“X-Auth-Token”。
  4. 在GET请求后通过‘?’和‘&’添加不同的查询条件组合,请求示例:https://VPC的Endpoint/v1/8b7e35ad379141fc9df3e178bd64f55c/bandwidths?limit=10&marker=a79fd11a-047b-4f5b-8f12-99c178cc780a。
  5. 请求响应成功后,响应参数如下:
    {
      "bandwidths": [
        {
          "id": "09b99c91-da7c-449f-94e2-f4934c5b2a71",
          "name": "vpngw-f632a7b0-ef50-4ac5-97e9-ddc56b3d5977",
          "size": 2000,
          "share_type": "PER",
          "publicip_info": [
            {
              "publicip_id": "2a65923c-7133-415d-ae3b-cf9635a942c5",
              "publicip_address": "10.xx.xx.3",
              "ip_version": 4,
              "publicip_type": "5_bgp"
            }
          ],
          "tenant_id": "26ae5181a416420998eb2093aaed84d9",
          "bandwidth_type": "bgp",
          "charge_mode": "bandwidth",
          "enterprise_project_id": "0",
          "status": "NORMAL"
        },
        {
          "id": "0a583ff1-b43e-4000-ade3-e7af0097f832",
          "name": "vpngw-7e880d5b-f458-40ad-a7e5-735c44cd8b7d",
          "size": 300,
          "share_type": "PER",
          "publicip_info": [
            {
              "publicip_id": "c754bc9a-16d5-4763-9674-d7561917aa80",
              "publicip_address": "10.xx.xx.9",
              "ip_version": 4,
              "publicip_type": "5_bgp"
            }
          ],
          "tenant_id": "26ae5181a416420998eb2093aaed84d9",
          "bandwidth_type": "bgp",
          "charge_mode": "bandwidth",
          "enterprise_project_id": "0",
          "status": "NORMAL"
        },
        {
          "id": "0a673f00-3640-4a13-949e-7049b2916baf",
          "name": "bandwidth123",
          "size": 10,
          "share_type": "PER",
          "publicip_info": [
            {
              "publicip_id": "cec7fb70-2f82-4561-bd83-2121fb642fdc",
              "publicip_address": "10.xx.xx.184",
              "ip_version": 4,
              "publicip_type": "5_bgp"
            }
          ],
          "tenant_id": "26ae5181a416420998eb2093aaed84d9",
          "bandwidth_type": "bgp",
          "charge_mode": "bandwidth",
          "enterprise_project_id": "0",
          "status": "NORMAL"
        },
        {
          "id": "0dde1eae-1783-46dc-998c-930fbe261ff9",
          "name": "bandwidth123",
          "size": 100,
          "share_type": "PER",
          "publicip_info": [
            {
              "publicip_id": "24232038-e178-40ad-80e4-5abb75db84be",
              "publicip_address": "10.xx.xx.101",
              "ip_version": 4,
              "publicip_type": "5_bgp"
            }
          ],
          "tenant_id": "26ae5181a416420998eb2093aaed84d9",
          "bandwidth_type": "bgp",
          "charge_mode": "bandwidth",
          "enterprise_project_id": "0",
          "status": "NORMAL"
        }
      ]
    }
  6. 请求异常返回值说明请参考错误码

常用列表查询方法

  1. EIP列表查询。

    GET /v1/{project_id}/bandwidths

  2. EIP列表分页查询。

    GET /v1/{project_id}/bandwidths?limit=10

  3. 从某资源开始分页查询EIP列表。

    GET /v1/{project_id}/bandwidths?limit=10&marker=f54e0df7-422d-4ab6-8d65-fd436151479c

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区