HealthLake contoh menggunakan AWS CLI

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

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.

Topik

Tindakan

Tindakan

Contoh kode berikut menunjukkan cara menggunakancreate-fhir-datastore.

AWS CLI

Contoh 1: Buat SigV4-enabled HealthLake penyimpanan data

create-fhir-datastoreContoh berikut menunjukkan cara membuat penyimpanan data baru di AWS HealthLake.


aws healthlake create-fhir-datastore \
    --datastore-type-version R4 \
    --datastore-name "FhirTestDatastore"

Output:


{
    "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/(Data store ID)/r4/",
    "DatastoreArn": "arn:aws:healthlake:us-east-1:(AWS Account ID):datastore/(Data store ID)",
    "DatastoreStatus": "CREATING",
    "DatastoreId": "(Data store ID)"
}

Contoh 2: Buat SMART di FHIR-enabled HealthLake penyimpanan data

create-fhir-datastoreContoh berikut menunjukkan cara membuat SMART baru di penyimpanan FHIR-enabled data di AWS HealthLake.


aws healthlake create-fhir-datastore \
    --datastore-name "your-data-store-name" \
    --datastore-type-version R4 \
    --preload-data-config PreloadDataType="SYNTHEA" \
    --sse-configuration '{ "KmsEncryptionConfig": {  "CmkType": "CUSTOMER_MANAGED_KMS_KEY", "KmsKeyId": "arn:aws:kms:us-east-1:your-account-id:key/your-key-id" } }' \
    --identity-provider-configuration  file://identity_provider_configuration.json

Isi dari identity_provider_configuration.json:


{
    "AuthorizationStrategy": "SMART_ON_FHIR_V1",
    "FineGrainedAuthorizationEnabled": true,
    "IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name",
    "Metadata": "{\"issuer\":\"https://ehr.example.com\", \"jwks_uri\":\"https://ehr.example.com/.well-known/jwks.json\",\"authorization_endpoint\":\"https://ehr.example.com/auth/authorize\",\"token_endpoint\":\"https://ehr.token.com/auth/token\",\"token_endpoint_auth_methods_supported\":[\"client_secret_basic\",\"foo\"],\"grant_types_supported\":[\"client_credential\",\"foo\"],\"registration_endpoint\":\"https://ehr.example.com/auth/register\",\"scopes_supported\":[\"openId\",\"profile\",\"launch\"],\"response_types_supported\":[\"code\"],\"management_endpoint\":\"https://ehr.example.com/user/manage\",\"introspection_endpoint\":\"https://ehr.example.com/user/introspect\",\"revocation_endpoint\":\"https://ehr.example.com/user/revoke\",\"code_challenge_methods_supported\":[\"S256\"],\"capabilities\":[\"launch-ehr\",\"sso-openid-connect\",\"client-public\"]}"
}

Output:


{
    "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/(Data store ID)/r4/",
    "DatastoreArn": "arn:aws:healthlake:us-east-1:(AWS Account ID):datastore/(Data store ID)",
    "DatastoreStatus": "CREATING",
    "DatastoreId": "(Data store ID)"
}

Untuk informasi selengkapnya, lihat Membuat dan memantau penyimpanan data FHIR di Panduan Peng AWS HealthLake embang.

Untuk detail API, lihat CreateFhirDataStore di Referensi Perintah. AWS CLI

Contoh kode berikut menunjukkan cara menggunakandelete-fhir-datastore.

AWS CLI

Untuk menghapus penyimpanan data FHIR

delete-fhir-datastoreContoh berikut menunjukkan cara menghapus penyimpanan data dan semua isinya di AWS HealthLake.


aws healthlake delete-fhir-datastore \
    --datastore-id (Data store ID)

Output:


{
    "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/(Data store ID)/r4/",
    "DatastoreArn": "arn:aws:healthlake:us-east-1:(AWS Account ID):datastore/(Data store ID)",
    "DatastoreStatus": "DELETING",
    "DatastoreId": "(Data store ID)"
}

Untuk informasi selengkapnya, lihat Membuat dan memantau penyimpanan data FHIR < https://docs.aws.amazon.com/healthlake/latest/devguide/working-with-FHIR-healthlake.html > di Panduan Peng AWS HealthLake embang.

