MSKAmazon-Konfigurationsvorgänge - Amazon Managed Streaming für Apache Kafka
Konfiguration erstellenUm eine MSK Konfiguration zu aktualisierenUm eine MSK Konfiguration zu löschenUm eine MSK Konfiguration zu beschreibenUm eine MSK Konfigurationsrevision zu beschreibenUm alle MSK Konfigurationen in Ihrem Konto für die aktuelle Region aufzulisten

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

MSKAmazon-Konfigurationsvorgänge

In diesem Thema wird beschrieben, wie Sie benutzerdefinierte MSK Konfigurationen erstellen und Operationen an diesen ausführen. Informationen zur Verwendung von MSK Konfigurationen zum Erstellen oder Aktualisieren von Clustern finden Sie unterAmazonMSK: So funktioniert's.

So erstellen Sie eine MSK Konfiguration

  1. Erstellen Sie eine Datei, in der Sie die festzulegenden Konfigurationseigenschaften und die Werte angeben, die Sie ihnen zuweisen möchten. Im Folgenden finden Sie den Inhalt einer Beispielkonfigurationsdatei.

    auto.create.topics.enable = true

log.roll.ms = 604800000

  2. Führen Sie Folgendes aus AWS CLI Befehl und ersetze config-file-path mit dem Pfad zu der Datei, in der Sie Ihre Konfiguration im vorherigen Schritt gespeichert haben.

    Anmerkung

    Der Name, den Sie für Ihre Konfiguration auswählen, muss mit dem folgenden regulären Ausdruck übereinstimmen: „^[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

    Im Folgenden finden Sie ein Beispiel für eine erfolgreiche Antwort nach der Ausführung dieses Befehls.

    {
    "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"
}

  3. Der vorherige Befehl gibt einen Amazon-Ressourcennamen (ARN) für Ihre neue Konfiguration zurück. Speichern Sie diesARN, da Sie es benötigen, um in anderen Befehlen auf diese Konfiguration zu verweisen. Wenn Sie Ihre Konfiguration verlierenARN, können Sie alle Konfigurationen in Ihrem Konto auflisten, um sie wiederzufinden.

Um eine MSK Konfiguration zu aktualisieren

  1. Erstellen Sie eine Datei, in der Sie die zu aktualisierenden Konfigurationseigenschaften angeben, und die Werte, die Sie ihnen zuweisen möchten. Im Folgenden finden Sie den Inhalt einer Beispielkonfigurationsdatei.

    auto.create.topics.enable = true

min.insync.replicas = 2

  2. Führen Sie Folgendes aus AWS CLI Befehl und ersetze config-file-path mit dem Pfad zu der Datei, in der Sie Ihre Konfiguration im vorherigen Schritt gespeichert haben.

    Ersetzen configuration-arn mit demARN, den Sie bei der Erstellung der Konfiguration erhalten haben. Wenn Sie die ARN bei der Erstellung der Konfiguration nicht gespeichert haben, können Sie den list-configurations Befehl verwenden, um die gesamte Konfiguration in Ihrem Konto aufzulisten. Die Konfiguration, die Sie in der Liste haben möchten, wird in der Antwort angezeigt. Die ARN Konfiguration wird auch in dieser Liste angezeigt.

    aws kafka update-configuration --arn configuration-arn --description "Example configuration revision description." --server-properties fileb://config-file-path

  3. Im Folgenden finden Sie ein Beispiel für eine erfolgreiche Antwort nach der Ausführung dieses Befehls.

    {
    "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
    }
}

Um eine MSK Konfiguration zu löschen

Das folgende Verfahren zeigt, wie Sie eine Konfiguration löschen, die nicht einem Cluster angefügt ist. Sie können eine Konfiguration nicht löschen, die einem Cluster angefügt ist.

  1. Um dieses Beispiel auszuführen, ersetzen Sie configuration-arn durch dieARN, die Sie bei der Erstellung der Konfiguration erhalten haben. Wenn Sie die ARN bei der Erstellung der Konfiguration nicht gespeichert haben, können Sie den list-configurations Befehl verwenden, um die gesamte Konfiguration in Ihrem Konto aufzulisten. Die Konfiguration, die Sie in der Liste haben möchten, wird in der Antwort angezeigt. Die ARN Konfiguration wird auch in dieser Liste angezeigt.

    aws kafka delete-configuration --arn configuration-arn

  2. Im Folgenden finden Sie ein Beispiel für eine erfolgreiche Antwort nach der Ausführung dieses Befehls.

    {
    "arn": " arn:aws:kafka:us-east-1:123456789012:configuration/SomeTest/abcdabcd-1234-abcd-1234-abcd123e8e8e-1",
    "state": "DELETING"
}

Um eine MSK Konfiguration zu beschreiben

  1. Der folgende Befehl gibt Metadaten zur Konfiguration zurück. Um eine detaillierte Beschreibung der Konfiguration zu erhalten, führen Sie describe-configuration-revision aus .

    Um dieses Beispiel auszuführen, ersetzen Sie configuration-arn durch dieARN, die Sie bei der Erstellung der Konfiguration erhalten haben. Wenn Sie die ARN bei der Erstellung der Konfiguration nicht gespeichert haben, können Sie den list-configurations Befehl verwenden, um die gesamte Konfiguration in Ihrem Konto aufzulisten. Die Konfiguration, die Sie in der Liste haben möchten, wird in der Antwort angezeigt. Die ARN Konfiguration wird auch in dieser Liste angezeigt.

    aws kafka describe-configuration --arn configuration-arn

  2. Im Folgenden finden Sie ein Beispiel für eine erfolgreiche Antwort nach der Ausführung dieses Befehls.

    {
    "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"
}

Um eine MSK Konfigurationsrevision zu beschreiben

Wenn Sie den describe-configuration Befehl verwenden, um eine MSK Konfiguration zu beschreiben, sehen Sie die Metadaten der Konfiguration. Um eine Beschreibung der Konfiguration zu erhalten, verwenden Sie den Befehl describe-configuration-revision.

  • Führen Sie den folgenden Befehl aus und ersetzen Sie configuration-arn mit demARN, den Sie bei der Erstellung der Konfiguration erhalten haben. Wenn Sie die ARN bei der Erstellung der Konfiguration nicht gespeichert haben, können Sie den list-configurations Befehl verwenden, um die gesamte Konfiguration in Ihrem Konto aufzulisten. Die Konfiguration, die Sie in der Liste suchen, wird in der Antwort angezeigt. Die ARN Konfiguration wird auch in dieser Liste angezeigt.

    aws kafka describe-configuration-revision --arn configuration-arn --revision 1

    Im Folgenden finden Sie ein Beispiel für eine erfolgreiche Antwort nach der Ausführung dieses Befehls.

    {
    "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"
}

    Der Wert von ServerProperties wird mit base64 codiert. Wenn Sie einen base64-Decoder (z. B. https://www.base64decode.org/) verwenden, um den Wert manuell zu dekodieren, erhalten Sie den Inhalt der ursprünglichen Konfigurationsdatei, mit der Sie die benutzerdefinierte Konfiguration erstellt haben. In diesem Fall erhalten Sie Folgendes:

    auto.create.topics.enable = true

log.roll.ms = 604800000

Um alle MSK Konfigurationen in Ihrem Konto für die aktuelle Region aufzulisten

  • Führen Sie den folgenden Befehl aus.

    aws kafka list-configurations

    Im Folgenden finden Sie ein Beispiel für eine erfolgreiche Antwort nach der Ausführung dieses Befehls.

    {
    "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"
        }
    ]
}