Sdílet prostřednictvím

Web Pub Sub - Send To Connection

  • Reference
Služba:
Azure Web PubSub Service
Verze rozhraní API:
2024-01-01

Odešle obsah uvnitř textu požadavku konkrétnímu připojení.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
connectionId
 path True

string

ID připojení.
endpoint
 path True

string

url

Koncový bod HTTP nebo HTTPS pro instanci služby Web PubSub.
hub
 path True

string

Název cílového centra, který by měl začínat abecedním znakem a obsahovat pouze alfanumerické znaky nebo podtržítko.

Vzor regulárního výrazu: ^[A-Za-z][A-Za-z0-9_`,.[\]]{0,127}$
api-version
 query True

string

Verze rozhraní REST API.
messageTtlSeconds
 query

integer

int32

Hodnota TTL (Time to Live) v sekundách pro zprávy odeslané do služby. 0 je výchozí hodnota, což znamená, že zpráva nikdy nevyprší. Maximální hodnota je 300. Pokud je tento parametr nenulový, služba zahodí zprávy, které klient nespotřebovávají v zadané hodnotě TTL. Tento parametr může pomoct, když je šířka pásma klienta omezená.

Text požadavku

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

Name Typ Description
message

string

Tělo datové části.

Odpovědi

Name Typ Description
202 Accepted

Přijal
Other Status Codes

ErrorDetail

Chybová odpověď

Hlavičky

x-ms-error-code: string

Příklady

WebPubSub_SendToConnection

Ukázkový požadavek

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

"Message to send"

Ukázková odpověď

Stavový kód:
202

Definice

Name Description
ErrorDetail

Objekt chyby.
InnerError

ErrorDetail

Objekt chyby.

Name Typ Description
code

string

Jedna ze serverově definovaných kódů chyb.
details

ErrorDetail[]

Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
inner

InnerError

message

string

Čitelné znázornění chyby člověkem.
target

string

Cíl chyby.

InnerError

Name Typ Description
code

string

Konkrétnější kód chyby, než poskytla chyba obsahující chybu.
inner

InnerError