Oracle Cloud Infrastructure Documentation

Creating a Queue

Create a queue.

    1. On the Queues list page, select Create queue. If you need help finding the list page or the queue, see Listing Queues.
    2. Enter a name for the queue in the Name text box. Avoid entering confidential information.
    3. Select the compartment that you want to create the queue in.
    4. (Optional) Add tags to the queue 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.

    5. Select a queue configuration method:
      • Default configuration: Accept the service default settings for the queue.
      • Custom configuration: Specify the queue settings yourself.
    6. 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.
      • Dead letter queue: If a message isn't delivered successfully, and has more delivery attempts than the configured maximum delivery attempts, then the message is transferred to a dead letter queue (DLQ).
      • Maximum delivery attempts: The maximum number of retries for a message delivery before it's moved to the dead letter queue (DLQ).
    7. 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 your key that's stored in OCI Vault. This lets you rotate, disable, and delete it as needed. After selecting this option, select the vault that contains the key, and the key itself. For more information, see Updating the Master Encryption Key Assigned to a Queue.
    8. Click Create queue.

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

    oci queue queue-admin queue create --compartment-id <compartment_id> --display-name <display_name>

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

  • Use the CreateQueue operation to create 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.