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.
# HealthImaging Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren HealthImaging.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `copy-image-set`
Das folgende Codebeispiel zeigt, wie Sie`copy-image-set`.
**AWS CLI**
**Beispiel 1: So kopieren Sie einen Bildsatz ohne Ziel.**
Im folgenden Beispiel für `copy-image-set` wird eine doppelte Kopie eines Bildersatzes ohne Ziel erstellt.
```
aws medical-imaging copy-image-set \
--datastore-id 12345678901234567890123456789012 \
--source-image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--copy-image-set-information '{"sourceImageSet": {"latestVersionId": "1" } }'
```
Ausgabe:
```
{
"destinationImageSetProperties": {
"latestVersionId": "2",
"imageSetWorkflowStatus": "COPYING",
"updatedAt": 1680042357.432,
"imageSetId": "b9a06fef182a5f992842f77f8e0868e5",
"imageSetState": "LOCKED",
"createdAt": 1680042357.432
},
"sourceImageSetProperties": {
"latestVersionId": "1",
"imageSetWorkflowStatus": "COPYING_WITH_READ_ONLY_ACCESS",
"updatedAt": 1680042357.432,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436
},
"datastoreId": "12345678901234567890123456789012"
}
```
**Beispiel 2: So kopieren Sie einen Bildersatz mit Ziel.**
Im folgenden Beispiel für `copy-image-set` wird eine doppelte Kopie eines Bildersatzes mit Ziel erstellt.
```
aws medical-imaging copy-image-set \
--datastore-id 12345678901234567890123456789012 \
--source-image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--copy-image-set-information '{"sourceImageSet": {"latestVersionId": "1" }, "destinationImageSet": { "imageSetId": "b9a06fef182a5f992842f77f8e0868e5", "latestVersionId": "1"} }'
```
Ausgabe:
```
{
"destinationImageSetProperties": {
"latestVersionId": "2",
"imageSetWorkflowStatus": "COPYING",
"updatedAt": 1680042505.135,
"imageSetId": "b9a06fef182a5f992842f77f8e0868e5",
"imageSetState": "LOCKED",
"createdAt": 1680042357.432
},
"sourceImageSetProperties": {
"latestVersionId": "1",
"imageSetWorkflowStatus": "COPYING_WITH_READ_ONLY_ACCESS",
"updatedAt": 1680042505.135,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436
},
"datastoreId": "12345678901234567890123456789012"
}
```
**Beispiel 3: So kopieren Sie eine Teilmenge von Instances aus einem Quellbildersatz in einen Zielbildersatz.**
Im folgenden Beispiel für `copy-image-set` wird eine DICOM-Instance aus dem Quellbildersatz in den Zielbildersatz kopiert. Der force-Parameter dient dazu, Inkonsistenzen in den Attributen auf Patienten-, Studien- und Serienebene zu überschreiben.
```
aws medical-imaging copy-image-set \
--datastore-id 12345678901234567890123456789012 \
--source-image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--copy-image-set-information '{"sourceImageSet": {"latestVersionId": "1","DICOMCopies": {"copiableAttributes": "{\"SchemaVersion\":\"1.1\",\"Study\":{\"Series\":{\"1.3.6.1.4.1.5962.99.1.3673257865.2104868982.1369432891697.3666.0\":{\"Instances\":{\"1.3.6.1.4.1.5962.99.1.3673257865.2104868982.1369432891697.3669.0\":{}}}}}}"}},"destinationImageSet": {"imageSetId": "b9eb50d8ee682eb9fcf4acbf92f62bb7","latestVersionId": "1"}}' \
--force
```
Ausgabe:
```
{
"destinationImageSetProperties": {
"latestVersionId": "2",
"imageSetWorkflowStatus": "COPYING",
"updatedAt": 1680042505.135,
"imageSetId": "b9eb50d8ee682eb9fcf4acbf92f62bb7",
"imageSetState": "LOCKED",
"createdAt": 1680042357.432
},
"sourceImageSetProperties": {
"latestVersionId": "1",
"imageSetWorkflowStatus": "COPYING_WITH_READ_ONLY_ACCESS",
"updatedAt": 1680042505.135,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436
},
"datastoreId": "12345678901234567890123456789012"
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Kopieren eines Bildsatzes](https://docs.aws.amazon.com/healthimaging/latest/devguide/copy-image-set.html).
+ Einzelheiten zur API finden Sie [CopyImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/copy-image-set.html)in der *AWS CLI Befehlsreferenz*.
### `create-datastore`
Das folgende Codebeispiel zeigt die Verwendung`create-datastore`.
**AWS CLI**
**Beispiel 1: Um einen Datenspeicher zu erstellen**
Im folgenden Codebeispiel für `create-datastore` wird ein Datenspeicher mit dem Namen `my-datastore` erstellt. Wenn Sie einen Datenspeicher ohne Angabe von a erstellen`--lossless-storage-format`, wird AWS HealthImaging standardmäßig HTJ2 K (High Throughput JPEG 2000) verwendet.
```
aws medical-imaging create-datastore \
--datastore-name "my-datastore"
```
Ausgabe:
```
{
"datastoreId": "12345678901234567890123456789012",
"datastoreStatus": "CREATING"
}
```
**Beispiel 2: So erstellen Sie einen Datenspeicher mit dem verlustfreien JPEG 2000-Speicherformat**
Ein Datenspeicher, der mit dem verlustfreien Speicherformat JPEG 2000 konfiguriert ist, transkodiert und speichert verlustfreie Bildframes im JPEG 2000-Format. Bildframes können dann ohne Transcodierung im Format JPEG 2000 Lossless abgerufen werden. Im folgenden `create-datastore` Codebeispiel wird ein für das verlustfreies JPEG 2000-Speicherformat konfigurierter Datenspeicher mit dem Namen `my-datastore` erstellt.
```
aws medical-imaging create-datastore \
--datastore-name "my-datastore" \
--lossless-storage-format JPEG_2000_LOSSLESS
```
Ausgabe:
```
{
"datastoreId": "12345678901234567890123456789012",
"datastoreStatus": "CREATING"
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Erstellen eines Datenspeichers](https://docs.aws.amazon.com/healthimaging/latest/devguide/create-data-store.html).
+ Einzelheiten zur API finden Sie [CreateDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/create-datastore.html)unter *AWS CLI Befehlsreferenz*.
### `delete-datastore`
Das folgende Codebeispiel zeigt die Verwendung`delete-datastore`.
**AWS CLI**
**So löschen Sie einen Datenspeicher**
Im folgenden Codebeispiel für `delete-datastore` wird ein Datenspeicher gelöscht.
```
aws medical-imaging delete-datastore \
--datastore-id "12345678901234567890123456789012"
```
Ausgabe:
```
{
"datastoreId": "12345678901234567890123456789012",
"datastoreStatus": "DELETING"
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Löschen eines Datenspeichers](https://docs.aws.amazon.com/healthimaging/latest/devguide/delete-data-store.html).
+ Einzelheiten zur API finden Sie [DeleteDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/delete-datastore.html)in der *AWS CLI Befehlsreferenz*.
### `delete-image-set`
Das folgende Codebeispiel zeigt die Verwendung`delete-image-set`.
**AWS CLI**
**So löschen Sie einen Bildersatz**
Im folgenden Codebeispiel für `delete-image-set` wird ein Bildersatz gelöscht.
```
aws medical-imaging delete-image-set \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e
```
Ausgabe:
```
{
"imageSetWorkflowStatus": "DELETING",
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"datastoreId": "12345678901234567890123456789012"
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Löschen eines Bildsatzes](https://docs.aws.amazon.com/healthimaging/latest/devguide/delete-image-set.html).
+ Einzelheiten zur API finden Sie [DeleteImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/delete-image-set.html)in der *AWS CLI Befehlsreferenz*.
### `get-datastore`
Das folgende Codebeispiel zeigt die Verwendung`get-datastore`.
**AWS CLI**
**Beispiel 1: Um die Eigenschaften eines Datenspeichers abzurufen**
Im folgenden Codebeispiel für `get-datastore` werden die Eigenschaften eines Datenspeichers abgerufen.
```
aws medical-imaging get-datastore \
--datastore-id 12345678901234567890123456789012
```
Ausgabe:
```
{
"datastoreProperties": {
"datastoreId": "12345678901234567890123456789012",
"datastoreName": "TestDatastore123",
"datastoreStatus": "ACTIVE",
"losslessStorageFormat": "HTJ2K"
"datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012",
"createdAt": "2022-11-15T23:33:09.643000+00:00",
"updatedAt": "2022-11-15T23:33:09.643000+00:00"
}
}
```
**Beispiel 2: Um die Eigenschaften eines Datenspeichers zu konfigurieren für JPEG2000**
Im folgenden `get-datastore` Codebeispiel werden die Eigenschaften eines Datenspeichers für einen Datenspeicher abgerufen, der für das Format JPEG 2000 Lossless konfiguriert ist.
```
aws medical-imaging get-datastore \
--datastore-id 12345678901234567890123456789012
```
Ausgabe:
```
{
"datastoreProperties": {
"datastoreId": "12345678901234567890123456789012",
"datastoreName": "TestDatastore123",
"datastoreStatus": "ACTIVE",
"losslessStorageFormat": "JPEG_2000_LOSSLESS",
"datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012",
"createdAt": "2022-11-15T23:33:09.643000+00:00",
"updatedAt": "2022-11-15T23:33:09.643000+00:00"
}
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Abrufen von Datenspeichereigenschaften](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-data-store.html).
+ Einzelheiten zur API finden Sie [GetDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-datastore.html)in der *AWS CLI Befehlsreferenz*.
### `get-dicom-import-job`
Das folgende Codebeispiel zeigt die Verwendung`get-dicom-import-job`.
**AWS CLI**
**So rufen Sie die Eigenschaften eines DICOM-Importauftrags ab**
Im folgenden Codebeispiel für `get-dicom-import-job` werden die Eigenschaften eines DICOM-Importauftrags abgerufen.
```
aws medical-imaging get-dicom-import-job \
--datastore-id "12345678901234567890123456789012" \
--job-id "09876543210987654321098765432109"
```
Ausgabe:
```
{
"jobProperties": {
"jobId": "09876543210987654321098765432109",
"jobName": "my-job",
"jobStatus": "COMPLETED",
"datastoreId": "12345678901234567890123456789012",
"dataAccessRoleArn": "arn:aws:iam::123456789012:role/ImportJobDataAccessRole",
"endedAt": "2022-08-12T11:29:42.285000+00:00",
"submittedAt": "2022-08-12T11:28:11.152000+00:00",
"inputS3Uri": "s3://medical-imaging-dicom-input/dicom_input/",
"outputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/"
}
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Developer Guide unter [Abrufen der Eigenschaften von Importaufträgen](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-dicom-import-job.html)*.
+ API-Einzelheiten finden Sie unter [Get DICOMImport Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-dicom-import-job.html) in der *AWS CLI Befehlsreferenz*.
### `get-image-frame`
Das folgende Codebeispiel zeigt die Verwendung`get-image-frame`.
**AWS CLI**
**So rufen Sie Pixeldaten des Bildersatzes ab**
Im folgenden Codebeispiel für `get-image-frame` wird ein Image-Frame abgerufen.
```
aws medical-imaging get-image-frame \
--datastore-id "12345678901234567890123456789012" \
--image-set-id "98765412345612345678907890789012" \
--image-frame-information imageFrameId=3abf5d5d7ae72f80a0ec81b2c0de3ef4 \
imageframe.jph
```
Hinweis: Dieses Codebeispiel beinhaltet keine Ausgabe, da die GetImageFrame Aktion einen Stream von Pixeldaten an die Datei imageframe.jph zurückgibt. Informationen zum Dekodieren und Anzeigen von Bildrahmen finden Sie unter K-Decodierungsbibliotheken. HTJ2
Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Abrufen von Pixeldaten von Bilddatensätzen](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-frame.html).
+ Einzelheiten zur API finden Sie [GetImageFrame](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-frame.html)in der *AWS CLI Befehlsreferenz*.
### `get-image-set-metadata`
Das folgende Codebeispiel zeigt die Verwendung`get-image-set-metadata`.
**AWS CLI**
**Beispiel 1: So rufen Sie Bildsatz-Metadaten ohne Version ab**
Im folgenden Codebeispiel für `get-image-set-metadata` werden Metadaten für einen Bildsatz abgerufen, ohne eine Version anzugeben.
Anmerkung: Der Parameter `outfile` ist erforderlich.
```
aws medical-imaging get-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
studymetadata.json.gz
```
Die zurückgegebenen Metadaten werden mit GZIP komprimiert und in der Datei „studymetadata.json.gz“ gespeichert. Um den Inhalt des zurückgegebenen JSON-Objekts anzuzeigen, müssen Sie es zuerst dekomprimieren.
Ausgabe:
```
{
"contentType": "application/json",
"contentEncoding": "gzip"
}
```
**Beispiel 2: So rufen Sie Bildsatz-Metadaten mit Version ab**
Im folgenden Codebeispiel für `get-image-set-metadata` werden Metadaten für einen Bildsatz mit einer bestimmten Version abgerufen.
Anmerkung: Der Parameter `outfile` ist erforderlich.
```
aws medical-imaging get-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--version-id 1 \
studymetadata.json.gz
```
Die zurückgegebenen Metadaten werden mit GZIP komprimiert und in der Datei „studymetadata.json.gz“ gespeichert. Um den Inhalt des zurückgegebenen JSON-Objekts anzuzeigen, müssen Sie es zuerst dekomprimieren.
Ausgabe:
```
{
"contentType": "application/json",
"contentEncoding": "gzip"
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Abrufen von Bilddatensatz-Metadaten](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-metadata.html).
+ Einzelheiten zur API finden Sie [GetImageSetMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set-metadata.html)in der *AWS CLI Befehlsreferenz*.
### `get-image-set`
Das folgende Codebeispiel zeigt die Verwendung`get-image-set`.
**AWS CLI**
**So rufen Sie Bildsatzeigenschaften ab**
Im folgenden Codebeispiel für `get-image-set` werden die Eigenschaften für einen Bildsatz abgerufen.
```
aws medical-imaging get-image-set \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 18f88ac7870584f58d56256646b4d92b \
--version-id 1
```
Ausgabe:
```
{
"versionId": "1",
"imageSetWorkflowStatus": "COPIED",
"updatedAt": 1680027253.471,
"imageSetId": "18f88ac7870584f58d56256646b4d92b",
"imageSetState": "ACTIVE",
"createdAt": 1679592510.753,
"datastoreId": "12345678901234567890123456789012"
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Abrufen von Bilddatensatz-Eigenschaften](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-properties.html).
+ Einzelheiten zur API finden Sie [GetImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set.html)in der *AWS CLI Befehlsreferenz*.
### `list-datastores`
Das folgende Codebeispiel zeigt die Verwendung`list-datastores`.
**AWS CLI**
**So listen Sie Datenspeicher auf**
Im folgenden Codebeispiel für `list-datastores` werden die verfügbaren Datenspeicher aufgelistet.
```
aws medical-imaging list-datastores
```
Ausgabe:
```
{
"datastoreSummaries": [
{
"datastoreId": "12345678901234567890123456789012",
"datastoreName": "TestDatastore123",
"datastoreStatus": "ACTIVE",
"datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012",
"createdAt": "2022-11-15T23:33:09.643000+00:00",
"updatedAt": "2022-11-15T23:33:09.643000+00:00"
}
]
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Developer Guide* unter [Auflisten von Datenspeichern](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-data-stores.html).
+ Einzelheiten zur API finden Sie [ListDatastores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-datastores.html)in der *AWS CLI Befehlsreferenz*.
### `list-dicom-import-jobs`
Das folgende Codebeispiel zeigt die Verwendung`list-dicom-import-jobs`.
**AWS CLI**
**So listen Sie DICOM-Importaufträge auf**
Im folgenden Codebeispiel für `list-dicom-import-jobs` werden die DICOM-Importaufträge aufgelistet.
```
aws medical-imaging list-dicom-import-jobs \
--datastore-id "12345678901234567890123456789012"
```
Ausgabe:
```
{
"jobSummaries": [
{
"jobId": "09876543210987654321098765432109",
"jobName": "my-job",
"jobStatus": "COMPLETED",
"datastoreId": "12345678901234567890123456789012",
"dataAccessRoleArn": "arn:aws:iam::123456789012:role/ImportJobDataAccessRole",
"endedAt": "2022-08-12T11:21:56.504000+00:00",
"submittedAt": "2022-08-12T11:20:21.734000+00:00"
}
]
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Developer Guide* unter [Auflisten von Importaufträgen](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-dicom-import-jobs.html).
+ Einzelheiten zur API finden Sie unter [DICOMImportJobs auflisten](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-dicom-import-jobs.html) in der *AWS CLI Befehlsreferenz*.
### `list-image-set-versions`
Das folgende Codebeispiel zeigt die Verwendung`list-image-set-versions`.
**AWS CLI**
**So listen Sie Versionen von Bildsätzen auf**
Im folgendem Codebeispiel für `list-image-set-versions` wird der Versionsverlauf für einen Bildsatz aufgelistet.
```
aws medical-imaging list-image-set-versions \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e
```
Ausgabe:
```
{
"imageSetPropertiesList": [
{
"ImageSetWorkflowStatus": "UPDATED",
"versionId": "4",
"updatedAt": 1680029436.304,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "ACTIVE",
"createdAt": 1680027126.436
},
{
"ImageSetWorkflowStatus": "UPDATED",
"versionId": "3",
"updatedAt": 1680029163.325,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "ACTIVE",
"createdAt": 1680027126.436
},
{
"ImageSetWorkflowStatus": "COPY_FAILED",
"versionId": "2",
"updatedAt": 1680027455.944,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "ACTIVE",
"message": "INVALID_REQUEST: Series of SourceImageSet and DestinationImageSet don't match.",
"createdAt": 1680027126.436
},
{
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "ACTIVE",
"versionId": "1",
"ImageSetWorkflowStatus": "COPIED",
"createdAt": 1680027126.436
}
]
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Developer Guide* unter [Auflisten von Imageset-Versionen](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-image-set-versions.html).
+ Einzelheiten zur API finden Sie [ListImageSetVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-image-set-versions.html)in der *AWS CLI Befehlsreferenz*.
### `list-tags-for-resource`
Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`.
**AWS CLI**
**Beispiel 1: So listen Sie Ressourcen-Tags für einen Datenspeicher auf**
Im folgenden Codebeispiel für `list-tags-for-resource` werden die Tags für einen Datenspeicher aufgelistet.
```
aws medical-imaging list-tags-for-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012"
```
Ausgabe:
```
{
"tags":{
"Deployment":"Development"
}
}
```
**Beispiel 2: So listen Sie Ressourcen-Tags für einen Bildsatz auf**
Im folgenden Codebeispiel für `list-tags-for-resource` werden die Tags für einen Bildsatz aufgelistet.
```
aws medical-imaging list-tags-for-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b"
```
Ausgabe:
```
{
"tags":{
"Deployment":"Development"
}
}
```
Weitere Informationen finden Sie unter [Ressourcen taggen mit AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) im *AWS HealthImaging Entwicklerhandbuch*.
+ Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.*
### `search-image-sets`
Das folgende Codebeispiel zeigt die Verwendung`search-image-sets`.
**AWS CLI**
**Beispiel 1: So suchen Sie nach Bilddatensätzen mit einem EQUAL-Operator**
Im folgenden Codebeispiel für `search-image-sets` wird der EQUAL-Operator verwendet, um Bildsätze auf der Grundlage eines bestimmten Werts zu durchsuchen.
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Inhalt von `search-criteria.json`
```
{
"filters": [{
"values": [{"DICOMPatientId" : "SUBJECT08701"}],
"operator": "EQUAL"
}]
}
```
Ausgabe:
```
{
"imageSetsMetadataSummaries": [{
"imageSetId": "09876543210987654321098765432109",
"createdAt": "2022-12-06T21:40:59.429000+00:00",
"version": 1,
"DICOMTags": {
"DICOMStudyId": "2011201407",
"DICOMStudyDate": "19991122",
"DICOMPatientSex": "F",
"DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
"DICOMPatientBirthDate": "19201120",
"DICOMStudyDescription": "UNKNOWN",
"DICOMPatientId": "SUBJECT08701",
"DICOMPatientName": "Melissa844 Huel628",
"DICOMNumberOfStudyRelatedInstances": 1,
"DICOMStudyTime": "140728",
"DICOMNumberOfStudyRelatedSeries": 1
},
"updatedAt": "2022-12-06T21:40:59.429000+00:00"
}]
}
```
**Beispiel 2: Um Bilddatensätze mit einem BETWEEN-Operator unter Verwendung von DICOMStudy Datum und DICOMStudy Uhrzeit zu suchen**
Im folgenden Codebeispiel für `search-image-sets` wird nach Bildsätzen mit DICOM-Studien gesucht, die zwischen dem 1. Januar 1990 (12:00 Uhr) und dem 1. Januar 2023 (12:00 Uhr) generiert wurden.
Hinweis: Die DICOMStudy Uhrzeit ist optional. Wenn der Parameter nicht vorhanden ist, ist 12:00 Uhr (Beginn des Tages) der Zeitwert für die Datumsangaben, die für die Filterung bereitgestellt werden.
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Inhalt von `search-criteria.json`
```
{
"filters": [{
"values": [{
"DICOMStudyDateAndTime": {
"DICOMStudyDate": "19900101",
"DICOMStudyTime": "000000"
}
},
{
"DICOMStudyDateAndTime": {
"DICOMStudyDate": "20230101",
"DICOMStudyTime": "000000"
}
}],
"operator": "BETWEEN"
}]
}
```
Ausgabe:
```
{
"imageSetsMetadataSummaries": [{
"imageSetId": "09876543210987654321098765432109",
"createdAt": "2022-12-06T21:40:59.429000+00:00",
"version": 1,
"DICOMTags": {
"DICOMStudyId": "2011201407",
"DICOMStudyDate": "19991122",
"DICOMPatientSex": "F",
"DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
"DICOMPatientBirthDate": "19201120",
"DICOMStudyDescription": "UNKNOWN",
"DICOMPatientId": "SUBJECT08701",
"DICOMPatientName": "Melissa844 Huel628",
"DICOMNumberOfStudyRelatedInstances": 1,
"DICOMStudyTime": "140728",
"DICOMNumberOfStudyRelatedSeries": 1
},
"updatedAt": "2022-12-06T21:40:59.429000+00:00"
}]
}
```
**Beispiel 3: So suchen Sie Bildsätze mit einem BETWEEN-Operator mithilfe von createdAt (Zeitstudien wurden bisher fortgeführt)**
Im folgenden `search-image-sets` Codebeispiel wird nach Bilddatensätzen gesucht, bei denen DICOM-Studien HealthImaging zwischen den Zeitbereichen in der UTC-Zeitzone persistiert wurden.
Hinweis: Geben Sie „createdAt“ in dem im Beispiel aufgeführten Format an („1985-04-12T23:20:50.52Z“).
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Inhalt von `search-criteria.json`
```
{
"filters": [{
"values": [{
"createdAt": "1985-04-12T23:20:50.52Z"
},
{
"createdAt": "2022-04-12T23:20:50.52Z"
}],
"operator": "BETWEEN"
}]
}
```
Ausgabe:
```
{
"imageSetsMetadataSummaries": [{
"imageSetId": "09876543210987654321098765432109",
"createdAt": "2022-12-06T21:40:59.429000+00:00",
"version": 1,
"DICOMTags": {
"DICOMStudyId": "2011201407",
"DICOMStudyDate": "19991122",
"DICOMPatientSex": "F",
"DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
"DICOMPatientBirthDate": "19201120",
"DICOMStudyDescription": "UNKNOWN",
"DICOMPatientId": "SUBJECT08701",
"DICOMPatientName": "Melissa844 Huel628",
"DICOMNumberOfStudyRelatedInstances": 1,
"DICOMStudyTime": "140728",
"DICOMNumberOfStudyRelatedSeries": 1
},
"lastUpdatedAt": "2022-12-06T21:40:59.429000+00:00"
}]
}
```
**Beispiel 4: Um Bilddatensätze mit einem EQUAL-Operator für DICOMSeries instanceUID und BETWEEN für updatedAt zu durchsuchen und die Antwort in ASC-Reihenfolge im Feld updatedAt zu sortieren**
Das folgende `search-image-sets` Codebeispiel sucht nach Bilddatensätzen mit einem EQUAL-Operator für DICOMSeries instanceUID und BETWEEN für updatedAt und sortiert die Antwort in ASC-Reihenfolge im Feld updatedAt.
Hinweis: Geben Sie „updatedAt“ in dem im Beispiel aufgeführten Format an („1985-04-12T23:20:50.52Z“).
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Inhalt von `search-criteria.json`
```
{
"filters": [{
"values": [{
"updatedAt": "2024-03-11T15:00:05.074000-07:00"
}, {
"updatedAt": "2024-03-11T16:00:05.074000-07:00"
}],
"operator": "BETWEEN"
}, {
"values": [{
"DICOMSeriesInstanceUID": "1.2.840.99999999.84710745.943275268089"
}],
"operator": "EQUAL"
}],
"sort": {
"sortField": "updatedAt",
"sortOrder": "ASC"
}
}
```
Ausgabe:
```
{
"imageSetsMetadataSummaries": [{
"imageSetId": "09876543210987654321098765432109",
"createdAt": "2022-12-06T21:40:59.429000+00:00",
"version": 1,
"DICOMTags": {
"DICOMStudyId": "2011201407",
"DICOMStudyDate": "19991122",
"DICOMPatientSex": "F",
"DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
"DICOMPatientBirthDate": "19201120",
"DICOMStudyDescription": "UNKNOWN",
"DICOMPatientId": "SUBJECT08701",
"DICOMPatientName": "Melissa844 Huel628",
"DICOMNumberOfStudyRelatedInstances": 1,
"DICOMStudyTime": "140728",
"DICOMNumberOfStudyRelatedSeries": 1
},
"lastUpdatedAt": "2022-12-06T21:40:59.429000+00:00"
}]
}
```
[https://docs.aws.amazon.com/healthimaging/latest/devguide/search-image-sets.html](https://docs.aws.amazon.com/healthimaging/latest/devguide/search-image-sets.html)
+ Einzelheiten zur API finden Sie [SearchImageSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/search-image-sets.html)in der *AWS CLI Befehlsreferenz*.
### `start-dicom-import-job`
Das folgende Codebeispiel zeigt die Verwendung`start-dicom-import-job`.
**AWS CLI**
**So starten Sie einen DICOM-Importauftrag**
Im folgenden Codebeispiel für `start-dicom-import-job` wird ein DICOM-Importauftrage gestartet.
```
aws medical-imaging start-dicom-import-job \
--job-name "my-job" \
--datastore-id "12345678901234567890123456789012" \
--input-s3-uri "s3://medical-imaging-dicom-input/dicom_input/" \
--output-s3-uri "s3://medical-imaging-output/job_output/" \
--data-access-role-arn "arn:aws:iam::123456789012:role/ImportJobDataAccessRole"
```
Ausgabe:
```
{
"datastoreId": "12345678901234567890123456789012",
"jobId": "09876543210987654321098765432109",
"jobStatus": "SUBMITTED",
"submittedAt": "2022-08-12T11:28:11.152000+00:00"
}
```
Weitere Informationen finden Sie unter [Starten eines Importauftrags](https://docs.aws.amazon.com/healthimaging/latest/devguide/start-dicom-import-job.html) im *AWS HealthImaging Entwicklerhandbuch*.
+ API-Einzelheiten finden Sie unter [DICOMImportJob starten](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/start-dicom-import-job.html) in der *AWS CLI Befehlsreferenz*.
### `tag-resource`
Das folgende Codebeispiel zeigt die Verwendung`tag-resource`.
**AWS CLI**
**Beispiel 1: So markieren Sie einen Datenspeicher**
In den folgenden Codebeispielen für `tag-resource` wird ein Datenspeicher mit Tags versehen.
```
aws medical-imaging tag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012" \
--tags '{"Deployment":"Development"}'
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
**Beispiel 2: So taggen Sie einen Bildsatz**
In den folgenden Codebeispielen für `tag-resource` wird ein Bildsatz mit Tags versehen.
```
aws medical-imaging tag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b" \
--tags '{"Deployment":"Development"}'
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Ressourcen taggen mit AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) im *AWS HealthImaging Entwicklerhandbuch*.
+ Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/tag-resource.html)in der *AWS CLI Befehlsreferenz.*
### `untag-resource`
Das folgende Codebeispiel zeigt die Verwendung`untag-resource`.
**AWS CLI**
**Beispiel 1: So heben Sie die Markierung eines Datenspeichers auf**
Im folgenden Codebeispiel für `untag-resource` werden Tags aus einem Datenspeicher entfernt.
```
aws medical-imaging untag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012" \
--tag-keys '["Deployment"]'
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
**Beispiel 2: So heben Sie das Tagging eines Bildsatzes auf**
Im folgenden Codebeispiel für `untag-resource` werden Tags aus einem Bildsatz entfernt.
```
aws medical-imaging untag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b" \
--tag-keys '["Deployment"]'
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Ressourcen taggen mit AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) im *AWS HealthImaging Entwicklerhandbuch*.
+ Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/untag-resource.html)in der *AWS CLI Befehlsreferenz.*
### `update-image-set-metadata`
Das folgende Codebeispiel zeigt die Verwendung`update-image-set-metadata`.
**AWS CLI**
**Beispiel 1: So fügen Sie ein Attribut in Bildsatz-Metadaten ein oder aktualisieren es**
Im folgenden Beispiel für `update-image-set-metadata` wird ein Attribut in die Metadaten eines Bildsatzes eingefügt.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--update-image-set-metadata-updates file://metadata-updates.json
```
Inhalt von `metadata-updates.json`
```
{
"DICOMUpdates": {
"updatableAttributes": "{\"SchemaVersion\":1.1,\"Patient\":{\"DICOM\":{\"PatientName\":\"MX^MX\"}}}"
}
}
```
Ausgabe:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Beispiel 2: So entfernen Sie ein Attribut aus den Metadaten eines Bildsatzes**
Im folgenden Beispiel für `update-image-set-metadata` wird ein Attribut aus den Metadaten eines Bildsatzes entfernt.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--update-image-set-metadata-updates file://metadata-updates.json
```
Inhalt von `metadata-updates.json`
```
{
"DICOMUpdates": {
"removableAttributes": "{\"SchemaVersion\":1.1,\"Study\":{\"DICOM\":{\"StudyDescription\":\"CHEST\"}}}"
}
}
```
Ausgabe:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Beispiel 3: So entfernen Sie eine Instance aus den Metadaten eines Bildsatzes**
Im folgenden Beispiel für `update-image-set-metadata` wird eine Instance aus den Metadaten eines Bildsatzes entfernt.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--update-image-set-metadata-updates file://metadata-updates.json \
--force
```
Inhalt von `metadata-updates.json`
```
{
"DICOMUpdates": {
"removableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {}}}}}}"
}
}
```
Ausgabe:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Beispiel 4: So setzen Sie einen Bildsatz auf eine frühere Version zurück**
Das folgende `update-image-set-metadata` Beispiel zeigt, wie ein Bilddatensatz auf eine frühere Version zurückgesetzt wird. CopyImageSet und UpdateImageSetMetadata Aktionen erstellen neue Versionen von Bilddatensätzen.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \
--latest-version-id 3 \
--cli-binary-format raw-in-base64-out \
--update-image-set-metadata-updates '{"revertToVersionId": "1"}'
```
Ausgabe:
```
{
"datastoreId": "12345678901234567890123456789012",
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"latestVersionId": "4",
"imageSetState": "LOCKED",
"imageSetWorkflowStatus": "UPDATING",
"createdAt": 1680027126.436,
"updatedAt": 1680042257.908
}
```
**Beispiel 5: So fügen Sie einer Instance ein privates DICOM-Datenelement hinzu**
Das folgende Beispiel für `update-image-set-metadata` zeigt, wie ein privates Element zu einer angegebenen Instance innerhalb eines Bildsatzes hinzugefügt wird. Der DICOM-Standard erlaubt private Datenelemente für die Übertragung von Informationen, die nicht in Standarddatenelementen enthalten sein dürfen. Mit der UpdateImageSetMetadata Aktion können Sie private Datenelemente erstellen, aktualisieren und löschen.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--force \
--update-image-set-metadata-updates file://metadata-updates.json
```
Inhalt von `metadata-updates.json`
```
{
"DICOMUpdates": {
"updatableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"DICOM\": {\"001910F9\": \"97\"},\"DICOMVRs\": {\"001910F9\": \"DS\"}}}}}}}"
}
}
```
Ausgabe:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Beispiel 6: So aktualisieren Sie ein privates DICOM-Datenelement in einer Instance**
Das folgende Beispiel für `update-image-set-metadata` zeigt, wie der Wert eines privates Datenelements, das zu einer Instance eines Bildsatzes gehört, aktualisiert wird.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--force \
--update-image-set-metadata-updates file://metadata-updates.json
```
Inhalt von `metadata-updates.json`
```
{
"DICOMUpdates": {
"updatableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"DICOM\": {\"00091001\": \"GE_GENESIS_DD\"}}}}}}}"
}
}
```
Ausgabe:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Beispiel 7: Um eine SOPInstance UID mit dem Force-Parameter zu aktualisieren**
Das folgende `update-image-set-metadata` Beispiel zeigt, wie eine SOPInstance UID aktualisiert wird, indem der Force-Parameter verwendet wird, um die DICOM-Metadatenbeschränkungen zu überschreiben.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--force \
--update-image-set-metadata-updates file://metadata-updates.json
```
Inhalt von `metadata-updates.json`
```
{
"DICOMUpdates": {
"updatableAttributes": "{\"SchemaVersion\":1.1,\"Study\":{\"Series\":{\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3656.0\":{\"Instances\":{\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3659.0\":{\"DICOM\":{\"SOPInstanceUID\":\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3659.9\"}}}}}}}"
}
}
```
Ausgabe:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Aktualisieren von Bilddatensatz-Metadaten](https://docs.aws.amazon.com/healthimaging/latest/devguide/update-image-set-metadata.html).
+ Einzelheiten zur API finden Sie [UpdateImageSetMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/update-image-set-metadata.html)in der *AWS CLI Befehlsreferenz*.