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 quadros de instância DICOM de HealthImaging Use a `GetDICOMInstanceFrames` ação para recuperar quadros de imagem individuais ou em lote (`multipart`solicitação) de uma instância DICOM em um [armazenamento de HealthImaging dados](getting-started-concepts.md#concept-data-store) especificando o UID da série, o UID do estudo, a instância e os números dos quadros UIDs associados a um recurso. Você pode especificar o [conjunto de imagens](getting-started-concepts.md#concept-image-set) do qual os quadros de instância devem ser recuperados fornecendo o ID do conjunto de imagens como um parâmetro de consulta. A API retornará somente quadros de instância 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 quadro de 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 quadros de instância DICOM () `multipart`** 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. Determine os quadros de imagem a serem recuperados dos metadados associados para formar o `frameList` parâmetro. O `frameList` parâmetro é uma lista separada por vírgula de um ou mais números de quadros não duplicados, em qualquer ordem. Por exemplo, o primeiro quadro de imagem nos metadados será o quadro 1. + Solicitação de quadro único: `/frames/1` + Solicitação de vários quadros: `/frames/1,2,3,4` 1. Crie uma URL para a solicitação usando os valores para `datastoreId` `studyInstanceUID``seriesInstanceUID`,`sopInstanceUID`,`imageSetId`,, `frameList` 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/frames/1?imageSetId=image-set-id ``` 1. Prepare e envie sua solicitação. `GetDICOMInstanceFrames`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 quadros de imagem em uma `multipart` resposta 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/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** O `transfer-syntax` UID é opcional e o padrão é Explicit VR Little Endian se não estiver incluído. Se a transcodificação para ELE não for viável (devido à importação com aviso), os pixels serão retornados sem transcodificação. 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. Você pode receber um 406 `NotAcceptableException` se a sintaxe de transferência solicitada não puder ser retornada com base na sintaxe de transferência armazenada ou se houver avisos de processamento específicos para a instância. Se isso ocorrer, repita a chamada com`transfer-syntax=*`. 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).