Untuk detail API, lihat DeleteFhirDataStore di Referensi Perintah. AWS CLI

Contoh kode berikut menunjukkan cara menggunakandescribe-fhir-datastore.

AWS CLI

Untuk mendeskripsikan penyimpanan data FHIR

describe-fhir-datastoreContoh berikut menunjukkan bagaimana menemukan properti penyimpanan data di AWS HealthLake.


aws healthlake describe-fhir-datastore \
    --datastore-id "1f2f459836ac6c513ce899f9e4f66a59"

Output:


{
    "DatastoreProperties": {
        "PreloadDataConfig": {
            "PreloadDataType": "SYNTHEA"
        },
        "SseConfiguration": {
            "KmsEncryptionConfig": {
                "CmkType": "CUSTOMER_MANAGED_KMS_KEY",
                "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
            }
        },
        "DatastoreName": "Demo",
        "DatastoreArn": "arn:aws:healthlake:us-east-1:<AWS Account ID>:datastore/<Data store ID>",
        "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/<Data store ID>/r4/",
        "DatastoreStatus": "ACTIVE",
        "DatastoreTypeVersion": "R4",
        "CreatedAt": 1603761064.881,
        "DatastoreId": "<Data store ID>",
        "IdentityProviderConfiguration": {
            "AuthorizationStrategy": "AWS_AUTH",
            "FineGrainedAuthorizationEnabled": false
        }
    }
}

Untuk informasi selengkapnya, lihat Membuat dan memantau penyimpanan data FHIR di Panduan Peng AWS HealthLake embang.

Untuk detail API, lihat Deskripsi FHirDataStore di Referensi Perintah. AWS CLI

Contoh kode berikut menunjukkan cara menggunakandescribe-fhir-export-job.

AWS CLI

Untuk menggambarkan pekerjaan ekspor FHIR

describe-fhir-export-jobContoh berikut menunjukkan cara menemukan properti dari pekerjaan ekspor FHIR di AWS HealthLake.


aws healthlake describe-fhir-export-job \
    --datastore-id (Data store ID) \
    --job-id 9b9a51943afaedd0a8c0c26c49135a31

Output:


{
    "ExportJobProperties": {
        "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)",
        "JobStatus": "IN_PROGRESS",
        "JobId": "9009813e9d69ba7cf79bcb3468780f16",
        "SubmitTime": "2024-11-20T11:31:46.672000-05:00",
        "EndTime": "2024-11-20T11:34:01.636000-05:00",
        "OutputDataConfig": {
            "S3Configuration": {
            "S3Uri": "s3://(Bucket Name)/(Prefix Name)/",
            "KmsKeyId": "arn:aws:kms:us-east-1:012345678910:key/d330e7fc-b56c-4216-a250-f4c43ef46e83"
        }

        },
        "DatastoreId": "(Data store ID)"
    }
}

Untuk informasi selengkapnya, lihat Meng ekspor file dari penyimpanan data FHIR di Panduan Peng AWS HealthLake embang.

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

Contoh kode berikut menunjukkan cara menggunakandescribe-fhir-import-job.

AWS CLI

Untuk mendeskripsikan pekerjaan impor FHIR

describe-fhir-import-jobContoh berikut menunjukkan cara mempelajari properti dari pekerjaan impor FHIR menggunakan AWS HealthLake.


aws healthlake describe-fhir-import-job \
    --datastore-id (Data store ID) \
    --job-id c145fbb27b192af392f8ce6e7838e34f

Output:


{
    "ImportJobProperties": {
    "InputDataConfig": {
        "S3Uri": "s3://(Bucket Name)/(Prefix Name)/"
        { "arrayitem2": 2 }
    },
    "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)",
    "JobStatus": "COMPLETED",
    "JobId": "c145fbb27b192af392f8ce6e7838e34f",
    "SubmitTime": 1606272542.161,
    "EndTime": 1606272609.497,
    "DatastoreId": "(Data store ID)"
    }
}

Untuk informasi selengkapnya, lihat Meng impor file ke penyimpanan data FHIR di Panduan Peng AWS HealthLake embang.

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

Contoh kode berikut menunjukkan cara menggunakanlist-fhir-datastores.

AWS CLI

Untuk daftar penyimpanan data FHIR

