Dapatkan Relay

Penting

API ini usang dan dihentikan per 11/1/2021 dan tidak boleh lagi digunakan.

Operasi ini menghitung titik akhir relai yang tersedia untuk umum dalam namespace layanan.

Minta

Metode Meminta URI Versi HTTP
GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/ Namespaces/{Namespace}/Relays/$skip={skip}&$top={top}

di mana {skip} adalah jumlah entri yang akan dilewati, dan {top} adalah jumlah entri yang akan diambil.
HTTP/1.1

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Header Permintaan Deskripsi
Ruang nama URL Titik Akhir Manajemen
x-ms-version 2012-03-01

Perhatikan bahwa permintaan juga memerlukan sertifikat klien. Sertifikat ini harus cocok dengan sertifikat yang Anda unggah untuk langganan tertentu.

Isi Permintaan

Tidak ada.

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode Respons

Kode Deskripsi
200 Berhasil mengambil kebijakan titik akhir relai.
401 Kegagalan otorisasi. Dikembalikan ketika pengguna tidak memiliki kredensial untuk mengambil kebijakan titik akhir relai namespace. Ini bisa disebabkan oleh langganan yang ditangguhkan.
404 Entitas tidak ada di bawah namespace layanan ini.
500 Pengecualian internal/tidak tertangani.

Untuk informasi tentang kode status, lihat Status dan Kode Kesalahan.

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Header Respons Deskripsi
Jenis-Konten application/xml;type=collection;charset=utf-8

Isi Respons

API mengembalikan dokumen XML AtomPub yang mewakili setiap kebijakan titik akhir relai, dengan elemen berikut:

Nama Properti Jenis Deskripsi
Nama String Nama titik akhir 2
Jenis Pendengar String Sekelompok jenis pendengar. Nilai yang valid:

- Unicast
-Multicast
- DirectConnection
- HybridConnection
- RelayedConnection
- DisampaikanHttp
NumberOfListeners Bilangan bulat Jumlah pendengar aktif saat ini