

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

# Mendapatkan DICOM bulkdata dari HealthImaging
<a name="dicom-retrieve-bulkdata"></a>

Gunakan `GetDICOMBulkdata` tindakan untuk mengambil data biner yang telah dipisahkan dari metadata DICOM di penyimpanan data. HealthImaging Saat mengambil metadata instance atau seri, atribut biner yang lebih besar dari 1MB akan diwakili oleh `BulkDataURI` bukan nilai inline. Anda dapat mengambil data biner untuk kumpulan gambar utama apa pun di penyimpanan HealthImaging data dengan menggunakan yang `BulkDataURI` disediakan dalam respons metadata. Anda dapat mengambil data massal untuk kumpulan gambar non-primer dengan memberikan ID kumpulan gambar sebagai parameter kueri.

**Untuk mendapatkan DICOM bulkdata**  


Ketika Anda mengambil metadata DICOM dari tindakan HealthImaging DICOMweb WADO-RS, seperti `GetDICOMInstanceMetadata` atau, atribut biner besar akan diganti sejalan dengan`GetDICOMSeriesMetadata`, seperti yang ditunjukkan di bawah ini: BulkData URIs

```
"00451026": {
    "vr": "UN",
    "BulkDataURI": "https://dicom-medical-imaging.us-west-2.amazonaws.com/datastore/<datastoreId>/studies/<StudyInstanceUID>/series/<SeriesInstanceUID>/instances/<SOPInstanceUID>/bulkdata/<bulkdataUriHash>"
}
```

Untuk mengambil elemen DICOM dengan `GetDICOMBulkdata` tindakan, gunakan langkah-langkah berikut.

1. Membangun URL untuk permintaan menggunakan nilai-nilai dari`BulkDataURI`, dari bentuk:

   ```
   https://dicom-medical-imaging.{{region}}.amazonaws.com/datastore/{{datastore-id}}/studies/{{study-instance-uid}}/series/{{series-instance-uid}}/instances/{{sop-instance-uid}}/bulkdata/{{bulkdata-uri-hash}}
   ```

1. Keluarkan `GetDICOMBulkdata` perintah Anda sebagai 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 mengambil elemen DICOM dari kumpulan gambar utama:

   ```
   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.2.840.10008.5.1.4.1.1.7/bulkdata/b026324c6904b2a9cb4b88d6d61c81d1' \
     --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/octet-stream' \
     --output 'bulkdata.bin'
   ```

   Untuk mengambil elemen data DICOM dari kumpulan gambar non-primer, berikan parameter: `ImageSetId`

   ```
   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.2.840.10008.5.1.4.1.1.7/bulkdata/b026324c6904b2a9cb4b88d6d61c81d1?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/octet-stream' \
     --output 'bulkdata.bin'
   ```

**catatan**  
`imageSetId`Parameter diperlukan untuk mengambil bulkdata untuk kumpulan gambar non-primer. DICOMBulkdata Tindakan Dapatkan hanya akan mengembalikan bulkdata untuk kumpulan gambar utama jika`datastoreId`,, `studyInstanceUID``seriesInstanceUID`, dan `SOPInstanceUID` ditentukan (tanpa). `imagesetID`