Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Recherche d'instances DICOM dans HealthImaging
<a name="dicomweb-search-instances"></a>

Utilisez l'`SearchDICOMInstances`API pour rechercher des instances DICOM dans un [magasin de HealthImaging données](getting-started-concepts.md#concept-data-store). Vous pouvez rechercher des instances DICOM en HealthImaging créant une URL qui inclut les éléments de données DICOM pris en charge (attributs). Les résultats de l'instance sont renvoyés au format JSON, triés par ordre croissant (du plus ancien au plus récent).

**Pour rechercher des instances DICOM**  


1. Collectez HealthImaging `region` et `datastoreId` valorisez. Pour de plus amples informations, veuillez consulter [Obtenir les propriétés du magasin de données](get-data-store.md).

1. Collectez des valeurs pour `StudyInstanceUID` et`SeriesInstanceUID`. Pour de plus amples informations, veuillez consulter [Obtenir les métadonnées d'un ensemble d'images](get-image-set-metadata.md).

1. Créez une URL pour la demande, y compris tous les éléments de recherche applicables. Pour afficher le chemin complet de l'URL dans l'exemple suivant, faites défiler le curseur sur le bouton **Copier**. L'URL est de la forme suivante :

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]
   ```  
**Éléments d'instance pour `SearchDICOMInstances`**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/healthimaging/latest/devguide/dicomweb-search-instances.html)

   HealthImaging utilise l'élément DICOM [(0008,1196) pour conserver les codes d'avertissement](https://dicom.nema.org/dicom/2013/output/chtml/part18/sect_6.6.html#sect_6.6.1.3.2.1.1) d'importation. Les codes d'avertissement d'importation sont consultables au niveau de l'instance. Les codes d'avertissement d'importation peuvent être recherchés à l'aide de caractères génériques ou de codes d'avertissement spécifiques. Consultez [HealthImaging Codes d'avertissement](reference-warning-codes.md).

1. Préparez et envoyez votre demande. `SearchDICOMInstances`utilise une requête HTTP GET avec le protocole de [AWS signature Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). L'exemple suivant utilise l'outil de ligne de `curl` commande pour rechercher des informations sur les instances 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
   ```

   Les résultats de recherche d'instance sont renvoyés au format JSON, `Instance Number (0020,0013)` triés par ordre croissant (du plus ancien au plus récent)

------