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 |
|---|---|---|---|---|
|
connection
|
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. |
|
message
|
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 |
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. |
Objeto de error. |
|
Azure. |
Respuesta que contiene los detalles del error. |
|
Azure. |
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 |
Matriz de detalles sobre errores específicos que llevaron a este error notificado. |
|
| 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 |
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 |
Error interno. |