HealthImaging exemples utilisant AWS CLI - AWS Command Line Interface
Actions

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

HealthImaging exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with 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

L'exemple de code suivant montre comment utilisercopy-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 la section Copier un ensemble d'images dans le manuel du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous CopyImageSetà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-datastore.

AWS CLI

Exemple 1 : 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. Lorsque vous créez une banque de données sans spécifier a--lossless-storage-format, la AWS HealthImaging valeur par défaut est HTJ2 K (High Throughput JPEG 2000).

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

Sortie :

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

Exemple 2 : pour créer un magasin de données au format de stockage sans perte JPEG 2000

Un magasin de données configuré avec le format de stockage sans perte JPEG 2000 transcode et conserve les images sans perte au format JPEG 2000. Les images peuvent ensuite être récupérées au format JPEG 2000 Lossless sans transcodage. L'exemple de create-datastore code suivant crée un magasin de données configuré pour le format de stockage JPEG 2000 Lossless avec le nommy-datastore.

aws medical-imaging create-datastore \
    --datastore-name "my-datastore" \
    --lossless-storage-format JPEG_2000_LOSSLESS

Sortie :

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

Pour plus d'informations, consultez la section Création d'un magasin de données dans le Guide du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous CreateDatastoreà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-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 la section Suppression d'un magasin de données dans le guide du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous DeleteDatastoreà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-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 la section Suppression d'un ensemble d'images dans le manuel du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous DeleteImageSetà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-datastore.

AWS CLI

Exemple 1 : 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",
        "losslessStorageFormat": "HTJ2K"
        "datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012",
        "createdAt": "2022-11-15T23:33:09.643000+00:00",
        "updatedAt": "2022-11-15T23:33:09.643000+00:00"
    }
}

Exemple 2 : pour obtenir les propriétés du magasin de données configurées pour JPEG2 000

L'exemple de get-datastore code suivant permet d'obtenir les propriétés d'un magasin de données pour un magasin de données configuré pour le format de stockage sans perte JPEG 2000.

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

Sortie :

{
    "datastoreProperties": {
        "datastoreId": "12345678901234567890123456789012",
        "datastoreName": "TestDatastore123",
        "datastoreStatus": "ACTIVE",
        "losslessStorageFormat": "JPEG_2000_LOSSLESS",
        "datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012",
        "createdAt": "2022-11-15T23:33:09.643000+00:00",
        "updatedAt": "2022-11-15T23:33:09.643000+00:00"
    }
}

Pour plus d'informations, consultez la section Obtenir les propriétés du magasin de données dans le Guide du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous GetDatastoreà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-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 la section Obtenir les propriétés des tâches d'importation dans le Guide du AWS HealthImaging développeur.

L'exemple de code suivant montre comment utiliserget-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' GetImageFrame action 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 trames d'images, consultez la section Bibliothèques de décodage HTJ2 K.

Pour plus d'informations, consultez la section Obtenir des données en pixels d'un ensemble d'images dans le Guide du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous GetImageFrameà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-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

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

Pour plus d'informations, consultez la section Obtenir les métadonnées d'un ensemble d'images dans le manuel du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous GetImageSetMetadataà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-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 la section Obtenir les propriétés d'un ensemble d'images dans le manuel du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous GetImageSetà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-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 la section Répertorier les banques de données dans le Guide du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous ListDatastoresà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-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 la section Répertorier les tâches d'importation dans le Guide du AWS HealthImaging développeur.

L'exemple de code suivant montre comment utiliserlist-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 la section Répertorier les versions des ensembles d'images dans le manuel du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous ListImageSetVersionsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-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 la section Marquage des ressources avec AWS HealthImaging dans le Guide du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous ListTagsForResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisersearch-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 à l'aide de l'opérateur BETWEEN en utilisant DICOMStudy la date et l' DICOMStudyheure

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 (00 h 00) et le 1er janvier 2023 (00 h 00).

Remarque : DICOMStudy L'heure est facultative. S’il n’est pas présent, 00 h 00 (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 search-image-sets code suivant recherche des ensembles d'images contenant des études DICOM persistantes 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 DICOMSeries EQUAL sur InstanceUid et BETWEEN sur UpdatedAt et trier les réponses dans l'ordre ASC sur le champ UpdatedAt

L'exemple de search-image-sets code suivant recherche des ensembles d'images avec un opérateur DICOMSeries EQUAL sur InstanceUid 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 la section Recherche de séries d'images dans le Guide du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous SearchImageSetsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstart-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 la section Démarrage d'une tâche d'importation dans le Guide du AWS HealthImaging développeur.

L'exemple de code suivant montre comment utilisertag-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

L’exemple de code tag-resource suivant balise 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 la section Marquage des ressources avec AWS HealthImaging dans le Guide du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous TagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseruntag-resource.

AWS CLI

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

L’exemple de untag-resource code 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 une balise d’un ensemble d’images

L’exemple de code untag-resource suivant supprime une 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 la section Marquage des ressources avec AWS HealthImaging dans le Guide du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous UntagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-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'update-image-set-metadataexemple suivant montre comment rétablir une version antérieure d'un ensemble d'images. CopyImageSet et UpdateImageSetMetadata les actions créent de nouvelles versions de séries 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 UpdateImageSetMetadata cette action.

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 SOPInstance UID avec le paramètre force

L'update-image-set-metadataexemple suivant montre comment mettre à jour un SOPInstance UID en utilisant le paramètre 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 la section Mise à jour des métadonnées des ensembles d'images dans le manuel du AWS HealthImaging développeur.

  • Pour plus de détails sur l'API, reportez-vous UpdateImageSetMetadataà la section Référence des AWS CLI commandes.