Gnr/recoverygroups/resume/{recoveryGroupName}/{node}: PUT

Resumes a suspended node for a specific recovery group.

Availability

Available with IBM Storage Scale Erasure Code Edition only.

Description

The PUT gnr/recoverygroups/resume/{recoveryGroupName}/{node} request resumes a suspended node for a recovery group. The request helps to restart IBM Storage Scale on the resumed node and also make its disks available. For more information about the fields in the data structures that are returned, see the mmvdisk recoverygroup command.

Request URL

https://<IP address or host name of API server>:<port>scalemgmt/v2/gnr/recoverygroups/resume/{recoveryGroupName}/{node}
where
recoverygroupName
Specifies the recovery group to which the node to be resumed is associated. Required.
node
Specifies the node that must be resumed.

Request headers

Accept: application/json

Request data

No request data:

Response data

{
  "jobs": [
    {
      "jobId": ID of the job,
      "status": "Job status",
      "submitted": "Date and time ",
      "completed": "Date and time ",
      "runtime": Duration,
      "request": {
        "type": "Request Type",
        "url": "Resource URL"
      },
      "result": {},
      "pids": []
    }
  ],
  "status": {
    "code": return status code,
    "message": "Return message."
  }
}

For more information about the fields in the following data structures, see the links at the end of the topic.

"jobs":
An array of elements that describe jobs. Each element describes one job.
"jobId": "ID",
Specifies the unique ID of the job.
"submitted": "Time"
Specifies the date and time at which the job was submitted.
"completed": "Time"
Specifies the date and time at which the job was completed.
"runtime": "Time"
Specifies the duration for which the job ran.
"status": "RUNNING | COMPLETED | FAILED"
Specifies the status of the job.
"result"
Array of commands that are run in this job.
"pids": list
A list of pids for this job.
"request"
"type": "{GET | POST | PUT | DELETE}"
specifies the HTTP request type.
"url": "URL"
Specifies the URL through which the job is submitted.
"status":
Return status.
"message": "ReturnMessage",
Specifies the return message.
"code": ReturnCode
Specifies the return code.

Examples

The following example resumes the node hciece01-hs.gpfs.net for the recovery group rg2.

Request data: 
curl -k -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic a3JpdGlrYTE6YWRtaW4wMDE=' 'https://198.51.100.1:443/scalemgmt/v2/gnr/recoverygroups/resume/rg2/hciece01-hs.gpfs.net'

Response data:

Note: In the JSON data that is returned, the return code indicates whether the command is successful. The response code 200 indicates that the command successfully retrieved the information. Error code 400 represents an invalid request and 500 represents internal server error. 
{
  "jobs": [
    {
      "jobId": 1000000000001,
      "status": "RUNNING",
      "submitted": "2021-04-27 06:31:37,838",
      "completed": "N/A",
      "runtime": 12,
      "request": {
        "type": "PUT",
        "url": "scalemgmt/v2/gnr/recoverygroups/resume/rg2/hciece01-hs.gpfs.net"
      },
      "result": {},
      "pids": []
    }
  ],
  "status": {
    "code": 202,
    "message": "The request was accepted for processing."
  }
}