文档首页/弹性公网IP EIP/API参考/API/带宽加油包/查询带宽加油包列表
更新时间：2025-02-08 GMT+08:00
查看PDF
分享

查询带宽加油包列表

功能介绍

查询带宽加油包列表信息

URI

GET /v2/{project_id}/bandwidthpkgs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

请求参数

无

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

bandwidthpkgs

Array of BandwidthPkgResp objects

bandwidthpkg对象列表

bandwidthpkgs_links

Array of BandwidthPkgPage objects

翻页展示

表3 BandwidthPkgResp

参数

参数类型

描述

resourceId

String

  • 功能说明：加油包ID
  • 取值范围：1-64，支持数字、字母、中文、_(下划线)、-（中划线）

resourceName

String

  • 功能说明：加油包名称

processedTime

String

  • 功能说明：资源创建时间，UTC时间格式：2016-03-28T00:00:00Z

bandwidthId

String

  • 功能说明：加油包绑定的原带宽ID

pkgSize

Integer

  • 功能说明：加油包的大小，即在原始带宽之上提升的带宽大小
  • 取值范围：>1M，pkgSize+原始带宽大小 < 云服务带宽接口限制的带宽上限

tenantId

String

  • 功能说明：租户id

billingInfo

String

  • 功能说明：加油包订单相关信息格式：非空时值为''orderId:productId''

startTime

String

  • 功能说明：加油包起始生效时间，UTC时间格式：2016-03-28T00:00:00Z
  • 取值范围：startTime >=服务处理请求的时间

endTime

String

  • 功能说明：加油包结束时间UTC时间格式：2016-03-28T00:00:00Z
  • 取值范围：startTime < endTime

status

String

  • 功能说明：加油包资源状态，仅管理员权限可以变更状态
  • 取值范围：''pending'', ''active'', ''completed'', ''error''
表4 BandwidthPkgPage

参数

参数类型

描述

href

String

  • 链接

rel

String

  • 翻页标志

请求示例

GET /v2/{project_id}/bandwidthpkgs

响应示例

状态码： 200

GET操作正常返回

{
  "bandwidthpkgs" : [ {
    "resourceId" : "0003cb59-eaa4-4c05-85bd-4b4cc806992c",
    "resourceName" : "bandwidthpkg-test",
    "pkgSize" : "5",
    "processedTime" : "2018-10-13 20:21:17.465126",
    "bandwidthId" : "6c50f312-2eab-4f08-9da2-b41b0801d8be",
    "tenantId" : "e136ddf186a84dff9c5d5364de79f4e4",
    "billingInfo" : "CS1810091953KI13V:edcb94a885a84ed3a3fdf8ea4d2741da",
    "startTime" : "2018-10-24 21:2:17.465126",
    "endTime" : "2018-10-28 21:2:17.465126",
    "status" : "pending"
  } ],
  "bandwidthpkgs_links" : [ {
    "href" : "https://vpc.br-iaas-odin1.ulanqab.huawei.com:443/v2/0605767f6f00d5762ff9c001c70e7359/bandwidthpkgs?limit=2000&marker=4fc74637-753f-46cb-af8c-b58528887a79&page_reverse=true",
    "rel" : "previous"
  } ]
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题：带宽加油包