# Ejemplos de HealthImaging que utilizan la AWS CLI
En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con HealthImaging.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `copy-image-set`
En el siguiente ejemplo de código, se muestra cómo utilizar `copy-image-set`.
**AWS CLI**
**Ejemplo 1: copia de un conjunto de imágenes sin un destino.**
El siguiente ejemplo de `copy-image-set` crea una copia duplicada de un conjunto de imágenes sin un destino.
```
aws medical-imaging copy-image-set \
--datastore-id 12345678901234567890123456789012 \
--source-image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--copy-image-set-information '{"sourceImageSet": {"latestVersionId": "1" } }'
```
Salida:
```
{
"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"
}
```
**Ejemplo 2: copia de un conjunto de imágenes con un destino.**
El siguiente ejemplo de `copy-image-set` crea una copia duplicada de un conjunto de imágenes con un destino.
```
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"} }'
```
Salida:
```
{
"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"
}
```
**Ejemplo 3: copiar un subconjunto de instancias de un conjunto de imágenes de origen a un conjunto de imágenes de destino.**
El siguiente ejemplo de `copy-image-set` copia una instancia de DICOM del conjunto de imágenes de origen al conjunto de imágenes de destino. El parámetro force se proporciona para anular las incoherencias en los atributos de nivel de paciente, estudio y serie.
```
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
```
Salida:
```
{
"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"
}
```
Para obtener más información, consulte [Copying an image set](https://docs.aws.amazon.com/healthimaging/latest/devguide/copy-image-set.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [CopyImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/copy-image-set.html) en la *Referencia de comandos de la AWS CLI*.
### `create-datastore`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-datastore`.
**AWS CLI**
**Ejemplo 1: Creación de un almacén de datos**
En el siguiente ejemplo de código `create-datastore` se crea un almacén de datos con el nombre `my-datastore`. Al crear un almacén de datos sin especificar un `--lossless-storage-format`, AWS HealthImaging toma como valor predeterminado HTJ2K (JPEG 2000 de alto rendimiento).
```
aws medical-imaging create-datastore \
--datastore-name "my-datastore"
```
Salida:
```
{
"datastoreId": "12345678901234567890123456789012",
"datastoreStatus": "CREATING"
}
```
**Ejemplo 2: Creación de un almacén de datos con el formato de almacenamiento JPEG 2000 sin pérdidas**
Un almacén de datos configurado con el formato de almacenamiento JPEG 2000 sin pérdidas transcodificará y conservará los fotogramas de imagen sin pérdidas en formato JPEG 2000. A continuación, los fotogramas de imagen se pueden recuperar en JPEG 2000 sin pérdidas sin necesidad de transcodificación. En el ejemplo de código `create-datastore` siguiente, se crea un almacén de datos configurado para el formato de almacenamiento JPEG 2000 sin pérdidas con el nombre `my-datastore`.
```
aws medical-imaging create-datastore \
--datastore-name "my-datastore" \
--lossless-storage-format JPEG_2000_LOSSLESS
```
Salida:
```
{
"datastoreId": "12345678901234567890123456789012",
"datastoreStatus": "CREATING"
}
```
Para obtener más información, consulte [Creating a data store](https://docs.aws.amazon.com/healthimaging/latest/devguide/create-data-store.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [CreateDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/create-datastore.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-datastore`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-datastore`.
**AWS CLI**
**Eliminación de un almacén de datos**
En el siguiente ejemplo de código `delete-datastore` se elimina un almacén de datos.
```
aws medical-imaging delete-datastore \
--datastore-id "12345678901234567890123456789012"
```
Salida:
```
{
"datastoreId": "12345678901234567890123456789012",
"datastoreStatus": "DELETING"
}
```
Para obtener más información, consulte [Deleting a data store](https://docs.aws.amazon.com/healthimaging/latest/devguide/delete-data-store.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [DeleteDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/delete-datastore.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-image-set`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-image-set`.
**AWS CLI**
**Eliminación de un conjunto de imágenes**
En el siguiente ejemplo de código `delete-image-set` se elimina un conjunto de imágenes.
```
aws medical-imaging delete-image-set \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e
```
Salida:
```
{
"imageSetWorkflowStatus": "DELETING",
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"datastoreId": "12345678901234567890123456789012"
}
```
Para obtener más información, consulte [Deleting an image set](https://docs.aws.amazon.com/healthimaging/latest/devguide/delete-image-set.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [DeleteImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/delete-image-set.html) en la *Referencia de comandos de la AWS CLI*.
### `get-datastore`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-datastore`.
**AWS CLI**
**Ejemplo 1: Obtención de las propiedades de un almacén de datos**
En el siguiente ejemplo de código `get-datastore` se obtienen las propiedades de un almacén de datos.
```
aws medical-imaging get-datastore \
--datastore-id 12345678901234567890123456789012
```
Salida:
```
{
"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"
}
}
```
**Ejemplo 2: Obtención de las propiedades del almacén de datos configuradas para JPEG2000**
En el ejemplo de código `get-datastore` siguiente, se obtienen las propiedades de un almacén de datos configurado para el formato de almacenamiento JPEG 2000 sin pérdidas.
```
aws medical-imaging get-datastore \
--datastore-id 12345678901234567890123456789012
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Getting data store properties](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-data-store.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [GetDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-datastore.html) en la *Referencia de comandos de la AWS CLI*.
### `get-dicom-import-job`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-dicom-import-job`.
**AWS CLI**
**Obtención de las propiedades de un trabajo de importación DICOM**
En el siguiente ejemplo de código `get-dicom-import-job` se obtienen las propiedades de un trabajo de importación DICOM.
```
aws medical-imaging get-dicom-import-job \
--datastore-id "12345678901234567890123456789012" \
--job-id "09876543210987654321098765432109"
```
Salida:
```
{
"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/"
}
}
```
Para obtener más información, consulte [Getting import job properties](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-dicom-import-job.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [GetDICOMImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-dicom-import-job.html) en la *Referencia de comandos de la AWS CLI*.
### `get-image-frame`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-image-frame`.
**AWS CLI**
**Obtención de datos de píxeles de un conjunto de imágenes**
En el siguiente ejemplo de código `get-image-frame` se obtiene un marco de una imagen.
```
aws medical-imaging get-image-frame \
--datastore-id "12345678901234567890123456789012" \
--image-set-id "98765412345612345678907890789012" \
--image-frame-information imageFrameId=3abf5d5d7ae72f80a0ec81b2c0de3ef4 \
imageframe.jph
```
Nota: Este código de ejemplo no incluye la salida porque la acción GetImageFrame devuelve un flujo de datos de píxeles al archivo imageframe.jph. Para obtener información sobre la decodificación y la visualización de marcos de imágenes, consulte las bibliotecas de decodificación HTJ2K.
Para obtener más información, consulte [Getting image set pixel data](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-frame.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [GetImageFrame](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-frame.html) en la *Referencia de comandos de la AWS CLI*.
### `get-image-set-metadata`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-image-set-metadata`.
**AWS CLI**
**Ejemplo 1: obtención de los metadatos de un conjunto de imágenes sin versión**
En el siguiente ejemplo de código `get-image-set-metadata` se obtienen los metadatos de un conjunto de imágenes sin especificar una versión.
Nota: El parámetro `outfile` es obligatorio
```
aws medical-imaging get-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
studymetadata.json.gz
```
Los metadatos devueltos se comprimen con gzip y se almacenan en el archivo studymetadata.json.gz. Para ver el contenido del objeto JSON devuelto, primero debe descomprimirlo.
Salida:
```
{
"contentType": "application/json",
"contentEncoding": "gzip"
}
```
**Ejemplo 2: obtención de los metadatos de un conjunto de imágenes con versión**
En el siguiente ejemplo de código `get-image-set-metadata` se obtienen los metadatos de un conjunto de imágenes con una versión especificada.
Nota: El parámetro `outfile` es obligatorio
```
aws medical-imaging get-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e \
--version-id 1 \
studymetadata.json.gz
```
Los metadatos devueltos se comprimen con gzip y se almacenan en el archivo studymetadata.json.gz. Para ver el contenido del objeto JSON devuelto, primero debe descomprimirlo.
Salida:
```
{
"contentType": "application/json",
"contentEncoding": "gzip"
}
```
Para obtener más información, consulte [Getting image set metadata](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-metadata.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [GetImageSetMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set-metadata.html) en la *Referencia de comandos de la AWS CLI*.
### `get-image-set`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-image-set`.
**AWS CLI**
**Obtención de las propiedades de un conjunto de imágenes**
En el siguiente ejemplo de código `get-image-set` se obtienen las propiedades de un conjunto de imágenes.
```
aws medical-imaging get-image-set \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 18f88ac7870584f58d56256646b4d92b \
--version-id 1
```
Salida:
```
{
"versionId": "1",
"imageSetWorkflowStatus": "COPIED",
"updatedAt": 1680027253.471,
"imageSetId": "18f88ac7870584f58d56256646b4d92b",
"imageSetState": "ACTIVE",
"createdAt": 1679592510.753,
"datastoreId": "12345678901234567890123456789012"
}
```
Para obtener más información, consulte [Getting image set properties](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-properties.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [GetImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set.html) en la *Referencia de comandos de la AWS CLI*.
### `list-datastores`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-datastores`.
**AWS CLI**
**Enumeración de almacenes de datos**
En el siguiente ejemplo de código `list-datastores` se enumeran los almacenes de datos disponibles.
```
aws medical-imaging list-datastores
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Listing data stores](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-data-stores.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [ListDatastores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-datastores.html) en la *Referencia de comandos de la AWS CLI*.
### `list-dicom-import-jobs`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-dicom-import-jobs`.
**AWS CLI**
**Enumeración de los trabajos de importación DICOM**
En el siguiente ejemplo de código `list-dicom-import-jobs` se enumeran los trabajos de importación DICOM.
```
aws medical-imaging list-dicom-import-jobs \
--datastore-id "12345678901234567890123456789012"
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Listing import jobs](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-dicom-import-jobs.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [ListDICOMImportJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-dicom-import-jobs.html) en la *Referencia de comandos de la AWS CLI*.
### `list-image-set-versions`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-image-set-versions`.
**AWS CLI**
**Enumeración de las versiones de un conjunto de imágenes**
En el siguiente ejemplo de código `list-image-set-versions` se enumera el historial de versiones de un conjunto de imágenes.
```
aws medical-imaging list-image-set-versions \
--datastore-id 12345678901234567890123456789012 \
--image-set-id ea92b0d8838c72a3f25d00d13616f87e
```
Salida:
```
{
"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
}
]
}
```
Para obtener más información, consulte [Listing image set versions](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-image-set-versions.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [ListImageSetVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-image-set-versions.html) en la *Referencia de comandos de la AWS CLI*.
### `list-tags-for-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.
**AWS CLI**
**Ejemplo 1: enumeración de las etiquetas de recursos de un almacén de datos**
En el siguiente ejemplo de código `list-tags-for-resource` se enumeran las etiquetas de un almacén de datos.
```
aws medical-imaging list-tags-for-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012"
```
Salida:
```
{
"tags":{
"Deployment":"Development"
}
}
```
**Ejemplo 2: enumeración de las etiquetas de recursos de un conjunto de imágenes**
En el siguiente ejemplo de código `list-tags-for-resource` se enumeran las etiquetas de un conjunto de imágenes.
```
aws medical-imaging list-tags-for-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b"
```
Salida:
```
{
"tags":{
"Deployment":"Development"
}
}
```
Para obtener más información, consulte [Tagging resources with AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para ver los detalles de la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-tags-for-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `search-image-sets`
En el siguiente ejemplo de código, se muestra cómo utilizar `search-image-sets`.
**AWS CLI**
**Ejemplo 1: búsqueda de conjuntos de imágenes con un operador EQUAL**
En el siguiente ejemplo de código `search-image-sets` se usa el operador EQUAL para buscar conjuntos de imágenes en función de un valor específico.
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Contenido de `search-criteria.json`
```
{
"filters": [{
"values": [{"DICOMPatientId" : "SUBJECT08701"}],
"operator": "EQUAL"
}]
}
```
Salida:
```
{
"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"
}]
}
```
**Ejemplo 2: búsqueda de conjuntos de imágenes con un operador BETWEEN mediante DICOMStudyDate y DICOMStudyTime**
En el siguiente ejemplo de código `search-image-sets` se buscan conjuntos de imágenes con estudios DICOM generados entre el 1 de enero de 1990 (00:00 h) y el 1 de enero de 2023 (00:00 h).
Nota: DICOMStudyTime es opcional. Si no está presente, el valor de hora de las fechas indicado para el filtrado es a las 00:00 h (inicio del día).
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Contenido de `search-criteria.json`
```
{
"filters": [{
"values": [{
"DICOMStudyDateAndTime": {
"DICOMStudyDate": "19900101",
"DICOMStudyTime": "000000"
}
},
{
"DICOMStudyDateAndTime": {
"DICOMStudyDate": "20230101",
"DICOMStudyTime": "000000"
}
}],
"operator": "BETWEEN"
}]
}
```
Salida:
```
{
"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"
}]
}
```
**Ejemplo 3: búsqueda de conjuntos de imágenes con un operador BETWEEN mediante createdAt (los estudios de tiempo se conservaban previamente)**
En el siguiente ejemplo de código `search-image-sets` se buscan conjuntos de imágenes con estudios DICOM que se conservan en HealthImaging entre los periodos de tiempo de la zona horaria UTC.
Nota: Ingrese createdAt en el formato de ejemplo (“1985-04-12T23:20:50.52Z”).
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Contenido de `search-criteria.json`
```
{
"filters": [{
"values": [{
"createdAt": "1985-04-12T23:20:50.52Z"
},
{
"createdAt": "2022-04-12T23:20:50.52Z"
}],
"operator": "BETWEEN"
}]
}
```
Salida:
```
{
"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"
}]
}
```
**Ejemplo 4: buscar conjuntos de imágenes con un operador EQUAL en DICOMSeriesInstanceUID y BETWEEN en updatedAt y ordenar la respuesta en orden ASC en el campo updatedAt**
El siguiente código `search-image-sets` busca conjuntos de imágenes con un operador EQUAL en DICOMSeriesInstanceUID y BETWEEN en updatedAt y ordena la respuesta en orden ASC en el campo updatedAt.
Nota: Introduzca updatedAt en el formato de ejemplo ("1985-04-12T23:20:50.52Z").
```
aws medical-imaging search-image-sets \
--datastore-id 12345678901234567890123456789012 \
--search-criteria file://search-criteria.json
```
Contenido 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"
}
}
```
Salida:
```
{
"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"
}]
}
```
Para obtener más información, consulte [Searching image sets](https://docs.aws.amazon.com/healthimaging/latest/devguide/search-image-sets.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [SearchImageSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/search-image-sets.html) en la *Referencia de comandos de la AWS CLI*.
### `start-dicom-import-job`
En el siguiente ejemplo de código, se muestra cómo utilizar `start-dicom-import-job`.
**AWS CLI**
**Inicio de un trabajo de importación DICOM**
En el siguiente ejemplo de código `start-dicom-import-job` se inicia un trabajo de importación 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"
```
Salida:
```
{
"datastoreId": "12345678901234567890123456789012",
"jobId": "09876543210987654321098765432109",
"jobStatus": "SUBMITTED",
"submittedAt": "2022-08-12T11:28:11.152000+00:00"
}
```
Para obtener más información, consulte [Starting an import job](https://docs.aws.amazon.com/healthimaging/latest/devguide/start-dicom-import-job.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [StartDICOMImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/start-dicom-import-job.html) en la *Referencia de comandos de la AWS CLI*.
### `tag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `tag-resource`.
**AWS CLI**
**Ejemplo 1: etiquetado de un almacén de datos**
En los siguientes ejemplos de código `tag-resource` se etiqueta un almacén de datos.
```
aws medical-imaging tag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012" \
--tags '{"Deployment":"Development"}'
```
Este comando no genera ninguna salida.
**Ejemplo 2: etiquetado de un conjunto de imágenes**
En los siguientes ejemplos de código `tag-resource` se etiqueta un conjunto de imágenes.
```
aws medical-imaging tag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b" \
--tags '{"Deployment":"Development"}'
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Tagging resources with AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para ver los detalles de la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/tag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `untag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `untag-resource`.
**AWS CLI**
**Ejemplo 1: eliminación de las etiquetas de un almacén de datos**
En el siguiente ejemplo de código `untag-resource` se eliminan las etiquetas de un almacén de datos.
```
aws medical-imaging untag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012" \
--tag-keys '["Deployment"]'
```
Este comando no genera ninguna salida.
**Ejemplo 2: eliminación de las etiquetas de un conjunto de imágenes**
En el siguiente ejemplo de código `untag-resource` se eliminan las etiquetas de un conjunto de imágenes.
```
aws medical-imaging untag-resource \
--resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b" \
--tag-keys '["Deployment"]'
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Tagging resources with AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para ver los detalles de la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/untag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `update-image-set-metadata`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-image-set-metadata`.
**AWS CLI**
**Ejemplo 1: insertar o actualizar un atributo en los metadatos del conjunto de imágenes**
El siguiente ejemplo de `update-image-set-metadata` inserta o actualiza un atributo en los metadatos del conjunto de imágenes
```
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
```
Contenido de `metadata-updates.json`
```
{
"DICOMUpdates": {
"updatableAttributes": "{\"SchemaVersion\":1.1,\"Patient\":{\"DICOM\":{\"PatientName\":\"MX^MX\"}}}"
}
}
```
Salida:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Ejemplo 2: eliminar un atributo de los metadatos del conjunto de imágenes**
El siguiente ejemplo de `update-image-set-metadata` elimina un atributo de los metadatos del conjunto de imágenes
```
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
```
Contenido de `metadata-updates.json`
```
{
"DICOMUpdates": {
"removableAttributes": "{\"SchemaVersion\":1.1,\"Study\":{\"DICOM\":{\"StudyDescription\":\"CHEST\"}}}"
}
}
```
Salida:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Ejemplo 3: eliminar una instancia de los metadatos del conjunto de imágenes**
El siguiente ejemplo de `update-image-set-metadata` elimina una instancia de los metadatos del conjunto de imágenes
```
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
```
Contenido 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\": {}}}}}}"
}
}
```
Salida:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "ea92b0d8838c72a3f25d00d13616f87e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Ejemplo 4: revertir un conjunto de imágenes a una versión anterior**
El siguiente ejemplo de `update-image-set-metadata` muestra cómo revertir un conjunto de imágenes a una versión anterior. Las acciones CopyImageSet y UpdateImageSetMetadata crean nuevas versiones de los conjuntos de imágenes.
```
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"}'
```
Salida:
```
{
"datastoreId": "12345678901234567890123456789012",
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"latestVersionId": "4",
"imageSetState": "LOCKED",
"imageSetWorkflowStatus": "UPDATING",
"createdAt": 1680027126.436,
"updatedAt": 1680042257.908
}
```
**Ejemplo 5: añadir un elemento de datos DICOM privado a una instancia**
El siguiente ejemplo de `update-image-set-metadata` muestra cómo añadir un elemento privado a una instancia específica en un conjunto de imágenes. El estándar DICOM permite que los elementos de datos privados comuniquen información que no puede estar contenida en elementos de datos estándar. Puede crear, actualizar y eliminar elementos de datos privados con la acción UpdateImageSetMetadata.
```
aws medical-imaging update-image-set-metadata \
--datastore-id 12345678901234567890123456789012 \
--image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \
--latest-version-id 1 \
--cli-binary-format raw-in-base64-out \
--force \
--update-image-set-metadata-updates file://metadata-updates.json
```
Contenido 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\"}}}}}}}"
}
}
```
Salida:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Ejemplo 6: actualizar un elemento de datos DICOM privado a una instancia**
El siguiente ejemplo de `update-image-set-metadata` muestra cómo actualizar el valor de un elemento de datos privado que pertenece a una instancia en un conjunto de imágenes.
```
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
```
Contenido 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\"}}}}}}}"
}
}
```
Salida:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
**Ejemplo 7: actualizar un SOPInstanceUID con el parámetro force**
En el siguiente ejemplo de `update-image-set-metadata`, se muestra cómo actualizar un SOPInstanceUID mediante el parámetro force para anular las restricciones de metadatos de 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
```
Contenido 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\"}}}}}}}"
}
}
```
Salida:
```
{
"latestVersionId": "2",
"imageSetWorkflowStatus": "UPDATING",
"updatedAt": 1680042257.908,
"imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e",
"imageSetState": "LOCKED",
"createdAt": 1680027126.436,
"datastoreId": "12345678901234567890123456789012"
}
```
Para obtener más información, consulte [Updating image set metadata](https://docs.aws.amazon.com/healthimaging/latest/devguide/update-image-set-metadata.html) en la *Guía para desarrolladores de AWS HealthImaging*.
+ Para obtener información sobre la API, consulte [UpdateImageSetMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/update-image-set-metadata.html) en la *Referencia de comandos de la AWS CLI*.