/scalemgmt/v3/troubleshooting/persistentReserve/{device}/keys: GET

Reads persistent reserve registration key values from a device.

Availability

Available on all IBM Storage Scale editions.

Description

The GET troubleshooting/persistentReserve/{device}/keys request gets information about the persistent reserve registration key values from a device.

Request URL

https://<IP address or host name of API server>:<port>/scalemgmt/v3/troubleshooting/persistentReserve/{device}/keys

where

{device}: Specifies the device name.

Request headers

Accept: application/json

Parameters

The following parameters can be used in the request URL to customize the request:

Table 1. List of parameters
Parameter name	Description and applicable keywords	Required/optional
device	The name of the device.	Required.
node_name	The name of the node that is directly attached to the device to read.	Optional.
X-StorageScaleDomain	The domain to be authorized against for the request. The default value is `StorageScaleDomain`.	Optional.

Request data

No request data.

Response data

200: A successful response.
```
"string"
```

default: An unexpected error response.

{
  "code": 0,
  "details": [
    {
      "@type": "string",
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  ],
  "message": "string"
}

Examples

The following example gets information about the persistent reserve registration key:

Request data:

curl -n -k -X GET https://10.28.12.49:46443/scalemgmt/v3/troubleshooting/persistentReserve/dm-19/keys

Response data:

{
   “keys”: 
       { 
            “node_id”: “1”,
            “node_name”: “Server5x”,
            “key_value”: “00006d0000000001”
      }
}

The following example gets information about the persistent reserve registration key for the specified node name:

Request data:

curl -n -k -X GET https://localhost:46443/scalemgmt/v3/troubleshooting/persistentReserve/dm-19/keys?node_name=test-52

Response data:

{
   “keys”: 
       { 
            “node_id”: “2”,
            “node_name”: “test-52”,
            “key_value”: “00006d0000000002”
      }
}