

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Obtención de metadatos de la serie DICOM de HealthImaging
<a name="dicomweb-retrieve-series-metadata"></a>

Utilice esta `GetDICOMSeriesMetadata` acción para recuperar los metadatos de una serie (`.json`archivo) DICOM de un almacén de HealthImaging [datos](getting-started-concepts.md#concept-data-store). Puede recuperar los metadatos de las series de cualquier [conjunto de imágenes](getting-started-concepts.md#concept-image-set) principal del HealthImaging banco de datos especificando el estudio y la serie UIDs asociados al recurso. Puede recuperar los metadatos de las series de conjuntos de imágenes no principales proporcionando el ID del conjunto de imágenes como parámetro de consulta. Los metadatos de la serie se devuelven en `DICOM JSON` formato.

**Para obtener los metadatos de la serie DICOM () `.json`**  


1. Recopile valores HealthImaging `datastoreId` y `imageSetId` parametrice.

1. Cree una URL para la solicitud con los valores de`datastoreId`,, y `studyInstanceUID``seriesInstanceUID`, de forma opcional`imageSetId`. Para ver la ruta URL completa en el siguiente ejemplo, desplázate sobre el botón **Copiar**. La URL tiene el siguiente formato:

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/metadata
   ```

1. Prepara y envía tu solicitud. `GetDICOMSeriesMetadata`utiliza una solicitud HTTP GET con el protocolo de [AWS firma Signature versión 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). En el siguiente ejemplo de código se utiliza la herramienta de línea de `curl` comandos para obtener metadatos (`.json`archivos) 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'
   ```

------

   Con el `imageSetId` parámetro opcional. 

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

------
**nota**  
El `imageSetId` parámetro es necesario para recuperar los metadatos de las series de conjuntos de imágenes no principales. La `GetDICOMInstanceMetadata` acción solo devolverá los metadatos de la serie para los conjuntos de imágenes principales si `seriesInstanceUID` se especifican los valores `datastoreId``studyInstanceUID`,, (sin un`imagesetID`).