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.

# Obtenir les métadonnées d'une instance DICOM à partir de HealthImaging
<a name="dicomweb-retrieve-instance-metadata"></a>

Utilisez cette `GetDICOMInstanceMetadata` action pour récupérer les métadonnées d'une instance DICOM dans un [magasin de HealthImaging données](getting-started-concepts.md#concept-data-store) en spécifiant la série, l'étude et l'instance UIDs associées à la ressource. L'API ne renvoie les métadonnées d'instance qu'à partir des ensembles d'images principaux, sauf si le paramètre optionnel [d'ensemble d'images](getting-started-concepts.md#concept-image-set) est fourni. Vous pouvez récupérer toutes les métadonnées d'instance (à partir de jeux d'images principaux ou non principaux) dans le magasin de données en les spécifiant en `imageSetId` tant que paramètre de requête.

**Pour obtenir les métadonnées d'une instance DICOM () `.json`**  


1. Collectez HealthImaging `datastoreId` et `imageSetId` paramétrez les valeurs.

1. Utilisez l'[https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)action avec les valeurs `datastoreId` des `imageSetId` paramètres et pour récupérer les valeurs de métadonnées associées pour `studyInstanceUID``seriesInstanceUID`, et`sopInstanceUID`. 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 en utilisant les valeurs pour `datastoreId``studyInstanceUID`,`seriesInstanceUID`,`sopInstanceUID`, et`imageSetId`. 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/{{datastore-id}}/studies/{{study-instance-uid}}/series/{{series-instance-uid}}/instances/{{sop-instance-uid}}/metadata?imageSetId={{image-set-id}}
   ```

1. Préparez et envoyez votre demande. `GetDICOMInstanceMetadata`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 de code suivant utilise l'outil de ligne de `curl` commande pour obtenir les métadonnées d'une instance DICOM (`.json`fichier) à partir de HealthImaging.

------
#### [ Shell ]

   ```
   curl --request GET \
     'https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/d9a2a515ab294163a2d2f4069eed584c/studies/1.3.6.1.4.1.5962.1.2.4.20040826285059.5457/series/1.3.6.1.4.1.5962.1.3.4.1.20040825185059.5457/instances/1.3.6.1.4.1.5962.1.1.4.1.1.20040826186059.5457/metadata?imageSetId=459e50687f121185f747b67bb60d1bc8' \
     --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'
   ```

------
**Note**  
L'UID de syntaxe de transfert indiqué dans les métadonnées correspond à l'UID de syntaxe de transfert stocké (`StoredTransferSyntaxUID`) dans. HealthImaging