list-fhir-datastoresContoh berikut menunjukkan cara menggunakan perintah dan bagaimana pengguna dapat memfilter hasil berdasarkan status penyimpanan data di AWS HealthLake.


aws healthlake list-fhir-datastores \
    --filter DatastoreStatus=ACTIVE

Output:


{
    "DatastorePropertiesList": [
    {
        "PreloadDataConfig": {
            "PreloadDataType": "SYNTHEA"
        },
        "SseConfiguration": {
            "KmsEncryptionConfig": {
                "CmkType": "CUSTOMER_MANAGED_KMS_KEY",
                "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
            }
        },
        "DatastoreName": "Demo",
        "DatastoreArn": "arn:aws:healthlake:us-east-1:<AWS Account ID>:datastore/<Data store ID>",
        "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/<Data store ID>/r4/",
        "DatastoreStatus": "ACTIVE",
        "DatastoreTypeVersion": "R4",
        "CreatedAt": 1603761064.881,
        "DatastoreId": "<Data store ID>",
        "IdentityProviderConfiguration": {
            "AuthorizationStrategy": "AWS_AUTH",
            "FineGrainedAuthorizationEnabled": false
        }
    }
    ]
}

Untuk informasi selengkapnya, lihat Membuat dan memantau penyimpanan data FHIR di Panduan Peng AWS HealthLake embang.

Untuk detail API, lihat ListFHirData Stores di Referensi Perintah. AWS CLI

Contoh kode berikut menunjukkan cara menggunakanlist-fhir-export-jobs.

AWS CLI

Untuk daftar semua pekerjaan ekspor FHIR

list-fhir-export-jobsContoh berikut menunjukkan cara menggunakan perintah untuk melihat daftar pekerjaan ekspor yang terkait dengan akun.


aws healthlake list-fhir-export-jobs \
    --datastore-id (Data store ID) \
    --submitted-before (DATE like 2024-10-13T19:00:00Z)\
    --submitted-after (DATE like 2020-10-13T19:00:00Z )\
    --job-name "FHIR-EXPORT" \
    --job-status SUBMITTED  \
    --max-results (Integer between 1 and 500)

Output:


{
    "ExportJobPropertiesList": [
        {
            "ExportJobProperties": {
                "OutputDataConfig": {
                    "S3Uri": "s3://(Bucket Name)/(Prefix Name)/",
                    "S3Configuration": {
                        "S3Uri": "s3://(Bucket Name)/(Prefix Name)/",
                        "KmsKeyId": "(KmsKey Id)"
                    }
                },
                "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)",
                "JobStatus": "COMPLETED",
                "JobId": "c145fbb27b192af392f8ce6e7838e34f",
                "JobName": "FHIR-EXPORT",
                "SubmitTime": "2024-11-20T11:31:46.672000-05:00",
                "EndTime": "2024-11-20T11:34:01.636000-05:00",
                "DatastoreId": "(Data store ID)"
            }
        }
    ]
}

Untuk informasi selengkapnya, lihat Meng ekspor file dari penyimpanan data FHIR di Panduan Peng AWS HealthLake embang.

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

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

AWS CLI

Untuk daftar semua pekerjaan impor FHIR

list-fhir-import-jobsContoh berikut menunjukkan cara menggunakan perintah untuk melihat daftar semua pekerjaan impor yang terkait dengan akun.


aws healthlake list-fhir-import-jobs \
    --datastore-id (Data store ID) \
    --submitted-before (DATE like 2024-10-13T19:00:00Z) \
    --submitted-after (DATE like 2020-10-13T19:00:00Z ) \
    --job-name "FHIR-IMPORT" \
    --job-status SUBMITTED  \
    -max-results (Integer between 1 and 500)

Output:


