

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

[Use a `GetDICOMSeriesMetadata` ação para recuperar os metadados de uma série DICOM (`.json`arquivo) de um HealthImaging armazenamento de dados.](getting-started-concepts.md#concept-data-store) Você pode recuperar metadados da série para qualquer [conjunto de imagens](getting-started-concepts.md#concept-image-set) primárias no armazenamento de HealthImaging dados especificando o estudo e a série UIDs associados ao recurso. Você pode recuperar metadados da série para conjuntos de imagens não primárias fornecendo o ID do conjunto de imagens como um parâmetro de consulta. Os metadados da série são retornados em `DICOM JSON` formato.

**Para obter metadados da série DICOM () `.json`**  


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

1. Crie uma URL para a solicitação usando os valores para`datastoreId`, `studyInstanceUID``seriesInstanceUID`, e opcionalmente`imageSetId`. 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/metadata
   ```

1. Prepare e envie sua solicitação. `GetDICOMSeriesMetadata`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) 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'
   ```

------

   Com o `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**  
O `imageSetId` parâmetro é necessário para recuperar metadados da série para conjuntos de imagens não primárias. A `GetDICOMInstanceMetadata` ação só retornará metadados de série para conjuntos de imagens primárias se`datastoreId`,`studyInstanceUID`, `seriesInstanceUID` forem especificados (sem um`imagesetID`).