HealthImaging を使用した の例 AWS CLI

次のコード例は、 AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています HealthImaging。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。このリンクには、コンテキスト内でコードをセットアップして実行する方法の手順が記載されています。

アクション

copy-image-set

次の例は、copy-image-set を使用する方法を説明しています。

AWS CLI

例 1：コピー先を指定せずに画像セットをコピーするには。

次の copy-image-set コード例では、コピー先を指定せずに画像セットの複製コピーを作成します。

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

出力:

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

例 2：コピー先を指定して画像セットをコピーするには。

次の copy-image-set コード例では、コピー先を指定して画像セットの複製コピーを作成します。

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

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「画像セットのコピー」を参照してください。

• API 詳細については、「 コマンドリファレンスCopyImageSet」の「」を参照してください。 AWS CLI

create-datastore

次の例は、create-datastore を使用する方法を説明しています。

AWS CLI

データストアを作成するには

次の create-datastore コード例では、my-datastore という名が付けられたデータストアを作成しています。

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

出力:

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

詳細については、「 デベロッパーガイド」の「データストアの作成」を参照してください。 AWS HealthImaging

• API 詳細については、「 コマンドリファレンスCreateDatastore」の「」を参照してください。 AWS CLI

delete-datastore

次のコード例は、delete-datastore を使用する方法を示しています。

AWS CLI

データストアを削除するには

次の delete-datastore コード例では、データストアを削除しています。

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

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「データストアの削除」を参照してください。

• API 詳細については、「 コマンドリファレンスDeleteDatastore」の「」を参照してください。 AWS CLI

delete-image-set

次のコード例は、delete-image-set を使用する方法を示しています。

AWS CLI

画像セットを削除するには

以下の delete-image-set コード例は画像セットを削除しています。

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

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「イメージセットの削除」を参照してください。

• API 詳細については、「 コマンドリファレンスDeleteImageSet」の「」を参照してください。 AWS CLI

get-datastore

次の例は、get-datastore を使用する方法を説明しています。

AWS CLI

データストアのプロパティを取得するには

次の get-datastore コード例では、データストアのプロパティを取得しています。

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

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「データストアプロパティの取得」を参照してください。

• API 詳細については、「 コマンドリファレンスGetDatastore」の「」を参照してください。 AWS CLI

get-dicom-import-job

次の例は、get-dicom-import-job を使用する方法を説明しています。

AWS CLI

DICOM インポートジョブのプロパティを取得するには

次の get-dicom-import-job コード例では、DICOM インポートジョブのプロパティを取得しています。

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

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「インポートジョブのプロパティの取得」を参照してください。

• API 詳細については、AWS CLI 「 コマンドリファレンス」の「G etDICOMImportジョブ」を参照してください。

get-image-frame

次の例は、get-image-frame を使用する方法を説明しています。

AWS CLI

画像セットのピクセルデータを取得するには

次の get-image-frame コード例では、画像フレームを取得しています。

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

注: GetImageFrame アクションはピクセルデータのストリームを imageframe.jph ファイルに返すため、このコード例には出力は含まれません。イメージフレームのデコードと表示については、「デコードライブラリHTJ2K」を参照してください。

詳細については、「 AWS HealthImaging デベロッパーガイド」の「画像セットのピクセルデータの取得」を参照してください。

• API 詳細については、「 コマンドリファレンスGetImageFrame」の「」を参照してください。 AWS CLI

get-image-set-metadata

次の例は、get-image-set-metadata を使用する方法を説明しています。

AWS CLI

例 1：画像セットのメタデータをバージョンなしで取得するには

次の get-image-set-metadata コード例では、バージョンを指定せずに画像セットのメタデータを取得しています。

注：outfile は必須のパラメータです

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

返されたメタデータは gzip で圧縮され、studymetadata.json.gz ファイルに保存されます。返されたJSONオブジェクトの内容を表示するには、まずオブジェクトを解凍する必要があります。

出力:

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

例 2：画像セットのメタデータをバージョン付きで取得するには

次の get-image-set-metadata コード例では、指定されたバージョンの画像セットのメタデータを取得しています。

注：outfile は必須のパラメータです

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

返されたメタデータは gzip で圧縮され、studymetadata.json.gz ファイルに保存されます。返されたJSONオブジェクトの内容を表示するには、まずオブジェクトを解凍する必要があります。

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「画像セットメタデータの取得」を参照してください。

• API 詳細については、「 コマンドリファレンスGetImageSetMetadata」の「」を参照してください。 AWS CLI

get-image-set

次のコード例は、get-image-set を使用する方法を示しています。

AWS CLI

画像セットのプロパティを取得するには

