Esempi di HealthImaging che utilizzano AWS CLI

Gli esempi di codice seguenti mostrano come eseguire azioni e implementare scenari comuni utilizzando la AWS Command Line Interface con HealthImaging.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

Operazioni

L’esempio di codice seguente mostra come utilizzare copy-image-set.

AWS CLI

Esempio 1: copiare un set di immagini senza una destinazione

Nell’esempio seguente, copy-image-set crea una copia duplicata di un set di immagini senza una destinazione.


aws medical-imaging copy-image-set \
    --datastore-id 12345678901234567890123456789012 \
    --source-image-set-id ea92b0d8838c72a3f25d00d13616f87e \
    --copy-image-set-information '{"sourceImageSet": {"latestVersionId": "1" } }'

Output:


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

Esempio 2: copiare un set di immagini con una destinazione

Nell’esempio seguente, copy-image-set crea una copia duplicata di un set di immagini con una destinazione.


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

Output:


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

Esempio 3: copiare un sottoinsieme di istanze da un set di immagini di origine a un set di immagini di destinazione.

Nell’esempio seguente, copy-image-set copia un’istanza DICOM dal set di immagini di origine nel set di immagini di destinazione. Il parametro force viene fornito per eseguire l’override delle incongruenze a livello degli attributi Patient, Study e Series.


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

Output:


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

Per ulteriori informazioni, consulta Copying an image set nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta CopyImageSet in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-datastore.

AWS CLI

Come creare un datastore

Nell’esempio di codice seguente, create-datastore crea un datastore denominato my-datastore.


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

Output:


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

Per ulteriori informazioni, consulta Creating a data store nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta CreateDatastore in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-datastore.

AWS CLI

Come eliminare un datastore

Nell’esempio di codice seguente, delete-datastore elimina un datastore.


aws medical-imaging delete-datastore \
    --datastore-id "12345678901234567890123456789012"

Output:


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

Per ulteriori informazioni, consulta Deleting a data store nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta DeleteDatastore in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-image-set.

AWS CLI

Come eliminare un set di immagini

Nell’esempio di codice seguente, delete-image-set elimina un set di immagini.


aws medical-imaging delete-image-set \
    --datastore-id 12345678901234567890123456789012 \
    --image-set-id ea92b0d8838c72a3f25d00d13616f87e

Output:


{
    "imageSetWorkflowStatus": "DELETING",
    "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
    "imageSetState": "LOCKED",
    "datastoreId": "12345678901234567890123456789012"
}

Per ulteriori informazioni, consulta Deleting an image set nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta DeleteImageSet in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-datastore.

AWS CLI

Come ottenere le proprietà di un datastore

Nell’esempio di codice seguente, get-datastore ottiene le proprietà di un datastore.


aws medical-imaging get-datastore \
    --datastore-id 12345678901234567890123456789012

Output:


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

Per ulteriori informazioni, consulta Getting data store properties nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta GetDatastore in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-dicom-import-job.

AWS CLI

Come ottenere le proprietà di un processo di importazione DICOM

Nell’esempio di codice seguente, get-dicom-import-job concede l’autorizzazione ad avviare un processo di importazione DICOM.


aws medical-imaging get-dicom-import-job \
    --datastore-id "12345678901234567890123456789012" \
    --job-id "09876543210987654321098765432109"

Output:


{
    "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/"
    }
}

Per ulteriori informazioni, consulta Getting import job properties nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta GetDICOMImportJob in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-image-frame.

AWS CLI

Come ottenere i dati dei pixel del set di immagini

Nell’esempio di codice seguente, get-image-frame ottiene un image frame di immagine.


aws medical-imaging get-image-frame \
    --datastore-id "12345678901234567890123456789012" \
    --image-set-id "98765412345612345678907890789012" \
    --image-frame-information imageFrameId=3abf5d5d7ae72f80a0ec81b2c0de3ef4 \
    imageframe.jph

Nota: questo esempio di codice non include l’output perché l’azione GetImageFrame restituisce un flusso di dati pixel al file imageframe.jph. Per informazioni sulla decodifica e la visualizzazione dei frame di immagini, consulta le librerie di decodifica HTJ2K.

Per ulteriori informazioni, consulta Getting image set pixel data nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta GetImageFrame in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-image-set-metadata.

AWS CLI

Esempio 1: ottenere i metadati del set di immagini senza la versione

Nell’esempio di codice seguente, get-image-set-metadata ottiene i metadati per un set di immagini senza specificare una versione.

Nota: outfile è un parametro obbligatorio.


