Exemples d’utilisation de l’AWS CLI avec HealthImaging

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec HealthImaging.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

Actions

L’exemple de code suivant montre comment utiliser copy-image-set.

AWS CLI

Exemple 1 : pour copier un ensemble d’images sans destination.

L’exemple copy-image-set suivant crée une copie d’un ensemble d’images sans destination.


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

Sortie :


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

Exemple 2 : pour copier un ensemble d’images avec une destination.

L’exemple copy-image-set suivant crée une copie d’un ensemble d’images avec une destination.


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

Sortie :


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

Exemple 3 : pour copier un sous-ensemble d’instances d’un ensemble d’images source vers un ensemble d’images de destination.

L’exemple copy-image-set suivant copie une instance DICOM de l’ensemble d’images source vers l’ensemble d’images de destination. Le paramètre de force est fourni pour corriger les incohérences dans les attributs au niveau du patient, de l’étude et de la série.


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

Sortie :


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

Pour plus d’informations, consultez Copying an image set dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez CopyImageSet dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-datastore.

AWS CLI

Pour créer un magasin de données

L’exemple de code create-datastore suivant crée un magasin de données portant le nom my-datastore.


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

Sortie :


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

Pour plus d’informations, consultez Creating a data store dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez CreateDatastore dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-datastore.

AWS CLI

Pour supprimer un magasin de données

L’exemple de code delete-datastore suivant supprime un magasin de données.


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

Sortie :


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

Pour plus d’informations, consultez Deleting a data store dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez DeleteDatastore dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-image-set.

AWS CLI

Pour supprimer un ensemble d’images

L’exemple de code delete-image-set suivant supprime un ensemble d’images.


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

Sortie :


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

Pour plus d’informations, consultez Deleting an image set dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez DeleteImageSet dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-datastore.

AWS CLI

Pour obtenir les propriétés d’un magasin de données

L’exemple de code get-datastore suivant fournit les propriétés d’un magasin de données.


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

Sortie :


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

Pour plus d’informations, consultez Getting data store properties dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez GetDatastore dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-dicom-import-job.

AWS CLI

Pour obtenir les propriétés d’une tâche d’importation DICOM

L’exemple de code get-dicom-import-job suivant fournit les propriétés d’une tâche d’importation DICOM.


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

Sortie :


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

Pour plus d’informations, consultez Getting import job properties dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez GetDICOMImportJob dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-image-frame.

AWS CLI

Pour obtenir les données de pixels d’un ensemble d’images

L’exemple de code get-image-frame suivant fournit un cadre d’image.


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

Remarque : cet exemple de code n’inclut pas de sortie, car l’action GetImageFrame renvoie un flux de données de pixels vers le fichier imageframe.jph. Pour plus d’informations sur le décodage et l’affichage de cadres d’image, consultez les bibliothèques de décodage HTJ2K.

Pour plus d’informations, consultez Getting image set pixel data dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez GetImageFrame dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-image-set-metadata.

AWS CLI

Exemple 1 : pour obtenir les métadonnées d’un ensemble d’images sans version

L’exemple de code get-image-set-metadata suivant fournit les métadonnées d’un ensemble d’images sans spécifier de version.

Remarque : outfile est un paramètre obligatoire


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

Les métadonnées renvoyées sont compressées avec gzip et stockées dans le fichier studymetadata.json.gz. Pour visualiser le contenu de l’objet JSON renvoyé, vous devez d’abord le décompresser.

Sortie :


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

Exemple 2 : pour obtenir les métadonnées d’un ensemble d’images avec version

L’exemple de code get-image-set-metadata suivant fournit les métadonnées d’un ensemble d’images avec une version spécifiée.

Remarque : outfile est un paramètre obligatoire


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

Sortie :


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

Pour plus d’informations, consultez Getting image set metadata dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez GetImageSetMetadata dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-image-set.

AWS CLI

Pour obtenir les propriétés d’un ensemble d’images

L’exemple de code get-image-set suivant fournit les propriétés d’un ensemble d’images.


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

Sortie :


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

Pour plus d’informations, consultez Getting image set properties dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez GetImageSet dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-datastores.

AWS CLI

Pour répertorier des magasins de données

L’exemple de code list-datastores suivant répertorie les magasins de données disponibles.


aws medical-imaging list-datastores

Sortie :


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

Pour plus d’informations, consultez Listing data stores dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez ListDatastores dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-dicom-import-jobs.

AWS CLI

Pour répertorier les tâches d’importation DICOM

L’exemple de code list-dicom-import-jobs suivant répertorie les tâches d’importation DICOM.


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

Sortie :


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

Pour plus d’informations, consultez Listing import jobs dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez ListDICOMImportJobs dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-image-set-versions.

AWS CLI

Pour répertorier les versions d’un ensemble d’images

L’exemple de code list-image-set-versions suivant répertorie l’historique des versions d’un ensemble d’images.


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

Sortie :


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

Pour plus d’informations, consultez Listing image set versions dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez ListImageSetVersions dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-tags-for-resource.

AWS CLI

Exemple 1 : pour répertorier les balises de ressources d’un magasin de données

L’exemple de code list-tags-for-resource suivant répertorie les balises d’un magasin de données.


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

Sortie :


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

Exemple 2 : pour répertorier les balises de ressources pour un ensemble d’images

L’exemple de code list-tags-for-resource suivant répertorie les balises d’un ensemble d’images.


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

Sortie :


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

Pour plus d’informations, consultez Balisage des ressources avec AWS HealthImaging dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez ListTagsForResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser search-image-sets.

AWS CLI

Exemple 1 : pour rechercher des ensembles d’images à l’aide d’un opérateur EQUAL