{
    "ImportJobPropertiesList": [
        {
            "JobId": "c0fddbf76f238297632d4aebdbfc9ddf",
            "JobStatus": "COMPLETED",
            "SubmitTime": "2024-11-20T10:08:46.813000-05:00",
            "EndTime": "2024-11-20T10:10:09.093000-05:00",
            "DatastoreId": "(Data store ID)",
            "InputDataConfig": {
                "S3Uri": "s3://(Bucket Name)/(Prefix Name)/"
            },
            "JobOutputDataConfig": {
                "S3Configuration": {
                    "S3Uri": "s3://(Bucket Name)/import/6407b9ae4c2def3cb6f1a46a0c599ec0-FHIR_IMPORT-c0fddbf76f238297632d4aebdbfc9ddf/",
                    "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/b7f645cb-e564-4981-8672-9e012d1ff1a0"
                }
            },
            "JobProgressReport": {
                "TotalNumberOfScannedFiles": 1,
                "TotalSizeOfScannedFilesInMB": 0.001798,
                "TotalNumberOfImportedFiles": 1,
                "TotalNumberOfResourcesScanned": 1,
                "TotalNumberOfResourcesImported": 1,
                "TotalNumberOfResourcesWithCustomerError": 0,
                "TotalNumberOfFilesReadWithCustomerError": 0,
                "Throughput": 0.0
            },
            "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengimpor file ke penyimpanan data FHIR di Panduan Peng AWS HealthLake embang.

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

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

AWS CLI

Untuk mencantumkan tag untuk penyimpanan data

list-tags-for-resourceContoh berikut mencantumkan tag yang terkait dengan penyimpanan data yang ditentukan. :


aws healthlake list-tags-for-resource \
    --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/0725c83f4307f263e16fd56b6d8ebdbe"

Output:


{
    "tags": {
        "key": "value",
        "key1": "value1"
    }
}

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

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

Contoh kode berikut menunjukkan cara menggunakanstart-fhir-export-job.

AWS CLI

Untuk memulai pekerjaan ekspor FHIR

start-fhir-export-jobContoh berikut menunjukkan cara memulai pekerjaan ekspor FHIR menggunakan AWS HealthLake.


aws healthlake start-fhir-export-job \
    --output-data-config '{"S3Configuration": {"S3Uri":"s3://(Bucket Name)/(Prefix Name)/","KmsKeyId":"arn:aws:kms:us-east-1:012345678910:key/d330e7fc-b56c-4216-a250-f4c43ef46e83"}}' \
    --datastore-id (Data store ID) \
    --data-access-role-arn arn:aws:iam::(AWS Account ID):role/(Role Name)

Output:


{
    "DatastoreId": "(Data store ID)",
    "JobStatus": "SUBMITTED",
    "JobId": "9b9a51943afaedd0a8c0c26c49135a31"
}

Untuk informasi selengkapnya, lihat Meng ekspor file dari penyimpanan data FHIR di Panduan Peng AWS HealthLake embang.

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

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

AWS CLI

Untuk memulai pekerjaan impor FHIR

start-fhir-import-jobContoh berikut menunjukkan cara memulai pekerjaan impor FHIR menggunakan AWS HealthLake.


aws healthlake start-fhir-import-job \
    --input-data-config S3Uri="s3://(Bucket Name)/(Prefix Name)/" \
    --job-output-data-config '{"S3Configuration": {"S3Uri":"s3://(Bucket Name)/(Prefix Name)/","KmsKeyId":"arn:aws:kms:us-east-1:012345678910:key/d330e7fc-b56c-4216-a250-f4c43ef46e83"}}' \
    --datastore-id (Data store ID) \
    --data-access-role-arn "arn:aws:iam::(AWS Account ID):role/(Role Name)"

Output:


{
    "DatastoreId": "(Data store ID)",
    "JobStatus": "SUBMITTED",
    "JobId": "c145fbb27b192af392f8ce6e7838e34f"
}

Untuk informasi selengkapnya, lihat Meng impor file ke penyimpanan data FHIR di Panduan Peng AWS HealthLake embang.

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

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menambahkan tag ke penyimpanan data

tag-resourceContoh berikut menunjukkan cara menambahkan tag ke penyimpanan data.


aws healthlake tag-resource \
    --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/0725c83f4307f263e16fd56b6d8ebdbe" \
    --tags '[{"Key": "key1", "Value": "value1"}]'

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Men ambahkan tag ke penyimpanan data di Panduan Peng AWS HealthLake embang. .

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

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari penyimpanan data.

untag-resourceContoh berikut menunjukkan cara menghapus tag dari penyimpanan data.


aws healthlake untag-resource \
    --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/b91723d65c6fdeb1d26543a49d2ed1fa" \
    --tag-keys '["key1"]'

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menghapus tag dari penyimpanan data di Panduan AWS HealthLake Pengembang.

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

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

HealthImaging

HealthOmics