Dapatkan Daftar Info Jenis Aplikasi
Mendapatkan daftar jenis aplikasi di kluster Service Fabric.
Mengembalikan informasi tentang tipe aplikasi yang disediakan atau dalam proses penyediaan di kluster Service Fabric. Setiap versi jenis aplikasi dikembalikan sebagai satu jenis aplikasi. Respons mencakup nama, versi, status, parameter, dan detail lainnya tentang jenis aplikasi. Ini adalah kueri yang dipaginasi, yang berarti jika tidak semua jenis aplikasi cocok dalam halaman, satu halaman hasil dikembalikan serta token kelanjutan, yang dapat digunakan untuk mendapatkan halaman berikutnya. Misalnya, jika ada 10 jenis aplikasi tetapi sebuah halaman hanya cocok dengan tiga jenis aplikasi pertama, atau jika hasil maks diatur ke 3, maka tiga dikembalikan. Untuk mengakses hasil lainnya, ambil halaman berikutnya dengan menggunakan token kelanjutan yang dikembalikan di kueri berikutnya. Token kelanjutan kosong dikembalikan jika tidak ada halaman berikutnya.
Minta
Metode | URI Permintaan |
---|---|
GET | /ApplicationTypes?api-version=6.0&ApplicationTypeDefinitionKindFilter={ApplicationTypeDefinitionKindFilter}&ExcludeApplicationParameters={ExcludeApplicationParameters}&ContinuationToken={ContinuationToken}&MaxResults={MaxResults}&timeout={timeout} |
Parameter
Nama | Jenis | Diperlukan | Lokasi |
---|---|---|---|
api-version |
string | Ya | Kueri |
ApplicationTypeDefinitionKindFilter |
bilangan bulat | Tidak | Kueri |
ExcludeApplicationParameters |
boolean | Tidak | Kueri |
ContinuationToken |
string | Tidak | Kueri |
MaxResults |
bilangan bulat (int64) | Tidak | Kueri |
timeout |
bilangan bulat (int64) | Tidak | Kueri |
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.
ApplicationTypeDefinitionKindFilter
Jenis: bilangan bulat
Diperlukan: Tidak
Default: 0
Digunakan untuk memfilter pada ApplicationTypeDefinitionKind, yang merupakan mekanisme yang digunakan untuk mendefinisikan jenis aplikasi Service Fabric.
- Default - Nilai default, yang melakukan fungsi yang sama dengan memilih "Semua". Nilainya adalah 0.
- Semua - Filter yang cocok dengan input dengan nilai ApplicationTypeDefinitionKind apa pun. Nilainya adalah 65535.
- ServiceFabricApplicationPackage - Filter yang cocok dengan input dengan ApplicationTypeDefinitionKind value ServiceFabricApplicationPackage. Nilainya adalah 1.
- Compose - Filter yang cocok dengan input dengan ApplicationTypeDefinitionKind value Compose. Nilainya adalah 2.
ExcludeApplicationParameters
Jenis: boolean
Diperlukan: Tidak
Default: false
Bendera yang menentukan apakah parameter aplikasi akan dikecualikan dari hasilnya.
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.
MaxResults
Jenis: bilangan bulat (int64)
Diperlukan: Tidak
Default: 0
InclusiveMinimum: 0
Jumlah maksimum hasil yang akan dikembalikan sebagai bagian dari kueri halaman. Parameter ini menentukan batas atas pada jumlah hasil yang dikembalikan. Hasil yang dikembalikan dapat kurang dari hasil maksimum yang ditentukan jika tidak cocok dalam pesan berdasarkan pembatasan ukuran pesan maksimum yang ditentukan dalam konfigurasi. Jika parameter ini nol atau tidak ditentukan, kueri halaman mencakup hasil sebanyak mungkin yang cocok dalam pesan kembali.
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 jenis aplikasi dalam kluster. |
PagedApplicationTypeInfoList |
Semua kode status lainnya | Respons kesalahan terperinci. |
FabricError |
Contoh
Membatasi hasil maksimum
Contoh ini menunjukkan cara mendapatkan informasi tentang jenis aplikasi yang disediakan atau diprovisikan dalam kluster. Jumlah hasil dalam halaman dibatasi hingga maksimum lima menggunakan parameter MaxResult.
Minta
GET http://localhost:19080/ApplicationTypes?api-version=6.0&MaxResults=5
Respons 200
Isi
{
"ContinuationToken": "PersistentQueueApp+2.0",
"Items": [
{
"Name": "CalculatorApp",
"Version": "1.0",
"DefaultParameterList": [
{
"Key": "ServiceInstanceCount",
"Value": "3"
}
],
"Status": "Available"
},
{
"Name": "CalculatorApp",
"Version": "2.0",
"DefaultParameterList": [
{
"Key": "ServiceInstanceCount",
"Value": "3"
}
],
"Status": "Available"
},
{
"Name": "GatewayApp",
"Version": "1.0",
"DefaultParameterList": [
{
"Key": "GatewayPort",
"Value": "8505"
},
{
"Key": "ServiceInstanceCount",
"Value": "1000"
}
],
"Status": "Available"
},
{
"Name": "PersistentQueueApp",
"Version": "1.0",
"DefaultParameterList": [
{
"Key": "MinReplicaSetSize",
"Value": "2"
},
{
"Key": "TargetReplicaSetSize",
"Value": "3"
}
],
"Status": "Available"
},
{
"Name": "PersistentQueueApp",
"Version": "2.0",
"DefaultParameterList": [
{
"Key": "MinReplicaSetSize",
"Value": "2"
},
{
"Key": "TargetReplicaSetSize",
"Value": "3"
}
],
"Status": "Available"
}
]
}
Halaman menggunakan token kelanjutan
Contoh ini menunjukkan cara halaman melalui informasi tentang jenis aplikasi yang disediakan atau diprovisikan dalam kluster 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/ApplicationTypes?api-version=6.0&ContinuationToken=PersistentQueueApp+2.0&MaxResults=5
Respons 200
Isi
{
"ContinuationToken": "",
"Items": [
{
"Name": "VolatileQueueApp",
"Version": "1.0",
"DefaultParameterList": [
{
"Key": "MinReplicaSetSize",
"Value": "2"
},
{
"Key": "TargetReplicaSetSize",
"Value": "3"
}
],
"Status": "Available"
},
{
"Name": "VolatileQueueApp",
"Version": "2.0",
"DefaultParameterList": [
{
"Key": "MinReplicaSetSize",
"Value": "2"
},
{
"Key": "TargetReplicaSetSize",
"Value": "3"
}
],
"Status": "Available"
}
]
}
Mengecualikan parameter aplikasi dari hasil
Contoh ini menunjukkan cara mengecualikan parameter aplikasi dalam hasil saat mendapatkan informasi tentang jenis aplikasi yang disediakan atau diprovisikan dalam kluster.
Minta
GET http://localhost:19080/ApplicationTypes?api-version=6.0&ExcludeApplicationParameters=True
Respons 200
Isi
{
"ContinuationToken": "",
"Items": [
{
"Name": "CalculatorApp",
"Version": "1.0",
"DefaultParameterList": [],
"Status": "Available"
},
{
"Name": "CalculatorApp",
"Version": "2.0",
"DefaultParameterList": [],
"Status": "Available"
},
{
"Name": "GatewayApp",
"Version": "1.0",
"DefaultParameterList": [],
"Status": "Available"
},
{
"Name": "PersistentQueueApp",
"Version": "1.0",
"DefaultParameterList": [],
"Status": "Available"
},
{
"Name": "PersistentQueueApp",
"Version": "2.0",
"DefaultParameterList": [],
"Status": "Available"
},
{
"Name": "VolatileQueueApp",
"Version": "1.0",
"DefaultParameterList": [],
"Status": "Available"
},
{
"Name": "VolatileQueueApp",
"Version": "2.0",
"DefaultParameterList": [],
"Status": "Available"
}
]
}