Refresh Host Raid Information

PUT/zstack/v1/storage-devices/local-raid/actions

Request

cURL

curl --request PUT \
  --url '/v1/storage-devices/local-raid/actions' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "status": "ok",
  "method": "PUT",
  "path": "/v1/storage-devices/local-raid/actions"
}

Headers

Authorization: OAuth the-session-uuid

Body

{
  "refreshLocalRaid": {
    "hostUuid": "36e5bbc506d632a5ac8e474e6d3b0caf"
  },
  "systemTags": [],
  "userTags": []
}

In the example above, systemTags and userTags fields can be omitted. They are listed to indicate that the body can contain these two fields.

Curl Example

curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X PUT -d '{"refreshLocalRaid":{"hostUuid":"36e5bbc506d632a5ac8e474e6d3b0caf"}}' \
http://localhost:8080/zstack/v1/storage-devices/local-raid/actions

Parameter List

Name	Type	Location	Description	Starting Version
hostUuid	String	body(contained in the `refreshLocalRaid` structure)	Host UUID	3.6
systemTags (Optional)	List	body		3.6
userTags (Optional)	List	body		3.6

API Response

Response Example

{
  "inventories": [
    {
      "name": "LSI 2208 Raid Controller",
      "uuid": "821bab441f4530b5a741bbed9ca76eb8",
      "description": "this is a description",
      "productName": "LSI 2208 MegaRAID",
      "sasAddress": "500304801f948100",
      "createDate": "Nov 14, 2017 2:20:57 PM",
      "lastOpDate": "Nov 14, 2017 2:20:57 PM"
    }
  ]
}

Name	Type	Description	Starting Version
success	boolean		0.6
error	ErrorCode	Error code. If not null, the operation failed. If null, the operation succeeded. See error for details	3.6
inventories	List	See inventories for details	3.6

error

Name	Type	Description	Starting Version
code	String	Error code number. Globally unique identifier of the error, for example SYS.1000, HOST.1001.	0.6
description	String	Brief error description	0.6
details	String	Detailed error information	0.6
elaboration	String	Reserved field, defaults to null	0.6
opaque	LinkedHashMap	Reserved field, defaults to null	0.6
cause	ErrorCode	Root cause error. The error that caused the current error. If there is no original error, this field is null.	0.6

inventories

Name	Type	Description	Starting Version
name	String	Resource name	3.6
uuid	String	UUID of the resource. Uniquely identifies the resource.	3.6
description	String	Resource description	3.6
productName	String	Product name	3.6
sasAddress	String	SAS address	3.6
hostUuid	String	Host UUID	3.6
createDate	Timestamp	Create time	3.6
lastOpDate	Timestamp	Last update time	3.6
adapterNumber	Integer	Raid card number	3.6
raidPhysicalDrives	List	See raidPhysicalDrives for details	3.6

raidPhysicalDrives

Name	Type	Description	Starting Version
uuid	String	UUID of the resource. Uniquely identifies the resource.	3.6
name	String	Resource name	3.6
raidLevel	String	Raid level	3.6
raidControllerUuid	String	Raid Controller Uuid	3.6
description	String	Resource description	3.6
enclosureDeviceId	Integer	Enclosure Id	3.6
slotNumber	Integer	Slot number	3.6
deviceId	Integer	Device Id	3.6
diskGroup	Integer	Disk Group Id	3.6
wwn	String	WWN	3.6
serialNumber	String	Serial number	3.6
deviceModel	String	Disk model	3.6
size	Long	Disk size	3.6
driveState	String	Disk status	3.6
driveType	String	Interface type	3.6
mediaType	String	Media type	3.6
rotationRate	Integer	Rotation speed	3.6
createDate	Timestamp	Create time	3.6
lastOpDate	Timestamp	Last update time	3.6
locateStatus	LocateStatus	See locateStatus for details	3.6

locateStatus

Name	Type	Description	Starting Version
Enabled	LocateStatus	Locator LED blinking	3.6
Disabled	LocateStatus	Locator LED off	3.6

SDK Examples

Java SDK

RefreshLocalRaidAction action = new RefreshLocalRaidAction();
action.hostUuid = "36e5bbc506d632a5ac8e474e6d3b0caf";
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
RefreshLocalRaidAction.Result res = action.call();

Python SDK

RefreshLocalRaidAction action = RefreshLocalRaidAction()
action.hostUuid = "36e5bbc506d632a5ac8e474e6d3b0caf"
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
RefreshLocalRaidAction.Result res = action.call()