Web Pub Sub - Send To Connection

Tjänst:

Azure Web PubSub Service

API-version:

2024-01-01

Skicka innehåll inuti begärandetexten till den specifika anslutningen.

POST {endpoint}/api/hubs/{hub}/connections/{connectionId}/:send?api-version=2024-01-01

Med valfria parametrar:

POST {endpoint}/api/hubs/{hub}/connections/{connectionId}/:send?api-version=2024-01-01&messageTtlSeconds={messageTtlSeconds}

URI-parametrar

Name	I	Obligatorisk	Typ	Description
connectionId	path	True	string	Anslutnings-ID:t.
endpoint	path	True	string url	HTTP- eller HTTPS-slutpunkt för web pubsub-tjänstinstansen.
hub	path	True	string	Målhubbens namn, som ska börja med alfabetiska tecken och endast innehålla alfanumeriska tecken eller understreck. Reguljärt uttrycksmönster: ^[A-Za-z][A-Za-z0-9_`,.[\]]{0,127}$
api-version	query	True	string	Versionen av REST-API:erna.
messageTtlSeconds	query		integer int32	TTL-värdet (time-to-live) i sekunder för meddelanden som skickas till tjänsten. 0 är standardvärdet, vilket innebär att meddelandet aldrig upphör att gälla. 300 är det maximala värdet. Om den här parametern inte är noll kommer meddelanden som inte förbrukas av klienten inom den angivna TTL:en att tas bort av tjänsten. Den här parametern kan vara till hjälp när klientens bandbredd är begränsad.

Begärandetext

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

Name	Typ	Description
message	string	Nyttolastens brödtext.

Svar

Name	Typ	Description
202 Accepted		Accepterad
Other Status Codes	ErrorDetail	Felsvar Sidhuvuden x-ms-error-code: string

Exempel

WebPubSub_SendToConnection

Exempelbegäran

HTTP

POST {endpoint}/api/hubs/hub1/connections/connection1/:send?api-version=2024-01-01&messageTtlSeconds=15

"Message to send"

Exempelsvar

Statuskod:

202

Definitioner

Name	Description
ErrorDetail	Felobjektet.
InnerError

ErrorDetail

Felobjektet.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
details	ErrorDetail[]	En matris med information om specifika fel som ledde till det rapporterade felet.
inner	InnerError
message	string	En mänsklig läsbar representation av felet.
target	string	Målet för felet.

InnerError

Name	Typ	Description
code	string	En mer specifik felkod än vad som angavs av det innehållande felet.
inner	InnerError