This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.89.1 published on Sunday, Mar 2, 2025 by Pulumi
azure-native.servicebus.getSubscription
Explore with Pulumi AI
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.89.1 published on Sunday, Mar 2, 2025 by Pulumi
Returns a subscription description for the specified topic. Azure REST API version: 2022-01-01-preview.
Other available API versions: 2022-10-01-preview, 2023-01-01-preview, 2024-01-01.
Using getSubscription
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 getSubscription(args: GetSubscriptionArgs, opts?: InvokeOptions): Promise<GetSubscriptionResult>
function getSubscriptionOutput(args: GetSubscriptionOutputArgs, opts?: InvokeOptions): Output<GetSubscriptionResult>def get_subscription(namespace_name: Optional[str] = None,
                     resource_group_name: Optional[str] = None,
                     subscription_name: Optional[str] = None,
                     topic_name: Optional[str] = None,
                     opts: Optional[InvokeOptions] = None) -> GetSubscriptionResult
def get_subscription_output(namespace_name: Optional[pulumi.Input[str]] = None,
                     resource_group_name: Optional[pulumi.Input[str]] = None,
                     subscription_name: Optional[pulumi.Input[str]] = None,
                     topic_name: Optional[pulumi.Input[str]] = None,
                     opts: Optional[InvokeOptions] = None) -> Output[GetSubscriptionResult]func LookupSubscription(ctx *Context, args *LookupSubscriptionArgs, opts ...InvokeOption) (*LookupSubscriptionResult, error)
