Streampool aktualisieren

Ändern Sie die Einstellungen eines Streampools für die Kafka-Verwendung und -Verschlüsselung (Masterverschlüsselungsschlüssel).

Wenn Sie einen Streampool aktualisieren, können Sie auch die zugehörigen Tags aktualisieren. Weitere Informationen zum Tagging finden Sie unter Ressourcentags.

Informationen zu den Anforderungen zum Erstellen und Verwalten von Streams finden Sie unter Erste Schritte mit Streaming.

    1. Wählen Sie auf der Listenseite Streampools den Streampool aus, mit dem Sie arbeiten möchten. Wenn Sie Hilfe beim Suchen der Listenseite oder des Streampools benötigen, finden Sie weitere Informationen unter Streampools auflisten.
    2. Wählen Sie auf der Detailseite die Option Einstellungen bearbeiten aus.
    3. Um den Streampool mit Kafka zu verwenden, wählen Sie Themen automatisch erstellen aus, und konfigurieren Sie die Streameinstellungen:
      • Standardaufbewahrungszeitraum (Stunden): Geben Sie eine Anzahl von Stunden für den Aufbewahrungszeitraum des Streams an.
      • Standardanzahl Partitionen: Geben Sie die Standardanzahl Partitionen für den Stream an.
    4. Um die Daten in den Streams in diesem Streampool mit Ihrem eigenen Vault-Verschlüsselungsschlüssel zu verschlüsseln, wählen Sie Mit vom Kunden verwalteten Schlüsseln verschlüsseln aus. Um den Vault-Service für Ihre Verschlüsselungsanforderungen zu verwenden, benötigen Sie Zugriff auf einen Vault und einen Schlüssel. Außerdem müssen Sie dem Service die Verwendung des Schlüssels ermöglichen.
      • Vault: Wählen Sie den Vault aus, der den zu verwendenden Masterverschlüsselungsschlüssel enthält.
      • Master-Verschlüsselungsschlüssel: Wählen Sie den zu verwendenden Master-Verschlüsselungsschlüssel aus.

      Weitere Informationen zur Verschlüsselung mit einem Vault-Schlüssel, den Sie verwalten, finden Sie unter Überblick über Vault und Schlüssel verwalten.

      Hinweis

      Sie können die Verschlüsselungseinstellungen auch auf der Detailseite aktualisieren.

      • Um die Verwendung eines von Oracle verwalteten Schlüssels für einen von Ihnen verwalteten Vault-Masterverschlüsselungsschlüssel zu stoppen, wählen Sie Zuweisen aus, wählen Sie einen Vault- und Verschlüsselungsschlüssel aus, auf den Sie Zugriff haben, und wählen Sie Zuweisen aus.
      • Um einen anderen von Ihnen verwalteten Vault-Master-Verschlüsselungsschlüssel auszuwählen, wählen Sie Aktualisieren, einen Vault- und Verschlüsselungsschlüssel aus, auf den Sie Zugriff haben, und wählen Sie Aktualisieren aus.
      • Um den zugewiesenen Vault-Master-Verschlüsselungsschlüssel zu entfernen und Oracle die Verwaltung des Verschlüsselungsschlüssels zu ermöglichen, wählen Sie Zuweisung aufheben und dann erneut Zuweisung aufheben aus, um das Entfernen der vorhandenen Schlüsselzuweisung zu bestätigen.
    5. Wählen Sie Einstellungen bearbeiten aus, um die Änderungen zu speichern.
    6. (Optional) Fügen Sie dem Streampool mindestens ein Tag hinzu: Wählen Sie auf der Detailseite die Option Tags aus.
      Wenn Sie über Berechtigungen zum Erstellen einer Ressource verfügen, sind Sie auch berechtigt, Freiform-Tags auf diese Ressource anzuwenden. Um ein definiertes Tag anzuwenden, müssen Sie über die Berechtigungen verfügen, den Tag-Namespace zu verwenden. Weitere Informationen zum Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Sie Tags anwenden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
  • Verwenden Sie den Befehl oci streaming admin stream-pool update und die erforderlichen Parameter, um einen Streampool zu aktualisieren:

    oci streaming admin stream-pool update --stream-pool-id <stream_pool_OCID>

    Beispiel:

    oci streaming admin stream-pool update --stream-pool-id ocid1.streampool.oc1.phx.exampleuniqueID --name MyUpdatedStreamPool
    {
      "data": {
        "compartment-id": "ocid1.tenancy.oc1..exampleuniqueID",
        "custom-encryption-key": {
          "key-state": "NONE",
          "kms-key-id": null
        },
        "defined-tags": {},
        "endpoint-fqdn": "cell-1.streaming.us-phoenix-1.oci.oraclecloud.com",
        "freeform-tags": {},
        "id": "ocid1.streampool.oc1.phx.exampleuniqueID",
        "is-private": false,
        "kafka-settings": {
          "auto-create-topics-enable": false,
          "bootstrap-servers": "cell-1.streaming.us-phoenix-1.oci.oraclecloud.com:9092",
          "log-retention-hours": 24,
          "num-partitions": 1
        },
        "lifecycle-state": "UPDATING",
        "lifecycle-state-details": null,
        "name": "MyUpdatedStreamPool",
        "private-endpoint-settings": {
          "nsg-ids": null,
          "private-endpoint-ip": null,
          "subnet-id": null
        },
        "time-created": "2020-11-02T23:01:59.429000+00:00"
      },
      "etag": "\"6ad44a83-4804-4cb5-87ae-2100d3a7012c-9679fcb9-37b7-48c5-9114-d514f132d363\""
    }
    Tipp

    Geben Sie die Eingabe für --custom-encryption-key-details, --private-endpoint-details und --kafka-settings als gültige formatierte JSON an. Informationen zur JSON-Formatierung finden Sie unter Komplexe Eingaben übergeben und JSON-Datei für komplexe Eingaben verwenden.

    Eine vollständige Liste der Parameter und Werte für CLI-Befehle finden Sie in der CLI-Befehlsreferenz.

  • Führen Sie den Vorgang UpdateStreamPool aus, um einen Streampool zu aktualisieren.

Mit Resource Manager und Terraform

Aktualisieren Sie die Ressource oci_streaming_stream_pool in der Terraform-Konfiguration, und bearbeiten Sie den Stack, oder führen Sie einen terraform apply-Job aus.

Informationen zu Resource Manager und Terraform

Resource Manager ist ein Oracle Cloud Infrastructure-(OCI-)Service, mit dem Sie das Provisioning Ihrer OCI-Ressourcen automatisieren können. Mithilfe von Terraform unterstützt Sie Resource Manager bei der Installation, Konfiguration und Verwaltung von Ressourcen über das "Infrastructure-as-Code"-Modell.

Eine Terraform-Konfiguration kodifiziert Ihre Infrastruktur in deklarativen Konfigurationsdateien. Die Konfiguration definiert die Ressourcen, die Sie bereitstellen möchten, sowie Variablen und spezifische Anweisungen für das Provisioning der Ressourcen.

Mit Resource Manager oder der Terraform-CLI mit dem OCI-Terraform-Provider können Sie sehen, wie Ihre Streams und Streampools in Terraform-Konfigurationsdateien dargestellt werden.

Weitere Informationen zum Schreiben von Konfigurationen für Resource Manager finden Sie unter Terraform-Konfigurationen für Resource Manager und Terraform-Konfiguration.