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.

# Rechercher les instances DICOM d'une étude dans HealthImaging
<a name="dicomweb-search-study-instances"></a>

Utilisez l'`SearchDICOMStudyInstances`API pour rechercher toutes les instances DICOM d'une étude dans un [magasin de HealthImaging données](getting-started-concepts.md#concept-data-store). Créez une URL de demande avec les éléments de données DICOM pris en charge (attributs) pour filtrer les résultats. L'API renvoie les résultats de recherche d'instance au format JSON, triés par date de dernière mise à jour, en ordre décroissant (du plus récent au plus ancien).

**Pour rechercher les instances DICOM d'une étude**  


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 la `StudyInstanceUID` valeur. 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. L'URL est de la forme suivante :

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

   Le tableau suivant répertorie les éléments de données DICOM pris en charge (attributs).  
**Éléments d'instance pour `SearchDICOMStudyInstances`**    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/healthimaging/latest/devguide/dicomweb-search-study-instances.html)

1. Préparez et envoyez votre demande. `SearchDICOMStudyInstances`utilise une requête HTTP GET signée avec [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). L'exemple suivant utilise l'outil de `curl` ligne de commande. Remplacez `{{region}}` par votre AWS région. `{{datastoreId}}`Remplacez-le par l'identifiant de votre banque de données. Remplacez `{{StudyInstanceUID}}` par l'UID de l'étude.

------
#### [ 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
   ```

------