Editing a Queue

Update a queue.

• Console
• CLI
• API

• 1. On the Queues list page, find the queue that you want to work with. If you need help finding the list page or the queue, see Listing Queues.
  2. From the Actions menu for the queue, select Configure queue.
  3. In the Configure queue panel, verify or change the queue settings:
     • Visibility timeout: How long a message in the queue is invisible to other consumers after being delivered to one.
     • Maximum retention period: How long a message remains in the queue before it's deleted by the service, if it isn't deleted by a consumer.
       Note
       
       The queue's retention period can't be changed after creation.
     • Channel capacity limit: The maximum amount of the queue's overall capacity that a single channel can use at any time. Specified as a percentage. The default value is 100, which means that a single channel can use the entirety of the queue's bandwidth. For more information, see Channels.
  4. Verify or change the encryption settings:
     • Oracle-managed key: Select this option to leave all encryption-related matters to Oracle.
     • Customer-managed key: Select this option to encrypt the queue using a key of your own that's stored in OCI Vault. This lets you rotate, disable, and delete it as needed. After selecting this option, choose the vault that contains the key, and the key itself. For more information, see Updating the Master Encryption Key Assigned to a Queue.
  5. Verify or change the dead letter queue settings:
     • Maximum delivery attempts: The number of times a message is delivered before it's moved to the dead letter queue.
  6. (Optional) Add or change the queue's tags by clicking Show tagging options.

     If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask your administrator. You can apply tags later.

  7. Click Save changes.

• Use the oci queue queue-admin queue update command and required parameters to edit a queue:

  Command

  CopyTry It

  oci queue queue-admin queue update --queue-id <queue_OCID>

  For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

• Use the UpdateQueue operation to update a queue.

  For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.