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

# Mendapatkan metadata instans DICOM dari HealthImaging
<a name="dicomweb-retrieve-instance-metadata"></a>

Gunakan `GetDICOMInstanceMetadata` tindakan untuk mengambil metadata dari instance DICOM di [penyimpanan HealthImaging data](getting-started-concepts.md#concept-data-store) dengan menentukan Seri, Studi, dan Instance UIDs yang terkait dengan sumber daya. API hanya akan mengembalikan metadata instance dari kumpulan gambar utama kecuali parameter [kumpulan gambar](getting-started-concepts.md#concept-image-set) opsional disediakan. Anda dapat mengambil metadata instance apa pun (dari kumpulan gambar primer atau non-primer) di penyimpanan data dengan menentukan parameter sebagai `imageSetId` kueri.

**Untuk mendapatkan metadata instance DICOM () `.json`**  


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}}/metadata?imageSetId={{image-set-id}}
   ```

1. Siapkan dan kirim permintaan Anda. `GetDICOMInstanceMetadata`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 metadata instance DICOM (`.json`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/metadata?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+json'
   ```

------
**catatan**  
UID Sintaks Transfer yang ditunjukkan dalam metadata cocok dengan Sintaks Transfer Tersimpan UID () di. `StoredTransferSyntaxUID` HealthImaging