Compartir a través de


Send To Connection - Send To Connection

Envíe contenido dentro del cuerpo de la solicitud a la conexión específica.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
connectionId
path True

string

minLength: 1

El identificador de conexión.

endpoint
path True

string (uri)

Punto de conexión HTTP o HTTPS para la instancia de servicio Web PubSub

hub
path True

string

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

Nombre del centro de destino, que debe comenzar con caracteres alfabéticos y solo contener caracteres alfanuméricos o caracteres de subrayado.

api-version
query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

messageTtlSeconds
query

integer (int32)

maximum: 300

El valor de tiempo de vida (TTL) en segundos para los mensajes enviados al servicio. 0 es el valor predeterminado, lo que significa que el mensaje nunca caduca. 300 es el valor máximo. Si este parámetro es distinto de 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 es limitado.

Cuerpo de la solicitud

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

Nombre Tipo Description
message

string (byte)

El cuerpo de la carga útil.

Respuestas

Nombre Tipo Description
204 No Content

No hay contenido para enviar para esta solicitud, pero los encabezados pueden ser útiles.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Una respuesta de error inesperada.

Encabezados

x-ms-error-code: string

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
https://webpubsub.azure.com/.default

Ejemplos

SendToConnection

Solicitud de ejemplo

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

"TWVzc2FnZSB0byBzZW5k"

Respuesta de muestra

Definiciones

Nombre Description
Azure.Core.Foundations.Error

Objeto de error.

Azure.Core.Foundations.ErrorResponse

Respuesta que contiene los detalles del error.

Azure.Core.Foundations.InnerError

Objeto que contiene información más específica sobre el error. Según las directrices de la API de REST de Azure: https://aka.ms/AzureRestApiGuidelines#handling-errors.

Azure.Core.Foundations.Error

Objeto de error.

Nombre Tipo Description
code

string

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

details

Azure.Core.Foundations.Error[]

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

innererror

Azure.Core.Foundations.InnerError

Objeto que contiene información más específica que el objeto actual sobre el error.

message

string

Representación legible del error.

target

string

Destino del error.

Azure.Core.Foundations.ErrorResponse

Respuesta que contiene los detalles del error.

Nombre Tipo Description
error

Azure.Core.Foundations.Error

Objeto de error.

Azure.Core.Foundations.InnerError

Objeto que contiene información más específica sobre el error. Según las directrices de la API de REST de Azure: https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nombre Tipo Description
code

string

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

innererror

Azure.Core.Foundations.InnerError

Error interno.