eks.addons.update

Change an add-on’s version or options

PATCH /eks/api/clusters/{cluster}/addons/{name}IAM eks:UpdateAddonChanges stateDestructive

Versions come from `addon-versions list`; upgrades are never automatic. A cluster upgrade is refused while an add-on’s version does not support the next Kubernetes minor.

Request syntax

PATCH /eks/api/clusters/{cluster}/addons/{name}
{
  "version": "string",
  "config": "map of string"
}

Path parameters

  • clusterRequired

    string

    Constraints: /^(ewk-[0-9a-f]{12}|[a-z]([a-z0-9-]{0,38}[a-z0-9])?)$/

  • nameRequired

    string

Request body

  • versionOptional

    string

    Another version from DescribeAddonVersions

    Constraints: max 32 chars

  • configOptional

    map of string

    Replaces the options as a whole

    Constraints: key=<json>

Response

200 with the add-on, status `updating`: name, version, system, status, statusMessage, config, health, namespace, latestVersion, upgradeAvailable, createdBy, createdAt, updatedAt. 400 when nothing is sent, for a version not offered or options it does not take; 404 for a DNS zone not in the organization; 409 while it is being removed, or for a version that does not support the cluster’s minor; 404 for an unknown cluster or add-on, 403 without the permission.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow eks:UpdateAddon on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud eks addons update cluster name

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_eks_addons_update.