다음을 통해 공유

ServiceBusAdministrationClient.GetSubscriptionRuntimePropertiesAsync Method

  • Reference

Definition

Namespace:
Azure.Messaging.ServiceBus.Administration
Assembly:
Azure.Messaging.ServiceBus.dll
Package:
Azure.Messaging.ServiceBus v7.18.2
Package:
Azure.Messaging.ServiceBus v7.18.0-beta.1
Source:
ServiceBusAdministrationClient.cs
Source:
ServiceBusAdministrationClient.cs

Retrieves the runtime properties of a subscription.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionRuntimeProperties>> GetSubscriptionRuntimePropertiesAsync (string topicName, string subscriptionName, System.Threading.CancellationToken cancellationToken = default);
abstract member GetSubscriptionRuntimePropertiesAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionRuntimeProperties>>
override this.GetSubscriptionRuntimePropertiesAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionRuntimeProperties>>
Public Overridable Function GetSubscriptionRuntimePropertiesAsync (topicName As String, subscriptionName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SubscriptionRuntimeProperties))

Parameters

topicName
String

The name of the topic relative to service bus namespace.

subscriptionName
String

The subscription name.

cancellationToken
CancellationToken

An optional CancellationToken instance to signal the request to cancel the operation.

Returns

Task<Response<SubscriptionRuntimeProperties>>

SubscriptionRuntimeProperties containing runtime properties about the subscription.

Exceptions

ServiceTimeout

The operation times out. The timeout period is initialized through the ServiceBusAdministrationClientOptions class (see Retry property). You may need to increase the value of timeout to avoid this exception if the timeout value is relatively low.

MessagingEntityNotFound

Topic or Subscription with this name does not exist.

ServiceBusy

The server is busy. You should wait before you retry the operation.

ArgumentNullException

The topic or subscription name is null or empty.

ArgumentOutOfRangeException

The topic or subscription name exceeds the maximum allowed length.

ArgumentException

The topic or subscription name is otherwise invalid.

UnauthorizedAccessException

Insufficient permission to perform this operation. You should check to ensure that your ServiceBusAdministrationClient has the necessary claims to perform this operation. https://learn.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations

ServiceBusException
  • The specified entity could not be found. The Reason will be set to MessagingEntityNotFound in this case.
  • The operation timed out. The Reason will be set to ServiceTimeout in this case.
  • The server is busy. You should wait before you retry the operation. The failure reason will be set to ServiceBusy in this case.
  • An internal error or unexpected exception occurs. The failure reason will be set to GeneralError in this case.

Applies to