

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á.

# Pesquisando as instâncias DICOM de um estudo em HealthImaging
<a name="dicomweb-search-study-instances"></a>

Use a `SearchDICOMStudyInstances` API para pesquisar todas as instâncias DICOM em um estudo em um [armazenamento de HealthImaging dados](getting-started-concepts.md#concept-data-store). Crie uma URL de solicitação com elementos de dados DICOM (atributos) compatíveis para filtrar os resultados. A API retorna os resultados da pesquisa de instâncias no formato JSON, ordenados pela data da última atualização, em ordem decrescente (da mais recente para a mais antiga).

**Para pesquisar as instâncias DICOM de um estudo**  


1. Colecione HealthImaging `region` e `datastoreId` valorize. Para obter mais informações, consulte [Obter propriedades do datastore](get-data-store.md).

1. Colete o `StudyInstanceUID` valor. 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, incluindo todos os elementos de pesquisa aplicáveis. O URL tem o formato:

   ```
   GET https://dicom-medical-imaging.{{region}}.amazonaws.com/datastore/{{datastoreId}}/studies/{{StudyInstanceUID}}/instances[?query]
   ```

   A tabela a seguir lista os elementos de dados DICOM (atributos) suportados.  
**Elementos de instância para `SearchDICOMStudyInstances`**    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/healthimaging/latest/devguide/dicomweb-search-study-instances.html)

1. Prepare e envie sua solicitação. `SearchDICOMStudyInstances`usa uma solicitação HTTP GET assinada com o [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). O exemplo a seguir usa a ferramenta de `curl` linha de comando. `{{region}}`Substitua pela sua AWS região. `{{datastoreId}}`Substitua pelo ID do seu armazenamento de dados. `{{StudyInstanceUID}}`Substitua pelo UID do estudo.

------
#### [ curl ]

   ```
   curl --request GET \
     "https://dicom-medical-imaging.{{region}}.amazonaws.com/datastore/{{datastoreId}}/studies/{{StudyInstanceUID}}/instances[?query]" \
     --aws-sigv4 'aws:amz:{{region}}:medical-imaging' \
     --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
     --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
     --header 'Accept: application/dicom+json' \
     --output results.json
   ```

------