Skip to content

queue.oracle.com/v1beta1

Back to API Reference

APIVersion: queue.oracle.com/v1beta1

This content is generated from the checked-in CRD schemas in config/crd/bases/. If a description is missing or incorrect, fix the source comments or generator inputs and rerun make generate manifests; do not hand-edit config/crd/bases/*.yaml.

Packages

Package Support Latest release Resources
Queue preview v2.0.0-alpha Queue

Resources

Kind Scope Sample Packages
Queue Namespaced Sample Queue (v2.0.0-alpha)

Queue

Manage OCI Queue service queues.

  • Plural: queues
  • Scope: Namespaced
  • APIVersion: queue.oracle.com/v1beta1
  • Sample: Sample (config/samples/queue_v1beta1_queue.yaml)
  • Packages: Queue (v2.0.0-alpha)

Spec

QueueSpec defines the desired state of Queue.

Field Description Type Required Default Enum
capabilities The capability to add on the queue list[object] No - -
channelConsumptionLimit The percentage of allocated queue resources that can be consumed by a single channel. For example, if a queue has a storage limit of 2Gb, and a single channel consumption limit is 0.1 (10%), that means data size of a single channel can't exceed 200Mb. Consumption limit of 100% (default) means that a single channel can consume up-to all allocated queue's resources. integer No - -
compartmentId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment containing the queue. string Yes - -
customEncryptionKeyId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the custom encryption key to be used to encrypt messages content. string No - -
deadLetterQueueDeliveryCount The number of times a message can be delivered to a consumer before being moved to the dead letter queue. A value of 0 indicates that the DLQ is not used. integer No - -
definedTags Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace": {"bar-key": "value"}} map[string, map[string, string]] No - -
displayName The user-friendly name of the queue. string Yes - -
freeformTags Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"} map[string, string] No - -
retentionInSeconds The retention period of messages in the queue, in seconds. integer No - -
timeoutInSeconds The default polling timeout of the messages in the queue, in seconds. integer No - -
visibilityInSeconds The default visibility timeout of the messages consumed from the queue, in seconds. integer No - -

Spec.capabilities[]

Back to Queue spec

QueueCapability defines nested fields for Queue.Capability.

Field Description Type Required Default Enum
isPrimaryConsumerGroupEnabled Specifies if the primary consumer group should be automatically enabled after adding the capability. boolean No - -
jsonData - string No - -
primaryConsumerGroupDeadLetterQueueDeliveryCount The number of times a message can be delivered to a consumer before being moved to the dead letter queue. A value of 0 indicates that the DLQ is not used. If the value isn't set, it will be using the value defined at the queue level. integer No - -
primaryConsumerGroupDisplayName Name of the primary consumer group. If omitted, it will be named "Primary Consumer Group". string No - -
primaryConsumerGroupFilter The filter used by the primary consumer group. Only messages matching the filter will be available by consumers of the group. An empty value means that all messages will be available in the group. string No - -
type - string No - -

Status

QueueStatus defines the observed state of Queue.

Field Description Type Required Default Enum
capabilities The list of capabilities enabled on the queue list[object] No - -
channelConsumptionLimit The percentage of allocated queue resources that can be consumed by a single channel. For example, if a queue has a storage limit of 2Gb, and a single channel consumption limit is 0.1 (10%), that means data size of a single channel can't exceed 200Mb. Consumption limit of 100% (default) means that a single channel can consume up-to all allocated queue's resources. integer No - -
compartmentId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment containing the queue. string No - -
createWorkRequestId The work request OCID tracking the in-flight create operation. string No - -
customEncryptionKeyId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the custom encryption key to be used to encrypt messages content. string No - -
deadLetterQueueDeliveryCount The number of times a message can be delivered to a consumer before being moved to the dead letter queue. A value of 0 indicates that the DLQ is not used. integer No - -
definedTags Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace": {"bar-key": "value"}} map[string, map[string, string]] No - -
deleteWorkRequestId The work request OCID tracking the in-flight delete operation. string No - -
displayName A user-friendly name for the queue. Does not have to be unique, and it's changeable. Avoid entering confidential information. string No - -
freeformTags Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"} map[string, string] No - -
id A unique identifier for the queue that is immutable on creation. string No - -
lifecycleDetails Any additional details about the current state of the queue. string No - -
lifecycleState The current state of the queue. string No - -
messagesEndpoint The endpoint to use to consume or publish messages in the queue. string No - -
retentionInSeconds The retention period of the messages in the queue, in seconds. integer No - -
status - object Yes - -
systemTags Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud": {"free-tier-retained": "true"}} map[string, map[string, string]] No - -
timeCreated The time that the queue was created, expressed in RFC 3339 (https://tools.ietf.org/rfc/rfc3339) timestamp format. Example: 2018-04-20T00:00:07.405Z string No - -
timeUpdated The time that the queue was updated, expressed in RFC 3339 (https://tools.ietf.org/rfc/rfc3339) timestamp format. Example: 2018-04-20T00:00:07.405Z string No - -
timeoutInSeconds The default polling timeout of the messages in the queue, in seconds. integer No - -
updateWorkRequestId The work request OCID tracking the in-flight update operation. string No - -
visibilityInSeconds The default visibility timeout of the messages consumed from the queue, in seconds. integer No - -

Status.capabilities[]

Back to Queue status

QueueCapability defines nested fields for Queue.Capability.

Field Description Type Required Default Enum
isPrimaryConsumerGroupEnabled Specifies if the primary consumer group should be automatically enabled after adding the capability. boolean No - -
jsonData - string No - -
primaryConsumerGroupDeadLetterQueueDeliveryCount The number of times a message can be delivered to a consumer before being moved to the dead letter queue. A value of 0 indicates that the DLQ is not used. If the value isn't set, it will be using the value defined at the queue level. integer No - -
primaryConsumerGroupDisplayName Name of the primary consumer group. If omitted, it will be named "Primary Consumer Group". string No - -
primaryConsumerGroupFilter The filter used by the primary consumer group. Only messages matching the filter will be available by consumers of the group. An empty value means that all messages will be available in the group. string No - -
type - string No - -

Status.status

Back to Queue status

Field Description Type Required Default Enum
async Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first. object No - -
conditions - list[object] No - -
createdAt - string (date-time) No - -
deletedAt - string (date-time) No - -
message - string No - -
ocid - string No - -
opcRequestId OpcRequestID is the latest non-empty OCI request ID from a mutating OCI response or surfaced OCI service error that materially contributed to the current shared status projection. Headerless follow-up observations keep the last non-empty value intact. string No - -
reason - string No - -
requestedAt - string (date-time) No - -
updatedAt - string (date-time) No - -

Status.status.async

Back to Queue status

Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first.

Field Description Type Required Default Enum
current - object No - -

Status.status.async.current

Back to Queue status

Field Description Type Required Default Enum
message - string No - -
normalizedClass - string Yes - attention, canceled, failed, pending, succeeded, unknown
percentComplete - number No - -
phase - string Yes - create, delete, update
rawOperationType - string No - -
rawStatus - string No - -
source - string Yes - lifecycle, none, workrequest
updatedAt - string (date-time) Yes - -
workRequestId - string No - -

Status.status.conditions[]

Back to Queue status

Field Description Type Required Default Enum
lastTransitionTime - string (date-time) No - -
message - string No - -
reason - string No - -
status - string Yes - -
type - string Yes - -