Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Ottenere i metadati dell'istanza DICOM da HealthImaging
<a name="dicomweb-retrieve-instance-metadata"></a>

Usa l'`GetDICOMInstanceMetadata`azione per recuperare i metadati da un'istanza DICOM in un HealthImaging [data store](getting-started-concepts.md#concept-data-store) specificando la serie, lo studio e l'istanza associati alla risorsa. UIDs L'API restituirà solo i metadati dell'istanza dai set di immagini primari, a meno che non venga fornito il parametro opzionale del set di [immagini](getting-started-concepts.md#concept-image-set). È possibile recuperare i metadati di qualsiasi istanza (da set di immagini primari o non primari) nel data store specificandoli come parametro di query. `imageSetId`

**Per ottenere i metadati dell'istanza DICOM () `.json`**  


1. Raccogli HealthImaging `datastoreId` e `imageSetId` parametra i valori.

1. Utilizzate l'[https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)azione con i valori `imageSetId` dei parametri `datastoreId` e per recuperare i valori dei metadati associati per `studyInstanceUID``seriesInstanceUID`, e. `sopInstanceUID` Per ulteriori informazioni, consulta [Ottenere i metadati del set di immagini](get-image-set-metadata.md).

1. Costruisci un URL per la richiesta utilizzando i valori per`datastoreId`,, `studyInstanceUID``seriesInstanceUID`, `sopInstanceUID` e. `imageSetId` Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante **Copia**. L'URL ha il seguente 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 e invia la tua richiesta. `GetDICOMInstanceMetadata`utilizza una richiesta HTTP GET con protocollo di [AWS firma Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). Il seguente esempio di codice utilizza lo strumento a riga di `curl` comando per ottenere i metadati (`.json`file) dell'istanza DICOM da. 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'
   ```

------
**Nota**  
L'UID della sintassi di trasferimento indicato nei metadati corrisponde allo Stored Transfer Syntax UID () in. `StoredTransferSyntaxUID` HealthImaging