Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Ottenere frame di istanze DICOM da HealthImaging Usa l'`GetDICOMInstanceFrames`azione per recuperare frame di immagini singoli o in batch (`multipart`richiesta) da un'istanza DICOM in un HealthImaging [data store](getting-started-concepts.md#concept-data-store) specificando l'UID della serie, l'UID dello studio, l'istanza e i numeri di frame associati a una UIDs risorsa. È possibile specificare il [set di immagini](getting-started-concepts.md#concept-image-set) da cui recuperare i frame dell'istanza fornendo l'ID del set di immagini come parametro di interrogazione. L'API restituirà solo frame di istanza dai set di immagini primari, a meno che non venga fornito il parametro opzionale del [set di immagini](getting-started-concepts.md#concept-image-set). È possibile recuperare qualsiasi frame di istanza (da set di immagini primari o non primari) nel data store specificandolo `imageSetId` come parametro di query. I dati DICOM possono essere recuperati nella sintassi di trasferimento memorizzata o in formato non compresso (ELE). **Per ottenere i frame delle istanze DICOM () `multipart`** 1. Raccogli HealthImaging `datastoreId` e `imageSetId` parametra i valori. 1. Utilizzate l'[https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)azione con i valori `imageSetId` dei parametri `datastoreId` e per recuperare i valori dei metadati associati per `studyInstanceUID``seriesInstanceUID`, e. `sopInstanceUID` Per ulteriori informazioni, consulta [Ottenere i metadati del set di immagini](get-image-set-metadata.md). 1. Determinate i fotogrammi dell'immagine da recuperare dai metadati associati per formare il parametro. `frameList` Il `frameList` parametro è un elenco separato da virgole di uno o più numeri di frame non duplicati, in qualsiasi ordine. Ad esempio, il primo frame dell'immagine nei metadati sarà il frame 1. + Richiesta a frame singolo: `/frames/1` + Richiesta multi-frame: `/frames/1,2,3,4` 1. Costruisci un URL per la richiesta utilizzando i valori per`datastoreId`,,`studyInstanceUID`, `seriesInstanceUID` `sopInstanceUID``imageSetId`, e. `frameList` Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante **Copia**. L'URL ha il seguente formato: ``` 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. Prepara e invia la tua richiesta. `GetDICOMInstanceFrames`utilizza una richiesta HTTP GET con protocollo di [AWS firma Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). Il seguente esempio di codice utilizza lo strumento da riga di `curl` comando per ottenere frame di immagini in una `multipart` risposta da 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' ``` ------ **Nota** L'`transfer-syntax`UID è facoltativo e il valore predefinito è Explicit VR Little Endian se non è incluso. Se la transcodifica in ELE non è possibile (a causa dell'importazione con avviso), i pixel verranno restituiti senza transcodifica. Le sintassi di trasferimento supportate includono: Explicit VR Little Endian (ELE) - `1.2.840.10008.1.2.1` (impostazione predefinita per fotogrammi di immagini senza perdita di dati) In `transfer-syntax=*` tal caso, i fotogrammi dell'immagine verranno restituiti nella sintassi di trasferimento memorizzata. JPEG 2000 ad alta produttività con RPCL Options Image Compression (solo senza perdita di dati) - `1.2.840.10008.1.2.4.202` - se l'istanza è archiviata in HealthImaging `1.2.840.10008.1.2.4.202` JPEG 2000 Lossless - `1.2.840.10008.1.2.4.90` - se l'istanza è archiviata come lossless. HealthImaging JPEG Baseline (Process 1): sintassi di trasferimento predefinita per la compressione di immagini JPEG a 8 bit con perdita di dati - `1.2.840.10008.1.2.4.50` - se l'istanza è memorizzata in HealthImaging `1.2.840.10008.1.2.4.50` Compressione delle immagini JPEG 2000 - `1.2.840.10008.1.2.4.91` - se l'istanza è archiviata in HealthImaging `1.2.840.10008.1.2.4.91` Compressione delle immagini JPEG 2000 ad alta produttività - `1.2.840.10008.1.2.4.203` - se l'istanza è archiviata in HealthImaging `1.2.840.10008.1.2.4.203` Compressione dell'immagine JPEG XL - `1.2.840.10008.1.2.4.112` - se l'istanza è archiviata in HealthImaging `1.2.840.10008.1.2.4.112` Le istanze HealthImaging archiviate in uno o più frame di immagine codificati nella famiglia di [sintassi di trasferimento](supported-transfer-syntaxes.md) MPEG (che include MPEG2 MPEG-4 AVC/H.264 and HEVC/H .265) possono essere recuperate con il corrispondente UID della sintassi di trasferimento. Ad esempio, se l'istanza è archiviata come Main Profile Main Level. `1.2.840.10008.1.2.4.100` MPEG2 È possibile ricevere un 406 `NotAcceptableException` se la sintassi di trasferimento richiesta non può essere restituita in base alla sintassi di trasferimento memorizzata o se sono presenti avvisi di elaborazione specifici per l'istanza. In tal caso, riprova la chiamata con. `transfer-syntax=*` Per ulteriori informazioni, consultare [Sintassi di trasferimento supportate](supported-transfer-syntaxes.md) e [Librerie di decodifica di frame di immagini per AWS HealthImaging](reference-libraries.md).