Exemplos do HealthImaging usando a AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o HealthImaging.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

Ações

O código de exemplo a seguir mostra como usar copy-image-set.

AWS CLI

Exemplo 1: para copiar um conjunto de imagens sem um destino.

O exemplo copy-image-set a seguir cria uma cópia duplicada de um conjunto de imagens sem um destino.


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

Saída:


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

Exemplo 2: para copiar um conjunto de imagens com um destino.

O exemplo copy-image-set a seguir cria uma cópia duplicada de um conjunto de imagens com um 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"} }'

Saída:


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

Exemplo 3: copiar um subconjunto de instâncias de um conjunto de imagens de origem para um conjunto de imagens de destino.

O exemplo copy-image-set a seguir copia uma instância DICOM do conjunto de imagens de origem para o conjunto de imagens de destino. O parâmetro force é fornecido para substituir inconsistências nos atributos dos níveis Patient, Study e 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

Saída:


{
    "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 obter mais informações, consulte Copiar um conjunto de imagens no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte CopyImageSet na AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar create-datastore.

AWS CLI

Para criar um armazenamento de dados

O exemplo de código create-datastore a seguir cria um armazenamento de dados com o nome de my-datastore.


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

Saída:


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

Para obter mais informações, consulte Criar um data store no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes da API, consulte CreateDatastore na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar delete-datastore.

AWS CLI

Para excluir um armazenamento de dados

O exemplo de código delete-datastore a seguir exclui um armazenamento de dados.


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

Saída:


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

Para obter mais informações, consulte Excluir um data store no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes da API, consulte DeleteDatastore na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar delete-image-set.

AWS CLI

Para excluir um conjunto de imagens

O exemplo de código delete-image-set a seguir exclui um conjunto de imagens.


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

Saída:


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

Para obter mais informações, consulte Excluir um conjunto de imagens no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte DeleteImageSet na AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar get-datastore.

AWS CLI

Para obter as propriedades de um armazenamento de dados

O exemplo de código get-datastore a seguir obtém as propriedades de um armazenamento de dados.


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

Saída:


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

Para obter mais informações, consulte Obter as propriedades de um data store no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes da API, consulte GetDatastore na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar get-dicom-import-job.

AWS CLI

Para obter as propriedades de um trabalho de importação dicom

O exemplo de código get-dicom-import-job a seguir obtém as propriedades de um trabalho de importação dicom.


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

Saída:


{
    "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 obter mais informações, consulte Obter as propriedades de um trabalho de importação no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte GetDICOMImportJob na AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar get-image-frame.

AWS CLI

Para obter dados de pixels do conjunto de imagens

O exemplo de código get-image-frame a seguir obtém um quadro de imagem.


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

Observação: esse exemplo de código não inclui uma saída porque a ação GetImageFrame retorna um fluxo de dados de pixels para o arquivo imageframe.jph . Para obter informações sobre decodificação e visualização de quadros de imagem, consulte as bibliotecas de decodificação HTJ2K.

Para obter mais informações, consulte Obter dados de pixel de um conjunto de imagens no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte GetImageFrame na AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar get-image-set-metadata.

AWS CLI

Exemplo 1: para obter os metadados de um conjunto de imagens sem versão

O exemplo de código get-image-set-metadata a seguir obtém metadados para um conjunto de imagens sem especificar uma versão.

Observação: outfile é um parâmetro obrigatório


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

Os metadados retornados são compactados com o gzip e armazenados no arquivo studymetadata.json.gz. Para visualizar o conteúdo do objeto JSON retornado, você deve primeiro descompactá-lo.

Saída:


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

Exemplo 2: para obter os metadados de um conjunto de imagens com versão

O exemplo de código get-image-set-metadata a seguir obtém metadados para um conjunto de imagens com uma versão especificada.

Observação: outfile é um parâmetro obrigatório


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

Os metadados retornados são compactados com o gzip e armazenados no arquivo studymetadata.json.gz. Para visualizar o conteúdo do objeto JSON retornado, você deve primeiro descompactá-lo.

Saída:


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

Para obter mais informações, consulte Obter metadados de um conjunto de imagem no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte GetImageSetMetadata na AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar get-image-set.

AWS CLI

Para obter as propriedades do conjunto de imagens

O exemplo de código get-image-set a seguir obtém as propriedades de um conjunto de imagens.


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

Saída:


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

Para obter mais informações, consulte Obter as propriedades de um conjunto de imagem no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte GetImageSet na AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar list-datastores.

AWS CLI

Para listar armazenamentos de dados

O exemplo de código list-datastores a seguir lista os armazenamentos de dados disponíveis.


aws medical-imaging list-datastores

Saída:


{
    "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 obter mais informações, consulte Listar data stores no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes da API, consulte ListDatastores na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar list-dicom-import-jobs.

AWS CLI

Para listar trabalhos de importação dicom

O exemplo de código list-dicom-import-jobs a seguir lista os trabalhos de importação dicom.


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

Saída:


{
    "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 obter mais informações, consulte Listar trabalhos de importação no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte ListDICOMImportJobs na AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar list-image-set-versions.

AWS CLI

Para listar as versões de um conjunto de imagens

O exemplo de código list-image-set-versions a seguir lista o histórico de versões de um conjunto de imagens.


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

Saída:


{
    "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 obter mais informações, consulte Listar versões de um conjunto de imagens no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte ListImageSetVersions na AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar list-tags-for-resource.

AWS CLI

Exemplo 1: para listar as tags de recurso de um armazenamento de dados

O exemplo de código list-tags-for-resource a seguir lista as tags de um armazenamento de dados.


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

Saída:


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

Exemplo 2: para listar tags de recurso de um conjunto de imagens

O exemplo de código list-tags-for-resource a seguir lista as tags de um conjunto de imagens.


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

Saída:


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

Para obter mais informações, consulte Adicionar tags a recursos com o AWS HealthImaging no Guia do desenvolvedor do AWS HealthImaging.

Para ver detalhes sobre a API, consulte ListTagsForResource na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar search-image-sets.

AWS CLI

Exemplo 1: para pesquisar conjuntos de imagens com um operador EQUAL

O exemplo de código search-image-sets a seguir usa o operador EQUAL para pesquisar conjuntos de imagens com base em um valor específico.


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

Conteúdo de search-criteria.json


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

Saída:


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

Exemplo 2: para pesquisar conjuntos de imagens com um operador BETWEEN usando DICOMStudyDate e DICOMStudyTime

O exemplo de código search-image-sets a seguir pesquisa conjuntos de imagens com estudos DICOM gerados entre 1º de janeiro de 1990 (00h) e 1º de janeiro de 2023 (00h).

Observação: DICOMStudyTime é opcional. Se não estiver presente, 00h (início do dia) é o valor da hora para as datas fornecidas para filtragem.


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

Conteúdo de search-criteria.json


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

Saída:


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

Exemplo 3: para pesquisar conjuntos de imagens com um operador BETWEEN usando createdAt (os estudos de tempo persistiam anteriormente)

O exemplo de código search-image-sets a seguir pesquisa conjuntos de imagens com estudos DICOM que persistiram no HealthImaging entre os intervalos de tempo no fuso horário UTC.

Observação: forneça createdAt no formato do exemplo ("1985-04-12T23:20:50.52Z").


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

Conteúdo de search-criteria.json


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

Saída:


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

Exemplo 4: pesquisar conjuntos de imagens com um operador EQUAL em DICOMSeriesInstanceUID e BETWEEN em updatedAt e classificar a resposta em ordem ASC no campo updatedAt

O exemplo de código search-image-sets a seguir pesquisa conjuntos de imagens com um operador EQUAL em DICOMSeriesInstanceUID e BETWEEN em updatedAt e classificar a resposta em ordem ASC no campo updatedAt.

Observação: forneça updatedAt no formato do exemplo ("1985-04-12T23:20:50.52Z").


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

Conteúdo 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"
    }
}

Saída:


{
    "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 obter mais informações, consulte Pesquisar conjuntos de imagens no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte SearchImageSets na AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar start-dicom-import-job.

AWS CLI

Para iniciar um trabalho de importação dicom

O exemplo de código start-dicom-import-job a seguir inicia um trabalho de importação 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"

Saída:


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

Para obter mais informações, consulte Iniciar um trabalho de importação no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte StartDICOMImportJob na AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar tag-resource.

AWS CLI

Exemplo 1: para marcar um armazenamento de dados

Os exemplos de código tag-resource a seguir marcam um armazenamento de dados.


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

Este comando não produz saída.

Exemplo 2: para marcar um conjunto de imagens

Os exemplos de código tag-resource a seguir marcam um conjunto de imagens.


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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar tags a recursos com o AWS HealthImaging no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes da API, consulte TagResource na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar untag-resource.

AWS CLI

Exemplo 1: para desmarcar um armazenamento de dados

O exemplo de código untag-resource a seguir desmarca um armazenamento de dados.


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

Este comando não produz saída.

Exemplo 2: para desmarcar um conjunto de imagens

O exemplo de código untag-resource a seguir desmarca um conjunto de imagens.


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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar tags a recursos com o AWS HealthImaging no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte UntagResource na AWS CLI Command Reference.

O código de exemplo a seguir mostra como usar update-image-set-metadata.

AWS CLI

Exemplo 1: inserir ou atualizar um atributo nos metadados do conjunto de imagens

O exemplo update-image-set-metadata a seguir insere ou atualiza um atributo nos metadados do conjunto de imagens.


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

Conteúdo de metadata-updates.json


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

Saída:


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

Exemplo 2: remover um atributo dos metadados do conjunto de imagens

O exemplo update-image-set-metadata a seguir remove um atributo dos metadados do conjunto de imagens.


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

Conteúdo de metadata-updates.json


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

Saída:


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

Exemplo 3: remover uma instância dos metadados de um conjunto de imagens

O exemplo update-image-set-metadata a seguir remove uma instância dos metadados de um conjunto de imagens.


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

Conteúdo 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\": {}}}}}}"
    }
}

Saída:


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

Exemplo 4: reverter um conjunto de imagens para uma versão anterior

O exemplo update-image-set-metadata a seguir mostra como reverter um conjunto de imagens para uma versão anterior. As ações CopyImageSet e UpdateImageSetMetadata criam novas versões dos conjuntos de imagens.


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

Saída:


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

Exemplo 5: adicionar um elemento de dados DICOM privado a uma instância

O exemplo update-image-set-metadata a seguir mostra como adicionar um elemento privado a uma instância especificada em um conjunto de imagens. O padrão DICOM permite elementos de dados privados para comunicação de informações que não podem estar contidas em elementos de dados padrão. É possível criar, editar e excluir elementos de dados privados com a ação 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

Conteúdo 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\"}}}}}}}"
    }
}

Saída:


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

Exemplo 6: atualizar um elemento de dados DICOM privado a uma instância

O exemplo update-image-set-metadata a seguir mostra como atualizar o valor de um elemento privado que pertence a uma instância em um conjunto de imagens.


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

Conteúdo 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\"}}}}}}}"
    }
}

Saída:


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

Exemplo 7: atualizar um SOPInstanceUID com o parâmetro force

O exemplo update-image-set-metadata a seguir mostra como atualizar um SOPInstanceUID usando o parâmetro force para substituir as restrições de metadados 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

Conteúdo 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\"}}}}}}}"
    }
}

Saída:


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

Para obter mais informações, consulte Atualizar os metadados de um conjunto de imagens no Guia do desenvolvedor do AWS HealthImaging.

Para obter detalhes sobre a API, consulte UpdateImageSetMetadata na AWS CLI Command Reference.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

AWS Health

HealthLake