aws medical-imaging get-image-set-metadata \
    --datastore-id 12345678901234567890123456789012 \
    --image-set-id ea92b0d8838c72a3f25d00d13616f87e \
    studymetadata.json.gz

I metadati restituiti vengono compressi con gzip e archiviati nel file studymetadata.json.gz. Per visualizzare il contenuto dell’oggetto JSON restituito, devi prima decomprimerlo.

Output:


{
    "contentType": "application/json",
    "contentEncoding": "gzip"
}

Esempio 2: ottenere i metadati del set di immagini con la versione

Nell’esempio di codice seguente, get-image-set-metadata ottiene i metadati per un set di immagini con una versione specificata.

Nota: outfile è un parametro obbligatorio.


aws medical-imaging get-image-set-metadata \
    --datastore-id 12345678901234567890123456789012 \
    --image-set-id ea92b0d8838c72a3f25d00d13616f87e \
    --version-id 1 \
    studymetadata.json.gz

I metadati restituiti vengono compressi con gzip e archiviati nel file studymetadata.json.gz. Per visualizzare il contenuto dell’oggetto JSON restituito, devi prima decomprimerlo.

Output:


{
    "contentType": "application/json",
    "contentEncoding": "gzip"
}

Per ulteriori informazioni, consulta Getting image set metadata nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta GetImageSetMetadata in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-image-set.

AWS CLI

Come ottenere le proprietà del set di immagini

Nell’esempio di codice seguente, get-image-set ottiene le proprietà di un set di immagini.


aws medical-imaging get-image-set \
    --datastore-id 12345678901234567890123456789012 \
    --image-set-id 18f88ac7870584f58d56256646b4d92b \
    --version-id 1

Output:


{
    "versionId": "1",
    "imageSetWorkflowStatus": "COPIED",
    "updatedAt": 1680027253.471,
    "imageSetId": "18f88ac7870584f58d56256646b4d92b",
    "imageSetState": "ACTIVE",
    "createdAt": 1679592510.753,
    "datastoreId": "12345678901234567890123456789012"
}

Per ulteriori informazioni, consulta Getting image set properties nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta GetImageSet in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-datastores.

AWS CLI

Come elencare i datastore

Nell’esempio di codice seguente list-datastores elenca i datastore disponibili.


aws medical-imaging list-datastores

Output:


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

Per ulteriori informazioni, consulta Listing data stores nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta ListDatastores in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-dicom-import-jobs.

AWS CLI

Come elencare i processi di importazione DICOM

Nell’esempio di codice seguente, list-dicom-import-jobs elenca i processi di importazione DICOM.


aws medical-imaging list-dicom-import-jobs \
    --datastore-id "12345678901234567890123456789012"

Output:


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

Per ulteriori informazioni, consulta Listing import jobs nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta ListDICOMImportJobs in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-image-set-versions.

AWS CLI

Come elencare le versioni dei set di immagini

Nell’esempio di codice seguente, list-image-set-versions elenca la cronologia delle versioni di un set di immagini.


aws medical-imaging list-image-set-versions \
    --datastore-id 12345678901234567890123456789012 \
    --image-set-id ea92b0d8838c72a3f25d00d13616f87e

Output:


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

Per ulteriori informazioni, consulta Listing image set versions nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta ListImageSetVersions in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Esempio 1: elencare i tag delle risorse per un datastore

Nell’esempio di codice seguente, list-tags-for-resource elenca i tag di un datastore.


aws medical-imaging list-tags-for-resource \
    --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012"

Output:


{
    "tags":{
        "Deployment":"Development"
    }
}

Esempio 2: elencare i tag delle risorse per un set di immagini

Nell’esempio di codice seguente, list-tags-for-resource elenca i tag di un set di immagini.


aws medical-imaging list-tags-for-resource \
    --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b"

Output:


{
    "tags":{
        "Deployment":"Development"
    }
}

Per ulteriori informazioni, consulta Tagging resources with AWS HealthImaging nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta ListTagsForResource in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare search-image-sets.

AWS CLI

Esempio 1: cercare set di immagini con un operatore EQUAL

Nell’esempio di codice seguente, search-image-sets utilizza l’operatore EQUAL per cercare set di immagini in base a un valore specifico.


aws medical-imaging search-image-sets \
    --datastore-id 12345678901234567890123456789012 \
    --search-criteria file://search-criteria.json

Contenuto di search-criteria.json


{
    "filters": [{
        "values": [{"DICOMPatientId" : "SUBJECT08701"}],
        "operator": "EQUAL"
    }]
}

Output:


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

Esempio 2: cercare set di immagini con un operatore BETWEEN utilizzando DICOMStudyDate e DICOMStudyTime

