View a markdown version of this page

HealthImaging contoh menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

HealthImaging contoh menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface with HealthImaging.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakancopy-image-set.

AWS CLI

Contoh 1: Untuk menyalin kumpulan gambar tanpa tujuan.

copy-image-setContoh berikut membuat salinan duplikat dari kumpulan gambar tanpa tujuan.

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

Output:

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

Contoh 2: Untuk menyalin kumpulan gambar dengan tujuan.

copy-image-setContoh berikut membuat salinan duplikat dari kumpulan gambar dengan tujuan.

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

Output:

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

Contoh 3: Untuk menyalin subset instance dari kumpulan gambar sumber ke kumpulan gambar tujuan.

copy-image-setContoh berikut menyalin satu instance DICOM dari set gambar sumber ke kumpulan gambar tujuan. Parameter gaya disediakan untuk mengganti inkonsistensi dalam atribut tingkat Pasien, Studi, dan Seri.

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

Output:

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

Untuk informasi selengkapnya, lihat Menyalin kumpulan gambar di Panduan AWS HealthImaging Pengembang.

  • Untuk detail API, lihat CopyImageSet di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-datastore.

AWS CLI

Contoh 1: Untuk membuat penyimpanan data

Contoh create-datastore kode berikut membuat penyimpanan data dengan namamy-datastore. Saat Anda membuat datastore tanpa menentukan a--lossless-storage-format, AWS HealthImaging defaultnya adalah HTJ2K (High Throughput JPEG 2000).

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

Output:

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

Contoh 2: Untuk membuat penyimpanan data dengan format penyimpanan JPEG 2000 Lossless

Penyimpanan data yang dikonfigurasi dengan format penyimpanan Lossless JPEG 2000 akan mentranskode dan mempertahankan bingkai gambar lossless dalam format JPEG 2000. Bingkai gambar kemudian dapat diambil dalam JPEG 2000 Lossless tanpa transcoding. Contoh create-datastore kode berikut membuat penyimpanan data yang dikonfigurasi untuk format penyimpanan JPEG 2000 Lossless dengan nama. my-datastore

aws medical-imaging create-datastore \
    --datastore-name "my-datastore" \
    --lossless-storage-format JPEG_2000_LOSSLESS

Output:

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

Untuk informasi selengkapnya, lihat Membuat penyimpanan data di Panduan AWS HealthImaging Pengembang.

Contoh kode berikut menunjukkan cara menggunakandelete-datastore.

AWS CLI

Untuk menghapus penyimpanan data

Contoh delete-datastore kode berikut menghapus penyimpanan data.

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

Output:

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

Untuk informasi selengkapnya, lihat Menghapus penyimpanan data di Panduan AWS HealthImaging Pengembang.

Contoh kode berikut menunjukkan cara menggunakandelete-image-set.

AWS CLI

Untuk menghapus kumpulan gambar

Contoh delete-image-set kode berikut menghapus kumpulan gambar.

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

Output:

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

Untuk informasi selengkapnya, lihat Menghapus kumpulan gambar di Panduan AWS HealthImaging Pengembang.

Contoh kode berikut menunjukkan cara menggunakanget-datastore.

AWS CLI

Contoh 1: Untuk mendapatkan properti penyimpanan data

Contoh get-datastore kode berikut mendapatkan properti penyimpanan data.

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

Output:

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

Contoh 2: Untuk mendapatkan properti penyimpanan data yang dikonfigurasi untuk JPEG2000

Contoh get-datastore kode berikut mendapatkan properti penyimpanan data untuk penyimpanan data yang dikonfigurasi untuk format penyimpanan JPEG 2000 Lossless.

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

Output:

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

Untuk informasi selengkapnya, lihat Mendapatkan properti penyimpanan data di Panduan AWS HealthImaging Pengembang.

  • Untuk detail API, lihat GetDatastore di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-dicom-import-job.

AWS CLI

Untuk mendapatkan properti pekerjaan impor dicom

Contoh get-dicom-import-job kode berikut mendapatkan properti pekerjaan impor dicom.

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

Output:

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

Untuk informasi selengkapnya, lihat Mendapatkan properti pekerjaan impor di Panduan AWS HealthImaging Pengembang.

Contoh kode berikut menunjukkan cara menggunakanget-image-frame.

AWS CLI

Untuk mendapatkan data piksel set gambar

Contoh get-image-frame kode berikut mendapatkan bingkai gambar.

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

Catatan: Contoh kode ini tidak menyertakan output karena GetImageFrame tindakan mengembalikan aliran data piksel ke file imageframe.jph. Untuk informasi tentang decoding dan melihat bingkai gambar, lihat pustaka decoding HTJ2K.

