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.
**Topics**
+ [Actions](#actions)
## Actions
### `copy-image-set`
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 [la section Copier un ensemble d'images](https://docs.aws.amazon.com/healthimaging/latest/devguide/copy-image-set.html) dans le *manuel du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [CopyImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/copy-image-set.html)à la section *Référence des AWS CLI commandes*.
### `create-datastore`
L'exemple de code suivant montre comment utiliser`create-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 nom`my-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](https://docs.aws.amazon.com/healthimaging/latest/devguide/create-data-store.html) dans le *Guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [CreateDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/create-datastore.html)à la section *Référence des AWS CLI commandes*.
### `delete-datastore`
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 [la section Suppression d'un magasin de données](https://docs.aws.amazon.com/healthimaging/latest/devguide/delete-data-store.html) dans le *guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/delete-datastore.html)à la section *Référence des AWS CLI commandes*.
### `delete-image-set`
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 [la section Suppression d'un ensemble d'images](https://docs.aws.amazon.com/healthimaging/latest/devguide/delete-image-set.html) dans le *manuel du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/delete-image-set.html)à la section *Référence des AWS CLI commandes*.
### `get-datastore`
L'exemple de code suivant montre comment utiliser`get-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 JPEG2000**
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](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-data-store.html) dans le *Guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [GetDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-datastore.html)à la section *Référence des AWS CLI commandes*.
### `get-dicom-import-job`
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 la section [Obtenir les propriétés des tâches d'importation](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-dicom-import-job.html) dans le *Guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, voir [Get DICOMImport Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-dicom-import-job.html) in *AWS CLI Command Reference*.
### `get-image-frame`
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' 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](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-frame.html) dans le *Guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [GetImageFrame](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-frame.html)à la section *Référence des AWS CLI commandes*.
### `get-image-set-metadata`
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
```
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](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-metadata.html) dans le *manuel du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [GetImageSetMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set-metadata.html)à la section *Référence des AWS CLI commandes*.
### `get-image-set`
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 la section [Obtenir les propriétés d'un ensemble d'images](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-properties.html) dans le *manuel du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [GetImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set.html)à la section *Référence des AWS CLI commandes*.
### `list-datastores`
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 la section [Répertorier les banques de données](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-data-stores.html) dans le *Guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [ListDatastores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-datastores.html)à la section *Référence des AWS CLI commandes*.
### `list-dicom-import-jobs`
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 la section [Répertorier les tâches d'importation](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-dicom-import-jobs.html) dans le *Guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, consultez la section [DICOMImportRépertorier les tâches](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-dicom-import-jobs.html) dans *AWS CLI Command Reference*.
### `list-image-set-versions`
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 la section [Répertorier les versions des ensembles d'images](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-image-set-versions.html) dans le *manuel du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [ListImageSetVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-image-set-versions.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
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 la section [Marquage des ressources avec AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) dans le *Guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `search-image-sets`
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 à 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](https://docs.aws.amazon.com/healthimaging/latest/devguide/search-image-sets.html) dans le *Guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [SearchImageSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/search-image-sets.html)à la section *Référence des AWS CLI commandes*.
### `start-dicom-import-job`
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 la section [Démarrage d'une tâche d'importation](https://docs.aws.amazon.com/healthimaging/latest/devguide/start-dicom-import-job.html) dans le *Guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, consultez [Start DICOMImport Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/start-dicom-import-job.html) dans *AWS CLI Command Reference*.
### `tag-resource`
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**
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](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) dans le *Guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/tag-resource.html)à la section *Référence des AWS CLI commandes*.
### `untag-resource`
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 `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](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) dans le *Guide du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/untag-resource.html)à la section *Référence des AWS CLI commandes*.
### `update-image-set-metadata`
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 \
--force
```
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-metadata`exemple 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-metadata`exemple 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](https://docs.aws.amazon.com/healthimaging/latest/devguide/update-image-set-metadata.html) dans le *manuel du AWS HealthImaging développeur*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateImageSetMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/update-image-set-metadata.html)à la section *Référence des AWS CLI commandes*.