API Reference | ZStack ZSphere · ZVF | ZStack Resource Center

API Request

URLs

GET zstack/v1/primary-storage/stranger

Headers

Authorization: OAuth the-session-uuid

Curl Example

curl -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" -X GET http://localhost:8080/zstack/v1/primary-storage/stranger?clusterUuid=3f7c761b89a5384ebeb6c186012d0997

Parameter List

Name	Type	Location	Description	Starting Version
clusterUuid	String	query	Cluster UUID	5.0.0
systemTags (Optional)	List	query	System tags	5.0.0
userTags (Optional)	List	query	User tags	5.0.0

API Response

Response Example

{
  "inventories": [
    {
      "uuid": "7a8202c37ea63e1093acb2c8d1d03e97",
      "name": "SharedBlockGroup-1",
      "url": "/dev/vg_uuid",
      "type": "SharedBlock",
      "attachedClusterUuids": [
        "07b8dedcc1b53243b9778b7a95e3cc25"
      ]
    }
  ],
  "resetVgUuidRequiredUuids": [
    "7a8202c37ea63e1093acb2c8d1d03e97"
  ]
}

Name	Type	Description	Starting Version
inventories	List	List of discovered data storage inventories	5.0.0
resetVgUuidRequiredUuids	List	List of candidate data storage UUIDs whose VG UUIDs must be reset	5.1.0
success	boolean	Whether the operation succeeded	5.0.0
error	ErrorCode	For details, see error	5.0.0

#error

Name	Type	Description	Starting Version
code	String	Error code, which globally and uniquely identifies the error, for example, SYS.1000 or HOST.1001	0.6
description	String	Summary description of the error	0.6
details	String	Details of the error	0.6
elaboration	String	Reserved field. The default value is null	0.6
opaque	LinkedHashMap	Reserved field. The default value is null	0.6
cause	ErrorCode	Root error that caused the current error. This field is null if there is no source error	0.6

SDK Examples

Java SDK

DiscoverStrangePrimaryStorageAction action = new DiscoverStrangePrimaryStorageAction();
action.clusterUuid = "3f7c761b89a5384ebeb6c186012d0997";
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
DiscoverStrangePrimaryStorageAction.Result res = action.call();

Python SDK

action = DiscoverStrangePrimaryStorageAction()
action.clusterUuid = "3f7c761b89a5384ebeb6c186012d0997"
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
res = action.call()