Datasets - Get

Layanan:

Azure AI Services

Versi API:

2023-04-01-preview

Dapatkan informasi tentang himpunan data tertentu.

Kode status dikembalikan:

• 200: Operasi berhasil diselesaikan.
• 400: Permintaan cacat.
• 404: Himpunan data dengan nama yang ditentukan tidak ditemukan.

GET /datasets/{name}?api-version=2023-04-01-preview

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
name	path	True	string	Nama himpunan data yang akan didapatkan. Pola regex: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version	query	True	string	Versi API yang diminta.

Respons

Nama	Jenis	Deskripsi
200 OK	Dataset	Berhasil
Other Status Codes	ErrorResponse	Kesalahan Header x-ms-error-code: string

Contoh

Datasets_Get

Permintaan sampel

HTTP

GET /datasets/my_dataset_name?api-version=2023-04-01-preview

Respon sampel

Kode status:

200

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://example.com/dataset.json"
  ],
  "name": "my_dataset_name",
  "createdDateTime": "2023-01-13T20:46:20.189Z",
  "updatedDateTime": "2023-01-13T20:46:20.189Z",
  "eTag": "kzktjgnqkjagdlkualdzikaseg"
}

Definisi

Nama	Deskripsi
AnnotationKind	Jenis anotasi yang terkandung dalam file anotasi. Misalnya, "ImageClassification" untuk menentukan bahwa file anotasi berisi label objek untuk melatih atau menguji model klasifikasi gambar multikelas.
Dataset	Menjelaskan himpunan data, yang mewakili sekumpulan gambar dan anotasi yang dapat digunakan untuk melatih atau menguji model.
ErrorResponse	Respons dikembalikan ketika terjadi kesalahan.
ErrorResponseDetails	Info kesalahan.
ErrorResponseInnerError	Kesalahan terperinci.
StorageAuthenticationKind	Jenis autentikasi penyimpanan.
StorageAuthenticationSettingsApiModel	Menjelaskan pengaturan autentikasi penyimpanan.

AnnotationKind

Jenis anotasi yang terkandung dalam file anotasi. Misalnya, "ImageClassification" untuk menentukan bahwa file anotasi berisi label objek untuk melatih atau menguji model klasifikasi gambar multikelas.

Nama	Jenis	Deskripsi
imageClassification	string
imageObjectDetection	string

Dataset

Menjelaskan himpunan data, yang mewakili sekumpulan gambar dan anotasi yang dapat digunakan untuk melatih atau menguji model.

Nama	Jenis	Deskripsi
annotationFileUris	string[]	Daftar URI absolut ke file anotasi, yang masing-masing harus disimpan sebagai blob dalam kontainer blob Azure Storage. Setiap file harus mengikuti format COCO untuk AnnotationKind yang ditentukan, dengan setiap jalur gambar menjadi URI absolut ke blob dalam kontainer blob. Sumber daya Computer Vision harus memiliki izin untuk membaca file anotasi dan semua file gambar yang dirujuk. Ini dapat dilakukan dengan mengaktifkan Identitas yang dikelola sistem untuk sumber daya Computer Vision, lalu menetapkan identitas ke peran yang memiliki izin untuk membaca dari kontainer blob yang berisi anotasi dan file gambar.
annotationKind	AnnotationKind	Jenis anotasi yang terkandung dalam file anotasi. Misalnya, "ImageClassification" untuk menentukan bahwa file anotasi berisi label objek untuk melatih atau menguji model klasifikasi gambar multikelas.
authentication	StorageAuthenticationSettingsApiModel	Menjelaskan pengaturan autentikasi penyimpanan.
createdDateTime	string	Baca saja. Tanggal dan waktu ketika himpunan data pertama kali didaftarkan, dalam UTC.
customProperties	object	Kamus pasangan kunci-nilai arbitrer untuk digunakan oleh aplikasi. Maksimum 10 pasangan kunci-nilai diizinkan.
eTag	string	Baca saja. ETag terbaru untuk himpunan data. Dapat digunakan dengan header 'If-Match' saat memperbarui atau menghapus himpunan data.
name	string	Baca saja. Nama yang digunakan untuk mengidentifikasi himpunan data secara unik.
updatedDateTime	string	Baca saja. Tanggal dan waktu saat himpunan data terakhir diperbarui, dalam UTC.

ErrorResponse

Respons dikembalikan ketika terjadi kesalahan.

Nama	Jenis	Deskripsi
error	ErrorResponseDetails	Info kesalahan.

ErrorResponseDetails

Info kesalahan.

Nama	Jenis	Deskripsi
code	string	Kode Kesalahan.
details	ErrorResponseDetails[]	Daftar kesalahan terperinci.
innererror	ErrorResponseInnerError	Kesalahan terperinci.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponseInnerError

Kesalahan terperinci.

Nama	Jenis	Deskripsi
code	string	Kode Kesalahan.
innererror	ErrorResponseInnerError	Kesalahan terperinci.
message	string	Pesan kesalahan.

StorageAuthenticationKind

Jenis autentikasi penyimpanan.

Nama	Jenis	Deskripsi
managedIdentity	string
none	string
sas	string

StorageAuthenticationSettingsApiModel

Menjelaskan pengaturan autentikasi penyimpanan.

Nama	Jenis	Deskripsi
kind	StorageAuthenticationKind	Jenis autentikasi penyimpanan.
sasToken	string	Pilihan. Token sas untuk mengakses kontainer. Hanya diperlukan ketika Kind = Sas.