翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon MSKクラスターの設定を更新する
クラスターの設定を更新するには、クラスターが ACTIVE
状態であることを確認します。また、MSKクラスター上のブローカーあたりのパーティション数が、「」で説明されている制限を下回ることを確認する必要があります クラスターの適切なサイズ設定: ブローカーあたりのパーティション数。これらの制限を超えるクラスターの設定を更新することはできません。
カスタムMSK設定の作成方法、更新できるプロパティ、既存のクラスターの設定を更新するときに発生する操作など、設定の詳細については、「」を参照してくださいAmazon MSK設定。
を使用したクラスターの設定の更新 AWS CLI
-
以下をコピーJSONし、ファイルに保存してください。ファイルを
configuration-info.json
と名付けます。置換ConfigurationArn
クラスターの更新に使用する設定の Amazon リソースネーム (ARN) 。ARN 文字列は、次の の引用符で囲む必要がありますJSON。置換
Configuration-Revision
使用する設定のリビジョン。設定のリビジョンは、1
から始まる整数です。この整数は、次の の引用符で囲むことはできませんJSON。{ "Arn":
ConfigurationArn
, "Revision":Configuration-Revision
} -
次のコマンドを実行して、 を置き換えます。
ClusterArn
クラスターの作成時にARN取得した を使用します。クラスターARNに がない場合は、すべてのクラスターを一覧表示することで見つけることができます。詳細については、「Amazon MSKクラスターを一覧表示する」を参照してください。置換
Path-to-Config-Info-File
設定情報ファイルへのパス。前のステップで作成したファイルに名前configuration-info.json
を付けて、現在のディレクトリに保存した場合は、Path-to-Config-Info-File
は ですconfiguration-info.json
。置換
Current-Cluster-Version
クラスターの最新バージョンを使用します。重要
クラスターのバージョンは単純な整数ではありません。クラスターの最新バージョンを検索するには、 DescribeClusterオペレーションまたは describe-cluster
AWS CLI コマンドを使用します。サンプルのバージョンは KTVPDKIKX0DER
です。aws kafka update-cluster-configuration --cluster-arn
ClusterArn
--configuration-info file://Path-to-Config-Info-File
--current-versionCurrent-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" }
-
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
コマンドを実行します。
を使用して Amazon MSKクラスターの設定を更新する API
を使用して Amazon MSKクラスターの設定を更新するAPIには、「」を参照してくださいUpdateClusterConfiguration。