Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mencari data DICOM di HealthImaging
<a name="dicomweb-search"></a>

AWS HealthImaging menawarkan representasi [ DICOMweb QIDO-RS](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) APIs untuk mencari studi, seri, dan instance berdasarkan ID Pasien, dan menerima pengenal uniknya untuk penggunaan lebih lanjut. HealthImaging DICOMweb QIDO-RS APIs menawarkan fleksibilitas dalam cara Anda mencari data yang disimpan HealthImaging dan menyediakan interoperabilitas dengan aplikasi lama.

**Penting:**  
HealthImaging DICOMweb APIs dapat digunakan untuk mengembalikan informasi kumpulan gambar dengan QIDO-RS. HealthImaging DICOMweb APIs referensi hanya [kumpulan gambar](getting-started-concepts.md#concept-image-set) kecuali dinyatakan lain. Gunakan [tindakan bawaan HealthImaging cloud,](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) atau parameter DICOMweb tindakan kumpulan gambar opsional untuk mengambil kumpulan gambar non-primer. HealthImaging's DICOMweb APIs dapat digunakan untuk mengembalikan informasi kumpulan gambar dengan respons DICOMweb -conformant.  
 HealthImaging DICOMweb Tindakan QIDO-RS dapat mengembalikan maksimum 10.000 catatan. [Jika ada lebih dari 10.000 sumber daya, mereka tidak akan dapat diambil melalui tindakan QIDO-RS, tetapi dapat diambil melalui tindakan DICOMweb WADO-RS atau tindakan cloud native.](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html)   
Yang APIs tercantum di bagian ini dibangun sesuai dengan standar DICOMweb (QIDO-RS) untuk pencitraan medis berbasis web. Mereka tidak ditawarkan melalui AWS CLI dan AWS SDKs.

## DICOMweb APIs mencari HealthImaging
<a name="dicomweb-search-services"></a>

Tabel berikut menjelaskan semua HealthImaging representasi DICOMweb QIDO-RS yang APIs tersedia untuk mencari data di. HealthImaging


**HealthImaging representasi QIDO-RS DICOMweb APIs**  

| Nama | Deskripsi | 
| --- | --- | 
| SearchDICOMStudies | Cari studi DICOM HealthImaging dengan menentukan elemen permintaan pencarian menggunakan permintaan GET. Hasil pencarian studi dikembalikan dalam format JSON, diurutkan berdasarkan pembaruan terakhir, tanggal turun (terbaru ke terlama). Lihat [Cari studi](dicomweb-search-studies.md). | 
| SearchDICOMSeries | Cari seri DICOM HealthImaging dengan menentukan elemen permintaan pencarian menggunakan permintaan GET. Hasil pencarian seri dikembalikan dalam format JSON, diurutkan berdasarkan Series Number (0020, 0011) urutan menaik (tertua hingga terbaru). Lihat [Cari seri](dicomweb-search-series.md). | 
| SearchDICOMInstances | Cari instance DICOM HealthImaging dengan menentukan elemen kueri penelusuran menggunakan permintaan GET. Hasil pencarian instance dikembalikan dalam format JSON, diurutkan berdasarkan Instance Number (0020, 0013) urutan menaik (tertua hingga terbaru). Lihat [Cari contoh](dicomweb-search-instances.md). | 

## Jenis DICOMweb kueri yang didukung untuk HealthImaging
<a name="dicomweb-query-types"></a>

HealthImaging mendukung kueri sumber daya hierarkis QIDO-RS di tingkat Studi, Seri, dan SOP Instans. Saat menggunakan pencarian hierarkis QIDO-RS untuk: HealthImaging
+ Mencari studi mengembalikan daftar Studi
+ Mencari Seri Studi membutuhkan yang diketahui `StudyInstanceUID` dan mengembalikan daftar Seri
+ Mencari daftar Instans membutuhkan yang diketahui `StudyInstanceUID` dan `SeriesInstanceUID`

Tabel berikut menjelaskan jenis kueri hierarkis QIDO-RS yang didukung untuk mencari data di. HealthImaging


**HealthImaging jenis kueri QIDO-RS yang didukung**  

| Jenis kueri | Contoh | 
| --- | --- | 
| Kueri nilai atribut | Cari semua seri dalam Studi di mana`modality=CT`.<br />`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT`<br />Cari semua studi di mana ID pasien dan tanggal studi masing-masing adalah nilai-nilai ini.<br />`…/studies?PatientID=11235813&StudyDate=20130509` | 
| Pertanyaan kata kunci | Cari semua seri menggunakan `SeriesInstanceUID` kata kunci.<br />`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?SeriesInstanceUID=1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894868` | 
| Kueri tag | Cari tag menggunakan parameter kueri yang diteruskan dalam group/element formulir.<br />{group} {element} seperti 0020000D | 
| Kueri rentang | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | 
| Hasil paging dengan limit dan offset | `.../studies?limit=1&offset=0&00080020=20000101`<br />Anda dapat menggunakan parameter limit dan offset untuk melakukan paginasi respons penelusuran. Nilai default limit adalah 1000, dan lihat [HealthImaging Titik akhir dan kuota AWS](endpoints-quotas.md) untuk nilai maksimum.<br />Batas maks = 1000, Max offset = 9000 | 
| Kueri wildcard | Kueri wildcard memberikan lebih banyak fleksibilitas pada pencarian menggunakan “\*” dan “?”. “\*” cocok dengan urutan karakter apa pun (termasuk nilai panjang nol) dan “?” cocok dengan karakter tunggal apa pun.<br />Cari semua studi di datastore yang StudyDescription berisi “Nuklir”:<br />`.../studies?StudyDescription=*Nuclear*`<br />Cari semua studi yang StudyDescription diakhiri dengan “Nuklir”:<br />`.../studies?StudyDescription=*Nuclear`<br />Cari semua studi yang StudyDescription dimulai dengan “Nuklir”:<br />`.../studies?StudyDescription=Nuclear*`<br />Cari semua studi di mana PatientID memiliki persis 3 karakter setelah 200965981:<br />`.../studies?PatientID=200965981???` | 
| FuzzyMatching pertanyaan | Aktifkan pencocokan fuzzy pada atribut DICOM nama ((0010.0010), PatientName ReferringPhysicianName (0008.0090)) dengan menambahkan parameter kueri opsional fuzzymatching:<br />`.../studies?fuzzymatching=true&PatientName="Thomas^Albert"`<br />Kueri ini melakukan pencocokan kata awalan case-insensitive pada bagian mana pun dari nilai. PatientName Ia mengembalikan hasil dengan PatientName nilai-nilai seperti “thomas”, “Albert”, “Thomas Albert”, “Thomas^Albert”, tetapi tidak “hom” atau “ber”. | 

**Topics**
+ [DICOMweb APIs mencari HealthImaging](#dicomweb-search-services)
+ [Jenis DICOMweb kueri yang didukung untuk HealthImaging](#dicomweb-query-types)
+ [Mencari studi DICOM di HealthImaging](dicomweb-search-studies.md)
+ [Mencari seri DICOM di HealthImaging](dicomweb-search-series.md)
+ [Mencari instance DICOM di HealthImaging](dicomweb-search-instances.md)