

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Metadaten der DICOM-Serie abrufen von HealthImaging
<a name="dicomweb-retrieve-series-metadata"></a>

Verwenden Sie die `GetDICOMSeriesMetadata` Aktion, um die Metadaten für eine DICOM-Serie (`.json`Datei) aus einem HealthImaging [Datenspeicher](getting-started-concepts.md#concept-data-store) abzurufen. Sie können Serienmetadaten für jeden primären [Bilddatensatz](getting-started-concepts.md#concept-image-set) im HealthImaging Datenspeicher abrufen, indem Sie die Studie und die Serie angeben, die der Ressource UIDs zugeordnet sind. Sie können Serienmetadaten für Bilddatensätze abrufen, die nicht primär sind, indem Sie die Bilddatensatz-ID als Abfrageparameter angeben. Die Serienmetadaten werden im `DICOM JSON` Format zurückgegeben.

**Um Metadaten der DICOM-Serie abzurufen () `.json`**  


1. Werte sammeln HealthImaging `datastoreId` und `imageSetId` parametrieren.

1. Konstruieren Sie eine URL für die Anfrage, indem Sie die Werte für `datastoreId``studyInstanceUID`,`seriesInstanceUID`, und optional verwenden`imageSetId`. Scrollen Sie über die Schaltfläche **Kopieren**, um den gesamten URL-Pfad im folgenden Beispiel anzuzeigen. Die URL hat die Form:

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/metadata
   ```

1. Bereiten Sie Ihre Anfrage vor und senden Sie sie ab. `GetDICOMSeriesMetadata`verwendet eine HTTP-GET-Anfrage mit dem [AWS Signaturprotokoll Signature Version 4.](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) Das folgende Codebeispiel verwendet das `curl` Befehlszeilentool, um Metadaten (`.json`Datei) von abzurufen 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'
   ```

------

   Mit dem optionalen `imageSetId` Parameter. 

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

------
**Anmerkung**  
Der `imageSetId` Parameter ist erforderlich, um Serienmetadaten für nicht primäre Bilddatensätze abzurufen. Die `GetDICOMInstanceMetadata` Aktion gibt nur Serienmetadaten für primäre Bilddatensätze zurück, wenn die`datastoreId`,`studyInstanceUID`, angegeben `seriesInstanceUID` sind (ohne ein`imagesetID`).