以下の get-image-set コード例では、画像セットのプロパティを取得しています。

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

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「イメージセットのプロパティの取得」を参照してください。

• API 詳細については、「 コマンドリファレンスGetImageSet」の「」を参照してください。 AWS CLI

list-datastores

次の例は、list-datastores を使用する方法を説明しています。

AWS CLI

データストアを一覧表示するには

次の list-datastores コード例では、利用可能なデータストアを一覧表示しています。

aws medical-imaging list-datastores

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「データストアの一覧表示」を参照してください。

• API 詳細については、「 コマンドリファレンスListDatastores」の「」を参照してください。 AWS CLI

list-dicom-import-jobs

次の例は、list-dicom-import-jobs を使用する方法を説明しています。

AWS CLI

DICOM インポートジョブを一覧表示するには

次の list-dicom-import-jobs コード例では、インポートジョブを一覧表示します。

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

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「インポートジョブの一覧表示」を参照してください。

• API 詳細については、AWS CLI 「 コマンドリファレンス」の「L istDICOMImportジョブ」を参照してください。

list-image-set-versions

次の例は、list-image-set-versions を使用する方法を説明しています。

AWS CLI

画像セットバージョンを一覧表示するには

次の list-image-set-versions コード例では、画像セットのバージョン履歴を一覧表示しています。

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

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「イメージセットのバージョンを一覧表示する」を参照してください。

• API 詳細については、「 コマンドリファレンスListImageSetVersions」の「」を参照してください。 AWS CLI

list-tags-for-resource

次の例は、list-tags-for-resource を使用する方法を説明しています。

AWS CLI

例 1：データストアリソースのタグを一覧表示するには

次の list-tags-for-resource コード例では、データストアのタグを一覧表示しています。

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

出力:

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

例 2：画像セットリソースのタグを一覧表示するには

次の list-tags-for-resource コード例では、画像セットのタグを一覧表示しています。

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

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「 によるリソースのタグ付け AWS HealthImaging」を参照してください。

• API 詳細については、「 コマンドリファレンスListTagsForResource」の「」を参照してください。 AWS CLI

search-image-sets

次の例は、search-image-sets を使用する方法を説明しています。

AWS CLI

例 1: EQUAL演算子を使用して画像セットを検索するには

次のsearch-image-setsコード例では、 EQUAL演算子を使用して、特定の値に基づいて画像セットを検索します。

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

search-criteria.json の内容

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

出力:

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

例 2: DICOMStudyDateおよび を使用してBETWEEN演算子で画像セットを検索するには DICOMStudyTime

次のsearch-image-setsコード例では、1990 年 1 月 1 日 (午前 12:00) から 2023 年 1 月 1 日 (午前 12:00) の間に生成されたDICOM調査を含む画像セットを検索します。

注: DICOMStudyTime はオプションです。入力されていない場合は、フィルターで指定された日付の時間値は午前 0 時 (1 日の始まり) になります。

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

search-criteria.json の内容

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

出力:

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

例 3: を使用してBETWEEN演算子で画像セットを検索するには createdAt （タイムスタディが以前に保持されていた）

次のsearch-image-setsコード例では、UTCタイムゾーンの HealthImaging 時間範囲内に保持されているDICOMスタディを含む画像セットを検索します。

注: サンプル形式 (1985-04-12T23:20:50.52Z」) createdAt で指定します。

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

search-criteria.json の内容

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

出力:

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

例 4: EQUALオペレータがオンDICOMSeriesInstanceUIDとBETWEENオンのイメージセットを検索 updatedAt し、フィールドでレスポンスをASC順番にソートするには updatedAt

次のsearch-image-setsコード例では、 と のEQUAL演算子を使用して画像セットを検索 updatedAt しDICOMSeriesInstanceUID、 updatedAt フィールドBETWEENでレスポンスをASC順番にソートします。

注: サンプル形式 (1985-04-12T23:20:50.52Z」) updatedAt で指定します。

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

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

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「イメージセットの検索」を参照してください。

• API 詳細については、「 コマンドリファレンスSearchImageSets」の「」を参照してください。 AWS CLI

start-dicom-import-job

次のコード例は、start-dicom-import-job を使用する方法を示しています。

AWS CLI

DICOM インポートジョブを開始するには

次の start-dicom-import-job コード例では、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"

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「インポートジョブの開始」を参照してください。

• API 詳細については、AWS CLI 「 コマンドリファレンス」の「S tartDICOMImportジョブ」を参照してください。

tag-resource

次のコード例は、tag-resource を使用する方法を示しています。

AWS CLI

例 1：データストアにタグを付けるには

次の tag-resource コード例では、データストアにタグを付けています。

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

