Get Relays
Importante
Esta API está obsoleta y retirada a partir del 11/1/2021 y ya no debe usarse.
Esta operación enumera los puntos de conexión de retransmisión disponibles públicamente en un espacio de nombres de servicio.
Solicitud
| Método | URI de solicitud | Versión de HTTP |
|---|---|---|
| GET |
https://management.core.windows.net/{subscription ID}/services/ServiceBus/ Namespaces/{Namespace}/Relays/$skip={skip}&$top={top} donde {skip} es el número de entradas que se van a omitir y {top} es el número de entradas que se van a recuperar. |
HTTP/1.1 |
Encabezados de solicitud
En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.
| Encabezado de solicitud | Descripción |
|---|---|
| Espacio de nombres | Dirección URL del punto de conexión de administración |
| x-ms-version | 2012-03-01 |
Tenga en cuenta que la solicitud también necesita un certificado de cliente. Este certificado debe coincidir con el certificado que cargó para la suscripción concreta.
Cuerpo de la solicitud
Ninguno.
Response
La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.
Códigos de respuesta
| Código | Descripción |
|---|---|
| 200 | Se recuperaron correctamente las directivas de puntos de conexión de retransmisión. |
| 401 | Error de autorización. Se devuelve cuando el usuario no tiene credenciales para recuperar las directivas de puntos de conexión de retransmisión de espacios de nombres. Esto puede deberse a la suspensión de una suscripción. |
| 404 | La entidad no existe en este espacio de nombres. |
| 500 | Excepción interna/no controlada. |
Para obtener información sobre los códigos de estado, vea Códigos de estado y error.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
| Content-Type | application/xml;type=collection;charset=utf-8 |
Cuerpo de la respuesta
La API devuelve un documento AtomPub XML que representa cada directiva de punto de conexión de retransmisión, con los siguientes elementos:
| Nombre de propiedad | Tipo | Descripción |
|---|---|---|
| Nombre | String | El nombre del punto de conexión |
| Tipo de agente de escucha | String | Grupo de tipos de agentes de escucha. Valores válidos: -Unidifusión -Multidifusión - DirectConnection - HybridConnection - RelayedConnection - RelayedHttp |
| NumberOfListeners | Entero | Número de agentes de escucha activos actuales |