Viewing Details About a Rack

Function

This API is used to query details about a rack.

This API supports fine-grained permissions for enterprise projects. For details, see ies:rack:get.

URI

GET /v1/{domain_id}/racks/{id}

**Table 1** URI parameter
Parameter	Mandatory	Type	Description
domain_id	Yes	String	Account ID in the URI.
id	Yes	String	Resource ID.

Request Parameters

**Table 2** Request header parameter
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
rack	Rack object	Rack information.

**Table 4** Rack
Parameter	Type	Description
id	String	Rack ID.
name	String	Rack name.
edge_site_id	String	Edge site ID.
rack_category_id	String	Rack category ID.
rack_type	String	Rack type.
status	String	Rack status. Options: CREATING: Creating AVAILABLE: Available EXPANDING: Expanding PENDING_PAYMENT: Pending payment
storage_assigned_size	Integer	Allocated storage capacity.
description	String	Rack description.
rack_sn_no	String	Rack SN.
rack_location_no	String	Rack location number.
created_at	String	Creation time.
updated_at	String	Update time.
effected_at	String	Effective time.
market_options	MarketOptions object	Billing information.
compute_unit	Array of ComputeSpec objects	Compute unit information.
storage_unit	StorageUnit object	Storage unit.
rack_info	RackInfo object	Rack information.
product_info	ProductInfo object	Attribute information about the product to which the offering belongs.

**Table 5** MarketOptions
Parameter	Type	Description
charge_mode	String	Billing mode. prepaid: Yearly/monthly
prepaid_options	PrepaidOptions object	Yearly/Monthly billing information.
strategies	Array of Strategy objects	The list of sales strategies.

**Table 6** PrepaidOptions
Parameter	Type	Description
order_id	String	Order ID.
product_id	String	Product ID.
pay_mode	String	Yearly/monthly payment type. Options: FULL: All upfront payments HALF: Half upfront payments PAID_BY_YEAR: Yearly payments ZERO_PAID_BY_YEAR: Yearly payments without upfront

**Table 7** Strategy
Parameter	Type	Description
status	String	O&M status. FREEZE: Frozen
scene	String	Resource operating status. Options: ARREAR: Resources are in arrears. POLICE: Resources are frozen for public security. ILLEGAL: Resources are frozen due to violation of laws and regulations. VERIFY: Resources are frozen because the user fails to pass real-name authentication.
effect	String	Resource operations: DELETABLE: Resources can be deleted. UNDELETABLE: Resources cannot be deleted.

**Table 8** ComputeSpec
Parameter	Type	Description
flavor_type	String	Compute flavor type, for example, C6.
count	Integer	The number of compute devices to be included in a specific rack category.

**Table 9** StorageUnit
Parameter	Type	Description
storage_type	String	Storage type. Options: SAS: high I/O SSD: ultra-high I/O SAS_SD: high I/O (software-defined) SSD_SD: ultra-high I/O (software-defined) SAS_ARM: high I/O (Kunpeng) SSD_ARM: ultra-high I/O (Kunpeng) VS_SMALL_CAP: edge object storage (small-capacity) VS_MEDIUM_CAP: edge object storage (medium-capacity) VS_LARGE_CAP: edge object storage (large-capacity) CBR_STANDARD_SMALL_CAP: Cloud Backup and Recovery (basic edition) (small-capacity) CBR_STANDARD_MEDIUM_CAP: Cloud Backup and Recovery (basic edition) (medium-capacity) CBR_STANDARD_LARGE_CAP: Cloud Backup and Recovery (basic edition) (large-capacity) CBR_PROFESSIONAL_SMALL_CAP: Cloud Backup and Recovery (professional edition) (small-capacity) CBR_PROFESSIONAL_MEDIUM_CAP: Cloud Backup and Recovery (professional edition) (medium-capacity) CBR_PROFESSIONAL_LARGE_CAP: Cloud Backup and Recovery (professional edition) (large-capacity)
capacity	Integer	Storage pool size, in TB.
gears	Array of integers	Sales tiers of storage pools.
flavor_type	String	Flavor type such as highio-4T.
count	Integer	The number of storage nodes.

**Table 10** RackInfo
Parameter	Type	Description
power	Integer	Rack power (w).
size	String	Rack size, for example, 100 x 200 x 200 (cm).
has_lock	Boolean	Whether racks have locks.

**Table 11** ProductInfo
Parameter	Type	Description
cloud_service_type	String	Cloud service type.
resource_type	String	Resource type.
resource_spec_code	String	Resource code.

Example Request

Viewing details about a rack

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

Example Response

Status code: 200

successful operation

{
  "rack" : {
    "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" : "600 mm x 1,200 mm x 2,000 mm (width x depth x height)",
      "has_lock" : true
    }
  }
}