翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon MSK設定オペレーション
このトピックでは、カスタム設定を作成する方法と、カスタムMSK設定に対してオペレーションを実行する方法について説明します。MSK 設定を使用してクラスターを作成または更新する方法については、「」を参照してくださいAmazon MSK: 仕組み。
このトピックには、次のセクションが含まれています。
MSK 設定を作成するには
-
設定する設定プロパティと、それらに割り当てる値を指定するファイルを作成します。次に、設定ファイルの例を示します。
auto.create.topics.enable = true log.roll.ms = 604800000
-
次の AWS CLI コマンドを実行し、
config-file-path
は、前のステップで設定を保存したファイルへのパスを指定します。注記
設定に選択する名前は、次の正規表現「^[0-9A-Za-z][0-9A-Za-z-]{0,}$」と一致する必要があります。
aws kafka create-configuration --name "ExampleConfigurationName" --description "Example configuration description." --kafka-versions "1.1.1" --server-properties fileb://
config-file-path
このコマンドを実行した後の正常なレスポンスの例を以下に示します。
{ "Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/SomeTest/abcdabcd-1234-abcd-1234-abcd123e8e8e-1", "CreationTime": "2019-05-21T19:37:40.626Z", "LatestRevision": { "CreationTime": "2019-05-21T19:37:40.626Z", "Description": "Example configuration description.", "Revision": 1 }, "Name": "ExampleConfigurationName" }
-
前のコマンドは、新しい設定の Amazon リソースネーム (ARN) を返します。この設定を他のコマンドで参照する必要があるARNため、これを保存します。設定 を紛失した場合はARN、アカウント内のすべての設定を一覧表示して、再度見つけることができます。
MSK 設定を更新するには
-
更新する設定プロパティと、それらに割り当てる値を指定するファイルを作成します。次に、設定ファイルの例を示します。
auto.create.topics.enable = true min.insync.replicas = 2
-
次の AWS CLI コマンドを実行し、
config-file-path
は、前のステップで設定を保存したファイルへのパスを指定します。置換
configuration-arn
設定の作成時にARN取得した を使用します。設定の作成ARN時に を保存しなかった場合は、list-configurations
コマンドを使用してアカウント内のすべての設定を一覧表示できます。目的の設定がレスポンス内のリストに表示されます。設定ARNの もそのリストに表示されます。aws kafka update-configuration --arn
configuration-arn
--description "Example configuration revision description." --server-propertiesfileb://config-file-path
-
このコマンドを実行した後の正常なレスポンスの例を以下に示します。
{ "Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/SomeTest/abcdabcd-1234-abcd-1234-abcd123e8e8e-1", "LatestRevision": { "CreationTime": "2020-08-27T19:37:40.626Z", "Description": "Example configuration revision description.", "Revision": 2 } }
MSK 設定を削除するには
次の手順は、クラスターに接続されていない設定を削除する方法を示しています。クラスターに添付されている設定を削除することはできません。
-
この例を実行するには、
configuration-arn
設定の作成時にARN取得した を使用します。設定の作成ARN時に を保存しなかった場合は、list-configurations
コマンドを使用してアカウント内のすべての設定を一覧表示できます。目的の設定がレスポンス内のリストに表示されます。設定ARNの もそのリストに表示されます。aws kafka delete-configuration --arn
configuration-arn
-
このコマンドを実行した後の正常なレスポンスの例を以下に示します。
{ "arn": " arn:aws:kafka:us-east-1:123456789012:configuration/SomeTest/abcdabcd-1234-abcd-1234-abcd123e8e8e-1", "state": "DELETING" }
MSK 設定を記述するには
-
次のコマンドは、設定に関するメタデータを返します。設定の詳細な説明を取得するには、
describe-configuration-revision
を実行します。この例を実行するには、
configuration-arn
設定の作成時にARN取得した を使用します。設定の作成ARN時に を保存しなかった場合は、list-configurations
コマンドを使用してアカウント内のすべての設定を一覧表示できます。目的の設定がレスポンス内のリストに表示されます。設定ARNの もそのリストに表示されます。aws kafka describe-configuration --arn
configuration-arn
-
このコマンドを実行した後の正常なレスポンスの例を以下に示します。
{ "Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/SomeTest/abcdabcd-abcd-1234-abcd-abcd123e8e8e-1", "CreationTime": "2019-05-21T00:54:23.591Z", "Description": "Example configuration description.", "KafkaVersions": [ "1.1.1" ], "LatestRevision": { "CreationTime": "2019-05-21T00:54:23.591Z", "Description": "Example configuration description.", "Revision": 1 }, "Name": "SomeTest" }
MSK 設定リビジョンを記述するには
describe-configuration
コマンドを使用してMSK設定を記述すると、設定のメタデータが表示されます。設定の詳細な記述を取得するには、describe-configuration-revision
コマンドを使用します。
-
次のコマンドを実行して を置き換えます。
configuration-arn
設定の作成時にARN取得した を使用します。設定の作成ARN時に を保存しなかった場合は、list-configurations
コマンドを使用してアカウント内のすべての設定を一覧表示できます。目的の設定がレスポンス内のリストに表示されます。設定ARNの もそのリストに表示されます。aws kafka describe-configuration-revision --arn
configuration-arn
--revision 1このコマンドを実行した後の正常なレスポンスの例を以下に示します。
{ "Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/SomeTest/abcdabcd-abcd-1234-abcd-abcd123e8e8e-1", "CreationTime": "2019-05-21T00:54:23.591Z", "Description": "Example configuration description.", "Revision": 1, "ServerProperties": "YXV0by5jcmVhdGUudG9waWNzLmVuYWJsZSA9IHRydWUKCgp6b29rZWVwZXIuY29ubmVjdGlvbi50aW1lb3V0Lm1zID0gMTAwMAoKCmxvZy5yb2xsLm1zID0gNjA0ODAwMDAw" }
ServerProperties
の値は base64 でエンコードされます。base64 デコーダー (https://www.base64decode.org/ など) を使用して手動でデコードする場合は、カスタム設定の作成に使用した元の設定ファイルの内容を取得します。この場合、次のようになります。auto.create.topics.enable = true log.roll.ms = 604800000
現在のリージョンのアカウント内のすべてのMSK設定を一覧表示するには
-
以下のコマンドを実行します。
aws kafka list-configurations
このコマンドを実行した後の正常なレスポンスの例を以下に示します。
{ "Configurations": [ { "Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/SomeTest/abcdabcd-abcd-1234-abcd-abcd123e8e8e-1", "CreationTime": "2019-05-21T00:54:23.591Z", "Description": "Example configuration description.", "KafkaVersions": [ "1.1.1" ], "LatestRevision": { "CreationTime": "2019-05-21T00:54:23.591Z", "Description": "Example configuration description.", "Revision": 1 }, "Name": "SomeTest" }, { "Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/SomeTest/abcdabcd-1234-abcd-1234-abcd123e8e8e-1", "CreationTime": "2019-05-03T23:08:29.446Z", "Description": "Example configuration description.", "KafkaVersions": [ "1.1.1" ], "LatestRevision": { "CreationTime": "2019-05-03T23:08:29.446Z", "Description": "Example configuration description.", "Revision": 1 }, "Name": "ExampleConfigurationName" } ] }