HealthImaging esempi utilizzando AWS CLI - AWS Command Line Interface
Azioni

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

HealthImaging esempi utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with HealthImaging.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Mentre le azioni mostrano come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecopy-image-set.

AWS CLI

Esempio 1: copiare un set di immagini senza una destinazione.

L'copy-image-setesempio seguente 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.

L'copy-image-setesempio seguente 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.

L'copy-image-setesempio seguente copia un'DICOMistanza dal set di immagini di origine al set di immagini di destinazione. Il parametro force viene fornito per ignorare le incongruenze negli attributi dei livelli 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 Copiare un set di immagini nella Guida per gli sviluppatori.AWS HealthImaging

  • Per API i dettagli, vedere CopyImageSetin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-datastore.

AWS CLI

Per creare un archivio dati

Il seguente esempio di create-datastore codice crea un archivio dati con il nomemy-datastore.

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

Output:

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

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

Il seguente esempio di codice mostra come utilizzaredelete-datastore.

AWS CLI

Per eliminare un archivio dati

Il seguente esempio di delete-datastore codice elimina un data store.

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

Output:

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

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

Il seguente esempio di codice mostra come utilizzaredelete-image-set.

AWS CLI

Per eliminare un set di immagini

Il seguente esempio di delete-image-set codice 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, consultate Eliminazione di un set di immagini nella Guida per gli AWS HealthImaging sviluppatori.

  • Per API i dettagli, vedere DeleteImageSetin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-datastore.

AWS CLI

Per ottenere le proprietà di un archivio dati

Il seguente esempio di get-datastore codice ottiene le proprietà di un data store.

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 Ottenere le proprietà del data store nella Guida per gli AWS HealthImaging sviluppatori.

  • Per API i dettagli, vedere GetDatastorein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-dicom-import-job.

AWS CLI

Per ottenere le proprietà di un processo di importazione dicom

Il seguente esempio di get-dicom-import-job codice ottiene le proprietà di 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 Ottenere le proprietà del processo di importazione nella Guida per gli AWS HealthImaging sviluppatori.

Il seguente esempio di codice mostra come utilizzareget-image-frame.

AWS CLI

Per ottenere i dati dei pixel impostati dall'immagine

Il seguente esempio di get-image-frame codice ottiene una cornice 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' GetImageFrame azione restituisce un flusso di dati di pixel al file imageframe.jph. Per informazioni sulla decodifica e la visualizzazione dei frame di immagini, consultate le librerie di decodifica. HTJ2K

Per ulteriori informazioni, consultate Ottenere i dati dei pixel del set di immagini nella Guida per gli AWS HealthImaging sviluppatori.

Il seguente esempio di codice mostra come utilizzareget-image-set-metadata.

AWS CLI

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

Il seguente esempio di get-image-set-metadata codice 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 restituito, è necessario prima decomprimerlo. JSON

Output:

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

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

Il seguente esempio di get-image-set-metadata codice 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 restituito, è necessario prima decomprimerlo. JSON

Output:

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

Per ulteriori informazioni, consulta Ottenere i metadati del set di immagini nella Guida per gli AWS HealthImaging sviluppatori.

Il seguente esempio di codice mostra come utilizzareget-image-set.

AWS CLI

Per ottenere le proprietà del set di immagini

Il seguente esempio di get-image-set codice 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 Ottenere le proprietà del set di immagini nella Guida per gli AWS HealthImaging sviluppatori.

  • Per API i dettagli, vedere GetImageSetin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-datastores.

AWS CLI

Per elencare gli archivi dati

Il seguente esempio di list-datastores codice elenca gli archivi dati 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 Elencare gli archivi di dati nella Guida per gli AWS HealthImaging sviluppatori.

Il seguente esempio di codice mostra come utilizzarelist-dicom-import-jobs.

AWS CLI

Per elencare i lavori di importazione dicom

Il seguente esempio di list-dicom-import-jobs codice 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 Elencare i lavori di importazione nella AWS HealthImaging Developer Guide.

Il seguente esempio di codice mostra come utilizzarelist-image-set-versions.

AWS CLI

