HealthImaging exemples utilisant AWS CLI - AWS Command Line Interface
Actions

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

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 montrent comment appeler des fonctions de service individuelles, vous pouvez les visualiser dans leur contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le 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'copy-image-setexemple suivant crée une copie d'une série 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 une série d'images avec une destination.

L'copy-image-setexemple suivant crée une copie d'une série 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 : copier un sous-ensemble d'instances d'un jeu d'images source vers un ensemble d'images de destination.

L'copy-image-setexemple suivant copie une DICOM instance du jeu d'images source vers le jeu d'images de destination. Le paramètre de force est fourni pour corriger les incohérences dans les attributs des niveaux Patient, Study et 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

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 API plus de détails, voir CopyImageSetla section Référence des AWS CLI commandes.

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

AWS CLI

Pour créer un magasin de données

L'exemple de create-datastore code suivant crée un magasin de données portant le nommy-datastore.

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

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 API plus de détails, voir CreateDatastorela 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 delete-datastore code 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 API plus de détails, voir DeleteDatastorela 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 delete-image-set code 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 API plus de détails, voir DeleteImageSetla section Référence des AWS CLI commandes.

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

AWS CLI

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

L'exemple de get-datastore code suivant permet d'obtenir 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 la section Obtenir les propriétés du magasin de données dans le Guide du AWS HealthImaging développeur.

  • Pour API plus de détails, voir GetDatastorela 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 get-dicom-import-job code suivant permet d'obtenir 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 relatives aux pixels définis par image

L'exemple de get-image-frame code suivant permet d'obtenir 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 HTJ2K décodage.

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 API plus de détails, voir GetImageFramela 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 get-image-set-metadata code suivant permet d'obtenir 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'JSONobjet 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 la version

L'exemple de get-image-set-metadata code suivant permet d'obtenir 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'JSONobjet 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 API plus de détails, voir GetImageSetMetadatala 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 des ensembles d'images

L'exemple de get-image-set code suivant permet d'obtenir 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 API plus de détails, voir GetImageSetla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-datastores.

AWS CLI

Pour répertorier les magasins de données

L'exemple de list-datastores code 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 API plus de détails, voir ListDatastoresla 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 list-dicom-import-jobs code 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'ensembles d'images

L'exemple de list-image-set-versions code 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.

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 list-tags-for-resource code 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 list-tags-for-resource code 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 API plus de détails, voir ListTagsForResourcela 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 EQUAL opérateur

L'exemple de search-image-sets code suivant utilise l'EQUALopérateur 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 d'un BETWEEN opérateur utilisant DICOMStudyDate et DICOMStudyTime

L'exemple de search-image-sets code suivant recherche des ensembles d'images contenant des DICOM études 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, 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 à l'aide d'un BETWEEN opérateur en utilisant createdAt (les études temporelles étaient auparavant conservées)

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

Remarque : Fournissez un exemple createdAt de format (« 1985-04-12T 23:20:50.52 Z »).

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 EQUAL opérateur activé DICOMSeriesInstanceUID et BETWEEN activé updatedAt et trier les réponses par ASC ordre sur le updatedAt champ

L'exemple de search-image-sets code suivant recherche des ensembles d'images avec un EQUAL opérateur activé DICOMSeriesInstanceUID et BETWEEN activé updatedAt et trie les réponses par ASC ordre sur le updatedAt champ.

Remarque : Fournissez un exemple updatedAt de format (« 1985-04-12T 23:20:50.52 Z »).

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 API plus de détails, voir SearchImageSetsla 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 start-dicom-import-job code 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 étiqueter un magasin de données

Les exemples de tag-resource code suivants balisent 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 aucun résultat.

Exemple 2 : pour baliser un ensemble d'images

Les exemples de tag-resource code 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 aucun résultat.

Pour plus d'informations, consultez la section Marquage des ressources avec AWS HealthImaging dans le Guide du AWS HealthImaging développeur.

  • Pour API plus de détails, voir TagResourcela section Référence des AWS CLI commandes.

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

AWS CLI

Exemple 1 : pour supprimer le balisage d'un magasin de données

L'exemple de untag-resource code suivant supprime les balises 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 aucun résultat.

Exemple 2 : pour annuler le balisage d'un ensemble d'images

L'exemple de untag-resource code suivant supprime les balises 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 aucun résultat.

Pour plus d'informations, consultez la section Marquage des ressources avec AWS HealthImaging dans le Guide du AWS HealthImaging développeur.

  • Pour API plus de détails, voir UntagResourcela 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'update-image-set-metadataexemple suivant insère ou met à jour un attribut dans les métadonnées du jeu 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'update-image-set-metadataexemple suivant supprime un attribut des métadonnées du jeu 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'update-image-set-metadataexemple suivant supprime une instance des métadonnées du jeu 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 DICOM données privé à une instance

L'update-image-set-metadataexemple suivant montre comment ajouter un élément privé à une instance spécifiée dans un ensemble d'images. La DICOM norme autorise les éléments de données privés pour la communication d'informations qui ne peuvent pas être contenus 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 DICOM de données privé sur une instance

L'update-image-set-metadataexemple 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 force

L'update-image-set-metadataexemple suivant montre comment mettre à jour aSOPInstanceUID, en utilisant le paramètre force pour contourner les contraintes de DICOM métadonnées.

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.