Updating a Stream Pool
Change a stream pool's settings for Kafka use and encryption (master encryption key).
When you update a stream pool, you can also update its tags. For more information about tagging, see Resource Tags.
To review requirements for creating and managing streams, see Getting Started with Streaming.
Use the oci streaming admin stream-pool update command and required parameters to update a stream pool:
oci streaming admin stream-pool update --stream-pool-id <stream_pool_OCID>
For example:
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\"" }
Tip
Provide input for--custom-encryption-key-details
,--private-endpoint-details
, and--kafka-settings
as valid formatted JSON. See Passing Complex Input and Using a JSON File for Complex Input for information about JSON formatting.For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Run the UpdateStreamPool operation to update a stream pool.
Using OCI SDKs
See the Developer Guide to Streaming for detailed SDK examples.
Using Resource Manager and Terraform
Update the oci_streaming_stream_pool
resource in your Terraform configuration and edit your stack or run a terraform apply
job.
Resource Manager is an Oracle Cloud Infrastructure (OCI) service that allows you to automate the process of provisioning your OCI resources. Using Terraform, Resource Manager helps you install, configure, and manage resources through the "infrastructure-as-code" model.
A Terraform configuration codifies your infrastructure in declarative configuration files. The configuration defines the resources you intend to provision, variables, and specific instructions for provisioning the resources
You can use Resource Manager or the Terraform CLI with the OCI Terraform provider to see how your streams and stream pools are represented in Terraform configuration files.
For more information about writing configurations for use with Resource Manager, see Terraform Configurations for Resource Manager and Terraform Configuration.