As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Obtendo uma instância DICOM de HealthImaging Use a `GetDICOMInstance` ação para recuperar uma instância DICOM (`.dcm`arquivo) de um [armazenamento de HealthImaging dados](getting-started-concepts.md#concept-data-store) especificando a série, o estudo e a instância UIDs associados ao recurso. A API retornará somente instâncias dos conjuntos de imagens primários, a menos que o [parâmetro opcional do conjunto de imagens](getting-started-concepts.md#concept-image-set) seja fornecido. Você pode recuperar qualquer instância (de conjuntos de imagens primárias ou não primárias) no armazenamento de dados especificando o `imageSetId` como um parâmetro de consulta. Os dados DICOM podem ser recuperados em sua sintaxe de transferência armazenada ou no formato não compactado (ELE). **Para obter uma instância DICOM () `.dcm`** 1. Colete HealthImaging `datastoreId` e defina `imageSetId` parâmetros de valores. 1. Use a [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)ação com os valores dos `imageSetId` parâmetros `datastoreId` e para recuperar os valores de metadados associados para `studyInstanceUID``seriesInstanceUID`, e. `sopInstanceUID` Para obter mais informações, consulte [Obtendo metadados do conjunto de imagens](get-image-set-metadata.md). 1. Crie uma URL para a solicitação usando os valores para `datastoreId` `studyInstanceUID``seriesInstanceUID`,`sopInstanceUID`,, `imageSetId` e. Para ver todo o caminho do URL no exemplo a seguir, role até o botão **Copiar**. O URL tem o 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. Prepare e envie sua solicitação. `GetDICOMInstance`usa uma solicitação HTTP GET com o protocolo de [AWS assinatura Signature versão 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). O exemplo de código a seguir usa a ferramenta de linha de `curl` comando para obter uma instância DICOM (`.dcm`arquivo) de 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** O `transfer-syntax` UID é opcional e o padrão é Explicit VR Little Endian se não estiver incluído. As sintaxes de transferência suportadas incluem: Explicit VR Little Endian (ELE) - `1.2.840.10008.1.2.1` (padrão para quadros de imagem sem perdas) `transfer-syntax=*`Nesse caso, os quadros da imagem serão retornados na sintaxe de transferência armazenada. JPEG 2000 de alto rendimento com opções de compressão de imagem de RPCL (somente sem perdas) - `1.2.840.10008.1.2.4.202` - se a instância estiver armazenada como HealthImaging `1.2.840.10008.1.2.4.202` JPEG 2000 Lossless - `1.2.840.10008.1.2.4.90` - se a instância for armazenada como sem perdas. HealthImaging Linha de base JPEG (Processo 1): sintaxe de transferência padrão para compactação de imagem JPEG de 8 bits com perdas - `1.2.840.10008.1.2.4.50` - se a instância estiver armazenada em como HealthImaging `1.2.840.10008.1.2.4.50` Compressão de imagem JPEG 2000 - `1.2.840.10008.1.2.4.91` - se a instância estiver armazenada em HealthImaging como `1.2.840.10008.1.2.4.91` Compressão de imagem JPEG 2000 de alto rendimento - `1.2.840.10008.1.2.4.203` - se a instância estiver armazenada em como HealthImaging `1.2.840.10008.1.2.4.203` Compressão de imagem JPEG XL - `1.2.840.10008.1.2.4.112` - se a instância estiver armazenada em como HealthImaging `1.2.840.10008.1.2.4.112` Instâncias armazenadas HealthImaging com um ou mais quadros de imagem codificados na família MPEG de [sintaxes de transferência](supported-transfer-syntaxes.md) (que inclui MPEG-4 AVC/H.264 and HEVC/H .265) podem ser MPEG2 recuperadas com o UID de sintaxe de transferência correspondente. Por exemplo, `1.2.840.10008.1.2.4.100` se a instância for armazenada como Nível MPEG2 principal do perfil principal. Para obter mais informações, consulte [Sintaxes de transferência compatíveis](supported-transfer-syntaxes.md) e [Bibliotecas de decodificação de quadros de imagem para AWS HealthImaging](reference-libraries.md).