Membaca sejarah sumber daya FHIR - AWS HealthLake
Membaca sejarah khusus versi

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

Membaca sejarah sumber daya FHIR

historyInteraksi FHIR mengambil sejarah sumber daya FHIR tertentu di penyimpanan data. HealthLake Dengan menggunakan interaksi ini, Anda dapat menentukan bagaimana isi sumber daya FHIR telah berubah dari waktu ke waktu. Ini juga berguna dalam koordinasi dengan log audit untuk melihat keadaan sumber daya sebelum dan sesudah modifikasi. Interaksi FHIRcreate,update, dan delete menghasilkan versi historis dari sumber daya yang akan disimpan. Untuk informasi tambahan, lihat historydi dokumentasi FHIR R4 RESTful API.

catatan

Anda dapat memilih keluar dari history jenis sumber daya FHIR tertentu. Untuk memilih keluar, buat kasus menggunakan AWS Support Center Console. Untuk membuat kasus Anda, masuk ke kasing Anda Akun AWS dan pilih Buat kasus.

Untuk membaca sejarah sumber daya FHIR

  1. Kumpulkan HealthLake region dan datastoreId nilai. Untuk informasi selengkapnya, lihat Mendapatkan properti penyimpanan data.

  2. Tentukan jenis FHIR Resource untuk membaca dan mengumpulkan id nilai terkait. Untuk informasi selengkapnya, lihat Jenis sumber daya.

  3. Buat URL untuk permintaan menggunakan nilai yang dikumpulkan untuk HealthLake region dandatastoreId. Juga termasuk Resource jenis FHIR, yang terkaitid, dan parameter pencarian opsional. Untuk melihat seluruh jalur URL dalam contoh berikut, gulir ke atas tombol Salin.

    GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id/_history{?[parameters]}
    HealthLake parameter pencarian yang didukung untuk interaksi FHIR history
    Parameter Deskripsi
    _count : integer Jumlah maksimum hasil pencarian pada halaman. Server akan mengembalikan nomor yang diminta atau jumlah maksimum hasil pencarian yang diizinkan secara default untuk penyimpanan data, mana yang lebih rendah.
    _since : instant Hanya sertakan versi sumber daya yang dibuat pada atau setelah waktu instan yang diberikan.
    _at : date(Time) Hanya sertakan versi sumber daya yang saat ini di beberapa titik selama periode waktu yang ditentukan dalam nilai waktu tanggal. Untuk informasi selengkapnya, lihat datedi dokumentasi HL7 FHIR RESTful API.

  4. Kirim permintaan . historyInteraksi FHIR menggunakan GET permintaan dengan AWS Signature Version 4 atau SMART pada otorisasi FHIR. curlContoh berikut menggunakan parameter _count pencarian untuk mengembalikan 100 hasil pencarian historis per halaman untuk Patient sumber daya FHIR di HealthLake. Untuk melihat seluruh contoh, gulir ke atas tombol Salin.

    SigV4

    Otorisasi SiGv4

    curl --request GET \
  'https://healthlake.region.amazonaws.com/datastore/datastore-id/r4/Patient/id/_history?_count=100' \
  --aws-sigv4 'aws:amz:region:healthlake' \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
  --header 'Accept: application/json'
    SMART on FHIR

    SMART pada contoh otorisasi FHIR untuk tipe IdentityProviderConfigurationdata.

    {
    "AuthorizationStrategy": "SMART_ON_FHIR",
    "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\",\"permission-v2\"]}"
}

    Penelepon dapat menetapkan izin di lambda otorisasi. Untuk informasi selengkapnya, lihat OAuth 2.0 cakupan.

    Isi pengembalian history interaksi terkandung dalam sumber daya FHIRBundle, dengan tipe yang disetel kehistory. Ini berisi riwayat versi yang ditentukan, diurutkan dengan versi tertua yang terakhir, dan termasuk sumber daya yang dihapus. Untuk informasi lebih lanjut, lihat Resource Bundledi dokumentasi FHIR R4.

Membaca riwayat sumber daya FHIR khusus versi

vreadInteraksi FHIR melakukan pembacaan sumber daya khusus versi di penyimpanan data. HealthLake Dengan menggunakan interaksi ini, Anda dapat melihat konten sumber daya FHIR seperti pada waktu tertentu di masa lalu.

catatan

Jika Anda menggunakan history interaksi FHIR tanpavread, HealthLake selalu mengembalikan versi terbaru dari metadata sumber daya.

HealthLake mendeklarasikannya mendukung pembuatan versi CapabilityStatement.rest.resource.versioninguntuk setiap sumber daya yang didukung. Semua penyimpanan HealthLake data termasuk Resource.meta.versionId (vid) pada semua sumber daya.

Ketika history interaksi FHIR diaktifkan (secara default untuk penyimpanan data yang dibuat setelah 10/25/2024 atau berdasarkan permintaan untuk penyimpanan data yang lebih lama), Bundle respons menyertakan vid sebagai bagian dari elemen. location Dalam contoh berikut, vid ditampilkan sebagai angka1. Untuk melihat contoh selengkapnya, lihat Contoh Bundle/Bundle-response (JSON).

"response" : {
    "status" : "201 Created",
    "location" : "Patient/12423/_history/1",
    ...}
Untuk membaca riwayat sumber daya FHIR khusus versi

  1. Kumpulkan HealthLake region dan datastoreId nilai. Untuk informasi selengkapnya, lihat Mendapatkan properti penyimpanan data.

  2. Tentukan Resource jenis FHIR untuk membaca dan mengumpulkan terkait id dan vid nilai. Untuk informasi selengkapnya, lihat Jenis sumber daya.

  3. Buat URL untuk permintaan menggunakan nilai yang dikumpulkan untuk HealthLake dan FHIR. Untuk melihat seluruh jalur URL dalam contoh berikut, gulir ke atas tombol Salin.

    GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id/_history/vid

  4. Kirim permintaan . historyInteraksi FHIR menggunakan GET permintaan dengan AWS Signature Version 4 atau SMART pada otorisasi FHIR. vreadInteraksi berikut mengembalikan satu contoh dengan konten yang ditentukan untuk Patient sumber daya FHIR untuk versi metadata sumber daya yang ditentukan oleh. vid Untuk melihat seluruh jalur URL dalam contoh berikut, gulir ke atas tombol Salin.

    SigV4

    Otorisasi SiGv4

    curl --request GET \
  'https://healthlake.region.amazonaws.com/datastore/datastore-id/r4/Patient/id/_history/vid' \
  --aws-sigv4 'aws:amz:region:healthlake' \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
  --header 'Accept: application/json'
    SMART on FHIR

    SMART pada contoh otorisasi FHIR untuk tipe IdentityProviderConfigurationdata.

    {
    "AuthorizationStrategy": "SMART_ON_FHIR",
    "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\",\"permission-v2\"]}"
}

    Penelepon dapat menetapkan izin di lambda otorisasi. Lihat informasi yang lebih lengkap di OAuth 2.0 cakupan.