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.

# Obtener metadatos de instancias DICOM de HealthImaging
<a name="dicomweb-retrieve-instance-metadata"></a>

Utilice la `GetDICOMInstanceMetadata` acción para recuperar los metadatos de una instancia DICOM en un [almacén de HealthImaging datos](getting-started-concepts.md#concept-data-store) especificando la serie, el estudio y la instancia UIDs asociados al recurso. La API solo devolverá los metadatos de las instancias de los conjuntos de imágenes principales, a menos que se proporcione el parámetro de [conjunto de imágenes](getting-started-concepts.md#concept-image-set) opcional. Puede recuperar cualquier metadato de la instancia (de conjuntos de imágenes principales o no principales) del almacén de datos especificándolo `imageSetId` como parámetro de consulta.

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


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

1. Utilice la [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)acción con los valores de los `imageSetId` parámetros `datastoreId` y para recuperar los valores de metadatos asociados para `studyInstanceUID``seriesInstanceUID`, y`sopInstanceUID`. Para obtener más información, consulte [Obtención de metadatos de conjuntos de imágenes](get-image-set-metadata.md).

1. Cree una URL para la solicitud con los valores de `datastoreId` `studyInstanceUID``seriesInstanceUID`,`sopInstanceUID`, y`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}}/instances/{{sop-instance-uid}}/metadata?imageSetId={{image-set-id}}
   ```

1. Prepara y envía tu solicitud. `GetDICOMInstanceMetadata`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). El siguiente ejemplo de código utiliza la herramienta de línea de `curl` comandos para obtener los metadatos (`.json`archivo) de HealthImaging la instancia DICOM.

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

------
**nota**  
El UID de sintaxis de transferencia indicado en los metadatos coincide con el UID de sintaxis de transferencia almacenado () `StoredTransferSyntaxUID` de. HealthImaging