更新 Amazon MSK 集群的配置 - Amazon Managed Streaming for Apache Kafka
使用 AWS CLI 更新集群的配置使用 API 更新集群的配置
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

更新 Amazon MSK 集群的配置

要更新集群配置，请确保集群处于 ACTIVE 状态。有关 MSK 配置的信息，包括如何创建自定义配置、可以更新哪些属性以及更新现有集群的配置时会发生什么情况，请参阅 Amazon MSK 配置。

使用 AWS CLI 更新集群的配置

  1. 复制以下 JSON 并将其保存到文件中。将文件命名为 configuration-info.json。 替换 ConfigurationArn 替换为要用于更新集群的配置的 Amazon 资源名称 （ARN）。在以下 JSON 中，ARN 字符串必须使用引号引起来。

    Replace Configuration-Revision 替换为要使用的配置的修订版本。配置修订是从 1 开始的整数。 在以下 JSON 中，该整数不得用引号引起来。 

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

  2. 运行以下命令，同时替换 ClusterArn 替换为您在创建集群时获取的 ARN。如果您没有该集群的 ARN，可以通过列出所有集群来找到它。有关更多信息，请参阅列出 Amazon MSK 集群。

    Replace Path-to-Config-Info-File 替换为您的配置信息文件的路径。如果您将上一步中创建的文件命名为 configuration-info.json 并将其保存在当前目录中，Path-to-Config-Info-File 为 configuration-info.json。

    Replace Current-Cluster-Version 替换为当前版本的集群。

    重要

    集群版本不是简单的整数。您可以通过描述集群来获取当前版本。示例版本是 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
            }
        }
    }
}

    在此输出中，OperationType 为 UPDATE_CLUSTER_CONFIGURATION。 如果 OperationState 的值为 UPDATE_IN_PROGRESS，请等待一段时间，然后再次运行 describe-cluster-operation 命令。

使用 API 更新集群的配置

要使用 API 创建集群，请参阅 UpdateClusterConfiguration。