One Identity Safeguard for Privileged Sessions 6.0.6 - REST API Reference Guide

Promote a Safeguard for Privileged Sessions node to be the Central Management node in a new cluster

You can build a cluster by promoting a Safeguard for Privileged Sessions node to the role of the Central Management node, and then join other nodes to your cluster.

To promote a node to be the Central Management node, complete the following steps:

1. Open a transaction.

   For details, see Open a transaction.

2. Create the Central Management node.

   POST an empty request to the https://<IP-address-of-node-to-become-Central-Management-node>/api/cluster/promote endpoint.

   The following is a sample response received.

   For details of the meta object, see Message format.

   {
       "body": {
           "address": "<IP-address-of-Central-Management-node>",
           "roles": [
               "central-management"
           ]
       },
       "meta": {
           "href": "/api/cluster/nodes/b35c54da-b556-4f91-ade5-d26283d68277",
           "parent": "/api/cluster/nodes",
           "remaining_seconds": 28800
       }
   }

   Elements		Type	Description
   body		Top-level element (JSON object)	Contains the JSON object of the node.
   	address	string	The IP address of the node.
   	roles	string	The role of the node.

3. Commit your changes.

   For details, see Commit a transaction.