As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Obtendo metadados da instância DICOM de HealthImaging
<a name="dicomweb-retrieve-instance-metadata"></a>

Use a `GetDICOMInstanceMetadata` ação para recuperar os metadados de uma instância DICOM em um [armazenamento de HealthImaging dados](getting-started-concepts.md#concept-data-store) especificando a série, o estudo e a instância UIDs associados ao recurso. A API só retornará metadados de instância dos conjuntos de imagens primários, a menos que o parâmetro opcional do [conjunto de imagens](getting-started-concepts.md#concept-image-set) seja fornecido. Você pode recuperar qualquer metadado de instância (de conjuntos de imagens primárias ou não primárias) no armazenamento de dados especificando o `imageSetId` como um parâmetro de consulta.

**Para obter metadados da instância DICOM () `.json`**  


1. Colete HealthImaging `datastoreId` e defina `imageSetId` parâmetros de valores.

1. Use a [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)ação com os valores dos `imageSetId` parâmetros `datastoreId` e para recuperar os valores de metadados associados para `studyInstanceUID``seriesInstanceUID`, e. `sopInstanceUID` Para obter mais informações, consulte [Obtendo metadados do conjunto de imagens](get-image-set-metadata.md).

1. Crie uma URL para a solicitação usando os valores para `datastoreId` `studyInstanceUID``seriesInstanceUID`,`sopInstanceUID`,, `imageSetId` e. Para ver todo o caminho do URL no exemplo a seguir, role até o botão **Copiar**. O URL tem o 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. Prepare e envie sua solicitação. `GetDICOMInstanceMetadata`usa uma solicitação HTTP GET com o protocolo de [AWS assinatura Signature versão 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). O exemplo de código a seguir usa a ferramenta de linha de `curl` comando para obter metadados (`.json`arquivo) da instância DICOM. 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**  
O UID da sintaxe de transferência indicado nos metadados corresponde ao UID da sintaxe de transferência armazenado () em. `StoredTransferSyntaxUID` HealthImaging