ServiceBusAdministrationClient.CreateSubscriptionAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| CreateSubscriptionAsync(CreateSubscriptionOptions, CancellationToken) |
Crea una nueva suscripción dentro de un tema en el espacio de nombres del servicio con el nombre especificado. |
| CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) |
Crea una nueva suscripción dentro de un tema con la regla predeterminada proporcionada. |
| CreateSubscriptionAsync(String, String, CancellationToken) |
Crea una nueva suscripción dentro de un tema en el espacio de nombres del servicio con el nombre especificado. |
CreateSubscriptionAsync(CreateSubscriptionOptions, CancellationToken)
Crea una nueva suscripción dentro de un tema en el espacio de nombres del servicio con el nombre especificado.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>> CreateSubscriptionAsync (Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions options, System.Threading.CancellationToken cancellationToken = default);abstract member CreateSubscriptionAsync : Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>
override this.CreateSubscriptionAsync : Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>Public Overridable Function CreateSubscriptionAsync (options As CreateSubscriptionOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SubscriptionProperties))Parámetros
- options
- CreateSubscriptionOptions
Objeto SubscriptionProperties que describe los atributos con los que se creará la nueva suscripción.
- cancellationToken
- CancellationToken
Una instancia opcional CancellationToken para indicar la solicitud para cancelar la operación.
Devoluciones
de SubscriptionProperties la suscripción recién creada.
Excepciones
Existe una suscripción con el mismo nombre en el mismo espacio de nombres de servicio.
Se agota el tiempo de espera de la operación. El período de tiempo de espera se inicializa a través de la ServiceBusAdministrationClientOptions clase (consulte la propiedad Retry). Es posible que tenga que aumentar el valor del tiempo de espera para evitar esta excepción si el valor de tiempo de espera es relativamente bajo.
No se admite el tamaño especificado en la descripción o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota.
El servidor está ocupado. Debe esperar antes de volver a intentar la operación.
La options instancia es null.
Permiso insuficiente para realizar esta operación. Debe comprobar para asegurarse de que ServiceBusAdministrationClient tiene las notificaciones necesarias para realizar esta operación. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- Existe una suscripción con el mismo nombre en el mismo espacio de nombres de servicio. Reason Se establecerá MessagingEntityAlreadyExists en en este caso.
- Se agota el tiempo de espera de la operación. Reason Se establecerá ServiceTimeout en en este caso.
- No se admite el tamaño especificado de la entidad o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota. El motivo del error se establecerá QuotaExceeded en en este caso.
- El servidor está ocupado. Debe esperar antes de volver a intentar la operación. El motivo del error se establecerá ServiceBusy en en este caso.
- Se produce un error interno o una excepción inesperada. El motivo del error se establecerá GeneralError en en este caso.
Comentarios
Produce si ya existe una suscripción. De forma predeterminada, se crea un filtro de paso a través para esta suscripción, lo que significa que permitirá que todos los mensajes vayan a esta suscripción. El nombre del filtro se representa mediante DefaultRuleName. CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) para crear una suscripción con un filtro diferente.
Se aplica a
CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken)
Crea una nueva suscripción dentro de un tema con la regla predeterminada proporcionada.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>> CreateSubscriptionAsync (Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions options, Azure.Messaging.ServiceBus.Administration.CreateRuleOptions rule, System.Threading.CancellationToken cancellationToken = default);abstract member CreateSubscriptionAsync : Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions * Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>
override this.CreateSubscriptionAsync : Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions * Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>Public Overridable Function CreateSubscriptionAsync (options As CreateSubscriptionOptions, rule As CreateRuleOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SubscriptionProperties))Parámetros
- options
- CreateSubscriptionOptions
Objeto SubscriptionProperties que describe los atributos con los que se creará la nueva suscripción.
- rule
- CreateRuleOptions
Objeto RuleProperties que describe la regla predeterminada. Si es null, se creará el filtro de paso a través con el nombre DefaultRuleName .
- cancellationToken
- CancellationToken
Una instancia opcional CancellationToken para indicar la solicitud para cancelar la operación.
Devoluciones
de SubscriptionProperties la suscripción recién creada.
Excepciones
Existe una suscripción con el mismo nombre en el mismo espacio de nombres de servicio.
Se agota el tiempo de espera de la operación. El período de tiempo de espera se inicializa a través de la ServiceBusAdministrationClientOptions clase (consulte la propiedad Retry). Es posible que tenga que aumentar el valor del tiempo de espera para evitar esta excepción si el valor de tiempo de espera es relativamente bajo.
No se admite el tamaño especificado en la descripción o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota.
El servidor está ocupado. Debe esperar antes de volver a intentar la operación.
La options instancia es null.
Permiso insuficiente para realizar esta operación. Debe comprobar para asegurarse de que ServiceBusAdministrationClient tiene las notificaciones necesarias para realizar esta operación. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- Existe una suscripción con el mismo nombre en el mismo espacio de nombres de servicio. Reason Se establecerá MessagingEntityAlreadyExists en en este caso.
- Se agota el tiempo de espera de la operación. Reason Se establecerá ServiceTimeout en en este caso.
- No se admite el tamaño especificado de la entidad o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota. El motivo del error se establecerá QuotaExceeded en en este caso.
- El servidor está ocupado. Debe esperar antes de volver a intentar la operación. El motivo del error se establecerá ServiceBusy en en este caso.
- Se produce un error interno o una excepción inesperada. El motivo del error se establecerá GeneralError en en este caso.
Comentarios
Produce si ya existe una suscripción.
Se aplica a
CreateSubscriptionAsync(String, String, CancellationToken)
Crea una nueva suscripción dentro de un tema en el espacio de nombres del servicio con el nombre especificado.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>> CreateSubscriptionAsync (string topicName, string subscriptionName, System.Threading.CancellationToken cancellationToken = default);abstract member CreateSubscriptionAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>
override this.CreateSubscriptionAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>Public Overridable Function CreateSubscriptionAsync (topicName As String, subscriptionName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SubscriptionProperties))Parámetros
- topicName
- String
Nombre del tema relativo a la dirección base del espacio de nombres del servicio.
- subscriptionName
- String
Nombre de la suscripción.
- cancellationToken
- CancellationToken
Una instancia opcional CancellationToken para indicar la solicitud para cancelar la operación.
Devoluciones
de SubscriptionProperties la suscripción recién creada.
Excepciones
Existe una suscripción con el mismo nombre en el mismo espacio de nombres de servicio.
Se agota el tiempo de espera de la operación. El período de tiempo de espera se inicializa a través de la ServiceBusAdministrationClientOptions clase (consulte la propiedad Retry). Es posible que tenga que aumentar el valor del tiempo de espera para evitar esta excepción si el valor de tiempo de espera es relativamente bajo.
No se admite el tamaño especificado en la descripción o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota.
El servidor está ocupado. Debe esperar antes de volver a intentar la operación.
El nombre de tema o suscripción es nulo o está vacío.
El nombre del nombre del tema o de la suscripción supera la longitud máxima permitida.
El nombre de tema o suscripción no es válido.
Permiso insuficiente para realizar esta operación. Debe comprobar para asegurarse de que ServiceBusAdministrationClient tiene las notificaciones necesarias para realizar esta operación. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- Existe una suscripción con el mismo nombre en el mismo espacio de nombres de servicio. Reason Se establecerá MessagingEntityAlreadyExists en en este caso.
- Se agota el tiempo de espera de la operación. Reason Se establecerá ServiceTimeout en en este caso.
- No se admite el tamaño especificado de la entidad o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota. El motivo del error se establecerá QuotaExceeded en en este caso.
- El servidor está ocupado. Debe esperar antes de volver a intentar la operación. El motivo del error se establecerá ServiceBusy en en este caso.
- Se produce un error interno o una excepción inesperada. El motivo del error se establecerá GeneralError en en este caso.
Comentarios
Produce si ya existe una suscripción. SubscriptionProperties para los valores predeterminados de la descripción de la suscripción. De forma predeterminada, se crea un filtro de paso a través para esta suscripción, lo que significa que permitirá que todos los mensajes vayan a esta suscripción. El nombre del filtro se representa mediante DefaultRuleName. CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) para crear una suscripción con un filtro diferente.
Se aplica a
Azure SDK for .NET
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de