Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Obtener una instancia DICOM de HealthImaging Utilice la `GetDICOMInstance` acción para recuperar una instancia (`.dcm`archivo) DICOM de un [almacén de HealthImaging datos](getting-started-concepts.md#concept-data-store) especificando la serie, el estudio y la instancia UIDs asociados al recurso. La API solo devolverá instancias de conjuntos de imágenes principales, a menos que se proporcione el [parámetro de conjunto de imágenes](getting-started-concepts.md#concept-image-set) opcional. Puede recuperar cualquier instancia (de conjuntos de imágenes principales o no principales) del almacén de datos especificándola `imageSetId` como parámetro de consulta. Los datos DICOM se pueden recuperar en su sintaxis de transferencia almacenada o en formato sin comprimir (ELE). **Para obtener una instancia DICOM () `.dcm`** 1. Recopile valores HealthImaging `datastoreId` y `imageSetId` parametrice. 1. Utilice la [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)acción con los valores de los `imageSetId` parámetros `datastoreId` y para recuperar los valores de metadatos asociados para `studyInstanceUID``seriesInstanceUID`, y`sopInstanceUID`. Para obtener más información, consulte [Obtención de metadatos de conjuntos de imágenes](get-image-set-metadata.md). 1. Cree una URL para la solicitud con los valores de `datastoreId` `studyInstanceUID``seriesInstanceUID`,`sopInstanceUID`, y`imageSetId`. Para ver la ruta URL completa en el siguiente ejemplo, desplázate sobre el botón **Copiar**. La URL tiene el siguiente formato: ``` 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. Prepara y envía tu solicitud. `GetDICOMInstance`utiliza una solicitud HTTP GET con el protocolo de [AWS firma Signature versión 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). En el siguiente ejemplo de código, se utiliza la herramienta de línea de `curl` comandos para obtener una instancia (`.dcm`archivo) DICOM. 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?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' ``` ------ **nota** El `transfer-syntax` UID es opcional y, si no se incluye, el valor predeterminado es Explicit VR Little Endian. Las sintaxis de transferencia compatibles incluyen: Explicit VR Little Endian (ELE): `1.2.840.10008.1.2.1` (predeterminado para marcos de imagen sin pérdidas) En `transfer-syntax=*` ese caso, los fotogramas de la imagen se devolverán con la sintaxis de transferencia almacenada. Compresión de imagen JPEG 2000 de alto rendimiento con opciones de RPCL (solo sin pérdidas): `1.2.840.10008.1.2.4.202` - si la instancia está almacenada en HealthImaging `1.2.840.10008.1.2.4.202` JPEG 2000 sin pérdidas: `1.2.840.10008.1.2.4.90` - si la instancia está almacenada como sin pérdidas. HealthImaging Línea base de JPEG (proceso 1): sintaxis de transferencia predeterminada para la compresión de imágenes JPEG de 8 bits con pérdidas: `1.2.840.10008.1.2.4.50` - si la instancia está almacenada en HealthImaging `1.2.840.10008.1.2.4.50` Compresión de imagen JPEG 2000`1.2.840.10008.1.2.4.91`: - si la instancia está almacenada en HealthImaging `1.2.840.10008.1.2.4.91` Compresión de imágenes JPEG 2000 de alto rendimiento: `1.2.840.10008.1.2.4.203` - si la instancia está almacenada en HealthImaging `1.2.840.10008.1.2.4.203` Compresión de imágenes JPEG XL`1.2.840.10008.1.2.4.112`: - si la instancia está almacenada en HealthImaging `1.2.840.10008.1.2.4.112` Las instancias almacenadas HealthImaging con uno o más fotogramas de imagen codificados en la familia de [sintaxis de transferencia](supported-transfer-syntaxes.md) MPEG (que incluye MPEG2 MPEG-4 AVC/H.264 and HEVC/H .265) se pueden recuperar con el UID de sintaxis de transferencia correspondiente. Por ejemplo, `1.2.840.10008.1.2.4.100` si la instancia se almacena como nivel principal del perfil principal. MPEG2 Para obtener más información, consulte [Sintaxis de transferencia compatibles](supported-transfer-syntaxes.md) y [Bibliotecas de decodificación de marcos de imágenes para AWS HealthImaging](reference-libraries.md).