v1

latestOpenAPI 3.0.02026-07-1410578280.2 KB
Swarm

Update a swarm

post/swarm/update

Query parameters

versioninteger required

The version number of the swarm object being updated. This is required to avoid conflicting writes.

rotateWorkerTokenboolean

Rotate the worker join token.

rotateManagerTokenboolean

Rotate the manager join token.

rotateManagerUnlockKeyboolean

Rotate the manager unlock key.

Request body

Labelsobject

User-defined key/value metadata.

Namestring

Name of the swarm.

Example request

{
  "CAConfig": {
    "NodeCertExpiry": 7776000000000000
  },
  "Dispatcher": {
    "HeartbeatPeriod": 5000000000
  },
  "Labels": {
    "com.example.corp.department": "engineering",
    "com.example.corp.type": "production"
  },
  "Name": "default",
  "Orchestration": {
    "TaskHistoryRetentionLimit": 10
  },
  "Raft": {
    "ElectionTick": 3,
    "HeartbeatTick": 1,
    "LogEntriesForSlowFollowers": 500,
    "SnapshotInterval": 10000
  },
  "TaskDefaults": {
    "LogDriver": {
      "Name": "json-file",
      "Options": {
        "max-file": "10",
        "max-size": "100m"
      }
    }
  }
}

Response

no error