/scalemgmt/v3/nodes:start: POST

Starts the mmfsd service on a node.

Availability

Available on all IBM Storage Scale editions.

Description

The POST nodes:start request Starts the mmfsd service on a node..

Request URL

https://<IP address or host name of API server>:<port>/scalemgmt/v3/nodes:start

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
body The body of the request that contains the required parameters to be passed on to the IBM Storage Scale system to perform the requested operation. This operation is a long-running operation (LRO). For more information about the parameters, see scalectl node command. Required.
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 indicate the LRO job completed. Check the operation response for detailed results.
    {
  "done": true,
  "error": {
    "details": [
      {
        "@type": "string",
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    ],
    "httpcode": 0,
    "message": "string",
    "status": "CANCELLED"
  },
  "metadata": {
    "@type": "string",
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "name": "string",
  "response": {
    "@type": "string",
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  }
}
  • default: An unexpected error response.
    {
  "code": 0,
  "details": [
    {
      "@type": "string",
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  ],
  "message": "string"
}

Examples

The following example displays how to start the node:

Request data: 
curl -n -k -X POST \
  https://localhost:46443/scalemgmt/v3/nodes:start \
  -H 'accept: application/json' \
  -d '{
    "target_nodes": ["all"]
  }'
Response data: 
{
  "name": "MToyMzliMmEyMi1iMWVhLTQ2ZTEtYTZjYy01OGQ0YzY2YWVjZTA=",
  "metadata": {
    "@type": "type.googleapis.com/generic.v3.LongRunningOperationMetadata",
    "job_id": "MToyMzliMmEyMi1iMWVhLTQ2ZTEtYTZjYy01OGQ0YzY2YWVjZTA=",
    "operation_details": {
      "@type": "type.googleapis.com/node.v3.StartNodeRequest",
      "target_nodes": ["all"]
    },
    "status": "DONE",
    "request_time": "2025-04-10T01:49:26.282870501Z",
    "completion_time": "2025-04-10T01:49:26.520542168Z",
    "last_update_time": "2025-04-10T01:49:26.520542168Z",
    "domain_ids": [
      0
    ]
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/node.v3.StartNodeResponse"
  }
}