Lesen der FHIR-Ressourcengeschichte - AWS HealthLake
Lesen des versionsspezifischen Verlaufs

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 historyin 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. 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.

  2. Ermitteln Sie den Typ von FHIRResource, der gelesen werden soll, und erfassen Sie den zugehörigen id Wert. Weitere Informationen finden Sie unter Ressourcentypen.

  3. 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
    Parameter Beschreibung
    _count : integer Die maximale Anzahl von Suchergebnissen auf einer Seite. Der Server gibt die angeforderte Anzahl oder die maximale Anzahl von Suchergebnissen zurück, die standardmäßig für den Datenspeicher zulässig sind, je nachdem, welcher Wert niedriger ist.
    _since : instant Schließt nur Ressourcenversionen ein, die zu oder nach dem angegebenen Zeitpunkt erstellt wurden.
    _at : date(Time) Schließt nur Ressourcenversionen ein, die zu einem bestimmten Zeitpunkt während des im Datums- und Uhrzeitwert angegebenen Zeitraums aktuell waren. Weitere Informationen finden Sie datein der HL7 RESTfulFHIR-API-Dokumentation.

  4. Senden Sie die Anforderung . Die history FHIR-Interaktion verwendet eine GET Anfrage mit entweder AWS Signature Version 4 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 IdentityProviderConfigurationDatentyp.

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

    Der zurückgegebene Inhalt einer history Interaktion ist in einer FHIR-Ressource enthaltenBundle, 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 Resource Bundlein 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 verwendenvread, wird HealthLake immer die neueste Version der Metadaten der Ressource zurückgegeben.

HealthLake erklärt, dass es die Versionierung CapabilityStatement.rest.resource.versioningfü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. location Im folgenden Beispiel vid wird das als Zahl angezeigt. 1 Das vollständige Beispiel finden Sie unter Beispiel Bundle/Bundle-Response (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.

  2. Ermitteln Sie den Resource FHIR-Typ, der gelesen und die zugehörigen id vid Werte gesammelt werden soll. Weitere Informationen finden Sie unter Ressourcentypen.

  3. 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

  4. Senden Sie die Anforderung . Die history FHIR-Interaktion verwendet eine GET Anfrage mit entweder AWS Signature Version 4 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 IdentityProviderConfigurationDatentyp.

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