

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Metadaten der DICOM-Instanz abrufen von HealthImaging
<a name="dicomweb-retrieve-instance-metadata"></a>

Verwenden Sie die `GetDICOMInstanceMetadata` Aktion, um die Metadaten aus einer DICOM-Instanz in einem HealthImaging [Datenspeicher](getting-started-concepts.md#concept-data-store) abzurufen, indem Sie die Serie, Studie und Instanz angeben, die der UIDs Ressource zugeordnet sind. Die API gibt nur Instanz-Metadaten aus primären Bilddatensätzen zurück, sofern der optionale [Bilddatensatzparameter](getting-started-concepts.md#concept-image-set) nicht angegeben wird. Sie können alle Instanz-Metadaten (aus primären oder nicht primären Bilddatensätzen) im Datenspeicher abrufen, indem Sie den `imageSetId` als Abfrageparameter angeben.

**Um DICOM-Instanz-Metadaten abzurufen () `.json`**  


1. Werte sammeln HealthImaging `datastoreId` und `imageSetId` parametrieren.

1. Verwenden Sie die [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)Aktion mit den `imageSetId` Parameterwerten `datastoreId` und, um die zugehörigen Metadatenwerte für `studyInstanceUID``seriesInstanceUID`, und abzurufen`sopInstanceUID`. Weitere Informationen finden Sie unter [Metadaten von Bilddatensätzen abrufen](get-image-set-metadata.md).

1. Konstruieren Sie mithilfe der Werte für`datastoreId`, `studyInstanceUID` `seriesInstanceUID``sopInstanceUID`, und eine URL für die Anforderung`imageSetId`. Scrollen Sie über die Schaltfläche **Kopieren**, um den gesamten URL-Pfad im folgenden Beispiel anzuzeigen. Die URL hat die Form:

   ```
   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. Bereiten Sie Ihre Anfrage vor und senden Sie sie ab. `GetDICOMInstanceMetadata`verwendet eine HTTP-GET-Anfrage mit dem [AWS Signaturprotokoll Signature Version 4.](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) Das folgende Codebeispiel verwendet das `curl` Befehlszeilentool, um Metadaten (`.json`Datei) der DICOM-Instanz HealthImaging abzurufen.

------
#### [ 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'
   ```

------
**Anmerkung**  
Die in den Metadaten angegebene UID für die Übertragungssyntax entspricht der UID () `StoredTransferSyntaxUID` für die gespeicherte Übertragungssyntax in. HealthImaging