Disk operations

RESTful API for IBM® Spectrum Control Base Edition uses the GET and POST commands for disk operations.

You can run a disk query by issuing the GET command to get a list of disks that belong to a storage system and their properties, or display the properties of a single disk.

For example, GET /api/v1/disks/1 lists the properties of the disk with identification number 1, as illustrated below.

OK 200
{
	"id": "1", 
	"array": "pur15m1",
	"name": "1:Disk:1:2",
	"status": "OK", 
	"capacity": "2TB", 
	"vendor" : "IBM", 
	"model" : "ST32000444SS", 
	"size" : "1878633", 
	"serial" : "9WM1YM3M", 
	"requires_service" : "REPLACE", 
	"service_reason" : "HARDWARE_ERROR", 
	"temperature" : 19, 
	"encryption" : "Not supported"
	"controller" : "SAS"
}

You can initiate phase-in or phase-out action on a disk by issuing the POST command with the following syntax:

POST /api/v1/disks/<disk-id>/phasein
POST /api/v1/disks/<disk-id>/phaseout

For example, POST /api/v1/disks/82/phasein starts a phase-in procedure for the disk with identification number 82. The response to the request is OK, followed by the task ID, as illustrated below. The task ID can be used in a query request to monitor the task progress, see Query request and response.

OK
{
 	"task id": "04fc6120-60ae-4182-baa9-687d6ae96ffe"
}