Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Mendapatkan instance DICOM dari HealthImaging Gunakan `GetDICOMInstance` tindakan untuk mengambil instance DICOM (`.dcm`file) dari [penyimpanan HealthImaging data](getting-started-concepts.md#concept-data-store) dengan menentukan Seri, Studi, dan Instance yang UIDs terkait dengan sumber daya. API hanya akan mengembalikan instance dari kumpulan gambar utama kecuali [parameter kumpulan gambar](getting-started-concepts.md#concept-image-set) opsional disediakan. Anda dapat mengambil instance apa pun (dari kumpulan gambar primer atau non-primer) di penyimpanan data dengan menentukan `imageSetId` sebagai parameter kueri. Data DICOM dapat diambil baik dalam sintaks transfer yang disimpan atau sebagai format tidak terkompresi (ELE). **Untuk mendapatkan instance DICOM () `.dcm`** 1. Kumpulkan HealthImaging `datastoreId` dan nilai `imageSetId` parameter. 1. Gunakan [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)tindakan dengan nilai `imageSetId` parameter `datastoreId` dan untuk mengambil nilai metadata terkait untuk`studyInstanceUID`,, `seriesInstanceUID` dan. `sopInstanceUID` Untuk informasi selengkapnya, lihat [Mendapatkan metadata set gambar](get-image-set-metadata.md). 1. Membangun URL untuk permintaan menggunakan nilai-nilai untuk`datastoreId`,,`studyInstanceUID`, `seriesInstanceUID``sopInstanceUID`, dan`imageSetId`. 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/datastore-id/studies/study-instance-uid/series/series-instance-uid/instances/sop-instance-uid?imageSetId=image-set-id ``` 1. Siapkan dan kirim permintaan Anda. `GetDICOMInstance`menggunakan permintaan HTTP GET dengan protokol penandatanganan [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). Contoh kode berikut menggunakan alat baris `curl` perintah untuk mendapatkan instance DICOM (`.dcm`file) dari HealthImaging. ------ #### [ Shell ] ``` curl --request GET \ 'https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/d9a2a515ab294163a2d2f4069eed584c/studies/1.3.6.1.4.1.5962.1.2.4.20040826285059.5457/series/1.3.6.1.4.1.5962.1.3.4.1.20040825185059.5457/instances/1.3.6.1.4.1.5962.1.1.4.1.1.20040826186059.5457?imageSetId=459e50687f121185f747b67bb60d1bc8' \ --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; transfer-syntax=1.2.840.10008.1.2.1' \ --output 'dicom-instance.dcm' ``` ------ **catatan** `transfer-syntax`UID bersifat opsional dan default ke Explicit VR Little Endian jika tidak disertakan. Sintaks transfer yang didukung meliputi: Eksplisit VR Little Endian (ELE) - `1.2.840.10008.1.2.1` (default untuk bingkai gambar lossless) Jika `transfer-syntax=*` kemudian bingkai gambar akan dikembalikan dalam sintaks transfer yang disimpan. High-Throughput JPEG 2000 dengan Kompresi Gambar Opsi RPCL (Hanya Tanpa Lossless) - `1.2.840.10008.1.2.4.202` - jika instance disimpan sebagai HealthImaging `1.2.840.10008.1.2.4.202` JPEG 2000 Lossless - `1.2.840.10008.1.2.4.90` - jika instance disimpan sebagai lossless. HealthImaging JPEG Baseline (Proses 1): Sintaks Transfer Default untuk Kompresi Gambar 8-bit Lossy JPEG - - `1.2.840.10008.1.2.4.50` jika instance disimpan sebagai HealthImaging `1.2.840.10008.1.2.4.50` Kompresi Gambar JPEG 2000 `1.2.840.10008.1.2.4.91` - - jika instance disimpan HealthImaging sebagai `1.2.840.10008.1.2.4.91` Kompresi Gambar JPEG 2000 High-Throughput `1.2.840.10008.1.2.4.203` - - jika instance disimpan sebagai HealthImaging `1.2.840.10008.1.2.4.203` Kompresi Gambar JPEG XL `1.2.840.10008.1.2.4.112` - - jika instance disimpan sebagai HealthImaging `1.2.840.10008.1.2.4.112` Contoh yang disimpan HealthImaging dengan satu atau lebih bingkai gambar yang dikodekan dalam keluarga MPEG [Transfer Syntax](supported-transfer-syntaxes.md) (yang mencakup MPEG2, MPEG-4 AVC/H.264 and HEVC/H .265) dapat diambil dengan UID sintaks transfer yang sesuai. Misalnya, `1.2.840.10008.1.2.4.100` jika instance disimpan sebagai MPEG2 Main Profile Main Level. Lihat informasi yang lebih lengkap di [Sintaks transfer yang didukung](supported-transfer-syntaxes.md) dan [Pustaka decoding bingkai gambar untuk AWS HealthImaging](reference-libraries.md).