Skip to content
TimescaleDB Enterprise
Esc
↑↓navigate↵open⌘Jpreview

Rebuild a DCS member

Replaces the etcd member of a DCS server that a new server took over, and updates the etcd hosts on every service that uses the DCS cluster. The server must be pending a rebuild: run its enroll command on the replacement server first. The other members and every service on the cluster must be healthy.

POST/api/v1/dcs-clusters/{id}/servers/{server_id}/rebuild
Authorization
tse_sessionAPI key · cookierequired
Path parameters
idstringrequired
server_idstringrequired
Responses
202

Accepted

idstringrequired
namestringrequired
serversServer[]required
Show properties
Array of Server
CleanupErrorstringrequired
CleanupKindstringrequired
CleanupPendingbooleanrequired
CleanupSincestring<date-time> | nullrequired
CreatedAtstring<date-time>required
Demobooleanrequired
EnrollStatestringrequired
HeadscaleNodeIDstringrequired
Hoststringrequired
IDstringrequired
Namestringrequired
OverlayIPstringrequired
Portinteger<int64>required
PreviousOverlayIPstringrequired
RebuildPendingbooleanrequired
SSHUserstringrequired
statusstringrequired
used_by_countinteger<int64>required
default

Error

codestring

Stable code of the refusal, when the route has codes

detailsstring[]

Additional detail, e.g. per-field validation failures

errorstringrequired

Human-readable error message

Request
curl -X POST 'https://console.example.com/api/v1/dcs-clusters/string/servers/string/rebuild' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "id": "string",
  "name": "string",
  "servers": [
    {
      "CleanupError": "string",
      "CleanupKind": "string",
      "CleanupPending": true,
      "CleanupSince": "2019-08-24T14:15:22Z",
      "CreatedAt": "2019-08-24T14:15:22Z",
      "Demo": true,
      "EnrollState": "string",
      "HeadscaleNodeID": "string",
      "Host": "string",
      "ID": "string",
      "Name": "string",
      "OverlayIP": "string",
      "Port": 0,
      "PreviousOverlayIP": "string",
      "RebuildPending": true,
      "SSHUser": "string"
    }
  ],
  "status": "string",
  "used_by_count": 0
}