/scalemgmt/v3/filesystems/{name}/manager: POST

Update the manager node of an existing file system.

Availability

Available on all IBM Storage Scale editions.

Description

The POST /filesystems/{name}/manager request updates the manager node of an existing file system.

Request URL

https://<IP address or host name of API server>:<port>/scalemgmt/v3//filesystems/{name}/manager

where

{name}: Specifies the name of the manager node.

Request headers

Accept: application/json

Request parameters

Table 1. List of request parameters
Parameter name	Description and applicable keywords	Required/optional
name	The name of the manager node.	Required.
manager	The body of the request that contains the parameters that are sent to IBM Storage Scale to perform the requested operation. `{ "manager": "string" }`	Required.
update_mask	The fields to update in an update request.	Optional.
X-StorageScaleDomain	Specifies the domain to authorize for the request. The default value is `StorageScaleDomain`.	Optional.

Request data

No request data.

Response data

200: A successful response.

{
  "cesinfo": {
    "address_policy": "string",
    "ces_shared_root": "string",
    "cesnodes": [
      {
        "ces_group": "string",
        "ces_ip_list": "string",
        "ces_state": "ENABLED",
        "daemon_node_name": "string",
        "ip_address": "string",
        "node_number": "string"
      }
    ],
    "enabled_services": "string",
    "interface_mode": "string",
    "log_level": "string"
  },
  "cluster_id": "string",
  "cluster_name": "string",
  "cnfsinfo": {
    "cnfs_ganesha": "string",
    "cnfs_monitor_enabled": "string",
    "cnfs_mound_port": "string",
    "cnfs_nfsd_procs": "string",
    "cnfs_reboot": "string",
    "cnfs_shared_root": "string",
    "cnfsnodes": [
      {
        "cnfs_group_id": "string",
        "cnfs_ip_list": "string",
        "cnfs_state": true,
        "daemon_node_name": "string",
        "ip_address": "string",
        "node_number": "string"
      }
    ]
  },
  "manager": "string",
  "nodes": [
    {
      "admin_login_name": "string",
      "admin_node_name": "string",
      "daemon_node_name": "string",
      "designation": {
        "ces": true,
        "cloud_gateway": true,
        "cnfs": true,
        "gateway": true,
        "ionode": true,
        "manager": true,
        "perfmon": true,
        "quorum": true,
        "snmp_collector": true
      },
      "ip_address": "string",
      "node_comment": "string",
      "node_number": "string"
    }
  ],
  "primary_server": "string",
  "rcp_path": "string",
  "rcp_sudo_wrapper": "YES",
  "repository_type": "string",
  "rsh_path": "string",
  "rsh_sudo_wrapper": "YES",
  "secondary_server": "string",
  "uid_domain": "string"
}

202: The request has been accepted for processing, but the processing has not been completed.
```
{}
```

default: An unexpected error response.

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

Examples

The following example updates the manager node of an existing file system:

Request data:

curl -X 'POST' \
  'https://localhost:46443/scalemgmt/v3/filesystems/gpfs0/manager' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "manager": "dev-11"
}'

Response data:

{
	"name":  "MTplZDVhZDIyMi0wYzFlLTQxYzYtYWI3NC0zOGFmZTA4NjEzZTc=",
	"metadata":  {
		"@type":  "type.googleapis.com/generic.v3.LongRunningOperationMetadata",
		"job_id":  "MTplZDVhZDIyMi0wYzFlLTQxYzYtYWI3NC0zOGFmZTA4NjEzZTc=",
		"operation_details":  {
			"@type":  "type.googleapis.com/manager.v3.UpdateFilesystemManagerRequest",
			"name":  "gpfs0",
			"manager":  {
				"manager":  "dev-11"
			}
		},
		"status":  "DONE",
		"request_time":  "2025-03-31T20:09:20.264592015Z",
		"completion_time":  "2025-03-31T20:09:20.578731476Z",
		"last_update_time":  "2025-03-31T20:09:20.578731476Z",
		"domain_ids":  [
			0
		]
	},
	"done":  true,
	"response":  {
		"@type":  "type.googleapis.com/manager.v3.FilesystemManager",
		"manager":  "dev-11"
	}
}