/scalemgmt/v3/nodes: POST

Adds a node to the IBM Storage Scale cluster.

Availability

Available on all IBM Storage Scale editions.

Description

The POST nodes request adds a node to the IBM Storage Scale cluster.

Request URL

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

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 that are sent to the IBM Storage Scale system to perform the requested operation. 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

201: A successful response and the node was added to the cluster.
```
{}
```

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 add a node to the cluster:

Request data:

curl -n -k -X POST \
  https://localhost:46443/scalemgmt/v3/nodes \
  -H 'accept: application/json' \
  -d '{
    "node_name": "gpfs-remote-3",
    "admin_node_name": "gpfs-remote-3",
    "accept": true,
    "license_type": "server",
    "node_comment": "Test node 3",
    "node_designations": ["manager", "quorum"]
  }'

Response data:

{
  "node_name": "gpfs-remote-3",
  "admin_node_name": "gpfs-remote-3",
  "node_comment": "Test node 3",
  "node_designations": [
    "manager",
    "quorum"
  ],
  "license_type": "server",
  "node_number": "2",
  "daemon_ip_address": "10.114.205.199"
}