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 instâncias DICOM em HealthImaging
<a name="dicomweb-search-instances"></a>

Use a `SearchDICOMInstances` API para pesquisar instâncias DICOM em um [armazenamento de HealthImaging dados](getting-started-concepts.md#concept-data-store). Você pode pesquisar instâncias DICOM criando uma URL que inclua elementos de dados DICOM compatíveis (atributos). HealthImaging Os resultados da instância são retornados no formato JSON, ordenados em ordem crescente (do mais antigo para o mais recente).

**Para pesquisar instâncias DICOM**  


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

1. Colete valores para `StudyInstanceUID` `SeriesInstanceUID` e. 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. 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/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]
   ```  
**Elementos de instância para `SearchDICOMInstances`**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/healthimaging/latest/devguide/dicomweb-search-instances.html)

   HealthImaging usa o elemento DICOM [(0008,1196)](https://dicom.nema.org/dicom/2013/output/chtml/part18/sect_6.6.html#sect_6.6.1.3.2.1.1) para manter os códigos de aviso de importação. Os códigos de aviso de importação podem ser pesquisados no nível da instância. Os códigos de aviso de importação podem ser pesquisados com caracteres curinga ou códigos de aviso específicos. Consulte [HealthImaging Códigos de aviso](reference-warning-codes.md).

1. Prepare e envie sua solicitação. `SearchDICOMInstances`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 a seguir usa a ferramenta de linha de `curl` comando para pesquisar informações sobre instâncias DICOM.

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

   ```
   curl --request GET \
     "https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]"
     --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+json' \
     --output results.json
   ```

   Os resultados da pesquisa de instâncias são retornados no formato JSON, ordenados por `Instance Number (0020,0013)` ordem crescente (do mais antigo para o mais recente)

------