Oracle Cloud Infrastructure - Dokumentation

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 Folgendes aktualisieren:

Informationen zum Prüfen der Anforderungen für das Erstellen und Verwalten von Streams finden Sie unter Erste Schritte mit Streaming.

    1. Wählen Sie auf der Listenseite Streampool den Streampool aus, mit dem Sie arbeiten möchten. Wenn Sie Hilfe beim Suchen der Listenseite oder des Streampools benötigen, lesen Sie Streampools auflisten.
    2. Wählen Sie auf der Detailseite die Option Einstellungen bearbeiten.
    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 an Partitionen: Geben Sie die Standardanzahl an Partitionen für den Stream.
    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 das Compartment aus, das den Vault mit dem zu verwendenden Masterverschlüsselungsschlüssel enthält, und wählen Sie den Vault aus.
      • Masterverschlüsselungsschlüssel: Wählen Sie das Compartment aus, das den zu verwendenden Masterverschlüsselungsschlüssel enthält, und wählen Sie den Schlü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, um die Änderungen zu speichern.

  • 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.