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

# 更新 AWS PCS 队列
<a name="working-with_queues_update"></a>

本主题概述了可用选项，并介绍了更新 AWS PCS 队列时应考虑的事项。有关 Slurm 自定义设置的信息，请参阅。[PCS 队列的自定义 Slurm 设置 AWS](slurm-custom-settings-queue.md)

## 更新 AWS PCS 队列时的注意事项
<a name="working-with_queues_update_considerations"></a>

队列更新不会影响正在运行的作业，但是在队列更新期间，集群可能无法接受新作业。

## 更新 AWS PCS 队列
<a name="working-with_queues_update_update"></a>

您可以使用 AWS 管理控制台 或 AWS CLI 更新队列。

------
#### [ AWS 管理控制台 ]

**更新队列**

1. 在以下位置打开 AWS PCS 控制台 `https://console.aws.amazon.com/pcs/home#/clusters`

1. 选择要在其中更新队列的集群。

1. 导航至 “**队列**”，转至要更新的队列，然后选择 “**编辑**”。

1. 在队列配置部分，更新以下任意值：
   +  **节点组**-添加或移除计算节点组与队列的关联。
   +  **其他调度程序设置**-添加、修改或删除队列的自定义 Slurm 设置。有关更多信息，请参阅 [PCS 队列的自定义 Slurm 设置 AWS](slurm-custom-settings-queue.md)。
   +  **标签**-为队列添加或移除标签。

1. 选择**更新**。应用更改时，“**状态**” 字段将显示 “正在*更新*”。
**重要**  
队列更新可能需要几分钟。

------
#### [ AWS CLI ]

**更新队列**

1. 使用以下命令更新您的队列。在运行命令之前，进行以下替换：

   1. *region-code*替换为 AWS 区域 要在其中创建集群的。

   1. *my-queue*替换为队列`computeNodeGroupId`的名称或。

   1. *my-cluster*替换为集群`clusterId`的名称或。

   1.  要更改计算节点组关联，请提供更新后的列表`--compute-node-group-configurations`。

      1.  例如，要添加第二个计算节点组，请执行`computeNodeGroupExampleID2`以下操作：

        ```
        --compute-node-group-configurations computeNodeGroupId=computeNodeGroupExampleID1,computeNodeGroupId=computeNodeGroupExampleID2
        ```

   ```
   aws pcs update-queue --region region-code \
       --queue-identifier my-queue \
       --cluster-identifier my-cluster \
       --compute-node-group-configurations \
       computeNodeGroupId=computeNodeGroupExampleID1
   ```  
**Example — 使用自定义 Slurm 设置更新队列**  

   ```
   aws pcs update-queue --region region-code \
       --queue-identifier my-queue \
       --cluster-identifier my-cluster \
       --slurm-configuration \
       'slurmCustomSettings=[{parameterName=Default,parameterValue=YES}]'
   ```

   有关更多信息，请参阅 [PCS 队列的自定义 Slurm 设置 AWS](slurm-custom-settings-queue.md)。

1. 更新队列可能需要几分钟。您可以使用以下命令查询队列的状态。在队列状态达到之前，您将无法向队列提交作业`ACTIVE`。

   ```
   aws pcs get-queue --region region-code \
       --cluster-identifier my-cluster \ 
       --queue-identifier my-queue
   ```

------

**建议的后续步骤**
+ 向更新后的队列提交任务。