

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 de la série DICOM à partir de HealthImaging
<a name="dicomweb-retrieve-series-metadata"></a>

Utilisez cette `GetDICOMSeriesMetadata` action pour récupérer les métadonnées d'une série DICOM (`.json`fichier) dans un [magasin de HealthImaging données](getting-started-concepts.md#concept-data-store). Vous pouvez récupérer les métadonnées des séries pour n'importe quel [ensemble d'images](getting-started-concepts.md#concept-image-set) principal du magasin de HealthImaging données en spécifiant l'étude et la série UIDs associées à la ressource. Vous pouvez récupérer les métadonnées des séries pour les ensembles d'images non principaux en fournissant l'ID du jeu d'images en tant que paramètre de requête. Les métadonnées de la série sont renvoyées au `DICOM JSON` format.

**Pour obtenir les métadonnées de la série DICOM () `.json`**  


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

1. Construisez une URL pour la demande en utilisant les valeurs pour `datastoreId``studyInstanceUID`,`seriesInstanceUID`, et éventuellement`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/metadata
   ```

1. Préparez et envoyez votre demande. `GetDICOMSeriesMetadata`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 des métadonnées (`.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/metadata \
     --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 'series-metadata.json'
   ```

------

   Avec le `imageSetId` paramètre optionnel. 

------
#### [ 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/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' \
     --output 'series-metadata.json'
   ```

------
**Note**  
Le `imageSetId` paramètre est nécessaire pour récupérer les métadonnées des séries pour les ensembles d'images non principaux. L'`GetDICOMInstanceMetadata`action ne renverra les métadonnées de série pour les ensembles d'images principaux que si les `datastoreId``studyInstanceUID`, `seriesInstanceUID` sont spécifiés (sans un`imagesetID`).