Create a new Cluster

Creates a new cluster.

Special notes:

  • In case no id field is provided the system generates a UUID for the cluster.
  • In case no accountID field is provided the system checks if header current-account is set.
    If so, its value is used as cluster owner and set to accountID.
    Otherwise, system sets accountID with the requester account ID.
    Note: You should set the accountID to the lowest b2b account with access to the system for which the cluster is created to ensure correct access.
  • By setting the parentID property, it is possible to build hierarchies of clusters.
  • By setting the systemID property, it is possible to assign a system to the cluster. Note, that system clusters are experimental and intended for internal use only.
Examples description

Create top-level cluster

{
  "name": "Wall Street 5 Cluster"
}

Create top-level cluster with specific ID

{
  "id": "386d2d55-ce95-42a9-8ddc-785ca6aafd60",
  "name": "Wall Street 5 Cluster"
}

Create child cluster

{
  "id": "386d2d55-ce95-42a9-8ddc-785ca6aafd60",
  "parentID": "82a99ca3-0ccc-4c0f-b049-b5326f4dfc80",
  "name": "Wall Street 5 Cluster"
}

Create cluster with specified account

{
  "id": "386d2d55-ce95-42a9-8ddc-785ca6aafd60",
  "accountID": "82a99ca3-0ccc-4c0f-b049-b5326f4dfc80",
  "name": "Wall Street 5 Cluster"
}
Language
Credentials
Header
Click Try It! to start a request and see the response here!