Question Answering Projects - List Projects
Mendapatkan semua proyek untuk pengguna.
GET {Endpoint}/language/authoring/query-knowledgebases/projects?api-version=2023-04-01
GET {Endpoint}/language/authoring/query-knowledgebases/projects?api-version=2023-04-01&top={top}&skip={skip}&maxpagesize={maxpagesize}
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
Endpoint
|
path | True |
string (uri) |
Titik akhir Cognitive Services yang didukung (misalnya, https://< resource-name.api.cognitiveservices.azure.com>). |
|
api-version
|
query | True |
string minLength: 1 |
Versi API yang digunakan untuk operasi ini. |
|
maxpagesize
|
query |
integer (int32) |
Jumlah maksimum sumber daya yang akan disertakan dalam satu respons. |
|
|
skip
|
query |
integer (int32) |
Offset ke dalam kumpulan sumber daya pertama yang akan dikembalikan. |
|
|
top
|
query |
integer (int32) |
Jumlah maksimum sumber daya yang akan dikembalikan dari koleksi. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Permintaan itu berhasil. |
|
| Other Status Codes |
Respons kesalahan tak terduga. Header x-ms-error-code: string |
Keamanan
Ocp-Apim-Subscription-Key
Jenis:
apiKey
Dalam:
header
OAuth2Auth
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
| Nama | Deskripsi |
|---|---|
| https://cognitiveservices.azure.com/.default |
Contoh
Successful query
Permintaan sampel
GET {Endpoint}/language/authoring/query-knowledgebases/projects?api-version=2023-04-01
Respon sampel
{
"value": [
{
"description": "proj1 is a test project.",
"createdDateTime": "2021-05-01T15:13:22Z",
"lastDeployedDateTime": "2021-05-01T15:13:22Z",
"lastModifiedDateTime": "2021-05-01T15:13:22Z",
"multilingualResource": true,
"projectName": "proj1",
"language": "en"
},
{
"description": "proj2 is a test project.",
"createdDateTime": "2021-05-01T15:13:22Z",
"lastDeployedDateTime": "2021-05-01T15:13:22Z",
"lastModifiedDateTime": "2021-05-01T15:13:22Z",
"multilingualResource": true,
"projectName": "proj2",
"language": "fr"
}
]
}
Definisi
| Nama | Deskripsi |
|---|---|
| Error |
Objek kesalahan. |
|
Error |
Kode kesalahan yang dapat dibaca manusia. |
|
Error |
Respons kesalahan. |
|
Inner |
Kode kesalahan yang dapat dibaca manusia. |
|
Inner |
Objek yang berisi informasi yang lebih spesifik tentang kesalahan. Sesuai panduan Microsoft One API - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses. |
|
Paged |
Kumpulan halaman item QuestionAnsweringProjectMetadata |
|
Project |
Pengaturan Proyek yang dapat dikonfigurasi. |
|
Question |
Mewakili proyek. |
Error
Objek kesalahan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| code |
Salah satu sekumpulan kode kesalahan yang ditentukan server. |
|
| details |
Error[] |
Array detail tentang kesalahan tertentu yang menyebabkan kesalahan yang dilaporkan ini. |
| innererror |
Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan. |
|
| message |
string |
Representasi kesalahan yang dapat dibaca manusia. |
| target |
string |
Target kesalahan. |
ErrorCode
Kode kesalahan yang dapat dibaca manusia.
| Nilai | Deskripsi |
|---|---|
| InvalidRequest |
Kesalahan permintaan tidak valid |
| InvalidArgument |
Kesalahan argumen tidak valid |
| Unauthorized |
Kesalahan akses tidak sah |
| Forbidden |
Kesalahan akses terlarang |
| NotFound |
Kesalahan tidak ditemukan |
| ProjectNotFound |
Kesalahan proyek tidak ditemukan |
| OperationNotFound |
Operasi tidak ditemukan kesalahan |
| AzureCognitiveSearchNotFound |
Kesalahan Azure Cognitive Search tidak ditemukan |
| AzureCognitiveSearchIndexNotFound |
Kesalahan indeks Azure Cognitive Search tidak ditemukan |
| TooManyRequests |
Terlalu banyak kesalahan permintaan |
| AzureCognitiveSearchThrottling |
Kesalahan pembatasan Azure Cognitive Search |
| AzureCognitiveSearchIndexLimitReached |
Kesalahan tercapainya batas indeks Azure Cognitive Search |
| InternalServerError |
Kesalahan server internal |
| ServiceUnavailable |
Kesalahan layanan tidak tersedia |
| Timeout |
Kesalahan waktu habis |
| QuotaExceeded |
Kesalahan kuota terlampaui |
| Conflict |
Kesalahan konflik |
| Warning |
Kesalahan peringatan |
ErrorResponse
Respons kesalahan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Objek kesalahan. |
InnerErrorCode
Kode kesalahan yang dapat dibaca manusia.
| Nilai | Deskripsi |
|---|---|
| InvalidRequest |
Kesalahan permintaan tidak valid |
| InvalidParameterValue |
Kesalahan nilai parameter tidak valid |
| KnowledgeBaseNotFound |
Pangkalan pengetahuan tidak menemukan kesalahan |
| AzureCognitiveSearchNotFound |
Kesalahan Azure Cognitive Search tidak ditemukan |
| AzureCognitiveSearchThrottling |
Kesalahan pembatasan Azure Cognitive Search |
| ExtractionFailure |
Kesalahan kegagalan ekstraksi |
| InvalidRequestBodyFormat |
Kesalahan format isi permintaan tidak valid |
| EmptyRequest |
Kesalahan permintaan kosong |
| MissingInputDocuments |
Kesalahan dokumen input hilang |
| InvalidDocument |
Kesalahan dokumen tidak valid |
| ModelVersionIncorrect |
Kesalahan versi model salah |
| InvalidDocumentBatch |
Kesalahan batch dokumen tidak valid |
| UnsupportedLanguageCode |
Kesalahan kode bahasa yang tidak didukung |
| InvalidCountryHint |
Kesalahan petunjuk negara tidak valid |
InnerErrorModel
Objek yang berisi informasi yang lebih spesifik tentang kesalahan. Sesuai panduan Microsoft One API - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
| Nama | Jenis | Deskripsi |
|---|---|---|
| code |
Salah satu sekumpulan kode kesalahan yang ditentukan server. |
|
| details |
object |
Detail kesalahan. |
| innererror |
Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan. |
|
| message |
string |
Pesan kesalahan. |
| target |
string |
Target kesalahan. |
PagedQuestionAnsweringProjectMetadata
Kumpulan halaman item QuestionAnsweringProjectMetadata
| Nama | Jenis | Deskripsi |
|---|---|---|
| nextLink |
string (uri) |
Tautan ke halaman item berikutnya |
| value |
Item QuestionAnsweringProjectMetadata di halaman ini |
ProjectSettings
Pengaturan Proyek yang dapat dikonfigurasi.
| Nama | Jenis | Deskripsi |
|---|---|---|
| defaultAnswer |
string |
Respons Jawaban Default ketika tidak ada kecocokan yang baik yang ditemukan di pangkalan pengetahuan. |
QuestionAnsweringProjectMetadata
Mewakili proyek.
| Nama | Jenis | Deskripsi |
|---|---|---|
| createdDateTime |
string (date-time) |
Tanggal pembuatan proyek. |
| description |
string |
Deskripsi proyek. |
| language |
string |
Bahasa rekaman teks. Ini adalah representasi BCP-47 dari sebuah bahasa. Misalnya, gunakan "en" untuk bahasa Inggris; "es" untuk bahasa Spanyol dll. Jika tidak diatur, gunakan "en" untuk bahasa Inggris sebagai default. |
| lastDeployedDateTime |
string (date-time) |
Mewakili tanggal-waktu penyebaran terakhir proyek. |
| lastModifiedDateTime |
string (date-time) |
Mewakili proyek tanggal-waktu terakhir yang diubah. |
| multilingualResource |
boolean |
Sumber daya diaktifkan untuk beberapa bahasa di seluruh proyek atau tidak. |
| projectName |
string maxLength: 100pattern: ^(?=[a-zA-Z0-9])[a-zA-Z0-9-]{0,98}[a-zA-Z0-9]$ |
Nama proyek. |
| settings |
Pengaturan Proyek yang dapat dikonfigurasi. |