Nell’esempio di codice seguente, search-image-sets cerca set di immagini con studi DICOM generati tra il 1° gennaio 1990 (00:00) e il 1° gennaio 2023 (00:00).

Nota: DICOMStudyTime è facoltativo. Se non presente, 12:00 (inizio della giornata) è il valore temporale per le date fornite per l’applicazione di filtri.


aws medical-imaging search-image-sets \
    --datastore-id 12345678901234567890123456789012 \
    --search-criteria file://search-criteria.json

Contenuto di search-criteria.json


{
    "filters": [{
        "values": [{
            "DICOMStudyDateAndTime": {
                "DICOMStudyDate": "19900101",
                "DICOMStudyTime": "000000"
            }
        },
        {
            "DICOMStudyDateAndTime": {
                "DICOMStudyDate": "20230101",
                "DICOMStudyTime": "000000"
            }
        }],
        "operator": "BETWEEN"
    }]
}

Output:


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

Esempio 3: cercare set di immagini con un operatore BETWEEN utilizzando createdAt (in precedenza gli studi temporali erano persistenti)

Nell’esempio di codice seguente, search-image-sets cerca i set di immagini con studi DICOM persistenti in HealthImaging tra gli intervalli di tempo nel fuso orario UTC.

Nota: fornisci createdAt nel formato dell’esempio (“1985-04-12T23:20:50.52Z”).


aws medical-imaging search-image-sets \
    --datastore-id 12345678901234567890123456789012 \
    --search-criteria  file://search-criteria.json

Contenuto di search-criteria.json


{
    "filters": [{
        "values": [{
            "createdAt": "1985-04-12T23:20:50.52Z"
        },
        {
            "createdAt": "2022-04-12T23:20:50.52Z"
        }],
        "operator": "BETWEEN"
    }]
}

Output:


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

Esempio 4: cercare set di immagini con un operatore EQUAL in DICOMSeriesInstanceUID e un operatore BETWEEN in updatedAt e ordinare la risposta in ordine crescente (ASC) nel campo updatedAt

Nell’esempio di codice seguente, search-image-sets cerca set di immagini con un operatore EQUAL in DICOMSeriesInstanceUID e un operatore BETWEEN in updatedAt e ordina la risposta in ordine crescente (ASC) nel campo updatedAt.

Nota: fornisci updatedAt nel formato dell’esempio (“1985-04-12T23:20:50.52Z”).


aws medical-imaging search-image-sets \
    --datastore-id 12345678901234567890123456789012 \
    --search-criteria  file://search-criteria.json

Contenuto di 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"
    }
}

Output:


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

Per ulteriori informazioni, consulta Searching image sets nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta SearchImageSets in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare start-dicom-import-job.

AWS CLI

Come avviare un processo di importazione DICOM

Nell’esempio di codice seguente, start-dicom-import-job avvia un processo di importazione DICOM.


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"

Output:


{
    "datastoreId": "12345678901234567890123456789012",
    "jobId": "09876543210987654321098765432109",
    "jobStatus": "SUBMITTED",
    "submittedAt": "2022-08-12T11:28:11.152000+00:00"
}

Per ulteriori informazioni, consulta Starting an import job nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta StartDICOMImportJob in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

Esempio 1: aggiungere tag a un datastore.

Negli esempi di codice seguenti, tag-resource aggiunge tag a un datastore.


aws medical-imaging tag-resource \
  --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012" \
  --tags '{"Deployment":"Development"}'

Questo comando non produce alcun output.

Esempio 2: aggiungere tag a un set di immagini

Negli esempi di codice seguente, tag-resource aggiunge tag a un set di immagini.


aws medical-imaging tag-resource \
    --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b" \
    --tags '{"Deployment":"Development"}'

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagging resources with AWS HealthImaging nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta TagResource in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare untag-resource.

AWS CLI

Esempio 1: rimuovere tag a un datastore.

Nell’esempio di codice seguente, untag-resource rimuove i tag da un datastore.


aws medical-imaging untag-resource \
    --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012" \
    --tag-keys '["Deployment"]'

Questo comando non produce alcun output.

Esempio 2: rimuovere tag da un set di immagini

Negli esempi di codice seguente, untag-resource rimuove i tag da un set di immagini.


aws medical-imaging untag-resource \
    --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b" \
    --tag-keys '["Deployment"]'

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagging resources with AWS HealthImaging nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta UntagResource in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-image-set-metadata.

AWS CLI

Esempio 1: inserire o aggiornare un attributo nei metadati del set di immagini

Nell’esempio seguente, update-image-set-metadata inserisce o aggiorna un attributo nei metadati del set di immagini.


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

Contenuto di metadata-updates.json


