文档首页/ CloudPond云服务/ API参考/ API/ 机柜/ 查询机柜列表
更新时间：2024-05-10 GMT+08:00
查看PDF
分享

查询机柜列表

功能介绍

查询机柜列表。

  • 该接口支持企业项目细粒度权限的校验，具体细粒度请参见 ies:region:list

调试

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

URI

GET /v1/{domain_id}/racks

表1 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

每页的数量

最小值：1

最大值：2000

缺省值：2000

marker

否

String

分页标识

sort_key

否

Array

排序字段

sort_dir

否

Array

排序方式，取值范围：

  • desc：降序
  • asc：升序

edge_site_id

否

String

边缘小站ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

racks

Array of Rack objects

机柜列表

page_info

PageInfo object

分页信息
表4 Rack

参数

参数类型

描述

id

String

机柜ID

name

String

机柜名称

edge_site_id

String

边缘小站ID

rack_category_id

String

机柜目录ID

rack_type

String

机柜类型

status

String

机柜状态。

  • CREATING：创建中
  • AVAILABLE：可用
  • EXPANDING：扩容中
  • PENDING_PAYMENT: 待支付

storage_assigned_size

Integer

已分配存储容量

description

String

机柜描述

rack_sn_no

String

机柜SN号

rack_location_no

String

机柜位置号

created_at

String

创建时间

updated_at

String

更新时间

effected_at

String

生效时间

market_options

MarketOptions object

计费信息

compute_unit

Array of ComputeSpec objects

计算单元信息

storage_unit

StorageUnit object

存储单元

rack_info

RackInfo object

机柜信息
表5 MarketOptions

参数

参数类型

描述

charge_mode

String

计费模式。

  • prepaid：包周期

prepaid_options

PrepaidOptions object

包周期计费信息
表6 PrepaidOptions

参数

参数类型

描述

order_id

String

订单ID

product_id

String

产品ID

pay_mode

String

包周期付款类型

  • FULL: 全预付
  • HALF：半预付
  • PAID_BY_YEAR：按年付费
表7 ComputeSpec

参数

参数类型

描述

flavor_type

String

算力规格类型，如C6

最小长度：1

最大长度：64

count

Integer

计算单元设备数

最小值：1
表8 StorageUnit

参数

参数类型

描述

storage_type

String

存储类型。

  • SAS：高IO
  • SSD：超高IO
  • SAS_SD：高IO(软件定义型专用)
  • SSD_SD：超高IO(软件定义型专用)
  • SAS_ARM：高IO（鲲鹏）
  • SSD_ARM：超高IO（鲲鹏）

capacity

Integer

存储池大小，单位：TB。

最小值：1

gears

Array of integers

存储池销售档位

flavor_type

String

规格类型。例如：highio-4T

最小长度：1

最大长度：64

count

Integer

存储节点台数。

最小值：1
表9 RackInfo

参数

参数类型

描述

power

Integer

机柜功率，单位：w

size

String

机柜尺寸，如100*200*200，单位：cm

最大长度：64

has_lock

Boolean

是否有机柜锁。
表10 PageInfo

参数

参数类型

描述

next_marker

String

下一页标识。

current_count

Integer

当前页数量。

请求示例

查询机柜列表

GET https://{ies_endpoint}/v1/{domain_id}/racks

响应示例

状态码： 200

successful operation

{
  "racks" : [ {
    "id" : "fe89570e-da65-4a4d-a64b-03231257dd96",
    "name" : "basic-absuv",
    "edge_site_id" : "a4a36874-c41b-4295-9fd5-6823864fd564",
    "rack_category_id" : "47ac059f-5df3-422b-b08a-eabba8c01980",
    "rack_type" : "BASIC",
    "status" : "AVAILABLE",
    "storage_assigned_size" : 36,
    "description" : null,
    "rack_sn_no" : "rack_sn_no",
    "rack_location_no" : "rack_location_no",
    "created_at" : "2022-01-18T02:56:02.759098Z",
    "updated_at" : "2022-01-18T02:59:56.559151Z",
    "effected_at" : "2022-01-19T02:59:25Z",
    "market_options" : {
      "charge_mode" : "prepaid",
      "prepaid_options" : {
        "order_id" : "CS2201181056V3SK6",
        "product_id" : "OFFI645544463633592326",
        "pay_mode" : "FULL"
      }
    },
    "compute_unit" : [ {
      "flavor_type" : "C6",
      "count" : 4
    }, {
      "flavor_type" : "Pi2",
      "count" : 1
    } ],
    "storage_unit" : {
      "storage_type" : "SAS",
      "capacity" : 144,
      "gears" : [ 36, 72, 108, 144 ],
      "flavor_type" : "string",
      "count" : 1
    },
    "rack_info" : {
      "power" : 6000,
      "size" : "600mm*1200mm*2000mm（宽*深*高）",
      "has_lock" : true
    }
  } ],
  "page_info" : {
    "current_count" : 1
  }
}

状态码

状态码

描述

200

successful operation

错误码

请参见错误码。

父主题： 机柜

相关文档