Skip to navigation

Point the cluster's nodes at a SPIRE server

View as MarkdownOpen in Claude

Starts a spire_server_update operation that points the SPIRE agent on every node of the cluster at the given server and waits for each agent to hold an SVID from it. Track it through conditions.updateInProgress and conditions.updateFailed on the cluster, and per node through GET /clusters/{clusterID}/spire-server. Repeating the request with the same server is safe, including while it is in progress.

Authentication

AuthorizationBearer

A JWT from an issuer the Operator has configured, carried as Authorization: Bearer <token>.

Path parameters

clusterIDstringRequiredformat: "uuid"
Cluster ID.

Request

The SPIRE server the cluster's nodes should point at.
addressstringRequired>=1 character
Host name or IP address of the SPIRE server.
portintegerRequired1-65535
SPIRE server port.

Response

Update started

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error