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

# SageMaker HyperPod クラスターの設定を更新する
<a name="sagemaker-hyperpod-eks-operate-cli-command-update-cluster"></a>

[update-cluster](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-cluster.html) を実行して、クラスターの設定を更新します。

**注記**  
重要な考慮事項:  
クラスターの作成後、HyperPod クラスターが関連付けられている EKS クラスター情報を変更することはできません。
クラスターでディープヘルスチェックが実行されている場合、この API は正常に機能しません。ディープヘルスチェックが進行中であることを示すエラーメッセージが表示される場合があります。クラスターを更新するには、ディープヘルスチェックが完了するまで待つ必要があります。

1. JSON 形式で [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateCluster.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateCluster.html) API リクエストファイルを作成します。更新する適切なクラスター名とインスタンスグループ名を指定していることを確認してください。インスタンスタイプ、インスタンス数、ライフサイクル設定エントリポイントスクリプト、スクリプトへのパスを変更できます。
**注記**  
`UpdateCluster` を使用して、SageMaker HyperPod クラスターからインスタンスグループ全体をスケールダウンしたり削除したりできます。インスタンスグループをスケールダウンまたは削除する方法の詳細については、「[SageMaker HyperPod クラスターのスケールダウン](smcluster-scale-down.md)」を参照してください。

   1. `ClusterName` で、更新するクラスターの名前を選択します。

   1. `InstanceGroupName` 用

      1. 既存のインスタンスグループを更新するには、更新するインスタンスグループの名前を指定します。

      1. 新しいインスタンスグループを追加するには、クラスターに存在しない新しい名前を指定します。

   1. `InstanceType` 用

      1. 既存のインスタンスグループを更新するには、最初に指定したインスタンスタイプをグループに一致させる必要があります。

      1. 新しいインスタンスグループを追加するには、グループを設定するインスタンスタイプを指定します。

      `InstanceRequirements` の代わりに を使用するインスタンスグループの場合`InstanceType`、`InstanceTypes`リストからインスタンスタイプを追加または削除できます。ただし、アクティブなノードが実行されているインスタンスタイプを削除することはできません。また、既存のインスタンスグループを更新する`InstanceRequirements`ときに `InstanceType`と を切り替えることはできません。 `InstanceType`と `InstanceRequirements`は相互に排他的です。

   1. `InstanceCount` 用

      1. 既存のインスタンスグループを更新するには、必要なインスタンス数に対応する整数を指定します。インスタンスグループをスケールアップまたはスケールダウンするには、高い値または低い値 (最低は 0) を指定できます。

      1. 新しいインスタンスグループを追加するには、1 以上の整数を指定します。

   1. `LifeCycleConfig` では、インスタンスグループを更新するときに、`SourceS3Uri` と `OnCreate` の両方の値を変更することができます。

   1. `ExecutionRole` 用

      1. 既存のインスタンスグループを更新するには、クラスターの作成時にアタッチしたのと同じ IAM ロールを引き続き使用します。

      1. 新しいインスタンスグループを追加するには、アタッチする IAM ロールを指定します。

   1. `ThreadsPerCore` 用

      1. 既存のインスタンスグループを更新するには、クラスターの作成時に指定した値と同じ値を使用し続けます。

      1. 新しいインスタンスグループを追加するには、インスタンスタイプごとに許可されるオプションから任意の値を選択できます。詳細については、インスタンスタイプを検索し、「*Amazon EC2 ユーザーガイド*」にある[インスタンスタイプごとの CPU コア数と CPU コアあたりのスレッド数](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cpu-options-supported-instances-values.html)のリファレンステーブルの「**コアあたりの有効なスレッド**」列を参照してください。

   1. `OnStartDeepHealthChecks` では、`InstanceStress` と `InstanceConnectivity` を追加して [ディープヘルスチェック](sagemaker-hyperpod-eks-resiliency-deep-health-checks.md) を有効にします。

   1. `NodeRecovery` では、`Automatic` を指定して自動ノード復旧を有効にします。SageMaker HyperPod は、ヘルスモニタリングエージェントが問題を見つけたときにインスタンス (ノード) を置き換えるか再起動します。

   次のコードスニペットは、使用できる JSON リクエストファイルテンプレートです。この API のリクエスト構文とパラメータの詳細については、[UpdateCluster](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateCluster.html) API リファレンスを参照してください。

   ```
   // update_cluster.json
   {
       // Required
       "ClusterName": "{{name-of-cluster-to-update}}",
       // Required
       "InstanceGroups": [{
           "InstanceGroupName": {{"string"}},
           "InstanceType": {{"string"}},
           "InstanceCount": {{number}},
           "LifeCycleConfig": {
               "SourceS3Uri": {{"string"}},
               "OnCreate": {{"string"}}
           },
           "ExecutionRole": {{"string"}},
           "ThreadsPerCore": {{number}},
           "OnStartDeepHealthChecks": [
               {{"InstanceStress", "InstanceConnectivity"}}
           ]
       }],
       "NodeRecovery": "{{Automatic}}"
   }
   ```

1. 次の `update-cluster` コマンドを実行して、リクエストを送信します。

   ```
   aws sagemaker update-cluster \
       --cli-input-json {{file://complete/path/to/update_cluster.json}}
   ```