Mise à jour d'un groupe de flux

Modifier les paramètres d'un groupe de flux pour l'utilisation et le chiffrement Kafka (clé de chiffrement principale).

Lorsque vous mettez à jour un groupe de flux, vous pouvez également mettre à jour ses marqueurs. Pour plus d'informations sur le marquage, voir Marqueurs de ressource.

Pour connaître les exigences relatives à la création et à la gestion des flux, voir Introduction au service de diffusion en continu.

    1. Dans la page de liste Groupes de flux, sélectionnez le groupe de flux avec lequel vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou le groupe de flux, voir Liste des groupes de flux.
    2. Dans la page de détails, sélectionnez Modifier les paramètres.
    3. Pour utiliser le groupe de flux avec Kafka, sélectionnez Créer automatiquement des sujets et configurez les paramètres de flux :
      • Période de conservation (en heures) : Spécifiez un nombre d'heures pour la période de conservation du flux.
      • Nombre de partitions par défaut : Spécifiez le nombre de partitions par défaut pour le flux.
    4. Pour chiffrer les données des flux de ce groupe à l'aide de votre propre clé de chiffrement du service de chambre forte, sélectionnez Chiffrer à l'aide des clés gérées par le client. Pour utiliser le service de chambre forte pour vos besoins de chiffrement, vous devez avoir accès à une chambre forte et à une clé, et vous devez autoriser le service à utiliser la clé.
      • Chambre forte : Sélectionnez la chambre forte qui contient la clé de chiffrement principale à utiliser.
      • Clé de chiffrement principale : Sélectionnez la clé de chiffrement principale à utiliser.

      Pour plus d'informations sur le chiffrement avec une clé de chambre forte que vous gérez, voir Aperçu du service de chambre forte et Gestion des clés.

      Note

      Vous pouvez également mettre à jour les paramètres de chiffrement à partir de la page de détails.

      • Pour arrêter d'utiliser une clé gérée par Oracle en lieu et place d'une clé de chiffrement principale de chambre forte que vous gérez, sélectionnez Affecter, sélectionnez une chambre forte et une clé de chiffrement auxquelles vous avez accès, puis sélectionnez Affecter.
      • Pour sélectionner une autre clé de chiffrement principale de chambre forte que vous gérez, sélectionnez Mettre à jour, sélectionnez une chambre forte et une clé de chiffrement auxquelles vous avez accès, puis sélectionnez Mettre à jour.
      • Pour supprimer la clé de chiffrement principale de chambre forte affectée et permettre à Oracle de gérer la clé de chiffrement, sélectionnez Annuler l'affectation, puis sélectionnez Annuler l'affectation de nouveau pour confirmer la suppression de l'affectation de clé existante.
    5. Sélectionnez Modifier les paramètres pour enregistrer les modifications.
    6. (Facultatif) Ajoutez un ou plusieurs marqueurs au groupe de flux : Dans la page de détails, sélectionnez Marqueurs.
      Si vous avez l'autorisation de créer une ressource, vous avez également l'autorisation d'appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
  • Utilisez la commande oci streaming admin stream-pool update et les paramètres requis pour mettre à jour un groupe de flux :

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

    Par exemple :

    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\""
    }
    Conseil

    Indiquez une entrée pour --custom-encryption-key-details, --private-endpoint-details et --kafka-settings dans un format JSON valide. Voir Transmission d'entrée complexe et Utilisation d'un fichier JSON pour une entrée complexe pour plus d'informations sur le formatage JSON.

    Pour la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commande, voir .

  • Exécutez l'opération UpdateStreamPool pour mettre à jour un groupe de flux.

Utilisation du gestionnaire de ressources et de Terraform

Mettez à jour la ressource oci_streaming_stream_pool dans votre configuration Terraform et modifiez votre pile ou exécutez une tâche terraform apply.

À propos du gestionnaire de ressources et de Terraform

Le gestionnaire de ressources est un service pour Oracle Cloud Infrastructure (OCI) qui vous permet d'automatiser le processus de provisionnement des ressources OCI. À l'aide de Terraform, le gestionnaire de ressources vous aide à installer, configurer et gérer des ressources selon le modèle "infrastructure-code".

Une configuration Terraform code l'infrastructure dans des fichiers de configuration déclaratifs. La configuration définit les ressources que vous prévoyez de provisionner, des variables et des instructions spécifiques pour le provisionnement des ressources.

Vous pouvez utiliser le gestionnaire de ressources ou l'interface de ligne de commande Terraform avec le fournisseur Terraform pour pour voir comment les flux et les groupes de flux sont représentés dans des fichiers de configuration Terraform.

Pour plus d'informations sur l'écriture de configurations à utiliser avec le gestionnaire de ressources, voir Configurations Terraform pour le gestionnaire de ressources et Configuration Terraform.