v1

latestOpenAPI 3.0.02026-07-17212535.2 KB
cluster-settings

Update cluster settings

put/cluster-settings

Request body

schedulerProfile'optimize-utilization' | 'distribute-load'

Scheduler profile to use. Possible values:

  • optimize-utilization — when scheduling a pending VM to a worker, pick the busiest worker that can fit a VM first, falling back to less busier workers (this is the default behavior when no explicit scheduler profile is set)

  • distribute-load — when scheduling a pending VM to a worker, pick the least occupied worker that can fit a VM first, falling back to more busier workers

Example request

{
  "hostDirPolicies": [
    {
      "pathPrefix": "/Users/ci/src",
      "ro": true
    }
  ]
}

Response

Cluster settings were successfully updated

schedulerProfile'optimize-utilization' | 'distribute-load'

Scheduler profile to use. Possible values:

  • optimize-utilization — when scheduling a pending VM to a worker, pick the busiest worker that can fit a VM first, falling back to less busier workers (this is the default behavior when no explicit scheduler profile is set)

  • distribute-load — when scheduling a pending VM to a worker, pick the least occupied worker that can fit a VM first, falling back to more busier workers

Example response

{
  "hostDirPolicies": [
    {
      "pathPrefix": "/Users/ci/src",
      "ro": true
    }
  ]
}