Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Lesen der FHIR-Ressourcengeschichte
Die `history` FHIR-Interaktion ruft den Verlauf einer bestimmten FHIR-Ressource in einem Datenspeicher ab. HealthLake Mithilfe dieser Interaktion können Sie feststellen, wie sich der Inhalt einer FHIR-Ressource im Laufe der Zeit verändert hat. Bei der Abstimmung mit Audit-Logs ist es auch nützlich, den Status einer Ressource vor und nach der Änderung zu überprüfen. Die FHIR-Interaktionen `create` und `delete` führen zu einer historischen Version der Ressource, die gespeichert werden soll. `update` Weitere Informationen finden Sie [https://hl7.org/fhir/R4/http.html#history](https://hl7.org/fhir/R4/http.html#history)in der **FHIR RESTful R4-API-Dokumentation**.
**Anmerkung**
Sie können sich `history` für bestimmte FHIR-Ressourcentypen abmelden. Um sich abzumelden, erstellen Sie einen Fall mit [AWS Support Center Console](https://console.aws.amazon.com/support/home#/). Um Ihren Fall zu erstellen, melden Sie sich bei Ihrem an AWS-Konto und wählen Sie **Fall erstellen**.
**Um den FHIR-Ressourcenverlauf zu lesen**
1. Sammeln HealthLake `region` und `datastoreId` schätzen. Weitere Informationen finden Sie unter [Eigenschaften des Datenspeichers abrufen](managing-data-stores-describe.md).
1. Ermitteln Sie den Typ von FHIR`Resource`, der gelesen werden soll, und erfassen Sie den zugehörigen `id` Wert. Weitere Informationen finden Sie unter [Ressourcentypen](reference-fhir-resource-types.md).
1. Konstruieren Sie mithilfe der gesammelten Werte für HealthLake `region` und `datastoreId` eine URL für die Anfrage. Geben Sie auch den `Resource` FHIR-Typ, die zugehörigen `id` und optionalen Suchparameter an. Scrollen Sie über die Schaltfläche **Kopieren**, um den gesamten URL-Pfad im folgenden Beispiel anzuzeigen.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id/_history{?[parameters]}
```
**HealthLake unterstützte Suchparameter für die FHIR-Interaktion `history`**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/healthlake/latest/devguide/managing-fhir-resources-read-history.html)
1. Senden Sie die Anforderung . Die `history` FHIR-Interaktion verwendet eine `GET` Anfrage mit entweder [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) oder SMART bei der FHIR-Autorisierung. Im folgenden `curl` Beispiel wird der `_count` Suchparameter verwendet, um 100 historische Suchergebnisse pro Seite für eine `Patient` FHIR-Ressource in zurückzugeben. HealthLake Scrollen Sie über die Schaltfläche **Kopieren**, um das gesamte Beispiel anzuzeigen.
------
#### [ SigV4 ]
SigV4-Autorisierung
```
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 on FHIR-Autorisierungsbeispiel für den [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)Datentyp.
```
{
"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\"]}"
}
```
Der Anrufer kann im Autorisierungs-Lambda Berechtigungen zuweisen. Weitere Informationen finden Sie unter [OAuth 2.0-Bereiche](reference-smart-on-fhir-oauth-scopes.md).
------
Der zurückgegebene Inhalt einer `history` Interaktion ist in einer FHIR-Ressource enthalten`Bundle`, wobei der Typ auf gesetzt ist. `history` Sie enthält den angegebenen Versionsverlauf, sortiert nach den ältesten Versionen zuletzt, und enthält gelöschte Ressourcen. Weitere Informationen finden Sie [https://hl7.org/fhir/R4/bundle.html](https://hl7.org/fhir/R4/bundle.html)in der **FHIR R4-Dokumentation**.
## Lesen des versionsspezifischen FHIR-Ressourcenverlaufs
Die `vread` FHIR-Interaktion führt ein versionsspezifisches Lesen einer Ressource in einem Datenspeicher durch. HealthLake Mithilfe dieser Interaktion können Sie den Inhalt einer FHIR-Ressource so anzeigen, wie er zu einem bestimmten Zeitpunkt in der Vergangenheit war.
**Anmerkung**
Wenn Sie die `history` FHIR-Interaktion *ohne* verwenden`vread`, wird HealthLake immer die neueste Version der Metadaten der Ressource zurückgegeben.
HealthLake erklärt, dass es die Versionierung [https://hl7.org/fhir/R4/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.versioning](https://hl7.org/fhir/R4/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.versioning)für jede unterstützte Ressource unterstützt. Alle HealthLake Datenspeicher enthalten `Resource.meta.versionId` (`vid`) für alle Ressourcen.
Wenn die `history` FHIR-Interaktion aktiviert ist (standardmäßig für Datenspeicher, die nach dem 25.10.2024 erstellt wurden, oder auf Anfrage für ältere Datenspeicher), enthält die `Bundle` Antwort das `vid` als Teil des Elements. [https://hl7.org/fhir/R4/bundle-definitions.html#Bundle.entry.response.location](https://hl7.org/fhir/R4/bundle-definitions.html#Bundle.entry.response.location) Im folgenden Beispiel `vid` wird das als Zahl angezeigt. `1` Das vollständige Beispiel finden Sie unter [Beispiel Bundle/Bundle-Response](https://build.fhir.org/bundle-response.json.html) (JSON).
```
"response" : {
"status" : "201 Created",
"location" : "Patient/12423/_history/1",
...}
```
**Um den versionsspezifischen FHIR-Ressourcenverlauf zu lesen**
1. Sammeln HealthLake `region` und bewerten. `datastoreId` Weitere Informationen finden Sie unter [Eigenschaften des Datenspeichers abrufen](managing-data-stores-describe.md).
1. Ermitteln Sie den `Resource` FHIR-Typ, der gelesen und die zugehörigen `id` `vid` Werte gesammelt werden soll. Weitere Informationen finden Sie unter [Ressourcentypen](reference-fhir-resource-types.md).
1. Konstruieren Sie anhand der für HealthLake und FHIR gesammelten Werte eine URL für die Anfrage. Scrollen Sie über die Schaltfläche **Kopieren**, um den gesamten URL-Pfad im folgenden Beispiel anzuzeigen.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id/_history/vid
```
1. Senden Sie die Anforderung . Die `history` FHIR-Interaktion verwendet eine `GET` Anfrage mit entweder [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) oder SMART bei der FHIR-Autorisierung. Die folgende `vread` Interaktion gibt eine einzelne Instanz mit dem für die `Patient` FHIR-Ressource angegebenen Inhalt für die Version der Ressourcenmetadaten zurück, die von der angegeben wurde. `vid` Scrollen Sie über die Schaltfläche **Kopieren**, um den gesamten URL-Pfad im folgenden Beispiel anzuzeigen.
------
#### [ SigV4 ]
SigV4-Autorisierung
```
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 on FHIR-Autorisierungsbeispiel für den [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)Datentyp.
```
{
"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\"]}"
}
```
Der Anrufer kann im Autorisierungs-Lambda Berechtigungen zuweisen. Weitere Informationen finden Sie unter [OAuth 2.0-Bereiche](reference-smart-on-fhir-oauth-scopes.md).
------