Compartir a través de

Web Pub Sub - Send To Group

  • Referencia
Service:
Azure Web PubSub Service
API Version:
2023-07-01

Envíe contenido dentro del cuerpo de la solicitud a un grupo de conexiones.

POST {endpoint}/api/hubs/{hub}/groups/{group}/:send?api-version=2023-07-01
With optional parameters: 
POST {endpoint}/api/hubs/{hub}/groups/{group}/:send?excluded={excluded}&api-version=2023-07-01&filter={filter}&messageTtlSeconds={messageTtlSeconds}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
endpoint
 path True

string

url

Punto de conexión HTTP o HTTPS para la instancia del servicio Web PubSub.
group
 path True

string

Nombre del grupo de destino, que longitud debe ser mayor que 0 y menor que 1025.

Regex pattern: ^(?!\s+$).+$
hub
 path True

string

El nombre del centro de destino, que debe comenzar con los caracteres alfabéticos y solo puede contener caracteres alfanuméricos o un guion bajo.

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

string

La versión de las API REST.
excluded
 query

string[]

Identificadores de conexión excluidos
filter
 query

string

Siguiendo la sintaxis de filtro de OData para filtrar los suscriptores que reciben los mensajes.
messageTtlSeconds
 query

integer

int32

Valor de período de vida (TTL) en segundos para los mensajes enviados al servicio. 0 es el valor predeterminado, lo que significa que el mensaje nunca expira. 300 es el valor máximo. Si este parámetro no es cero, el servicio quitará los mensajes que el cliente no consuma dentro del TTL especificado. Este parámetro puede ayudar cuando el ancho de banda del cliente está limitado.

Cuerpo de la solicitud

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

Nombre Tipo Description
message

string

El cuerpo de la carga.

Respuestas

Nombre Tipo Description
202 Accepted

Aceptado
Other Status Codes

ErrorDetail

Respuesta de error

Headers

x-ms-error-code: string

Ejemplos

WebPubSub_SendToGroup

Sample Request

POST {endpoint}/api/hubs/hub1/groups/group1/:send?api-version=2023-07-01&filter=startswith(userId, 'listener-')&messageTtlSeconds=15

"Message to send"

Sample Response

Status code:
202

Definiciones

Nombre Description
ErrorDetail

Objeto de error.
InnerError

ErrorDetail

Objeto de error.

Nombre Tipo Description
code

string

Uno de un conjunto definido por el servidor de códigos de error.
details

ErrorDetail[]

Matriz de detalles sobre errores específicos que llevaron a este error notificado.
inner

InnerError

message

string

Representación legible del error.
target

string

Destino del error.

InnerError

Nombre Tipo Description
code

string

Código de error más específico del proporcionado por el error contenedor.
inner

InnerError