Obtaining All the Drive Enclosure Information

GET /de

Introduction

Obtains Drive Enclosure information.

Displays de_id in ascending order.

Request Examples

  • This is an example of obtaining the Drive Enclosure status only.

    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X GET "https://192.168.1.1:5665/api/v1/de?fields=status"

Response Examples

{
  "total_count": 512,
  "list_count": 1,
  "de_list": [
    {
      "de_id": "01",
      "de_href": "/api/v1/de/1",
      "status": "Normal",
      "detail_status": "Normal",
      "max_drive_count": 24,
      "type": SAS,
      "temperature_status": "Normal",
      "temperature": "25"
      "power_1min_avg": 255,
      "power_1hour_avg": 310,
      "iom0_status": "Normal",
      "iom1_status": "Normal",
      "psu0_status": "Normal",
      "psu1_status": "Normal",
      "drive_href_list": [
        "/api/v1/drive/0100",
        "/api/v1/drive/0101",
        "/api/v1/drive/0102",
        "/api/v1/drive/0103"
      ]
    }
  ]
}

Parameters

QUERY PARAMETERS

fields

Array of strings

Parameter to display.

Only the information of the specified Parameter name (Response Body Parameter) is extracted and obtained.

For details about the specification methods, see Property Filter.
de_id

Array of strings

DE ID.

Specify the ID of the Drive Enclosure for which you want information.

Input criteria:

  • You can specify up to 256 values.
status

Array of strings

Status.

Specify the status of the resource for which you want information.
Item Description
Normal Normal state.
Unused Implemented but unused.
Maintenance Maintenance state.
Warning Preventive maintenance is required.
Error An error has occurred and maintenance is required.

Input criteria:

  • You can specify up to 5 values.
max_records

integer

The maximum number of resources for which you want information.

Specify this parameter when you want to limit the number of pieces of information that can be answered.

Input criteria

  • The range of allowed values is 1 to 512.
last_get_id

string

The identifier of the resource for which to retrieve further information.

If all resources matching the response conditions cannot be answered at once, next_href is returned.

The last_get_id is the information given to next_href to obtain further information.

Responses

If successful, the HTTP status code is 200 (OK) and the response body is returned.

RESPONSE BODY

total_count

integer

The total number of Resources present in the device.

If a filter is applied, this is the total number of Resources that meet the criteria.
list_count

integer

Number of Lists to respond.
de_list

Array of objects

The information that can be obtained with GET /de/de_id as the number specified for list_count is output. For more information, see "Responses" in Obtaining Drive Enclosure Information.
next_href

string

Link to get more information.

This item is returned only when it is not possible to respond all information at once.

For example, this item is responded if there are more Resources that match the response condition than the number specified by max_records.