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

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

Gunakan `SearchDICOMInstances` API untuk mencari instance DICOM di penyimpanan HealthImaging [data](getting-started-concepts.md#concept-data-store). Anda dapat mencari instance DICOM HealthImaging dengan membuat URL yang menyertakan elemen data DICOM (atribut) yang didukung. Hasil Instance dikembalikan dalam format JSON, diurutkan berdasarkan ascending (tertua ke terbaru).

**Untuk mencari instance DICOM**  


1. Kumpulkan HealthImaging `region` dan `datastoreId` nilai. Untuk informasi selengkapnya, lihat [Mendapatkan properti penyimpanan data](get-data-store.md).

1. Kumpulkan nilai untuk `StudyInstanceUID` dan`SeriesInstanceUID`. Untuk informasi selengkapnya, lihat [Mendapatkan metadata set gambar](get-image-set-metadata.md).

1. Buat URL untuk permintaan, termasuk semua elemen pencarian yang berlaku. Untuk melihat seluruh jalur URL dalam contoh berikut, gulir ke atas tombol **Salin**. URL adalah dari bentuk:

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]
   ```  
**Elemen contoh untuk `SearchDICOMInstances`**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/healthimaging/latest/devguide/dicomweb-search-instances.html)

   HealthImaging menggunakan elemen DICOM [(0008,1196)](https://dicom.nema.org/dicom/2013/output/chtml/part18/sect_6.6.html#sect_6.6.1.3.2.1.1) untuk mempertahankan kode peringatan impor. Kode peringatan impor dapat dicari di tingkat instans. Kode peringatan impor dapat dicari dengan wildcard atau kode peringatan tertentu. Lihat [HealthImaging Kode Peringatan](reference-warning-codes.md).

1. Siapkan dan kirim permintaan Anda. `SearchDICOMInstances`menggunakan permintaan HTTP GET dengan protokol penandatanganan [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). Contoh berikut menggunakan alat baris `curl` perintah untuk mencari informasi tentang instance DICOM.

------
#### [ curl ]

   ```
   curl --request GET \
     "https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]"
     --aws-sigv4 'aws:amz:us-east-1:medical-imaging' \
     --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
     --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
     --header 'Accept: application/dicom+json' \
     --output results.json
   ```

   Hasil pencarian instance dikembalikan dalam format JSON, diurutkan berdasarkan `Instance Number (0020,0013)` urutan menaik (tertua hingga terbaru)

------