このコマンドでは何も出力されません。

例 2：画像セットにタグを付けるには

次の tag-resource コード例では、画像セットにタグを付けています。

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

このコマンドでは何も出力されません。

詳細については、「 AWS HealthImaging デベロッパーガイド」の「 によるリソースのタグ付け AWS HealthImaging」を参照してください。

• API 詳細については、「 コマンドリファレンスTagResource」の「」を参照してください。 AWS CLI

untag-resource

次のコード例は、untag-resource を使用する方法を示しています。

AWS CLI

例 1：データストアのタグを削除するには

次の untag-resource コード例では、データストアにタグを削除します。

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

このコマンドでは何も出力されません。

例 2：画像セットにタグを削除するには

次の untag-resource コード例では、画像セットにタグを削除します。

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

このコマンドでは何も出力されません。

詳細については、「 AWS HealthImaging デベロッパーガイド」の「 によるリソースのタグ付け AWS HealthImaging」を参照してください。

• API 詳細については、「 コマンドリファレンスUntagResource」の「」を参照してください。 AWS CLI

update-image-set-metadata

次のコード例は、update-image-set-metadata を使用する方法を示しています。

AWS CLI

画像セットメタデータに属性を挿入または更新するには

次のupdate-image-set-metadataコード例では、画像セットメタデータに 属性を挿入または更新します。

aws medical-imaging update-image-set-metadata \
    --datastore-id 12345678901234567890123456789012 \
    --image-set-id ea92b0d8838c72a3f25d00d13616f87e \
    --latest-version-id 1 \
    --update-image-set-metadata-updates file://metadata-updates.json

metadata-updates.json の内容

{
    "DICOMUpdates": {
        "updatableAttributes": "eyJTY2hlbWFWZXJzaW9uIjoxLjEsIlBhdGllbnQiOnsiRElDT00iOnsiUGF0aWVudE5hbWUiOiJNWF5NWCJ9fX0="
    }
}

注: updatableAttributesは Base64 でエンコードされたJSON文字列です。エンコードされていないJSON文字列を次に示します。

{SchemaVersion"":1.1,""":{"DICOM":{"PatientNameMX^MX"}}}

出力:

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

画像セットメタデータから属性を削除するには

次のupdate-image-set-metadataコード例では、画像セットメタデータから 属性を削除します。

aws medical-imaging update-image-set-metadata \
    --datastore-id 12345678901234567890123456789012 \
    --image-set-id ea92b0d8838c72a3f25d00d13616f87e \
    --latest-version-id 1 \
    --update-image-set-metadata-updates file://metadata-updates.json

metadata-updates.json の内容

{
    "DICOMUpdates": {
        "removableAttributes": "e1NjaGVtYVZlcnNpb246MS4xLFN0dWR5OntESUNPTTp7U3R1ZHlEZXNjcmlwdGlvbjpDSEVTVH19fQo="
    }
}

注: removableAttributesは Base64 でエンコードされたJSON文字列です。エンコードされていないJSON文字列を次に示します。キーと値は、削除する属性と一致する必要があります。

{SchemaVersion"":1.1,"Study":{"DICOM":{"StudyDescriptionCHEST"}}}

出力:

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

イメージセットメタデータからインスタンスを削除するには

次のupdate-image-set-metadataコード例では、イメージセットメタデータからインスタンスを削除します。

aws medical-imaging update-image-set-metadata \
    --datastore-id 12345678901234567890123456789012 \
    --image-set-id ea92b0d8838c72a3f25d00d13616f87e \
    --latest-version-id 1 \
    --update-image-set-metadata-updates file://metadata-updates.json

metadata-updates.json の内容

{
    "DICOMUpdates": {
        "removableAttributes": "eezEuMS4xLjEuMS4xLjEyMzQ1LjEyMzQ1Njc4OTAxMi4xMjMuMTIzNDU2Nzg5MDEyMzQuMTp7SW5zdGFuY2VzOnsxLjEuMS4xLjEuMS4xMjM0NS4xMjM0NTY3ODkwMTIuMTIzLjEyMzQ1Njc4OTAxMjM0LjE6e319fX19fQo="
    }
}

注: removableAttributesは Base64 でエンコードされたJSON文字列です。エンコードされていないJSON文字列を次に示します。

{"1.1.1.1.1.12345.123456789012.123.12345678901234.1":{"Instances":{"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1":{}}}}}}

出力:

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

詳細については、「 AWS HealthImaging デベロッパーガイド」の「画像セットメタデータの更新」を参照してください。

• API 詳細については、「 コマンドリファレンスUpdateImageSetMetadata」の「」を参照してください。 AWS CLI