Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Ricerca di istanze DICOM in HealthImaging
<a name="dicomweb-search-instances"></a>

[Usa l'`SearchDICOMInstances`API per cercare istanze DICOM in un archivio dati. HealthImaging ](getting-started-concepts.md#concept-data-store) Puoi cercare istanze DICOM in creando un URL che HealthImaging includa elementi di dati DICOM supportati (attributi). I risultati dell'istanza vengono restituiti in formato JSON, ordinati in ordine crescente (dal più vecchio al più recente).

**Per cercare istanze DICOM**  


1. Raccolta HealthImaging `region` e valori. `datastoreId` Per ulteriori informazioni, consulta [Ottenere le proprietà del data store](get-data-store.md).

1. Raccogli valori per `StudyInstanceUID` e`SeriesInstanceUID`. Per ulteriori informazioni, consulta [Ottenere i metadati del set di immagini](get-image-set-metadata.md).

1. Costruisci un URL per la richiesta, inclusi tutti gli elementi di ricerca applicabili. Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante **Copia**. L'URL ha il seguente formato:

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]
   ```  
**Elementi di istanza per `SearchDICOMInstances`**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/healthimaging/latest/devguide/dicomweb-search-instances.html)

   HealthImaging utilizza l'elemento DICOM [(0008,1196) per rendere persistenti i codici di avviso di importazione](https://dicom.nema.org/dicom/2013/output/chtml/part18/sect_6.6.html#sect_6.6.1.3.2.1.1). I codici di avviso di importazione sono ricercabili a livello di istanza. I codici di avviso di importazione possono essere ricercati utilizzando caratteri jolly o codici di avviso specifici. Per informazioni, consulta [HealthImaging Codici di avviso](reference-warning-codes.md).

1. Prepara e invia la tua richiesta. `SearchDICOMInstances`utilizza una richiesta HTTP GET con protocollo di [AWS firma Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). L'esempio seguente utilizza lo strumento da riga di `curl` comando per cercare informazioni sulle istanze 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
   ```

   I risultati della ricerca delle istanze vengono restituiti in formato JSON, ordinati `Instance Number (0020,0013)` in ordine crescente (dalla più vecchia alla più recente)

------