帮助改进此页面

要帮助改进本用户指南，请选择位于每个页面右侧窗格中的在 GitHub 上编辑此页面链接。

使用功能资源

本主题介绍管理所有功能类型的功能资源的常见操作。

EKS 功能资源

EKS 功能是在 Amazon EKS 集群上启用托管功能的 AWS 资源。各项功能在 EKS 中运行，无需在 Worker 节点上安装和维护控制器和其他操作组件。这些功能是为特定的 EKS 集群创建，并且在整个生命周期内都与该集群保持关联。

每种能力资源都有：

了解功能状态

功能资源的状态表示其当前状态。您可以在 EKS 控制台或使用 AWS CLI 查看功能状态和运行状况。

控制台：

AWSCLI：

aws eks describe-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name my-capability-name

功能状态

CREATING：正在设置功能。您可以离开控制台，功能将继续在后台创建。

ACTIVE：功能正在运行中并可供使用。如果资源未按预期运行，请检查资源状态和 IAM 权限。请参阅 EKS 功能问题排查 查看相关指南。

UPDATING：正在应用配置更改。等待状态恢复为 ACTIVE。

删除：正在从集群中删除功能。

CREATE_FAILED：设置时遇到了错误。常见原因包括：

有关具体错误的详细信息，请查看功能运行状况部分。

UPDATE_FAILED：配置更新失败。有关详细信息，请查看功能运行状况部分并验证 IAM 权限。

创建功能

要在集群上创建功能，请参阅以下主题：

列出功能

您可以列出集群上的所有功能资源。

控制台

AWS CLI

使用 list-capabilities 命令查看集群上的所有功能。将 region-code 替换为您的集群所在的 AWS 区域，并将 my-cluster 替换为您的集群的名称。

aws eks list-capabilities \
  --region region-code \
  --cluster-name my-cluster
         

{
    "capabilities": [
        {
            "capabilityName": "my-ack",
            "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/ack/my-ack/abc123",
            "type": "ACK",
            "status": "ACTIVE",
            "createdAt": "2025-11-02T10:30:00.000000-07:00",
            "modifiedAt": "2025-11-02T10:32:15.000000-07:00",
        },
        {
            "capabilityName": "my-kro",
            "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/kro/my-kro/abc123",
            "type": "KRO",
            "status": "ACTIVE",
            "version": "v0.6.3",
            "createdAt": "2025-11-02T10:30:00.000000-07:00",
            "modifiedAt": "2025-11-02T10:32:15.000000-07:00",
        },
        {
            "capabilityName": "my-argocd",
            "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/argocd/my-argocd/abc123",
            "type": "ARGOCD",
            "status": "ACTIVE",
            "version": "3.1.8-eks-1",
            "createdAt": "2025-11-21T08:22:28.486000-05:00",
            "modifiedAt": "2025-11-21T08:22:28.486000-05:00"
        }
    ]
}

描述功能

获取有关特定功能的详细信息，包括其配置和状态。

控制台

AWS CLI

使用 describe-capability 命令查看详细信息。将 region-code 替换为集群所在的 AWS 区域，将 my-cluster 替换为集群的名称，将 capability-name 替换为功能名称（ack、argocd 或 kro）。

aws eks describe-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name capability-name
         

输出示例：

{
  "capability": {
    "capabilityName": "my-ack",
    "capabilityArn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/ack/my-ack/abc123",
    "clusterName": "my-cluster",
    "type": "ACK",
    "roleArn": "arn:aws:iam::111122223333:role/AmazonEKSCapabilityACKRole",
    "status": "ACTIVE",
    "configuration": {},
    "tags": {},
    "health": {
      "issues": []
    },
    "createdAt": "2025-11-19T17:11:30.242000-05:00",
    "modifiedAt": "2025-11-19T17:11:30.242000-05:00",
    "deletePropagationPolicy": "RETAIN"
  }
}

更新功能的配置

创建后，您可以更新功能配置的某些方面。具体的配置选项因功能类型而异。

AWS CLI

使用 update-capability 命令修改功能：

aws eks update-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name capability-name \
  --role-arn arn:aws:iam::[.replaceable]111122223333:role/NewCapabilityRole
         

删除功能

如果不再需要集群上的某项功能，可以删除该功能资源。

控制台

AWS CLI

使用 delete-capability 命令删除功能资源：

将 region-code 替换为集群所在的 AWS 区域，将 my-cluster 替换为集群的名称，并将 capability-name 替换为要删除的功能名称。

aws eks delete-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name capability-name
         

后续步骤