本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# `AWS-UpdateEKSManagedNodeGroup`
<a name="aws-updateeksmanagednodegroup"></a>

 **描述** 

`AWS-UpdateEKSManagedNodeGroup` 运行手册可帮助您更新 Amazon Elastic Kubernetes Service (Amazon EKS) 托管节点组。您可以选择 `Version` 或 `Configuration` 更新。

 [运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-UpdateEKSManagedNodeGroup) 

**文档类型**

自动化

**所有者**

Amazon

**平台**

Linux、macOS、Windows

**参数**
+ AutomationAssumeRole

  类型：字符串

  描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。
+ ClusterName

  类型：字符串

  描述：（必需）要更新其节点组的集群的名称。
+ NodeGroupName

  类型：字符串

  描述：（必选）要更新的节点组的名称。
+ UpdateType

  类型：字符串

  有效值：更新节点组版本 \$1 更新节点组配置

  默认：更新节点组版本

  描述：（必需）要对节点组执行的更新的类型。

以下参数仅适用于 `Version` 更新类型：
+ AMIRelease版本

  类型：字符串

  描述：（可选）要使用的 Amazon EKS 优化 AMI 的版本。默认情况下会使用最新版本。
+ ForceUpgrade

  类型：布尔值

  描述：（可选）如果为真，则更新不会因容器组中断预算违规而失败。
+ KubernetesVersion

  类型：字符串

  描述：（可选）要将节点组更新到的 Kubernetes 版本。
+ LaunchTemplateId

  类型：字符串

  描述：（可选）启动模板的 ID。
+ LaunchTemplateName

  类型：字符串

  描述：（可选）启动模板的名称。
+ LaunchTemplateVersion

  类型：字符串

  描述：（可选）Amazon Elastic Compute Cloud (Amazon EC2) 启动模板版本。此参数仅在节点组是根据启动模板创建时才有效。

以下参数仅适用于 `Configuration` 更新类型：
+ AddOrUpdateNodeGroupLabels

  类型： StringMap

  描述：（可选）要添加或更新的 Kubernetes 标签。
+ AddOrUpdateKubernetesTaintsEffect

  类型： StringList

  描述：（可选）要添加或更新的 Kubernetes 污点。
+ MaxUnavailableNodeGroups

  类型：整数

  默认：0

  描述：（可选）版本更新期间一次不可用的最大节点数量。
+ MaxUnavailablePercentageNodeGroup

  类型：整数

  默认值：0

  描述：（可选）版本更新期间不可用的节点的最大百分比。
+ NodeGroupDesiredSize

  类型：整数

  默认值：0

  描述：（可选）托管节点组应保留的当前节点数。
+ NodeGroupMaxSize

  类型：整数

  默认值：0

  描述：（可选）托管节点组可以扩展到的最大节点数。
+ NodeGroupMinSize

  类型：整数

  默认值：0

  描述：（可选）托管节点组可以缩减到的最小节点数。
+ RemoveKubernetesTaintsEffect

  类型： StringList

  描述：（可选）要删除的 Kubernetes 污点。
+ RemoveNodeGroupLabels

  类型： StringList

  描述：（可选）要删除的以逗号分隔的标签列表。

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。
+  `eks:UpdateNodegroupConfig` 
+  `eks:UpdateNodegroupVersion` 

 **文档步骤** 
+  `aws:executeScript` - 根据您为运行手册输入参数指定的值更新 Amazon EKS 集群节点组。
+  `aws:waitForAwsResourceProperty` - 等待集群更新状态变为 `Successful`。