翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon MSK クラスターの設定を更新する
クラスターの設定を更新するには、クラスターが `ACTIVE` 状態であることを確認します。また、MSK クラスター上のブローカーあたりのパーティション数が [クラスターの適切なサイズ設定: 標準ブローカーあたりのパーティション数](bestpractices.md#partitions-per-broker) で説明されている制限を下回っていることを確認する必要があります。これらの制限を超えるクラスターの設定を更新することはできません。
カスタム設定の作成方法、更新可能なプロパティ、既存のクラスター の設定を更新した場合の動作など、MSK 設定について詳細は、「[Amazon MSK Provisioned 設定](msk-configuration.md)」を参照してください。
**Topics**
+ [設定更新中のブローカーの可用性](#update-config-cluster-availability)
+ [を使用したクラスターの設定の更新 AWS CLI](#update-config-cli)
+ [API を使用して Amazon MSK クラスターの設定を更新する](#update-config-api)
## 設定更新中のブローカーの可用性
Amazon MSK は、ほとんどのクラスター設定の更新中に高可用性を維持します。Amazon MSK はローリング更新を実行し、一度に 1 つのブローカーを更新します。このプロセス中、クラスターは引き続き使用できますが、個々のブローカーは設定が更新されると再起動します。ただし、一部の設定変更では、すべてのブローカーを同時に更新する必要がある場合があります。これにより、クラスター全体の停止が短時間発生する可能性があります。更新中のブローカーの可用性への影響の詳細については、[Amazon MSK Provisioned 設定](msk-configuration.md) を参照してください。
本番クラスターを更新する前に、非本番稼働環境で設定変更をテストし、メンテナンス期間中に更新をスケジュールすることをお勧めします。
MSK クラスターのアップグレード中に問題が発生した場合は、[Amazon MSK クラスターをアップグレードするときに問題をトラブルシューティングするにはどうすればよいですか？](https://repost.aws/knowledge-center/msk-upgrade-cluster-issues) を参照してください。
## を使用したクラスターの設定の更新 AWS CLI
1. 次の JSON をコピーして、ファイルに保存します。ファイルを `configuration-info.json` と名付けます。*ConfigurationArn* をクラスターの更新に使用する設定の Amazon リソースネーム (ARN) に置き換えます。次の JSON では、ARN 文字列は引用符で囲む必要があります。
*Configuration-Revision* を、使用する設定のリビジョンに置き換えます。設定のリビジョンは、`1` から始まる整数です。次の JSON では、この整数を引用符で囲むことはできません。
```
{
"Arn": ConfigurationArn,
"Revision": Configuration-Revision
}
```
1. *ClusterArn* をクラスター作成時に取得した ARN に置き換えて、次のコマンドを実行します。クラスターの ARN がない場合は、すべてのクラスターを一覧表示することで見つけられます。詳細については、「[Amazon MSK クラスターを一覧表示する](msk-list-clusters.md)」を参照してください。
*Path-to-Config-Info-File* を設定情報ファイルのパスに置き換えます。前の手順で作成したファイルを `configuration-info.json` と命名して現在のディレクトリに保存した場合、*Path-to-Config-Info-File* は `configuration-info.json` です。
*Current-Cluster-Version* を、クラスターの現在のバージョンに置き換えます。
**重要**
クラスターのバージョンは単純な整数ではありません。クラスターの最新バージョンを検索するには、[DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster) オペレーションまたは [describe-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html) AWS CLI コマンドを使用します。サンプルのバージョンは `KTVPDKIKX0DER` です。
```
aws kafka update-cluster-configuration --cluster-arn ClusterArn --configuration-info file://Path-to-Config-Info-File --current-version Current-Cluster-Version
```
次に、このコマンドの使用例を示します。
```
aws kafka update-cluster-configuration --cluster-arn "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1" --configuration-info file://c:\users\tester\msk\configuration-info.json --current-version "K1X5R6FKA87"
```
この `update-cluster-configuration` コマンドの出力は、次の JSON の例のようになります。
```
{
"ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
"ClusterOperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef"
}
```
1. `update-cluster-configuration` オペレーションの結果を取得するには、*ClusterOperationArn*を `update-cluster-configuration` コマンドの出力で取得した ARN に置き換えて、次のコマンドを実行します。
```
aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn
```
この `describe-cluster-operation` コマンドの出力は、次の JSON の例のようになります。
```
{
"ClusterOperationInfo": {
"ClientRequestId": "982168a3-939f-11e9-8a62-538df00285db",
"ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
"CreationTime": "2019-06-20T21:08:57.735Z",
"OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef",
"OperationState": "UPDATE_COMPLETE",
"OperationType": "UPDATE_CLUSTER_CONFIGURATION",
"SourceClusterInfo": {},
"TargetClusterInfo": {
"ConfigurationInfo": {
"Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/ExampleConfigurationName/abcdabcd-abcd-1234-abcd-abcd123e8e8e-1",
"Revision": 1
}
}
}
}
```
この出力では、`OperationType` は `UPDATE_CLUSTER_CONFIGURATION` です。`OperationState` の値が `UPDATE_IN_PROGRESS` の場合は、しばらく待ってから再度 `describe-cluster-operation` コマンドを実行します。
## API を使用して Amazon MSK クラスターの設定を更新する
API を使用して Amazon MSK クラスターの設定を更新するには、「[UpdateClusterConfiguration](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-configuration.html#UpdateClusterConfiguration)」を参照してください。