Obter Retransmissões

Importante

Essa API está obsoleta e desativada a partir de 1º/11/2021 e não deve mais ser usada.

Essa operação enumera os pontos de extremidade de retransmissão disponíveis publicamente em um namespace de serviço.

Solicitação

Método	URI da solicitação	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 serem ignoradas e {top} é o número de entradas a serem recuperadas.	HTTP/1.1

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação	Descrição
Namespace	URL do ponto de extremidade de gerenciamento
x-ms-version	2012-03-01

A solicitação também exige um certificado do cliente. Esse certificado deve corresponder ao carregado para uma assinatura específica.

Corpo da solicitação

Nenhum.

Resposta

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Códigos de resposta

Código	Descrição
200	Políticas de pontos de extremidade de retransmissão recuperadas com êxito.
401	Falha de autorização. Retornado quando o usuário não tem credenciais para recuperar políticas de pontos de extremidade de retransmissão de namespaces. Isso pode ocorrer em função de uma assinatura suspensa.
404	A entidade não existe neste namespace.
500	Exceção interna/não tratada.

Para obter informações sobre status códigos, consulte Códigos de status e erro.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. 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	Descrição
Tipo de conteúdo	application/xml;type=collection;charset=utf-8

Corpo da resposta

A API retorna um documento AtomPub XML que representa cada política de ponto de extremidade de retransmissão, com os seguintes elementos:

Nome da propriedade	Tipo	Descrição
Nome	String	Nome do ponto de extremidade
Tipo de ouvinte	String	Tipo de grupo de ouvintes. Valores válidos: -Unicast -Multicast - DirectConnection – HybridConnection - RelayedConnection - RelayedHttp
NumberOfListeners	Integer	Número de ouvintes ativos atuais