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.

# Suche nach DICOM-Instanzen in HealthImaging
<a name="dicomweb-search-instances"></a>

[Verwenden Sie die `SearchDICOMInstances` API, um in einem Datenspeicher nach DICOM-Instanzen zu suchen. HealthImaging ](getting-started-concepts.md#concept-data-store) Sie können in nach DICOM-Instanzen suchen, HealthImaging indem Sie eine URL erstellen, die unterstützte DICOM-Datenelemente (Attribute) enthält. Die Instanzergebnisse werden im JSON-Format in aufsteigender Reihenfolge (vom ältesten zum neuesten) zurückgegeben.

**Um nach DICOM-Instanzen zu suchen**  


1. Sammeln HealthImaging `region` und `datastoreId` Werte. Weitere Informationen finden Sie unter [Eigenschaften des Datenspeichers abrufen](get-data-store.md).

1. Sammle Werte für `StudyInstanceUID` und`SeriesInstanceUID`. Weitere Informationen finden Sie unter [Metadaten von Bilddatensätzen abrufen](get-image-set-metadata.md).

1. Konstruieren Sie eine URL für die Anfrage, einschließlich aller zutreffenden Suchelemente. 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/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]
   ```  
**Instanzelemente für `SearchDICOMInstances`**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/healthimaging/latest/devguide/dicomweb-search-instances.html)

   HealthImaging verwendet das DICOM-Element [(0008,1196), um Import-Warncodes dauerhaft zu speichern](https://dicom.nema.org/dicom/2013/output/chtml/part18/sect_6.6.html#sect_6.6.1.3.2.1.1). Die Import-Warncodes können auf Instanzebene durchsucht werden. Importwarncodes können mit Platzhaltern oder bestimmten Warncodes durchsucht werden. Siehe [HealthImaging Warncodes](reference-warning-codes.md).

1. Bereiten Sie Ihre Anfrage vor und senden Sie sie ab. `SearchDICOMInstances`verwendet eine HTTP-GET-Anfrage mit dem [AWS Signaturprotokoll Signature Version 4.](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) Im folgenden Beispiel wird das `curl` Befehlszeilentool verwendet, um nach Informationen über DICOM-Instanzen zu suchen.

------
#### [ curl ]

   ```
   curl --request GET \
     "https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]"
     --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 results.json
   ```

   Die Ergebnisse der Instanzsuche werden im JSON-Format zurückgegeben, sortiert nach `Instance Number (0020,0013)` aufsteigender Reihenfolge (vom ältesten zum neuesten)

------