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. # DICOM-Instanz-Frames abrufen von HealthImaging Verwenden Sie die `GetDICOMInstanceFrames` Aktion, um einzelne Bild-Frames oder Batch-Frames (`multipart`Anfrage) von einer DICOM-Instance in einem HealthImaging [Datenspeicher](getting-started-concepts.md#concept-data-store) abzurufen, indem Sie die Serien-UID, die Studien-UID, die Instanz und die Frame-Nummern angeben UIDs, die einer Ressource zugeordnet sind. Sie können den [Bilddatensatz](getting-started-concepts.md#concept-image-set) angeben, aus dem Instanz-Frames abgerufen werden sollen, indem Sie die Bilddatensatz-ID als Abfrageparameter angeben. Die API gibt nur Instanzframes aus primären Bilddatensätzen zurück, es sei denn, der optionale [Bildsatzparameter](getting-started-concepts.md#concept-image-set) wird bereitgestellt. Sie können jeden Instanz-Frame (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 DICOM-Instanz-Frames () abzurufen `multipart`** 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. Ermitteln Sie die Bildrahmen, die aus den zugehörigen Metadaten abgerufen werden sollen, um den `frameList` Parameter zu bilden. Der `frameList` Parameter ist eine durch Kommas getrennte Liste mit einer oder mehreren Frame-Nummern, die nicht doppelt vorhanden sind, in beliebiger Reihenfolge. Der erste Bildrahmen in den Metadaten ist beispielsweise Frame 1. + Einzelrahmen-Anfrage: `/frames/1` + Anfrage mit mehreren Frames: `/frames/1,2,3,4` 1. Konstruieren Sie eine URL für die Anfrage mit den Werten für `datastoreId``studyInstanceUID`,`seriesInstanceUID`, `sopInstanceUID``imageSetId`, und`frameList`. 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/frames/1?imageSetId=image-set-id ``` 1. Bereiten Sie Ihre Anfrage vor und senden Sie sie ab. `GetDICOMInstanceFrames`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 Bildrahmen in einer `multipart` Antwort von abzurufen 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' ``` ------ **Anmerkung** Die `transfer-syntax` UID ist optional und wird standardmäßig auf Explicit VR Little Endian gesetzt, falls sie nicht enthalten ist. Wenn die Transcodierung nach ELE nicht möglich ist (aufgrund eines Imports mit Warnung), werden Pixel ohne Transcodierung zurückgegeben. 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. Dies ist beispielsweise der Fall, `1.2.840.10008.1.2.4.100` wenn die Instanz als Main Profile Main Level gespeichert ist. MPEG2 Möglicherweise erhalten Sie einen `NotAcceptableException` 406-Wert, wenn die angeforderte Übertragungssyntax aufgrund der gespeicherten Übertragungssyntax nicht zurückgegeben werden kann oder wenn es spezielle Verarbeitungswarnungen für die Instanz gibt. Wenn dies der Fall ist, versuchen Sie erneut, den Anruf mit`transfer-syntax=*`. 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).