Per elencare le versioni dei set di immagini

Il seguente esempio di list-image-set-versions codice 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, consultate Elenco delle versioni dei set di immagini nella Guida per gli AWS HealthImaging sviluppatori.

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Esempio 1: per elencare i tag delle risorse per un archivio dati

Il seguente esempio di list-tags-for-resource codice elenca i tag per un data store.

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

Il seguente esempio di list-tags-for-resource codice elenca i tag per 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 AWS HealthImaging Developer Guide.

Il seguente esempio di codice mostra come utilizzaresearch-image-sets.

AWS CLI

Esempio 1: Per cercare set di immagini con un EQUAL operatore

Il seguente esempio di search-image-sets codice utilizza l'EQUALoperatore 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: Per cercare set di immagini con un BETWEEN operatore utilizzando DICOMStudyDate e DICOMStudyTime

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

Nota: DICOMStudyTime è facoltativo. Se non è presente, 12:00 AM (inizio giornata) è il valore temporale per le date fornite per il filtraggio.

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: per cercare set di immagini con un BETWEEN operatore utilizzando createdAt (gli studi temporali erano precedentemente persistenti)

Il seguente esempio di search-image-sets codice cerca set di immagini con DICOM gli studi persistenti HealthImaging tra gli intervalli di tempo del fuso orario. UTC

Nota: fornite un createdAt formato di esempio («1985-04-12T 23:20:50.52 Z»).

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: per cercare set di immagini con un EQUAL operatore attivo e attivo DICOMSeriesInstanceUID e ordinare le risposte in ordine sul campo BETWEEN updatedAt ASC updatedAt

Il seguente esempio di search-image-sets codice cerca i set di immagini con un EQUAL operatore on DICOMSeriesInstanceUID e BETWEEN on updatedAt e ordina la risposta in ASC ordine sul updatedAt campo.

Nota: fornite un updatedAt formato di esempio («1985-04-12T 23:20:50.52 Z»).

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 Developer Guide.AWS HealthImaging

Il seguente esempio di codice mostra come utilizzarestart-dicom-import-job.

AWS CLI

Per avviare un processo di importazione dicom

Il seguente esempio di start-dicom-import-job codice 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 Avvio di un processo di importazione nella Guida per gli AWS HealthImaging sviluppatori.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Esempio 1: etichettare un archivio dati

I seguenti esempi di tag-resource codice contrassegnano un data store.

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: etichettare un set di immagini

I seguenti esempi di tag-resource codice contrassegnano 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 AWS HealthImaging Developer Guide.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Esempio 1: rimuovere i tag da un archivio dati

Il seguente esempio di untag-resource codice rimuove i tag da un data store.

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 i tag da un set di immagini

Il seguente esempio di untag-resource codice 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 Developer Guide.AWS HealthImaging

Il seguente esempio di codice mostra come utilizzareupdate-image-set-metadata.

AWS CLI

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

L'update-image-set-metadataesempio seguente 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

L'update-image-set-metadataesempio seguente 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

L'update-image-set-metadataesempio seguente 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: Per ripristinare una versione precedente di un set di immagini

L'update-image-set-metadataesempio seguente mostra come ripristinare un set di immagini a una versione precedente. CopyImageSet e UpdateImageSetMetadata le azioni 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 DICOM dati privato a un'istanza

L'update-image-set-metadataesempio seguente mostra come aggiungere un elemento privato a un'istanza specificata all'interno di un set di immagini. Lo DICOM standard consente elementi di dati privati per la comunicazione di informazioni che non possono essere contenuti in elementi di dati standard. È possibile creare, aggiornare ed eliminare elementi di dati privati con l'UpdateImageSetMetadata azione.

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 DICOM dati privato in un'istanza

L'update-image-set-metadataesempio 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 a SOPInstanceUID con il parametro force

L'update-image-set-metadataesempio seguente mostra come aggiornare aSOPInstanceUID, utilizzando il parametro force per sovrascrivere i vincoli dei DICOM metadati.

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 Aggiornamento dei metadati del set di immagini nella Guida per gli sviluppatori.AWS HealthImaging