{
    "DICOMUpdates": {
        "updatableAttributes": "{\"SchemaVersion\":1.1,\"Patient\":{\"DICOM\":{\"PatientName\":\"MX^MX\"}}}"
    }
}

Output:


{
    "latestVersionId": "2",
    "imageSetWorkflowStatus": "UPDATING",
    "updatedAt": 1680042257.908,
    "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
    "imageSetState": "LOCKED",
    "createdAt": 1680027126.436,
    "datastoreId": "12345678901234567890123456789012"
}

Esempio 2: rimuovere un attributo dai metadati del set di immagini

Nell’esempio seguente, update-image-set-metadata rimuove un attributo dai metadati del set di immagini.


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

Contenuto di metadata-updates.json


{
    "DICOMUpdates": {
        "removableAttributes": "{\"SchemaVersion\":1.1,\"Study\":{\"DICOM\":{\"StudyDescription\":\"CHEST\"}}}"
    }
}

Output:


{
    "latestVersionId": "2",
    "imageSetWorkflowStatus": "UPDATING",
    "updatedAt": 1680042257.908,
    "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
    "imageSetState": "LOCKED",
    "createdAt": 1680027126.436,
    "datastoreId": "12345678901234567890123456789012"
}

Esempio 3: rimuovere un’istanza dai metadati del set di immagini

Nell’esempio seguente, update-image-set-metadata rimuove un’istanza dai metadati del set di immagini.


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

Contenuto di 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\": {}}}}}}"
    }
}

Output:


{
    "latestVersionId": "2",
    "imageSetWorkflowStatus": "UPDATING",
    "updatedAt": 1680042257.908,
    "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
    "imageSetState": "LOCKED",
    "createdAt": 1680027126.436,
    "datastoreId": "12345678901234567890123456789012"
}

Esempio 4: ripristinare la versione precedente di un set di immagini

Nell’esempio seguente, update-image-set-metadata ripristina la versione precedente di un set di immagini. Le azioni CopyImageSet e UpdateImageSetMetadata creano nuove versioni dei set di immagini.


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

Output:


{
    "datastoreId": "12345678901234567890123456789012",
    "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
    "latestVersionId": "4",
    "imageSetState": "LOCKED",
    "imageSetWorkflowStatus": "UPDATING",
    "createdAt": 1680027126.436,
    "updatedAt": 1680042257.908
}

Esempio 5: aggiungere un elemento di dati DICOM privato a un’istanza

Nell’esempio seguente, update-image-set-metadata aggiunge un elemento privato a un’istanza specificata all’interno di un set di immagini. Lo standard DICOM consente di utilizzare elementi di dati privati nella comunicazione di informazioni che non possono essere contenute in elementi di dati standard. Puoi creare, aggiornare ed eliminare elementi di dati privati con l’azione UpdateImageSetMetadata.


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

Contenuto di 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\"}}}}}}}"
    }
}

Output:


{
    "latestVersionId": "2",
    "imageSetWorkflowStatus": "UPDATING",
    "updatedAt": 1680042257.908,
    "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
    "imageSetState": "LOCKED",
    "createdAt": 1680027126.436,
    "datastoreId": "12345678901234567890123456789012"
}

Esempio 6: aggiornare un elemento di dati DICOM privato a un’istanza

L’esempio update-image-set-metadata seguente mostra come aggiornare il valore di un elemento di dati privato appartenente a un’istanza all’interno di un set di immagini.


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

Contenuto di 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\"}}}}}}}"
    }
}

Output:


{
    "latestVersionId": "2",
    "imageSetWorkflowStatus": "UPDATING",
    "updatedAt": 1680042257.908,
    "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
    "imageSetState": "LOCKED",
    "createdAt": 1680027126.436,
    "datastoreId": "12345678901234567890123456789012"
}

Esempio 7: aggiornare SOPInstanceUID con il parametro force

Nell’esempio seguente, update-image-set-metadata aggiorna SOPInstanceUID, utilizzando il parametro force per sovrascrivere i vincoli dei metadati DICOM.


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

Contenuto di 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\"}}}}}}}"
    }
}

Output:


{
    "latestVersionId": "2",
    "imageSetWorkflowStatus": "UPDATING",
    "updatedAt": 1680042257.908,
    "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
    "imageSetState": "LOCKED",
    "createdAt": 1680027126.436,
    "datastoreId": "12345678901234567890123456789012"
}

Per ulteriori informazioni, consulta Updating image set metadata nella Guida per gli sviluppatori di AWS HealthImaging.

Per informazioni dettagliate sull’API, consulta UpdateImageSetMetadata in AWS CLI Command Reference.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

AWS Health

HealthLake