1. Packages
  2. Azure Classic
  3. API Docs
  4. servicebus
  5. getQueue

We recommend using Azure Native.

Azure v6.10.0 published on Tuesday, Nov 19, 2024 by Pulumi

azure.servicebus.getQueue

Explore with Pulumi AI

azure logo

We recommend using Azure Native.

Azure v6.10.0 published on Tuesday, Nov 19, 2024 by Pulumi

    Use this data source to access information about an existing Service Bus Queue.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as azure from "@pulumi/azure";
    
    const example = azure.servicebus.getQueue({
        name: "existing",
        namespaceId: "existing",
    });
    export const id = example.then(example => example.id);
    
    import pulumi
    import pulumi_azure as azure
    
    example = azure.servicebus.get_queue(name="existing",
        namespace_id="existing")
    pulumi.export("id", example.id)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/servicebus"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		example, err := servicebus.LookupQueue(ctx, &servicebus.LookupQueueArgs{
    			Name:        "existing",
    			NamespaceId: pulumi.StringRef("existing"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("id", example.Id)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Azure = Pulumi.Azure;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Azure.ServiceBus.GetQueue.Invoke(new()
        {
            Name = "existing",
            NamespaceId = "existing",
        });
    
        return new Dictionary<string, object?>
        {
            ["id"] = example.Apply(getQueueResult => getQueueResult.Id),
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.azure.servicebus.ServicebusFunctions;
    import com.pulumi.azure.servicebus.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 example = ServicebusFunctions.getQueue(GetQueueArgs.builder()
                .name("existing")
                .namespaceId("existing")
                .build());
    
            ctx.export("id", example.applyValue(getQueueResult -> getQueueResult.id()));
        }
    }
    
    variables:
      example:
        fn::invoke:
          Function: azure:servicebus:getQueue
          Arguments:
            name: existing
            namespaceId: existing
    outputs:
      id: ${example.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(name: Optional[str] = None,
                  namespace_id: Optional[str] = None,
                  namespace_name: Optional[str] = None,
                  resource_group_name: Optional[str] = None,
                  opts: Optional[InvokeOptions] = None) -> GetQueueResult
    def get_queue_output(name: Optional[pulumi.Input[str]] = None,
                  namespace_id: Optional[pulumi.Input[str]] = None,
                  namespace_name: Optional[pulumi.Input[str]] = None,
                  resource_group_name: Optional[pulumi.Input[str]] = None,
                  opts: Optional[InvokeOptions] = None) -> Output[GetQueueResult]
    func LookupQueue(ctx *Context, args *LookupQueueArgs, opts ...InvokeOption) (*LookupQueueResult, error)
    func LookupQueueOutput(ctx *Context, args *LookupQueueOutputArgs, opts ...InvokeOption) LookupQueueResultOutput

    > Note: This function is named LookupQueue 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: azure:servicebus/getQueue:getQueue
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Name string
    The name of this Service Bus Queue.
    NamespaceId string
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    NamespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    ResourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    Name string
    The name of this Service Bus Queue.
    NamespaceId string
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    NamespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    ResourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    name String
    The name of this Service Bus Queue.
    namespaceId String
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    namespaceName String

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    resourceGroupName String

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    name string
    The name of this Service Bus Queue.
    namespaceId string
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    namespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    resourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    name str
    The name of this Service Bus Queue.
    namespace_id str
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    namespace_name str

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    resource_group_name str

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    name String
    The name of this Service Bus Queue.
    namespaceId String
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    namespaceName String

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    resourceGroupName String

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    getQueue Result

    The following output properties are available:

    AutoDeleteOnIdle string
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    DeadLetteringOnMessageExpiration bool
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    DefaultMessageTtl string
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    DuplicateDetectionHistoryTimeWindow string
    The ISO 8601 timespan duration during which duplicates can be detected.
    EnableBatchedOperations bool
    Boolean flag which controls whether server-side batched operations are enabled.
    EnableExpress bool
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    EnablePartitioning bool
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    ForwardDeadLetteredMessagesTo string
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    ForwardTo string
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    Id string
    The provider-assigned unique ID for this managed resource.
    LockDuration string
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    MaxDeliveryCount int
    Integer value which controls when a message is automatically dead lettered.
    MaxSizeInMegabytes int
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    Name string
    RequiresDuplicateDetection bool
    Boolean flag which controls whether the Queue requires duplicate detection.
    RequiresSession bool
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    Status string
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    NamespaceId string
    NamespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    ResourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    AutoDeleteOnIdle string
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    DeadLetteringOnMessageExpiration bool
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    DefaultMessageTtl string
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    DuplicateDetectionHistoryTimeWindow string
    The ISO 8601 timespan duration during which duplicates can be detected.
    EnableBatchedOperations bool
    Boolean flag which controls whether server-side batched operations are enabled.
    EnableExpress bool
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    EnablePartitioning bool
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    ForwardDeadLetteredMessagesTo string
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    ForwardTo string
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    Id string
    The provider-assigned unique ID for this managed resource.
    LockDuration string
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    MaxDeliveryCount int
    Integer value which controls when a message is automatically dead lettered.
    MaxSizeInMegabytes int
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    Name string
    RequiresDuplicateDetection bool
    Boolean flag which controls whether the Queue requires duplicate detection.
    RequiresSession bool
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    Status string
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    NamespaceId string
    NamespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    ResourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    autoDeleteOnIdle String
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    deadLetteringOnMessageExpiration Boolean
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    defaultMessageTtl String
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    duplicateDetectionHistoryTimeWindow String
    The ISO 8601 timespan duration during which duplicates can be detected.
    enableBatchedOperations Boolean
    Boolean flag which controls whether server-side batched operations are enabled.
    enableExpress Boolean
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    enablePartitioning Boolean
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    forwardDeadLetteredMessagesTo String
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    forwardTo String
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    id String
    The provider-assigned unique ID for this managed resource.
    lockDuration String
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    maxDeliveryCount Integer
    Integer value which controls when a message is automatically dead lettered.
    maxSizeInMegabytes Integer
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    name String
    requiresDuplicateDetection Boolean
    Boolean flag which controls whether the Queue requires duplicate detection.
    requiresSession Boolean
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    status String
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    namespaceId String
    namespaceName String

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    resourceGroupName String

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    autoDeleteOnIdle string
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    deadLetteringOnMessageExpiration boolean
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    defaultMessageTtl string
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    duplicateDetectionHistoryTimeWindow string
    The ISO 8601 timespan duration during which duplicates can be detected.
    enableBatchedOperations boolean
    Boolean flag which controls whether server-side batched operations are enabled.
    enableExpress boolean
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    enablePartitioning boolean
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    forwardDeadLetteredMessagesTo string
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    forwardTo string
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    id string
    The provider-assigned unique ID for this managed resource.
    lockDuration string
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    maxDeliveryCount number
    Integer value which controls when a message is automatically dead lettered.
    maxSizeInMegabytes number
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    name string
    requiresDuplicateDetection boolean
    Boolean flag which controls whether the Queue requires duplicate detection.
    requiresSession boolean
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    status string
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    namespaceId string
    namespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    resourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    auto_delete_on_idle str
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    dead_lettering_on_message_expiration bool
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    default_message_ttl str
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    duplicate_detection_history_time_window str
    The ISO 8601 timespan duration during which duplicates can be detected.
    enable_batched_operations bool
    Boolean flag which controls whether server-side batched operations are enabled.
    enable_express bool
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    enable_partitioning bool
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    forward_dead_lettered_messages_to str
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    forward_to str
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    id str
    The provider-assigned unique ID for this managed resource.
    lock_duration str
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    max_delivery_count int
    Integer value which controls when a message is automatically dead lettered.
    max_size_in_megabytes int
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    name str
    requires_duplicate_detection bool
    Boolean flag which controls whether the Queue requires duplicate detection.
    requires_session bool
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    status str
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    namespace_id str
    namespace_name str

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    resource_group_name str

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    autoDeleteOnIdle String
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    deadLetteringOnMessageExpiration Boolean
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    defaultMessageTtl String
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    duplicateDetectionHistoryTimeWindow String
    The ISO 8601 timespan duration during which duplicates can be detected.
    enableBatchedOperations Boolean
    Boolean flag which controls whether server-side batched operations are enabled.
    enableExpress Boolean
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    enablePartitioning Boolean
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    forwardDeadLetteredMessagesTo String
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    forwardTo String
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    id String
    The provider-assigned unique ID for this managed resource.
    lockDuration String
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    maxDeliveryCount Number
    Integer value which controls when a message is automatically dead lettered.
    maxSizeInMegabytes Number
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    name String
    requiresDuplicateDetection Boolean
    Boolean flag which controls whether the Queue requires duplicate detection.
    requiresSession Boolean
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    status String
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    namespaceId String
    namespaceName String

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    resourceGroupName String

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 4.0 of the AzureRM Provider.

    Package Details

    Repository
    Azure Classic pulumi/pulumi-azure
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the azurerm Terraform Provider.
    azure logo

    We recommend using Azure Native.

    Azure v6.10.0 published on Tuesday, Nov 19, 2024 by Pulumi