Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Mendapatkan bingkai instans DICOM dari HealthImaging Gunakan `GetDICOMInstanceFrames` tindakan untuk mengambil bingkai gambar tunggal atau batch (`multipart`permintaan) dari instance DICOM di [penyimpanan HealthImaging data](getting-started-concepts.md#concept-data-store) dengan menentukan UID Seri, UID Studi, Instance UIDs, dan nomor bingkai yang terkait dengan sumber daya. Anda dapat menentukan [kumpulan gambar](getting-started-concepts.md#concept-image-set) dari mana bingkai instance harus diambil dengan memberikan ID kumpulan gambar sebagai parameter kueri. API hanya akan mengembalikan frame instance dari kumpulan gambar utama kecuali parameter [set gambar](getting-started-concepts.md#concept-image-set) opsional disediakan. Anda dapat mengambil frame instance apa pun (dari kumpulan gambar primer atau non-primer) di penyimpanan data dengan menentukan parameter `imageSetId` sebagai kueri. Data DICOM dapat diambil baik dalam sintaks transfer yang disimpan atau sebagai format tidak terkompresi (ELE). **Untuk mendapatkan frame instance DICOM () `multipart`** 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. Tentukan bingkai gambar untuk diambil dari metadata terkait untuk membentuk parameter. `frameList` `frameList`Parameternya adalah daftar terpisah koma dari satu atau lebih nomor bingkai non-duplikat, dalam urutan apa pun. Misalnya, bingkai gambar pertama dalam metadata adalah bingkai 1. + Permintaan bingkai tunggal: `/frames/1` + Permintaan multi-bingkai: `/frames/1,2,3,4` 1. Membangun URL untuk permintaan menggunakan nilai-nilai untuk`datastoreId`,,`studyInstanceUID`,`seriesInstanceUID`, `sopInstanceUID``imageSetId`, dan`frameList`. 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/frames/1?imageSetId=image-set-id ``` 1. Siapkan dan kirim permintaan Anda. `GetDICOMInstanceFrames`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 bingkai gambar dalam `multipart` respons 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/frames/1?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: multipart/related; type=application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1' ``` ------ **catatan** `transfer-syntax`UID bersifat opsional dan default ke Explicit VR Little Endian jika tidak disertakan. Jika transcoding ke ELE tidak layak (karena impor dengan peringatan) maka piksel akan dikembalikan tanpa transcoding. 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. Anda mungkin menerima 406 `NotAcceptableException` jika sintaks transfer yang diminta tidak dapat dikembalikan berdasarkan sintaks transfer yang disimpan, atau jika ada peringatan pemrosesan khusus untuk instance tersebut. Jika ini terjadi, coba lagi panggilan dengan`transfer-syntax=*`. 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).