EventHubClientOptions interface
Opisuje opcje, które można udostępnić podczas tworzenia elementu EventHubClient.
-
userAgent
: ciąg dołączany do wbudowanych parametrów agenta użytkownika przekazywanych jako właściwość połączenia z usługą. -
webSocketOptions
: Opcje konfigurowania kanału połączenia AMQP za pośrednictwem gniazd sieci Web.-
websocket
: konstruktor Protokołu WebSocket używany do tworzenia połączenia protokołu AMQP, jeśli zdecydujesz się nawiązać połączenie za pośrednictwem protokołu WebSocket. -
webSocketConstructorOptions
: Opcje przekazywania do konstruktora protokołu Websocket podczas wybierania połączenia za pośrednictwem protokołu WebSocket.
-
-
retryOptions
: opcje ponawiania dla wszystkich operacji na kliencie/producencie/odbiorcy.-
maxRetries
: liczba ponownych prób wykonania operacji w przypadku błędu możliwego do ponowienia próby. -
maxRetryDelayInMs
: maksymalne opóźnienie między ponowną próbą. Dotyczy tylko podczas wykonywania ponownych prób wykładniczych. -
mode
: który tryb ponawiania próby ma być stosowany, określony przez wyliczenieRetryMode
. Opcje toExponential
iFixed
. Wartość domyślna toFixed
. -
retryDelayInMs
: czas oczekiwania w milisekundach przed podjęciem następnej próby. Gdymode
jest ustawiona naExponential
, służy do obliczania wykładniczo rosnących opóźnień między ponownymi próbami. Wartość domyślna: 30000 milisekund. -
timeoutInMs
: czas oczekiwania w milisekundach przed przekroczeniem limitu czasu operacji. Spowoduje to wyzwolenie ponawiania próby w przypadku pozostałych ponownych prób. Wartość domyślna: 60000 milisekund.
-
Proste użycie może być { "maxRetries": 4 }
.
Przykładowe użycie:
{
retryOptions: {
maxRetries: 4
}
}
Właściwości
custom |
Niestandardowy punkt końcowy używany podczas nawiązywania połączenia z usługą Event Hubs. Może to być przydatne, gdy sieć nie zezwala na nawiązywanie połączenia ze standardowym adresem punktu końcowego usługi Azure Event Hubs, ale umożliwia nawiązywanie połączenia za pośrednictwem pośrednika. Przykład: "https://my.custom.endpoint:100/" |
identifier | Unikatowa nazwa używana do identyfikowania klienta. Jeśli nie zostanie podany, identyfikator GUID będzie używany jako identyfikator |
retry |
Opcje konfigurowania zasad ponawiania dla wszystkich operacji na kliencie.
Na przykład |
user |
Wartość dołączona do wbudowanego ciągu agenta użytkownika przekazanego do usługi Event Hubs. |
web |
Opcje konfigurowania kanału połączenia AMQP za pośrednictwem gniazd sieci Web. |
Szczegóły właściwości
customEndpointAddress
Niestandardowy punkt końcowy używany podczas nawiązywania połączenia z usługą Event Hubs. Może to być przydatne, gdy sieć nie zezwala na nawiązywanie połączenia ze standardowym adresem punktu końcowego usługi Azure Event Hubs, ale umożliwia nawiązywanie połączenia za pośrednictwem pośrednika.
Przykład: "https://my.custom.endpoint:100/"
customEndpointAddress?: string
Wartość właściwości
string
identifier
Unikatowa nazwa używana do identyfikowania klienta. Jeśli nie zostanie podany, identyfikator GUID będzie używany jako identyfikator
identifier?: string
Wartość właściwości
string
retryOptions
Opcje konfigurowania zasad ponawiania dla wszystkich operacji na kliencie.
Na przykład { "maxRetries": 4 }
lub { "maxRetries": 4, "retryDelayInMs": 30000 }
.
retryOptions?: RetryOptions
Wartość właściwości
userAgent
Wartość dołączona do wbudowanego ciągu agenta użytkownika przekazanego do usługi Event Hubs.
userAgent?: string
Wartość właściwości
string
webSocketOptions
Opcje konfigurowania kanału połączenia AMQP za pośrednictwem gniazd sieci Web.
webSocketOptions?: WebSocketOptions