Freigeben über

Web Pub Sub - Send To User

  • Referenz
Dienst:
Azure Web PubSub Service
API-Version:
2024-01-01

Senden sie Inhalte innerhalb des Anforderungstexts an den jeweiligen Benutzer.

POST {endpoint}/api/hubs/{hub}/users/{userId}/:send?api-version=2024-01-01
Mit optionalen Parametern: 
POST {endpoint}/api/hubs/{hub}/users/{userId}/:send?api-version=2024-01-01&filter={filter}&messageTtlSeconds={messageTtlSeconds}

URI-Parameter

Name In Erforderlich Typ Beschreibung
endpoint
 path True

string (url)

HTTP- oder HTTPS-Endpunkt für die Web PubSub-Dienstinstanz.
hub
 path True

string

pattern: ^[A-Za-z][A-Za-z0-9_`,.[\]]{0,127}$

Zielhubname, der mit alphabetischen Zeichen beginnen und nur alphanumerische Zeichen oder Unterstriche enthalten soll.
userId
 path True

string

minLength: 1

Die Benutzer-ID.
api-version
 query True

string

Die Version der REST-APIs.
filter
 query

string

Folgen sie der OData-Filtersyntax, um die Abonnenten herauszufiltern, die die Nachrichten erhalten.
messageTtlSeconds
 query

integer (int32)

minimum: 0
maximum: 300

Der Zeit-zu-Live-Wert (TTL) in Sekunden für Nachrichten, die an den Dienst gesendet werden. 0 ist der Standardwert, was bedeutet, dass die Nachricht nie abläuft. 300 ist der Maximalwert. Wenn dieser Parameter ungleich Null ist, werden nachrichten, die nicht vom Client innerhalb der angegebenen TTL verwendet werden, vom Dienst gelöscht. Dieser Parameter kann hilfreich sein, wenn die Bandbreite des Clients begrenzt ist.

Anforderungstext

Media Types: "application/octet-stream", "text/plain", "application/json"

Name Typ Beschreibung
message

string (binary)

Der Nutzlasttext.

Antworten

Name Typ Beschreibung
202 Accepted

Angenommen
Other Status Codes

ErrorDetail

Fehlerantwort

Header

x-ms-error-code: string

Beispiele

WebPubSub_SendToUser

Beispielanforderung

POST {endpoint}/api/hubs/hub1/users/user1/:send?api-version=2024-01-01&filter=startswith(userId, 'listener-')&messageTtlSeconds=15

"Message to send"

Beispiel für eine Antwort

Statuscode:
202

Definitionen

Name Beschreibung
ErrorDetail

Das Fehlerobjekt.
InnerError

ErrorDetail

Objekt

Das Fehlerobjekt.

Name Typ Beschreibung
code

string

Eine serverdefinierte Gruppe von Fehlercodes.
details

ErrorDetail[]

Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
inner

InnerError

message

string

Eine lesbare Darstellung des Fehlers.
target

string

Das Ziel des Fehlers.

InnerError

Objekt
Name Typ Beschreibung
code

string

Ein spezifischerer Fehlercode als vom enthaltenden Fehler bereitgestellt wurde.
inner

InnerError