Untuk informasi selengkapnya, lihat M endapatkan data piksel kumpulan gambar di Panduan AWS HealthImaging Pengembang.

Contoh kode berikut menunjukkan cara menggunakanget-image-set-metadata.

AWS CLI

Contoh 1: Untuk mendapatkan metadata set gambar tanpa versi

Contoh get-image-set-metadata kode berikut mendapatkan metadata untuk kumpulan gambar tanpa menentukan versi.

Catatan: outfile adalah parameter yang diperlukan

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

Metadata yang dikembalikan dikompresi dengan gzip dan disimpan dalam file studymetadata.json.gz. Untuk melihat isi objek JSON yang dikembalikan, Anda harus terlebih dahulu mendekompresinya.

Output:

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

Contoh 2: Untuk mendapatkan metadata set gambar dengan versi

Contoh get-image-set-metadata kode berikut mendapatkan metadata untuk kumpulan gambar dengan versi tertentu.

Catatan: outfile adalah parameter yang diperlukan

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

Metadata yang dikembalikan dikompresi dengan gzip dan disimpan dalam file studymetadata.json.gz. Untuk melihat isi objek JSON yang dikembalikan, Anda harus terlebih dahulu mendekompresinya.

Output:

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

Untuk informasi selengkapnya, lihat Mendapatkan metadata kumpulan gambar di Panduan AWS HealthImaging Pengembang.

Contoh kode berikut menunjukkan cara menggunakanget-image-set.

AWS CLI

Untuk mendapatkan properti set gambar

Contoh get-image-set kode berikut mendapatkan properti untuk kumpulan gambar.

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

Output:

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

Untuk informasi selengkapnya, lihat Mendapatkan properti set gambar di Panduan AWS HealthImaging Pengembang.

  • Untuk detail API, lihat GetImageSet di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-datastores.

AWS CLI

Untuk membuat daftar penyimpanan data

Contoh list-datastores kode berikut mencantumkan penyimpanan data yang tersedia.

aws medical-imaging list-datastores

Output:

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

Untuk informasi selengkapnya, lihat M endaftarkan penyimpanan data di Panduan AWS HealthImaging Pengembang.

Contoh kode berikut menunjukkan cara menggunakanlist-dicom-import-jobs.

AWS CLI

Untuk membuat daftar pekerjaan impor dicom

Contoh list-dicom-import-jobs kode berikut mencantumkan pekerjaan impor dicom.

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

Output:

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

Untuk informasi selengkapnya, lihat M endaftarkan pekerjaan impor di Panduan AWS HealthImaging Pengembang.

Contoh kode berikut menunjukkan cara menggunakanlist-image-set-versions.

AWS CLI

Untuk mencantumkan versi set gambar

Contoh list-image-set-versions kode berikut mencantumkan riwayat versi untuk kumpulan gambar.

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

Output:

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

Untuk informasi selengkapnya, lihat M endaftarkan versi kumpulan gambar di Panduan AWS HealthImaging Pengembang.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Contoh 1: Untuk mencantumkan tag sumber daya untuk penyimpanan data

Contoh list-tags-for-resource kode berikut mencantumkan tag untuk penyimpanan data.

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

Output:

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

Contoh 2: Untuk mencantumkan tag sumber daya untuk kumpulan gambar

Contoh list-tags-for-resource kode berikut mencantumkan tag untuk kumpulan gambar.

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

Output:

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

Untuk informasi selengkapnya, lihat Menandai sumber daya dengan AWS HealthImaging di Panduan Peng AWS HealthImaging embang.

Contoh kode berikut menunjukkan cara menggunakansearch-image-sets.

AWS CLI

Contoh 1: Untuk mencari set gambar dengan operator EQUAL

Contoh search-image-sets kode berikut menggunakan operator EQUAL untuk mencari set gambar berdasarkan nilai tertentu.

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

Isi dari search-criteria.json

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

Output:

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

Contoh 2: Untuk mencari set gambar dengan operator BETWEEN menggunakan DICOMStudyDate dan DICOMStudyTime

Contoh search-image-sets kode berikut mencari kumpulan gambar dengan Studi DICOM yang dihasilkan antara 1 Januari 1990 (12:00 AM) dan 1 Januari 2023 (12:00 AM).

Catatan: DICOMStudyTime bersifat opsional. Jika tidak ada, 12:00 AM (awal hari) adalah nilai waktu untuk tanggal yang disediakan untuk pemfilteran.

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

Isi dari search-criteria.json

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

Output:

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

Contoh 3: Untuk mencari set gambar dengan operator BETWEEN menggunakan createDat (studi waktu sebelumnya dipertahankan)

