Oracle Cloud Infrastructure v2.17.0 published on Friday, Nov 15, 2024 by Pulumi
oci.Queue.getQueue
Explore with Pulumi AI
This data source provides details about a specific Queue resource in Oracle Cloud Infrastructure Queue service.
Gets a queue by identifier.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testQueue = oci.Queue.getQueue({
queueId: testQueueOciQueueQueue.id,
});
import pulumi
import pulumi_oci as oci
test_queue = oci.Queue.get_queue(queue_id=test_queue_oci_queue_queue["id"])
package main
import (
"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/Queue"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := Queue.GetQueue(ctx, &queue.GetQueueArgs{
QueueId: testQueueOciQueueQueue.Id,
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() =>
{
var testQueue = Oci.Queue.GetQueue.Invoke(new()
{
QueueId = testQueueOciQueueQueue.Id,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Queue.QueueFunctions;
import com.pulumi.oci.Queue.inputs.GetQueueArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var testQueue = QueueFunctions.getQueue(GetQueueArgs.builder()
.queueId(testQueueOciQueueQueue.id())
.build());
}
}
variables:
testQueue:
fn::invoke:
Function: oci:Queue:getQueue
Arguments:
queueId: ${testQueueOciQueueQueue.id}
Using getQueue
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getQueue(args: GetQueueArgs, opts?: InvokeOptions): Promise<GetQueueResult>
function getQueueOutput(args: GetQueueOutputArgs, opts?: InvokeOptions): Output<GetQueueResult>
def get_queue(queue_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetQueueResult
def get_queue_output(queue_id: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetQueueResult]
func GetQueue(ctx *Context, args *GetQueueArgs, opts ...InvokeOption) (*GetQueueResult, error)
func GetQueueOutput(ctx *Context, args *GetQueueOutputArgs, opts ...InvokeOption) GetQueueResultOutput
> Note: This function is named GetQueue
in the Go SDK.
public static class GetQueue
{
public static Task<GetQueueResult> InvokeAsync(GetQueueArgs args, InvokeOptions? opts = null)
public static Output<GetQueueResult> Invoke(GetQueueInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetQueueResult> getQueue(GetQueueArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: oci:Queue/getQueue:getQueue
arguments:
# arguments dictionary
The following arguments are supported:
- Queue
Id string - The unique queue identifier.
- Queue
Id string - The unique queue identifier.
- queue
Id String - The unique queue identifier.
- queue
Id string - The unique queue identifier.
- queue_
id str - The unique queue identifier.
- queue
Id String - The unique queue identifier.
getQueue Result
The following output properties are available:
- Channel
Consumption intLimit - 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.
- Compartment
Id string - The OCID of the compartment containing the queue.
- Custom
Encryption stringKey Id - The OCID of the custom encryption key to be used to encrypt messages content.
- Dead
Letter intQueue Delivery Count - 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.
- Dictionary<string, string>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- Display
Name string - A user-friendly name for the queue. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Dictionary<string, string>
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- Id string
- A unique identifier for the queue that is immutable on creation.
- Lifecycle
Details string - Any additional details about the current state of the queue.
- Messages
Endpoint string - The endpoint to use to consume or publish messages in the queue.
- Purge
Trigger int - Purge
Type string - Queue
Id string - Retention
In intSeconds - The retention period of the messages in the queue, in seconds.
- State string
- The current state of the queue.
- Dictionary<string, string>
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string - The time that the queue was created, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- Time
Updated string - The time that the queue was updated, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- Timeout
In intSeconds - The default polling timeout of the messages in the queue, in seconds.
- Visibility
In intSeconds - The default visibility timeout of the messages consumed from the queue, in seconds.
- Channel
Consumption intLimit - 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.
- Compartment
Id string - The OCID of the compartment containing the queue.
- Custom
Encryption stringKey Id - The OCID of the custom encryption key to be used to encrypt messages content.
- Dead
Letter intQueue Delivery Count - 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.
- map[string]string
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- Display
Name string - A user-friendly name for the queue. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- map[string]string
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- Id string
- A unique identifier for the queue that is immutable on creation.
- Lifecycle
Details string - Any additional details about the current state of the queue.
- Messages
Endpoint string - The endpoint to use to consume or publish messages in the queue.
- Purge
Trigger int - Purge
Type string - Queue
Id string - Retention
In intSeconds - The retention period of the messages in the queue, in seconds.
- State string
- The current state of the queue.
- map[string]string
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string - The time that the queue was created, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- Time
Updated string - The time that the queue was updated, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- Timeout
In intSeconds - The default polling timeout of the messages in the queue, in seconds.
- Visibility
In intSeconds - The default visibility timeout of the messages consumed from the queue, in seconds.
- channel
Consumption IntegerLimit - 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.
- compartment
Id String - The OCID of the compartment containing the queue.
- custom
Encryption StringKey Id - The OCID of the custom encryption key to be used to encrypt messages content.
- dead
Letter IntegerQueue Delivery Count - 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.
- Map<String,String>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- display
Name String - A user-friendly name for the queue. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Map<String,String>
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- id String
- A unique identifier for the queue that is immutable on creation.
- lifecycle
Details String - Any additional details about the current state of the queue.
- messages
Endpoint String - The endpoint to use to consume or publish messages in the queue.
- purge
Trigger Integer - purge
Type String - queue
Id String - retention
In IntegerSeconds - The retention period of the messages in the queue, in seconds.
- state String
- The current state of the queue.
- Map<String,String>
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String - The time that the queue was created, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- time
Updated String - The time that the queue was updated, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- timeout
In IntegerSeconds - The default polling timeout of the messages in the queue, in seconds.
- visibility
In IntegerSeconds - The default visibility timeout of the messages consumed from the queue, in seconds.
- channel
Consumption numberLimit - 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.
- compartment
Id string - The OCID of the compartment containing the queue.
- custom
Encryption stringKey Id - The OCID of the custom encryption key to be used to encrypt messages content.
- dead
Letter numberQueue Delivery Count - 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.
- {[key: string]: string}
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- display
Name string - A user-friendly name for the queue. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- {[key: string]: string}
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- id string
- A unique identifier for the queue that is immutable on creation.
- lifecycle
Details string - Any additional details about the current state of the queue.
- messages
Endpoint string - The endpoint to use to consume or publish messages in the queue.
- purge
Trigger number - purge
Type string - queue
Id string - retention
In numberSeconds - The retention period of the messages in the queue, in seconds.
- state string
- The current state of the queue.
- {[key: string]: string}
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created string - The time that the queue was created, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- time
Updated string - The time that the queue was updated, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- timeout
In numberSeconds - The default polling timeout of the messages in the queue, in seconds.
- visibility
In numberSeconds - The default visibility timeout of the messages consumed from the queue, in seconds.
- channel_
consumption_ intlimit - 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.
- compartment_
id str - The OCID of the compartment containing the queue.
- custom_
encryption_ strkey_ id - The OCID of the custom encryption key to be used to encrypt messages content.
- dead_
letter_ intqueue_ delivery_ count - 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.
- Mapping[str, str]
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- display_
name str - A user-friendly name for the queue. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Mapping[str, str]
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- id str
- A unique identifier for the queue that is immutable on creation.
- lifecycle_
details str - Any additional details about the current state of the queue.
- messages_
endpoint str - The endpoint to use to consume or publish messages in the queue.
- purge_
trigger int - purge_
type str - queue_
id str - retention_
in_ intseconds - The retention period of the messages in the queue, in seconds.
- state str
- The current state of the queue.
- Mapping[str, str]
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time_
created str - The time that the queue was created, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- time_
updated str - The time that the queue was updated, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- timeout_
in_ intseconds - The default polling timeout of the messages in the queue, in seconds.
- visibility_
in_ intseconds - The default visibility timeout of the messages consumed from the queue, in seconds.
- channel
Consumption NumberLimit - 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.
- compartment
Id String - The OCID of the compartment containing the queue.
- custom
Encryption StringKey Id - The OCID of the custom encryption key to be used to encrypt messages content.
- dead
Letter NumberQueue Delivery Count - 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.
- Map<String>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- display
Name String - A user-friendly name for the queue. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Map<String>
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- id String
- A unique identifier for the queue that is immutable on creation.
- lifecycle
Details String - Any additional details about the current state of the queue.
- messages
Endpoint String - The endpoint to use to consume or publish messages in the queue.
- purge
Trigger Number - purge
Type String - queue
Id String - retention
In NumberSeconds - The retention period of the messages in the queue, in seconds.
- state String
- The current state of the queue.
- Map<String>
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String - The time that the queue was created, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- time
Updated String - The time that the queue was updated, expressed in RFC 3339 timestamp format. Example:
2018-04-20T00:00:07.405Z
- timeout
In NumberSeconds - The default polling timeout of the messages in the queue, in seconds.
- visibility
In NumberSeconds - The default visibility timeout of the messages consumed from the queue, in seconds.
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
oci
Terraform Provider.