翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

既存のクラスターを、指定された設定ファイルの設定に合わせて更新します。

**注記**  
 クラスターの更新は、すべてのクラスターノードが正常に更新を適用した場合にのみ成功します。更新が失敗した場合、トラブルシューティングのガイダンスについては、[`pcluster describe-cluster` コマンドで `clusterStatus` が `UPDATE_FAILED` であることが表示されている](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\_CONFIGURATION}}**  
YAML クラスター設定ファイルを指定します。

**--cluster-name, -n {{CLUSTER\_NAME}}**  
クラスターの名前を指定します。

**--debug**  
デバッグログの有効化

**--dryrun {{DRYRUN}}**  
`true` の場合、クラスターを更新やリソースを作成することなく、検証を実行します。イメージの構成や更新の要件を検証するために使用することができます。(デフォルトは `false` です)

**--force-update {{FORCE\_UPDATE}}**  
`true` の場合、更新検証のエラーを無視して、強制的に更新を行います。(デフォルトは `false` です)

**--query {{QUERY}}**  
出力に対して実行する JMESPath クエリを指定します。

**--region, -r {{REGION}}**  
 AWS リージョン 使用する を指定します。クラスター設定ファイルの [`Region`](cluster-configuration-file-v3.md#yaml-Region)設定、 `AWS_DEFAULT_REGION`環境変数、 `~/.aws/config` ファイルの `[default]`セクションの `region`設定、または `--region`パラメータを使用して、 を指定 AWS リージョン する必要があります。

**--suppress-validators {{ SUPPRESS\_VALIDATORS}} [{{SUPPRESS\_VALIDATORS ...}}]**  
抑制する 1 つまたは複数のコンフィグバリデータを指定します。  
形式: (`ALL`\|`type:[A-Za-z0-9]+`)

**--validation-failure-level {{{INFO,WARNING,ERROR}}}**  
更新時に報告される検証エラーのレベルを指定します。

** AWS ParallelCluster バージョン 3.1.4 の使用例:**

```
$ 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
      }
    }
  ]
}
```