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 dados em massa DICOM de HealthImaging
<a name="dicom-retrieve-bulkdata"></a>

Use a `GetDICOMBulkdata` ação para recuperar dados binários que foram separados dos metadados DICOM em um HealthImaging armazenamento de dados. Ao recuperar metadados de instâncias ou séries, atributos binários maiores que 1 MB serão representados por um `BulkDataURI` em vez de valores embutidos. Você pode recuperar os dados binários de qualquer conjunto de imagens primárias no armazenamento de HealthImaging dados usando o `BulkDataURI` fornecido na resposta de metadados. Você pode recuperar dados em massa para conjuntos de imagens não primárias fornecendo o ID do conjunto de imagens como um parâmetro de consulta.

**Para obter dados em massa do DICOM**  


Quando você recupera metadados DICOM de uma ação do HealthImaging DICOMweb WADO-RS, como `GetDICOMInstanceMetadata` ou`GetDICOMSeriesMetadata`, atributos binários grandes serão substituídos em linha por, conforme mostrado abaixo: BulkData URIs

```
"00451026": {
    "vr": "UN",
    "BulkDataURI": "https://dicom-medical-imaging.us-west-2.amazonaws.com/datastore/<datastoreId>/studies/<StudyInstanceUID>/series/<SeriesInstanceUID>/instances/<SOPInstanceUID>/bulkdata/<bulkdataUriHash>"
}
```

Para recuperar um elemento DICOM com a `GetDICOMBulkdata` ação, use as etapas a seguir.

1. Crie uma URL para a solicitação usando os valores do`BulkDataURI`, do formato:

   ```
   https://dicom-medical-imaging.{{region}}.amazonaws.com/datastore/{{datastore-id}}/studies/{{study-instance-uid}}/series/{{series-instance-uid}}/instances/{{sop-instance-uid}}/bulkdata/{{bulkdata-uri-hash}}
   ```

1. Emita seu `GetDICOMBulkdata` comando como uma solicitação HTTP GET com o protocolo de [assinatura AWS 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 recuperar um elemento DICOM de um conjunto de imagens primário:

   ```
   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.2.840.10008.5.1.4.1.1.7/bulkdata/b026324c6904b2a9cb4b88d6d61c81d1' \
     --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/octet-stream' \
     --output 'bulkdata.bin'
   ```

   Para recuperar um elemento de dados DICOM de um conjunto de imagens não primário, forneça um parâmetro: `ImageSetId`

   ```
   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.2.840.10008.5.1.4.1.1.7/bulkdata/b026324c6904b2a9cb4b88d6d61c81d1?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/octet-stream' \
     --output 'bulkdata.bin'
   ```

**nota**  
O `imageSetId` parâmetro é necessário para recuperar dados em massa para conjuntos de imagens não primárias. A DICOMBulkdata ação Obter só retornará dados em massa para conjuntos de imagens primárias se`datastoreId`, `studyInstanceUID``seriesInstanceUID`, e `SOPInstanceUID` forem especificados (sem um`imagesetID`).