Amazon MSKクラスターの設定を更新する - Amazon Managed Streaming for Apache Kafka

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

Amazon MSKクラスターの設定を更新する

クラスターの設定を更新するには、クラスターが ACTIVE 状態であることを確認します。また、MSKクラスター上のブローカーあたりのパーティション数が、「」で説明されている制限を下回ることを確認する必要があります クラスターの適切なサイズ設定: ブローカーあたりのパーティション数。これらの制限を超えるクラスターの設定を更新することはできません。

カスタムMSK設定の作成方法、更新できるプロパティ、既存のクラスターの設定を更新するときに発生する操作など、設定の詳細については、「」を参照してくださいAmazon MSK設定

を使用したクラスターの設定の更新 AWS CLI

  1. 以下をコピーJSONし、ファイルに保存してください。ファイルを configuration-info.json と名付けます。置換 ConfigurationArn クラスターの更新に使用する設定の Amazon リソースネーム (ARN) 。ARN 文字列は、次の の引用符で囲む必要がありますJSON。

    置換 Configuration-Revision 使用する設定のリビジョン。設定のリビジョンは、1 から始まる整数です。この整数は、次の の引用符で囲むことはできませんJSON。

    { "Arn": ConfigurationArn, "Revision": Configuration-Revision }

  2. 次のコマンドを実行して、 を置き換えます。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-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" }
  3. 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 } } } }

    この出力では、OperationTypeUPDATE_CLUSTER_CONFIGURATION です。OperationState の値が UPDATE_IN_PROGRESS の場合は、しばらく待ってから再度 describe-cluster-operation コマンドを実行します。

を使用して Amazon MSKクラスターの設定を更新する API

を使用して Amazon MSKクラスターの設定を更新するAPIには、「」を参照してくださいUpdateClusterConfiguration