func LookupSubscriptionOutput(ctx *Context, args *LookupSubscriptionOutputArgs, opts ...InvokeOption) LookupSubscriptionResultOutput> Note: This function is named LookupSubscription in the Go SDK.
public static class GetSubscription 
{
    public static Task<GetSubscriptionResult> InvokeAsync(GetSubscriptionArgs args, InvokeOptions? opts = null)
    public static Output<GetSubscriptionResult> Invoke(GetSubscriptionInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetSubscriptionResult> getSubscription(GetSubscriptionArgs args, InvokeOptions options)
public static Output<GetSubscriptionResult> getSubscription(GetSubscriptionArgs args, InvokeOptions options)
fn::invoke:
  function: azure-native:servicebus:getSubscription
  arguments:
    # arguments dictionaryThe following arguments are supported:
- NamespaceName string
- The namespace name
- ResourceGroup stringName 
- Name of the Resource group within the Azure subscription.
- SubscriptionName string
- The subscription name.
- TopicName string
- The topic name.
- NamespaceName string
- The namespace name
- ResourceGroup stringName 
- Name of the Resource group within the Azure subscription.
- SubscriptionName string
- The subscription name.
- TopicName string
- The topic name.
- namespaceName String
- The namespace name
- resourceGroup StringName 
- Name of the Resource group within the Azure subscription.
- subscriptionName String
- The subscription name.
- topicName String
- The topic name.
- namespaceName string
- The namespace name
- resourceGroup stringName 
- Name of the Resource group within the Azure subscription.
- subscriptionName string
- The subscription name.
- topicName string
- The topic name.
- namespace_name str
- The namespace name
- resource_group_ strname 
- Name of the Resource group within the Azure subscription.
- subscription_name str
- The subscription name.
- topic_name str
- The topic name.
- namespaceName String
- The namespace name
- resourceGroup StringName 
- Name of the Resource group within the Azure subscription.
- subscriptionName String
- The subscription name.
- topicName String
- The topic name.
getSubscription Result
The following output properties are available:
- AccessedAt string
- Last time there was a receive request to this subscription.
- CountDetails Pulumi.Azure Native. Service Bus. Outputs. Message Count Details Response 
- Message count details
- CreatedAt string
- Exact time the message was created.
- Id string
- Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
- Location string
- The geo-location where the resource lives
- MessageCount double
- Number of messages.
- Name string
- The name of the resource
- SystemData Pulumi.Azure Native. Service Bus. Outputs. System Data Response 
- The system meta data relating to this resource.
- Type string
- The type of the resource. E.g. "Microsoft.EventHub/Namespaces" or "Microsoft.EventHub/Namespaces/EventHubs"
- UpdatedAt string
- The exact time the message was updated.
- AutoDelete stringOn Idle 
- ISO 8061 timeSpan idle interval after which the topic is automatically deleted. The minimum duration is 5 minutes.
- ClientAffine Pulumi.Properties Azure Native. Service Bus. Outputs. SBClient Affine Properties Response 
- Properties specific to client affine subscriptions.
- DeadLettering boolOn Filter Evaluation Exceptions 
- Value that indicates whether a subscription has dead letter support on filter evaluation exceptions.
- DeadLettering boolOn Message Expiration 
- Value that indicates whether a subscription has dead letter support when a message expires.
- DefaultMessage stringTime To Live 
- ISO 8061 Default message timespan to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself.
- DuplicateDetection stringHistory Time Window 
- ISO 8601 timeSpan structure that defines the duration of the duplicate detection history. The default value is 10 minutes.
- EnableBatched boolOperations 
- Value that indicates whether server-side batched operations are enabled.
- ForwardDead stringLettered Messages To 
- Queue/Topic name to forward the Dead Letter message
- ForwardTo string
- Queue/Topic name to forward the messages
- IsClient boolAffine 
- Value that indicates whether the subscription has an affinity to the client id.
- LockDuration string
- ISO 8061 lock duration timespan for the subscription. The default value is 1 minute.
- MaxDelivery intCount 
- Number of maximum deliveries.
- RequiresSession bool
- Value indicating if a subscription supports the concept of sessions.
- Status string
- Enumerates the possible values for the status of a messaging entity.
- AccessedAt string
- Last time there was a receive request to this subscription.
- CountDetails MessageCount Details Response 
- Message count details
- CreatedAt string
- Exact time the message was created.
- Id string
- Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
- Location string
- The geo-location where the resource lives
- MessageCount float64
- Number of messages.
- Name string
- The name of the resource
- SystemData SystemData Response 
- The system meta data relating to this resource.
- Type string
- The type of the resource. E.g. "Microsoft.EventHub/Namespaces" or "Microsoft.EventHub/Namespaces/EventHubs"
- UpdatedAt string
- The exact time the message was updated.
- AutoDelete stringOn Idle 
- ISO 8061 timeSpan idle interval after which the topic is automatically deleted. The minimum duration is 5 minutes.
- ClientAffine SBClientProperties Affine Properties Response 
- Properties specific to client affine subscriptions.
- DeadLettering boolOn Filter Evaluation Exceptions 
- Value that indicates whether a subscription has dead letter support on filter evaluation exceptions.
- DeadLettering boolOn Message Expiration 
- Value that indicates whether a subscription has dead letter support when a message expires.
- DefaultMessage stringTime To Live 
- ISO 8061 Default message timespan to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself.
- DuplicateDetection stringHistory Time Window 
- ISO 8601 timeSpan structure that defines the duration of the duplicate detection history. The default value is 10 minutes.
- EnableBatched boolOperations 
- Value that indicates whether server-side batched operations are enabled.
- ForwardDead stringLettered Messages To 
- Queue/Topic name to forward the Dead Letter message
- ForwardTo string
- Queue/Topic name to forward the messages
- IsClient boolAffine 
- Value that indicates whether the subscription has an affinity to the client id.
- LockDuration string
- ISO 8061 lock duration timespan for the subscription. The default value is 1 minute.
- MaxDelivery intCount 
- Number of maximum deliveries.
- RequiresSession bool
- Value indicating if a subscription supports the concept of sessions.
- Status string
- Enumerates the possible values for the status of a messaging entity.
- accessedAt String
- Last time there was a receive request to this subscription.
- countDetails MessageCount Details Response 
- Message count details
- createdAt String
- Exact time the message was created.
- id String
- Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
- location String
- The geo-location where the resource lives
- messageCount Double
- Number of messages.
- name String
- The name of the resource
- systemData SystemData Response 
- The system meta data relating to this resource.
- type String
- The type of the resource. E.g. "Microsoft.EventHub/Namespaces" or "Microsoft.EventHub/Namespaces/EventHubs"
- updatedAt String
- The exact time the message was updated.
- autoDelete StringOn Idle 
- ISO 8061 timeSpan idle interval after which the topic is automatically deleted. The minimum duration is 5 minutes.
- clientAffine SBClientProperties Affine Properties Response 
- Properties specific to client affine subscriptions.
- deadLettering BooleanOn Filter Evaluation Exceptions 
- Value that indicates whether a subscription has dead letter support on filter evaluation exceptions.
- deadLettering BooleanOn Message Expiration 
- Value that indicates whether a subscription has dead letter support when a message expires.
- defaultMessage StringTime To Live 
- ISO 8061 Default message timespan to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself.
- duplicateDetection StringHistory Time Window 
- ISO 8601 timeSpan structure that defines the duration of the duplicate detection history. The default value is 10 minutes.
- enableBatched BooleanOperations 
- Value that indicates whether server-side batched operations are enabled.
- forwardDead StringLettered Messages To 
- Queue/Topic name to forward the Dead Letter message
- forwardTo String
- Queue/Topic name to forward the messages
- isClient BooleanAffine 
- Value that indicates whether the subscription has an affinity to the client id.
- lockDuration String
- ISO 8061 lock duration timespan for the subscription. The default value is 1 minute.
- maxDelivery IntegerCount 
- Number of maximum deliveries.
- requiresSession Boolean
- Value indicating if a subscription supports the concept of sessions.
- status String
- Enumerates the possible values for the status of a messaging entity.
- accessedAt string
- Last time there was a receive request to this subscription.
- countDetails MessageCount Details Response 
- Message count details
- createdAt string
- Exact time the message was created.
- id string
- Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
- location string
- The geo-location where the resource lives
- messageCount number
- Number of messages.
- name string
- The name of the resource
- systemData SystemData Response 
- The system meta data relating to this resource.
- type string
- The type of the resource. E.g. "Microsoft.EventHub/Namespaces" or "Microsoft.EventHub/Namespaces/EventHubs"
- updatedAt string
- The exact time the message was updated.
- autoDelete stringOn Idle 
- ISO 8061 timeSpan idle interval after which the topic is automatically deleted. The minimum duration is 5 minutes.
- clientAffine SBClientProperties Affine Properties Response 
- Properties specific to client affine subscriptions.
- deadLettering booleanOn Filter Evaluation Exceptions 
- Value that indicates whether a subscription has dead letter support on filter evaluation exceptions.
- deadLettering booleanOn Message Expiration 
- Value that indicates whether a subscription has dead letter support when a message expires.
- defaultMessage stringTime To Live 
- ISO 8061 Default message timespan to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself.
- duplicateDetection stringHistory Time Window 
- ISO 8601 timeSpan structure that defines the duration of the duplicate detection history. The default value is 10 minutes.
- enableBatched booleanOperations 
- Value that indicates whether server-side batched operations are enabled.
- forwardDead stringLettered Messages To 
- Queue/Topic name to forward the Dead Letter message
- forwardTo string
- Queue/Topic name to forward the messages
- isClient booleanAffine 
- Value that indicates whether the subscription has an affinity to the client id.
- lockDuration string
- ISO 8061 lock duration timespan for the subscription. The default value is 1 minute.
- maxDelivery numberCount 
- Number of maximum deliveries.
- requiresSession boolean
- Value indicating if a subscription supports the concept of sessions.
- status string
- Enumerates the possible values for the status of a messaging entity.
- accessed_at str
- Last time there was a receive request to this subscription.
- count_details MessageCount Details Response 
- Message count details
- created_at str
- Exact time the message was created.
- id str
- Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
- location str
- The geo-location where the resource lives
- message_count float
- Number of messages.
- name str
- The name of the resource
- system_data SystemData Response 
- The system meta data relating to this resource.
- type str
- The type of the resource. E.g. "Microsoft.EventHub/Namespaces" or "Microsoft.EventHub/Namespaces/EventHubs"
- updated_at str
- The exact time the message was updated.
- auto_delete_ stron_ idle 
- ISO 8061 timeSpan idle interval after which the topic is automatically deleted. The minimum duration is 5 minutes.
- client_affine_ SBClientproperties Affine Properties Response 
- Properties specific to client affine subscriptions.
- dead_lettering_ boolon_ filter_ evaluation_ exceptions 
- Value that indicates whether a subscription has dead letter support on filter evaluation exceptions.
- dead_lettering_ boolon_ message_ expiration 
- Value that indicates whether a subscription has dead letter support when a message expires.
- default_message_ strtime_ to_ live 
- ISO 8061 Default message timespan to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself.
- duplicate_detection_ strhistory_ time_ window 
- ISO 8601 timeSpan structure that defines the duration of the duplicate detection history. The default value is 10 minutes.
- enable_batched_ booloperations 
- Value that indicates whether server-side batched operations are enabled.
- forward_dead_ strlettered_ messages_ to 
- Queue/Topic name to forward the Dead Letter message
- forward_to str
- Queue/Topic name to forward the messages
- is_client_ boolaffine 
- Value that indicates whether the subscription has an affinity to the client id.
- lock_duration str
- ISO 8061 lock duration timespan for the subscription. The default value is 1 minute.
- max_delivery_ intcount 
- Number of maximum deliveries.
- requires_session bool
- Value indicating if a subscription supports the concept of sessions.
- status str
- Enumerates the possible values for the status of a messaging entity.
- accessedAt String
- Last time there was a receive request to this subscription.
- countDetails Property Map
- Message count details
- createdAt String
- Exact time the message was created.
- id String
- Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
- location String
- The geo-location where the resource lives
- messageCount Number
- Number of messages.
- name String
- The name of the resource
- systemData Property Map
- The system meta data relating to this resource.
- type String
- The type of the resource. E.g. "Microsoft.EventHub/Namespaces" or "Microsoft.EventHub/Namespaces/EventHubs"
- updatedAt String
- The exact time the message was updated.
- autoDelete StringOn Idle 
- ISO 8061 timeSpan idle interval after which the topic is automatically deleted. The minimum duration is 5 minutes.
- clientAffine Property MapProperties 
- Properties specific to client affine subscriptions.
- deadLettering BooleanOn Filter Evaluation Exceptions 
- Value that indicates whether a subscription has dead letter support on filter evaluation exceptions.
- deadLettering BooleanOn Message Expiration 
- Value that indicates whether a subscription has dead letter support when a message expires.
- defaultMessage StringTime To Live 
- ISO 8061 Default message timespan to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself.
- duplicateDetection StringHistory Time Window 
- ISO 8601 timeSpan structure that defines the duration of the duplicate detection history. The default value is 10 minutes.
- enableBatched BooleanOperations 
- Value that indicates whether server-side batched operations are enabled.
- forwardDead StringLettered Messages To 
- Queue/Topic name to forward the Dead Letter message
- forwardTo String
- Queue/Topic name to forward the messages
- isClient BooleanAffine 
- Value that indicates whether the subscription has an affinity to the client id.
- lockDuration String
- ISO 8061 lock duration timespan for the subscription. The default value is 1 minute.
- maxDelivery NumberCount 
- Number of maximum deliveries.
- requiresSession Boolean
- Value indicating if a subscription supports the concept of sessions.
- status String
- Enumerates the possible values for the status of a messaging entity.
Supporting Types
MessageCountDetailsResponse   
- ActiveMessage doubleCount 
- Number of active messages in the queue, topic, or subscription.
- DeadLetter doubleMessage Count 
- Number of messages that are dead lettered.
- ScheduledMessage doubleCount 
- Number of scheduled messages.
- TransferDead doubleLetter Message Count 
- Number of messages transferred into dead letters.
- TransferMessage doubleCount 
- Number of messages transferred to another queue, topic, or subscription.
- ActiveMessage float64Count 
- Number of active messages in the queue, topic, or subscription.
- DeadLetter float64Message Count 
- Number of messages that are dead lettered.
- ScheduledMessage float64Count 
- Number of scheduled messages.
- TransferDead float64Letter Message Count 
- Number of messages transferred into dead letters.
- TransferMessage float64Count 
- Number of messages transferred to another queue, topic, or subscription.
- activeMessage DoubleCount 
- Number of active messages in the queue, topic, or subscription.
- deadLetter DoubleMessage Count 
- Number of messages that are dead lettered.
- scheduledMessage DoubleCount 
- Number of scheduled messages.
- transferDead DoubleLetter Message Count 
- Number of messages transferred into dead letters.
- transferMessage DoubleCount 
- Number of messages transferred to another queue, topic, or subscription.
- activeMessage numberCount 
- Number of active messages in the queue, topic, or subscription.
- deadLetter numberMessage Count 
- Number of messages that are dead lettered.
- scheduledMessage numberCount 
- Number of scheduled messages.
- transferDead numberLetter Message Count 
- Number of messages transferred into dead letters.
- transferMessage numberCount 
- Number of messages transferred to another queue, topic, or subscription.
- active_message_ floatcount 
- Number of active messages in the queue, topic, or subscription.
- dead_letter_ floatmessage_ count 
- Number of messages that are dead lettered.
- scheduled_message_ floatcount 
- Number of scheduled messages.
- transfer_dead_ floatletter_ message_ count 
- Number of messages transferred into dead letters.
- transfer_message_ floatcount 
- Number of messages transferred to another queue, topic, or subscription.
- activeMessage NumberCount 
- Number of active messages in the queue, topic, or subscription.
- deadLetter NumberMessage Count 
- Number of messages that are dead lettered.
- scheduledMessage NumberCount 
- Number of scheduled messages.
- transferDead NumberLetter Message Count 
- Number of messages transferred into dead letters.
- transferMessage NumberCount 
- Number of messages transferred to another queue, topic, or subscription.
SBClientAffinePropertiesResponse   
- ClientId string
- Indicates the Client ID of the application that created the client-affine subscription.
- IsDurable bool
- For client-affine subscriptions, this value indicates whether the subscription is durable or not.
- bool
- For client-affine subscriptions, this value indicates whether the subscription is shared or not.
- ClientId string
- Indicates the Client ID of the application that created the client-affine subscription.
- IsDurable bool
- For client-affine subscriptions, this value indicates whether the subscription is durable or not.
- bool
- For client-affine subscriptions, this value indicates whether the subscription is shared or not.
- clientId String
- Indicates the Client ID of the application that created the client-affine subscription.
- isDurable Boolean
- For client-affine subscriptions, this value indicates whether the subscription is durable or not.
- Boolean
- For client-affine subscriptions, this value indicates whether the subscription is shared or not.
- clientId string
- Indicates the Client ID of the application that created the client-affine subscription.
- isDurable boolean
- For client-affine subscriptions, this value indicates whether the subscription is durable or not.
- boolean
- For client-affine subscriptions, this value indicates whether the subscription is shared or not.
- client_id str
- Indicates the Client ID of the application that created the client-affine subscription.
- is_durable bool
- For client-affine subscriptions, this value indicates whether the subscription is durable or not.
- bool
- For client-affine subscriptions, this value indicates whether the subscription is shared or not.
- clientId String
- Indicates the Client ID of the application that created the client-affine subscription.
- isDurable Boolean
- For client-affine subscriptions, this value indicates whether the subscription is durable or not.
- Boolean
- For client-affine subscriptions, this value indicates whether the subscription is shared or not.
SystemDataResponse  
- CreatedAt string
- The timestamp of resource creation (UTC).
- CreatedBy string
- The identity that created the resource.
- CreatedBy stringType 
- The type of identity that created the resource.
- LastModified stringAt 
- The type of identity that last modified the resource.
- LastModified stringBy 
- The identity that last modified the resource.
- LastModified stringBy Type 
- The type of identity that last modified the resource.
- CreatedAt string
- The timestamp of resource creation (UTC).
- CreatedBy string
- The identity that created the resource.
- CreatedBy stringType 
- The type of identity that created the resource.
- LastModified stringAt 
- The type of identity that last modified the resource.
- LastModified stringBy 
- The identity that last modified the resource.
- LastModified stringBy Type 
- The type of identity that last modified the resource.
- createdAt String
- The timestamp of resource creation (UTC).
- createdBy String
- The identity that created the resource.
- createdBy StringType 
- The type of identity that created the resource.
- lastModified StringAt 
- The type of identity that last modified the resource.
- lastModified StringBy 
- The identity that last modified the resource.
- lastModified StringBy Type 
- The type of identity that last modified the resource.
- createdAt string
- The timestamp of resource creation (UTC).
- createdBy string
- The identity that created the resource.
- createdBy stringType 
- The type of identity that created the resource.
- lastModified stringAt 
- The type of identity that last modified the resource.
- lastModified stringBy 
- The identity that last modified the resource.
- lastModified stringBy Type 
- The type of identity that last modified the resource.
- created_at str
- The timestamp of resource creation (UTC).
- created_by str
- The identity that created the resource.
- created_by_ strtype 
- The type of identity that created the resource.
- last_modified_ strat 
- The type of identity that last modified the resource.
- last_modified_ strby 
- The identity that last modified the resource.
- last_modified_ strby_ type 
- The type of identity that last modified the resource.
- createdAt String
- The timestamp of resource creation (UTC).
- createdBy String
- The identity that created the resource.
- createdBy StringType 
- The type of identity that created the resource.
- lastModified StringAt 
- The type of identity that last modified the resource.
- lastModified StringBy 
- The identity that last modified the resource.
- lastModified StringBy Type 
- The type of identity that last modified the resource.
Package Details
- Repository
- Azure Native pulumi/pulumi-azure-native
- License
- Apache-2.0
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.89.1 published on Sunday, Mar 2, 2025 by Pulumi