Obter Reencaminhamentos
Importante
Esta API é obsoleta e descontinuada a partir de 11/01/2021 e já não deve ser utilizada.
Esta operação enumera os pontos finais de reencaminhamento publicamente disponíveis num espaço de nomes de serviço.
Pedir
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| GET |
https://management.core.windows.net/{subscription ID}/services/ServiceBus/ Namespaces/{Namespace}/Relays/$skip={skip}&$top={top} em que {skip} é o número de entradas a ignorar e {top} é o número de entradas a obter. |
HTTP/1.1 |
Cabeçalhos do Pedido
A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.
| Cabeçalho do Pedido | Description |
|---|---|
| Espaço de Nomes | URL do Ponto Final de Gestão |
| x-ms-version | 2012-03-01 |
Tenha em atenção que o pedido também requer um certificado de cliente. Este certificado tem de corresponder ao certificado que carregou para essa subscrição específica.
Corpo do Pedido
Nenhum.
Resposta
A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.
Códigos de Resposta
| Código | Descrição |
|---|---|
| 200 | Foram obtidas com êxito políticas de pontos finais de reencaminhamento. |
| 401 | Falha de autorização. Devolvido quando o utilizador não tem credenciais para obter políticas de pontos finais de reencaminhamento de espaços de nomes. Tal pode dever-se a uma subscrição suspensa. |
| 404 | A entidade não existe neste espaço de nomes. |
| 500 | Exceção interna/não processada. |
Para obter informações sobre códigos de estado, veja Códigos de Estado e Erro.
Cabeçalhos de Resposta
A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
| Cabeçalho de Resposta | Description |
|---|---|
| Content-Type | application/xml;type=collection;charset=utf-8 |
Corpo da Resposta
A API devolve um documento XML AtomPub que representa cada política de ponto final de reencaminhamento, com os seguintes elementos:
| Nome da Propriedade | Tipo | Descrição |
|---|---|---|
| Nome | String | Nome do ponto final |
| Tipo de Serviço de Escuta | String | Tipo de grupo de serviços de escuta. Valores válidos: - Unicast - Multicast - DirectConnection - HybridConnection - RelayedConnection - ReencaminhadoHttp |
| NumberOfListeners | Número inteiro | Número de serviços de escuta ativos atuais |