Bagikan melalui

Dapatkan Daftar Info Sub-Nama

  • Artikel

Menghitung semua nama Service Fabric dengan nama yang diberikan.

Menghitung semua nama Service Fabric dengan nama yang diberikan. Jika subname tidak pas di halaman, satu halaman hasil dikembalikan serta token kelanjutan, yang dapat digunakan untuk mendapatkan halaman berikutnya. Mengkueri nama yang tidak ada akan gagal.

Minta

Metode URI Permintaan
GET /Names/{nameId}/$/GetSubNames?api-version=6.0&Recursive={Recursive}&ContinuationToken={ContinuationToken}&timeout={timeout}

Parameter

Nama Jenis Diperlukan Lokasi
nameId string Ya Jalur
api-version string Ya Kueri
Recursive boolean Tidak Kueri
ContinuationToken string Tidak Kueri
timeout bilangan bulat (int64) Tidak Kueri

nameId

Jenis: string
Diperlukan: Ya

Nama Service Fabric, tanpa skema URI 'fabric:'.

api-version

Jenis: string
Diperlukan: Ya
Default: 6.0

Versi API. Parameter ini diperlukan dan nilainya harus '6.0'.

Versi SERVICE Fabric REST API didasarkan pada versi runtime tempat API diperkenalkan atau diubah. Runtime Service Fabric mendukung lebih dari satu versi API. Ini adalah versi TERBARU api yang didukung. Jika versi API yang lebih rendah diteruskan, respons yang dikembalikan mungkin berbeda dari yang didokumenkan dalam spesifikasi ini.

Selain itu, runtime menerima versi apa pun yang lebih tinggi dari versi terbaru yang didukung hingga versi runtime saat ini. Jadi jika versi API terbaru adalah 6.0, tetapi jika runtime adalah 6.1, untuk mempermudah penulisan klien, runtime akan menerima versi 6.1 untuk API tersebut. Namun perilaku API akan sesuai versi 6.0 yang didokumentasikan.

Recursive

Jenis: boolean
Diperlukan: Tidak
Default: false

Memungkinkan menentukan bahwa pencarian yang dilakukan harus rekursif.

ContinuationToken

Jenis: string
Diperlukan: Tidak

Parameter token kelanjutan digunakan untuk mendapatkan serangkaian hasil berikutnya. Token kelanjutan dengan nilai tidak kosong disertakan dalam respons API ketika hasil dari sistem tidak sesuai dalam respons tunggal. Ketika nilai ini diteruskan ke panggilan API berikutnya, API mengembalikan serangkaian hasil berikutnya. Jika tidak ada hasil lebih lanjut, maka token kelanjutan tidak berisi nilai. Nilai parameter ini tidak boleh dikodekan URL.

timeout

Jenis: bilangan bulat (int64)
Diperlukan: Tidak
Default: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik.

Respons

Kode Status HTTP Deskripsi Skema Respons
200 (OK) Daftar halaman nama Service Fabric.
 PagedSubNameInfoList
Semua kode status lainnya Respons kesalahan terperinci.
 FabricError

Contoh

Mendapatkan sub nama

Contoh ini menunjukkan cara mendapatkan informasi tentang semua sub nama dari nama Service Fabric tertentu.

Minta

GET http://localhost:19080/Names/samples/$/GetSubNames?api-version=6.0

Respons 200

Isi
{
  "ContinuationToken": "",
  "IsConsistent": true,
  "SubNames": [
    "fabric:/samples/CalculatorApp",
    "fabric:/samples/mynames"
  ]
}

Mencari sub nama secara rekursif

Contoh ini menunjukkan cara mendapatkan informasi secara rekursif tentang semua sub nama anak dari nama Service Fabric tertentu.

Minta

GET http://localhost:19080/Names/samples/$/GetSubNames?api-version=6.0&Recursive=True

Respons 200

Isi
{
  "ContinuationToken": "",
  "IsConsistent": true,
  "SubNames": [
    "fabric:/samples/apps",
    "fabric:/samples/data",
    "fabric:/samples/CalculatorApp",
    "fabric:/samples/CalculatorApp/CalculatorService",
    "fabric:/samples/CalculatorApp/CalculatorService/Name-1",
    "fabric:/samples/CalculatorApp/CalculatorService/Name-2",
    "fabric:/samples/mynames/name-1"
  ]
}

Halaman menggunakan token kelanjutan

Contoh ini menunjukkan cara halaman melalui informasi tentang sub nama di bawah nama Service Fabric tertentu menggunakan parameter ContinuationToken. Nilai parameter ini disediakan dari kueri sebelumnya, dalam hal ini contoh yang ditunjukkan di atas. Respons berisi dua hasil yang tersisa dan ContinuationToken kosong. ContinuationToken kosong menunjukkan bahwa hasil tambahan tidak tersedia.

Minta

GET http://localhost:19080/Names/samples/$/GetSubNames?api-version=6.0&Recursive=True&ContinuationToken=fabric:/samples/apps/PersistentQueueApp$131439231986491349

Respons 200

Isi
{
  "ContinuationToken": "",
  "IsConsistent": true,
  "SubNames": [
    "fabric:/samples/apps/VolatileQueueApp",
    "fabric:/samples/apps/NotepadApp"
  ]
}