Get control-plane config history | NVIDIA Kubernetes Engine

{
  "changes": [
    {
      "configurationID": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "createdAt": "2024-01-10T08:00:00Z",
      "isCurrent": false,
      "changedFields": [],
      "changeReason": "Initial control-plane configuration",
      "createdBy": "admin@acme.example"
    },
    {
      "configurationID": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "createdAt": "2024-02-14T11:22:00Z",
      "isCurrent": false,
      "changedFields": [
        {
          "field": "kubernetesVersion",
          "to": "\"1.29.2\"",
          "from": "\"1.28.5\""
        }
      ],
      "changeReason": "Kubernetes version upgrade to 1.29",
      "createdBy": "ops-bot@acme.example"
    },
    {
      "configurationID": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "createdAt": "2024-03-05T15:45:00Z",
      "isCurrent": true,
      "changedFields": [
        {
          "field": "nico.release",
          "to": "\"nvke-cp-2024.03.1\"",
          "from": "\"nvke-cp-2024.01.1\""
        }
      ],
      "changeReason": "OS release update for security patch",
      "createdBy": "platform-engineer@acme.example"
    }
  ]
}

Returns the control-plane configuration change history, oldest first. Each entry shows which rollout-relevant fields changed relative to the previous snapshot. Use it to resolve the pinnedConfigurationID on each control-plane node and the cluster’s desired configurationId.

Authentication

AuthorizationBearer

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

Path parameters

clusterIDstringRequiredformat: "uuid"

Cluster ID.

Response

The control-plane config history

changeslist of objects

Oldest first. A node's pinnedConfigurationID and the cluster's desired configurationId both refer to entries here.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error