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. # Abrufen einer DICOM-Instanz von HealthImaging Verwenden Sie die `GetDICOMInstance` Aktion, um eine DICOM-Instanz (`.dcm`Datei) aus 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 Instanzen aus primären Bilddatensätzen zurück, sofern der optionale [Bilddatensatzparameter](getting-started-concepts.md#concept-image-set) nicht angegeben wird. Sie können jede Instanz (aus primären oder nicht primären Bilddatensätzen) im Datenspeicher abrufen, indem Sie den `imageSetId` als Abfrageparameter angeben. DICOM-Daten können entweder in der gespeicherten Übertragungssyntax oder im unkomprimierten Format (ELE) abgerufen werden. **Um eine DICOM-Instanz zu erhalten () `.dcm`** 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?imageSetId=image-set-id ``` 1. Bereiten Sie Ihre Anfrage vor und senden Sie sie ab. `GetDICOMInstance`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 eine DICOM-Instanz (`.dcm`Datei) von 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?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' ``` ------ **Anmerkung** Die `transfer-syntax` UID ist optional und wird standardmäßig auf Explicit VR Little Endian gesetzt, falls sie nicht enthalten ist. Zu den unterstützten Übertragungssyntaxen gehören: Explicit VR Little Endian (ELE) — `1.2.840.10008.1.2.1` (Standard für verlustfreie Bildrahmen) `transfer-syntax=*`Wenn ja, werden die Bildrahmen in der gespeicherten Übertragungssyntax zurückgegeben. JPEG 2000 mit hohem Durchsatz und RPCL-Optionen Bildkomprimierung (nur verlustfrei) — `1.2.840.10008.1.2.4.202` — wenn die Instanz gespeichert ist unter HealthImaging `1.2.840.10008.1.2.4.202` JPEG 2000 Lossless — `1.2.840.10008.1.2.4.90` — wenn die Instanz als Lossless gespeichert ist. HealthImaging JPEG-Baseline (Prozess 1): Standardübertragungssyntax für die verlustbehaftete 8-Bit-JPEG-Bildkomprimierung `1.2.840.10008.1.2.4.50` —, wenn die Instanz gespeichert ist in HealthImaging `1.2.840.10008.1.2.4.50` JPEG 2000-Bildkomprimierung — `1.2.840.10008.1.2.4.91` — wenn die Instanz gespeichert ist unter HealthImaging `1.2.840.10008.1.2.4.91` JPEG 2000-Bildkomprimierung mit hohem Durchsatz `1.2.840.10008.1.2.4.203` - - wenn die Instanz gespeichert ist unter HealthImaging `1.2.840.10008.1.2.4.203` JPEG XL-Bildkomprimierung `1.2.840.10008.1.2.4.112` - - wenn die Instanz gespeichert ist unter HealthImaging `1.2.840.10008.1.2.4.112` Instanzen, in HealthImaging denen ein oder mehrere Bildrahmen gespeichert sind, die in der MPEG-Familie von [Transfersyntaxen](supported-transfer-syntaxes.md) (zu der auch MPEG-4 AVC/H.264 and HEVC/H .265 gehören) kodiert sind MPEG2, können mit der entsprechenden Transfer-Syntax-UID abgerufen werden. Zum Beispiel, `1.2.840.10008.1.2.4.100` wenn die Instanz als Main Profile Main Level gespeichert ist. MPEG2 Weitere Informationen erhalten Sie unter [Unterstützte Übertragungssyntaxen](supported-transfer-syntaxes.md) und [Bibliotheken zur Dekodierung von Image-Frames für AWS HealthImaging](reference-libraries.md).