查询机柜列表 - ListRacks

功能介绍

查询机柜列表。

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

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
ies:edgeSite:listRacks
List
edgeSite *
g:EnterpriseProjectId
ies:rack:list
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
ies:edgeSite:listRacks	List	edgeSite *	g:EnterpriseProjectId	ies:rack:list	-

URI

GET /v1/{domain_id}/racks

表1 路径参数
参数	是否必选	参数类型	描述
domain_id	是	String	path中租户的账号ID

表2 Query参数
参数	是否必选	参数类型	描述
limit	否	Integer	每页的数量
marker	否	String	分页标识
sort_key	否	Array of strings	排序字段
sort_dir	否	Array of strings	排序方式，取值范围： desc：降序 asc：升序
edge_site_id	否	String	边缘小站ID
delivery_order_id	否	String	交易单ID
status	否	Array of strings	根据机柜状态查询，支持多值查询

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
racks	Array of Rack objects	机柜列表
page_info	PageInfo object	分页信息

表5 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	机柜信息
product_info	ProductInfo object	商品归属产品属性信息

表6 MarketOptions
参数	参数类型	描述
charge_mode	String	计费模式。 prepaid：包周期
prepaid_options	PrepaidOptions object	包周期计费信息
strategies	Array of Strategy objects	销售策略列表

表7 PrepaidOptions
参数	参数类型	描述
order_id	String	订单ID
product_id	String	产品ID
pay_mode	String	包周期付款类型 FULL: 全预付 HALF：半预付 PAID_BY_YEAR：按年付费 ZERO_PAID_BY_YEAR：零预付-按年 ZERO_PAID_BY_MONTH：零预付-按月

表8 Strategy
参数	参数类型	描述
status	String	运维状态说明： FREEZE - 已冻结
scene	String	资源运营状态场景： ARREAR：欠费场景； POLICE：公安场景。 ILLEGAL：违规场景。 VERIFY：客户未实名认证冻结场景。
effect	String	资源运营功能： DELETABLE：可删除 UNDELETABLE：不可删除

表9 ComputeSpec
参数	参数类型	描述
flavor_type	String	算力规格类型，如C6
count	Integer	计算单元设备数

**表10** StorageUnit
参数	参数类型	描述
storage_type	String	存储类型。 SAS：高IO SSD：超高IO SAS_SD：高IO(软件定义型专用) SSD_SD：超高IO(软件定义型专用) SAS_ARM：高IO（鲲鹏） SSD_ARM：超高IO（鲲鹏） VS_SMALL_CAP：边缘对象存储-小容量型 VS_MEDIUM_CAP：边缘对象存储-中容量型 VS_LARGE_CAP：边缘对象存储-大容量型 CBR_STANDARD_SMALL_CAP:云备份(基础版)-小容量型 CBR_STANDARD_MEDIUM_CAP:云备份(基础版)-中容量型 CBR_STANDARD_LARGE_CAP:云备份(基础版)-大容量型 CBR_PROFESSIONAL_SMALL_CAP:云备份(专业版)-小容量型 CBR_PROFESSIONAL_MEDIUM_CAP:云备份(专业版)-中容量型 CBR_PROFESSIONAL_LARGE_CAP:云备份(专业版)-大容量型
capacity	Integer	存储池大小，单位：TB。
gears	Array of integers	存储池销售档位
flavor_type	String	规格类型。例如：highio-4T
count	Integer	存储节点台数。

**表11** RackInfo
参数	参数类型	描述
power	Integer	机柜功率，单位：w
size	String	机柜尺寸，如100200200，单位：cm
has_lock	Boolean	是否有机柜锁。

**表12** ProductInfo
参数	参数类型	描述
cloud_service_type	String	云服务类型
resource_type	String	资源类型
resource_spec_code	String	资源编码

**表13** 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
  }
}