L’exemple de code search-image-sets suivant utilise l’opérateur EQUAL pour rechercher des ensembles d’images en fonction d’une valeur spécifique.


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

Contenu de search-criteria.json


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

Sortie :


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

Exemple 2 : pour rechercher des ensembles d’images avec un opérateur BETWEEN à l’aide de DICOMStudyDate et DICOMStudyTime

L’exemple de code search-image-sets suivant recherche des ensembles d’images contenant des études DICOM générées entre le 1er janvier 1990 (00h00) et le 1er janvier 2023 (00h00).

Remarque : DICOMStudyTime est facultatif. S’il n’est pas présent, 00h00 (début de journée) est la valeur horaire pour les dates fournies pour le filtrage.


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

Contenu de search-criteria.json


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

Sortie :


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

Exemple 3 : pour rechercher des ensembles d’images avec un opérateur BETWEEN à l’aide de createdAt (les études temporelles étaient précédemment conservées)

L’exemple de code search-image-sets suivant recherche des ensembles d’images contenant des études DICOM persistantes dans HealthImaging entre les plages horaires du fuseau horaire UTC.

Remarque : indiquez createdAt dans le format d’exemple (« 1985-04-12T23:20:50.52Z »).


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

Contenu de search-criteria.json


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

Sortie :


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

Exemple 4 : pour rechercher des ensembles d’images avec un opérateur EQUAL sur DICOMSeriesInstanceUID et BETWEEN sur updatedAt et trier la réponse dans l’ordre ASC sur le champ updatedAt

L’exemple de code search-image-sets suivant recherche des ensembles d’images avec un opérateur EQUAL sur DICOMSeriesInstanceUID et BETWEEN sur updatedAt et trie la réponse dans l’ordre ASC sur le champ updatedAt.

Remarque : indiquez updatedAt dans le format d’exemple (« 1985-04-12T23:20:50.52Z »).


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

Contenu de 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"
    }
}

Sortie :


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

Pour plus d’informations, consultez Searching image sets dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez SearchImageSets dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser start-dicom-import-job.

AWS CLI

Pour démarrer une tâche d’importation DICOM

L’exemple de code start-dicom-import-job suivant démarre une tâche d’importation 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"

Sortie :


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

Pour plus d’informations, consultez Starting an import job dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez StartDICOMImportJob dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser tag-resource.

AWS CLI

Exemple 1 : pour baliser un magasin de données

L’exemple de code tag-resource suivant balise un magasin de données.


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

Cette commande ne produit aucune sortie.

Exemple 2 : pour baliser un ensemble d’images

Les exemples de code tag-resource suivants balisent un ensemble d’images.


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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Balisage des ressources avec AWS HealthImaging dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez TagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser untag-resource.

AWS CLI

Exemple 1 : pour supprimer une balise d’un magasin de données

L’exemple de code untag-resource suivant supprime une balise d’un magasin de données.


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

Cette commande ne produit aucune sortie.

Exemple 2 : pour supprimer la balise d’un ensemble d’images

L’exemple de code untag-resource suivant supprime la balise d’un ensemble d’images.


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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Balisage des ressources avec AWS HealthImaging dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez UntagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-image-set-metadata.

AWS CLI

Exemple 1 : pour insérer ou mettre à jour un attribut dans les métadonnées d’un ensemble d’images

L’exemple update-image-set-metadata suivant insère ou met à jour un attribut dans les métadonnées d’un ensemble d’images.


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

Contenu de metadata-updates.json


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

Sortie :


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

Exemple 2 : pour supprimer un attribut des métadonnées d’un ensemble d’images

L’exemple update-image-set-metadata suivant supprime un attribut des métadonnées d’un ensemble d’images.


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

Contenu de metadata-updates.json


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

Sortie :


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

Exemple 3 : pour supprimer une instance des métadonnées d’un ensemble d’images

L’exemple update-image-set-metadata suivant supprime une instance des métadonnées d’un ensemble d’images.


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

Contenu de 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\": {}}}}}}"
    }
}

Sortie :


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

Exemple 4 : pour rétablir une version précédente d’un ensemble d’images

L’exemple update-image-set-metadata suivant montre comment rétablir une version précédente d’un ensemble d’images. Les actions CopyImageSet et UpdateImageSetMetadata créent de nouvelles versions d’ensembles d’images.


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

Sortie :


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

Exemple 5 : pour ajouter un élément de données DICOM privé à une instance

L’exemple update-image-set-metadata suivant montre comment ajouter un élément privé à une instance spécifiée dans un ensemble d’images. La norme DICOM autorise les éléments de données privés pour la communication d’informations qui ne peuvent être contenues dans les éléments de données standard. Vous pouvez créer, mettre à jour et supprimer des éléments de données privés à l’aide de l’action 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

Contenu de 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\"}}}}}}}"
    }
}

Sortie :


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

Exemple 6 : pour mettre à jour un élément de données DICOM privé vers une instance

L’exemple update-image-set-metadata suivant montre comment mettre à jour la valeur d’un élément de données privé appartenant à une instance au sein d’un ensemble d’images.


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

Contenu de 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\"}}}}}}}"
    }
}

Sortie :


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

Exemple 7 : pour mettre à jour un SOPInstanceUID avec le paramètre de force

L’exemple update-image-set-metadata suivant montre comment mettre à jour un SOPInstanceUID en utilisant le paramètre de force pour contourner les contraintes de métadonnées 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

Contenu de 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\"}}}}}}}"
    }
}

Sortie :


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

Pour plus d’informations, consultez Updating image set metadata dans le Manuel du développeur AWS HealthImaging.

Pour plus de détails sur l’API, consultez UpdateImageSetMetadata dans la Référence des commandes de l’AWS CLI.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

AWS Health

HealthLake