Compartir a través de


EventHubClientOptions interface

Describe las opciones que se pueden proporcionar al crear EventHubClient.

  • userAgent : una cadena que se va a anexar a la cadena del agente de usuario integrada que se pasa como una propiedad de conexión al servicio.
  • webSocketOptions: opciones para configurar el canalización de la conexión AMQP a través de sockets web.
    • websocket : el constructor WebSocket que se usa para crear una conexión AMQP si decide realizar la conexión a través de un WebSocket.
    • webSocketConstructorOptions: opciones para pasar al constructor Websocket cuando se decide establecer la conexión a través de Un WebSocket.
  • retryOptions: las opciones de reintento para todas las operaciones del cliente, productor o consumidor.
    • maxRetries: número de veces que se puede reintentar la operación en caso de un error que se puede reintentar.
    • maxRetryDelayInMs: el retraso máximo entre reintentos. Solo es aplicable al realizar reintentos exponenciales.
    • mode: el modo de reintento que se va a aplicar, especificado por la enumeración RetryMode. Las opciones son Exponential y Fixed. El valor predeterminado es Fixed.
    • retryDelayInMs: cantidad de tiempo de espera en milisegundos antes de realizar el siguiente intento. Cuando mode se establece en Exponential, se usa para calcular los retrasos que aumentan exponencialmente entre reintentos. Valor predeterminado: 30000 milisegundos.
    • timeoutInMs: cantidad de tiempo en milisegundos que se esperarán antes de que se agote el tiempo de espera de la operación. Esto desencadenará un reintento si quedan intentos de reintento. Valor predeterminado: 60000 milisegundos.

Un uso simple puede ser { "maxRetries": 4 }.

Uso de ejemplo:

{
    retryOptions: {
        maxRetries: 4
    }
}

Propiedades

customEndpointAddress

Un punto de conexión personalizado que se usará al conectarse al servicio Event Hubs. Esto puede ser útil cuando la red no permite conectarse a la dirección de punto de conexión estándar de Azure Event Hubs, pero permite conectarse a través de un intermediario.

Ejemplo: "https://my.custom.endpoint:100/"

identifier

Nombre único que se usa para identificar el cliente. Si no se proporciona, se usará un GUID como identificador.

retryOptions

Opciones para configurar la directiva de reintento para todas las operaciones del cliente. Por ejemplo, { "maxRetries": 4 } o { "maxRetries": 4, "retryDelayInMs": 30000 }.

userAgent

Valor que se anexa a la cadena del agente de usuario integrada que se pasa al servicio Event Hubs.

webSocketOptions

Opciones para configurar el canalización de la conexión AMQP a través de sockets web.

Detalles de las propiedades

customEndpointAddress

Un punto de conexión personalizado que se usará al conectarse al servicio Event Hubs. Esto puede ser útil cuando la red no permite conectarse a la dirección de punto de conexión estándar de Azure Event Hubs, pero permite conectarse a través de un intermediario.

Ejemplo: "https://my.custom.endpoint:100/"

customEndpointAddress?: string

Valor de propiedad

string

identifier

Nombre único que se usa para identificar el cliente. Si no se proporciona, se usará un GUID como identificador.

identifier?: string

Valor de propiedad

string

retryOptions

Opciones para configurar la directiva de reintento para todas las operaciones del cliente. Por ejemplo, { "maxRetries": 4 } o { "maxRetries": 4, "retryDelayInMs": 30000 }.

retryOptions?: RetryOptions

Valor de propiedad

userAgent

Valor que se anexa a la cadena del agente de usuario integrada que se pasa al servicio Event Hubs.

userAgent?: string

Valor de propiedad

string

webSocketOptions

Opciones para configurar el canalización de la conexión AMQP a través de sockets web.

webSocketOptions?: WebSocketOptions

Valor de propiedad