Oracle Cloud Infrastructure Documentation

Creating a Queue

Create a queue.

    1. Open the navigation menu and click Developer Services. Under Application Integration, click Queues.
    2. On the left side of the screen, click Queues.
    3. Click Create queue.
    4. Enter a name for the queue in the Name text box. Avoid entering confidential information.
    5. Select a compartment from the Compartment list.
    6. Select a queue configuration method:
      • Default configuration: Accept the service default settings for the queue.
      • Custom configuration: Specify the queue settings yourself.
    7. 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.
      • Maximum channel consumption: The maximum amount of the queue's storage and throughput 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.
    8. 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.
    9. 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.
    10. (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.

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