HealthImaging-Beispiele unter Verwendung von AWS CLI - AWS-SDK-Codebeispiele
Aktionen

Weitere AWS-SDK-Beispiele sind im GitHub-Repository Beispiele für AWS Doc SDKs verfügbar.

HealthImaging-Beispiele unter Verwendung von AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie AWS Command Line Interface mit HealthImaging nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Servicefunktionen 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.

Themen

Aktionen

Die folgenden Codebeispiele zeigen, wie copy-image-set verwendet wird.

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 unter Kopieren eines Bildersatzes im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter CopyImageSet in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie create-datastore verwendet wird.

AWS CLI

So erstellen Sie einen Datenspeicher

Im folgenden Codebeispiel für create-datastore wird ein Datenspeicher mit dem Namen my-datastore erstellt.

aws medical-imaging create-datastore \
    --datastore-name "my-datastore"

Ausgabe:

{
    "datastoreId": "12345678901234567890123456789012",
    "datastoreStatus": "CREATING"
}

Weitere Informationen finden Sie unter Erstellen eines Datenspeichers im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter CreateDatastore in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-datastore verwendet wird.

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 unter Löschen eines Datenspeichers im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter DeleteDatastore in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-image-set verwendet wird.

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 unter Löschen eines Bildersatzes im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter DeleteImageSet in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie get-datastore verwendet wird.

AWS CLI

So rufen Sie die Eigenschaften eines Datenspeichers ab

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",
        "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 unter Abrufen der Eigenschaften eines Datenspeichers im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter GetDatastore in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie get-dicom-import-job verwendet wird.

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 unter Abrufen der Eigenschaften eines Importauftrags im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter GetDICOMImportJob in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie get-image-frame verwendet wird.

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 „HTJ2K decoding libraries“.

Weitere Informationen finden Sie unter Abrufen der Pixeldaten des Bildersatzes im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter GetImageFrame in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie get-image-set-metadata verwendet wird.

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 unter Abrufen von Bildsatz-Metadaten im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter GetImageSetMetadata in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie get-image-set verwendet wird.

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 unter Abrufen der Eigenschaften eines Bildsatzes im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter GetImageSet in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-datastores verwendet wird.

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 unter Auflisten von Datenspeichern im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter ListDatastores in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-dicom-import-jobs verwendet wird.

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 unter Auflisten von Importaufträgen im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter ListDICOMImportJobs in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-image-set-versions verwendet wird.

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 unter Auflisten von Versionen von Bildsätzen im Entwicklerhandbuch für AWS HealthImaging.

Die folgenden Codebeispiele zeigen, wie list-tags-for-resource verwendet wird.

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 Tagging von Ressourcen mit AWS HealthImaging im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter ListTagsForResource in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie search-image-sets verwendet wird.

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: So suchen Sie Bildsätze mit einem BETWEEN-Operator mithilfe von DICOMStudyDate und DICOMStudyTime

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: DICOMStudyTime 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 dem folgenden Codebeispiel für search-image-sets wird nach Bildersätzen über DICOM-Studien gesucht, die zwischen den Zeiträumen in der UTC-Zeitzone in HealthImaging abgelegt 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: So suchen Sie Bildsätze mit einem EQUAL-Operator für DICOMSeriesInstanceUID und BETWEEN im Feld „updatedAt“ und sortieren die Antwort in ASC-Reihenfolge nach dem Feld „updatedAt

Im folgenden Codebeispiel für search-image-sets wird nach Bildsätzen mit einem EQUAL-Operator für DICOMSeriesInstanceUID und BETWEEN im Feld „updatedAt“ gesucht und die Antwort in ASC-Reihenfolge nach dem Feld „updatedAt“ sortiert.

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"
    }]
}

Weitere Informationen finden Sie unter Suchen nach Bilddatensätzen im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter SearchImageSets in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie start-dicom-import-job verwendet wird.

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 im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter StartDICOMImportJob in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie tag-resource verwendet wird.

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 Tagging von Ressourcen mit AWS HealthImaging im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie untag-resource verwendet wird.

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 Tagging von Ressourcen mit AWS HealthImaging im Entwicklerhandbuch für AWS HealthImaging.

  • Weitere API-Informationen finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie update-image-set-metadata verwendet wird.

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

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 Beispiel für update-image-set-metadata zeigt, wie ein Bildsatz auf eine frühere Version zurückgesetzt wird. Mit den Aktionen „CopyImageSet“ und „UpdateImageSetMetadata“ werden neue Versionen von Bildsätzen erstellt.

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. Sie können private Datenelemente mit der Aktion „UpdateImageSetMetadata“ 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: So aktualisieren Sie eine SOPInstanceUID mit dem Force-Parameter

Im folgenden Beispiel für update-image-set-metadata wird gezeigt, wie eine SOPInstanceUID unter Verwendung des Force-Parameter aktualisiert 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 unter Aktualisieren von Bildsatz-Metadaten im Entwicklerhandbuch für AWS HealthImaging.