Contoh search-image-sets kode berikut mencari kumpulan gambar dengan Studi DICOM bertahan di HealthImaging antara rentang waktu di zona waktu UTC.

Catatan: Berikan createDat dalam format contoh (“198 T23:20:50.52Z 5-04-12 “).

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

Isi dari search-criteria.json

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

Output:

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

Contoh 4: Untuk mencari kumpulan gambar dengan operator EQUAL pada DICOMSeriesInstanceUID dan BETWEEN pada updateDat dan mengurutkan respons dalam urutan ASC pada bidang UpdateDat

Contoh search-image-sets kode berikut mencari kumpulan gambar dengan operator EQUAL pada dan BETWEEN pada DICOMSeriesInstanceUID updateDat dan mengurutkan respons dalam urutan ASC pada bidang updateDat.

Catatan: Berikan UpdateDat dalam format contoh (“1985-04-12 “)T23:20:50.52Z.

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

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

Output:

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

Untuk informasi selengkapnya, lihat Mencari kumpulan gambar di Panduan AWS HealthImaging Pengembang.

Contoh kode berikut menunjukkan cara menggunakanstart-dicom-import-job.

AWS CLI

Untuk memulai pekerjaan impor dicom

Contoh start-dicom-import-job kode berikut memulai pekerjaan impor 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"

Output:

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

Untuk informasi selengkapnya, lihat Mem ulai pekerjaan impor di Panduan AWS HealthImaging Pengembang.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Contoh 1: Untuk menandai penyimpanan data

Contoh tag-resource kode berikut menandai penyimpanan data.

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

Perintah ini tidak menghasilkan output.

Contoh 2: Untuk menandai kumpulan gambar

Contoh tag-resource kode berikut menandai kumpulan gambar.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai sumber daya dengan AWS HealthImaging di Panduan Peng AWS HealthImaging embang.

  • Untuk detail API, lihat TagResource di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Contoh 1: Untuk menghapus tag penyimpanan data

Contoh untag-resource kode berikut menghapus tag penyimpanan data.

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

Perintah ini tidak menghasilkan output.

Contoh 2: Untuk menghapus tag pada kumpulan gambar

Contoh untag-resource kode berikut menghapus tag pada kumpulan gambar.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai sumber daya dengan AWS HealthImaging di Panduan Peng AWS HealthImaging embang.

Contoh kode berikut menunjukkan cara menggunakanupdate-image-set-metadata.

AWS CLI

Contoh 1: Untuk menyisipkan atau memperbarui atribut dalam metadata set gambar

update-image-set-metadataContoh berikut menyisipkan atau memperbarui atribut dalam metadata set gambar.

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

Isi metadata-updates.json

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

Output:

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

Contoh 2: Untuk menghapus atribut dari metadata kumpulan gambar

update-image-set-metadataContoh berikut menghapus atribut dari metadata set gambar.

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

Isi metadata-updates.json

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

Output:

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

Contoh 3: Untuk menghapus instance dari metadata kumpulan gambar

update-image-set-metadataContoh berikut menghapus instance dari metadata set gambar.

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

Isi 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\": {}}}}}}"
    }
}

Output:

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

Contoh 4: Untuk mengembalikan set gambar ke versi sebelumnya

update-image-set-metadataContoh berikut menunjukkan cara mengembalikan set gambar ke versi sebelumnya. CopyImageSet dan UpdateImageSetMetadata tindakan membuat versi baru dari kumpulan gambar.

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

Output:

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

Contoh 5: Untuk menambahkan elemen data DICOM pribadi ke instance

update-image-set-metadataContoh berikut menunjukkan cara menambahkan elemen pribadi ke instance tertentu dalam kumpulan gambar. Standar DICOM mengizinkan elemen data pribadi untuk komunikasi informasi yang tidak dapat terkandung dalam elemen data standar. Anda dapat membuat, memperbarui, dan menghapus elemen data pribadi dengan UpdateImageSetMetadata tindakan tersebut.

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

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

Output:

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

Contoh 6: Untuk memperbarui elemen data DICOM pribadi ke instance

update-image-set-metadataContoh berikut menunjukkan cara memperbarui nilai elemen data pribadi milik instance dalam kumpulan gambar.

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

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

Output:

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

Contoh 7: Untuk memperbarui SopInstanceUid dengan parameter force

update-image-set-metadataContoh berikut menunjukkan cara memperbarui SopInstanceUid, menggunakan parameter force untuk mengganti batasan metadata 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

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

Output:

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

Untuk informasi selengkapnya, lihat Memperbarui metadata kumpulan gambar di Panduan AWS HealthImaging Pengembang.