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
`history`Interaksi 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 FHIR`create`,`update`, dan `delete` menghasilkan versi historis dari sumber daya yang akan disimpan. Untuk informasi tambahan, lihat [https://hl7.org/fhir/R4/http.html#history](https://hl7.org/fhir/R4/http.html#history)di 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](https://console.aws.amazon.com/support/home#/). 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](managing-data-stores-describe.md).
1. Tentukan jenis FHIR `Resource` untuk membaca dan mengumpulkan `id` nilai terkait. Untuk informasi selengkapnya, lihat [Jenis sumber daya](reference-fhir-resource-types.md).
1. Buat URL untuk permintaan menggunakan nilai yang dikumpulkan untuk HealthLake `region` dan`datastoreId`. Juga termasuk `Resource` jenis FHIR, yang terkait`id`, 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`**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/healthlake/latest/devguide/managing-fhir-resources-read-history.html)
1. Kirim permintaan . `history`Interaksi FHIR menggunakan `GET` permintaan dengan [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) atau SMART pada otorisasi FHIR. `curl`Contoh 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 [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)data.
```
{
"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](reference-smart-on-fhir-oauth-scopes.md).
------
Isi pengembalian `history` interaksi terkandung dalam sumber daya FHIR`Bundle`, dengan tipe yang disetel ke`history`. Ini berisi riwayat versi yang ditentukan, diurutkan dengan versi tertua yang terakhir, dan termasuk sumber daya yang dihapus. Untuk informasi lebih lanjut, lihat [https://hl7.org/fhir/R4/bundle.html](https://hl7.org/fhir/R4/bundle.html)di dokumentasi **FHIR R4**.
## Membaca riwayat sumber daya FHIR khusus versi
`vread`Interaksi 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 *tanpa*`vread`, HealthLake selalu mengembalikan versi terbaru dari metadata sumber daya.
HealthLake mendeklarasikannya mendukung pembuatan versi [https://hl7.org/fhir/R4/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.versioning](https://hl7.org/fhir/R4/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.versioning)untuk 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. [https://hl7.org/fhir/R4/bundle-definitions.html#Bundle.entry.response.location](https://hl7.org/fhir/R4/bundle-definitions.html#Bundle.entry.response.location) Dalam contoh berikut, `vid` ditampilkan sebagai angka`1`. Untuk melihat contoh selengkapnya, lihat [Contoh Bundle/Bundle-response](https://build.fhir.org/bundle-response.json.html) (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](managing-data-stores-describe.md).
1. Tentukan `Resource` jenis FHIR untuk membaca dan mengumpulkan terkait `id` dan `vid` nilai. Untuk informasi selengkapnya, lihat [Jenis sumber daya](reference-fhir-resource-types.md).
1. 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
```
1. Kirim permintaan . `history`Interaksi FHIR menggunakan `GET` permintaan dengan [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) atau SMART pada otorisasi FHIR. `vread`Interaksi 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 [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)data.
```
{
"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](reference-smart-on-fhir-oauth-scopes.md).
------