本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `pcluster update-cluster`
<a name="pcluster.update-cluster-v3"></a>

更新現有叢集以符合指定組態檔案的設定。

**注意**  
 只有當所有叢集節點都已成功套用更新時，叢集更新才會成功。如果更新失敗，請參閱[使用 `clusterStatus` `UPDATE_FAILED``pcluster describe-cluster`命令查看](troubleshooting-fc-v3-update-cluster.md#update-cluster-failure-v3)一節以取得疑難排解指引。

```
pcluster update-cluster [-h] 
                 --cluster-configuration CLUSTER_CONFIGURATION
                 --cluster-name CLUSTER_NAME
                [--debug]
                [--dryrun DRYRUN]
                [--force-update FORCE_UPDATE]
                [--query QUERY]
                [--region REGION]
                [--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
                [--validation-failure-level {INFO,WARNING,ERROR}]
```

## 具名引數
<a name="pcluster-v3.update-cluster.namedargs"></a>

**-h, --help**  
顯示 的說明文字`pcluster update-cluster`。

**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***  
指定 YAML 叢集組態檔案。

**--cluster-name, -n *CLUSTER\$1NAME***  
指定叢集的名稱。

**--debug**  
啟用偵錯記錄。

**--dryrun *DRYRUN***  
當 時`true`， 會執行驗證而不更新叢集並建立任何資源。它可用於驗證映像組態和更新需求。（預設為 `false`。)

**--force-update *FORCE\$1UPDATE***  
當 時`true`， 會忽略更新驗證錯誤來強制更新。（預設為 `false`。)

**--query *QUERY***  
指定要在輸出上執行的 JMESPath 查詢。

**--region, -r *REGION***  
指定 AWS 區域 要使用的 。 AWS 區域 必須使用叢集組態檔案中[`Region`](cluster-configuration-file-v3.md#yaml-Region)的設定、`AWS_DEFAULT_REGION`環境變數、 `~/.aws/config` 檔案 `[default]`區段中的`region`設定或 `--region` 參數來指定 。

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
識別要隱藏的一或多個組態驗證器。  
格式：(`ALL`\$1`type:[A-Za-z0-9]+`)

**--validation-failure-level *\$1INFO,WARNING,ERROR\$1***  
指定回報進行更新的驗證失敗層級。

**使用 3.1.4 AWS ParallelCluster 版的範例：**

```
$ pcluster update-cluster -c cluster-config.yaml -n cluster-v3 -r us-east-1
{
  "cluster": {
    "clusterName": "cluster-v3",
    "cloudformationStackStatus": "UPDATE_IN_PROGRESS",
    "cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
    "region": "us-east-1",
    "version": "3.1.4",
    "clusterStatus": "UPDATE_IN_PROGRESS"
  },
  "changeSet": [
    {
      "parameter": "HeadNode.Iam.S3Access",
      "requestedValue": {
        "BucketName": "amzn-s3-demo-bucket1",
        "KeyName": "output",
        "EnableWriteAccess": false
      }
    },
    {
      "parameter": "HeadNode.Iam.S3Access",
      "currentValue": {
        "BucketName": "amzn-s3-demo-bucket2",
        "KeyName": "logs",
        "EnableWriteAccess": true
      }
    }
  ]
}
```