Lire l'historique des ressources du FHIR - AWS HealthLake
Lecture de l'historique spécifique à une version

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Lire l'historique des ressources du FHIR

L'historyinteraction FHIR permet de récupérer l'historique d'une ressource FHIR particulière dans un HealthLake magasin de données. Grâce à cette interaction, vous pouvez déterminer l'évolution du contenu d'une ressource FHIR au fil du temps. Il est également utile en coordination avec les journaux d'audit pour voir l'état d'une ressource avant et après modification. Les interactions create FHIR et delete aboutissent à une version historique de la ressource à enregistrer. update Pour plus d'informations, consultez la historydocumentation de l' RESTful API FHIR R4.

Note

Vous pouvez choisir de ne pas utiliser history des types de ressources FHIR spécifiques. Pour vous désinscrire, créez un dossier en utilisant AWS Support Center Console. Pour créer votre dossier, connectez-vous à votre dossier Compte AWS et choisissez Créer un dossier.

Pour lire l'historique des ressources du FHIR

  1. Collectez HealthLake region et datastoreId valorisez. Pour de plus amples informations, veuillez consulter Obtenir les propriétés du magasin de données.

  2. Déterminez le type de FHIR Resource à lire et collectez la id valeur associée. Pour de plus amples informations, veuillez consulter Types de ressource.

  3. Créez une URL pour la demande en utilisant les valeurs collectées pour HealthLake region etdatastoreId. Incluez également le Resource type FHIR, ses paramètres de recherche associés id et facultatifs. Pour afficher le chemin complet de l'URL dans l'exemple suivant, faites défiler le curseur sur le bouton Copier.

    GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id/_history{?[parameters]}
    HealthLake paramètres de recherche pris en charge pour l'interaction FHIR history
    Paramètre Description
    _count : integer Le nombre maximum de résultats de recherche sur une page. Le serveur renverra le nombre demandé ou le nombre maximum de résultats de recherche autorisés par défaut pour le magasin de données, le plus faible des deux étant retenu.
    _since : instant N'incluez que les versions de ressources créées à l'instant donné ou après.
    _at : date(Time) N'incluez que les versions de ressources qui étaient à jour à un moment donné pendant la période spécifiée dans la valeur de date et d'heure. Pour plus d'informations, consultez la documentation datede l' RESTfulAPI HL7 FHIR.

  4. Envoyez la demande . L'historyinteraction FHIR utilise une GET demande avec AWS signature version 4 ou SMART sur autorisation FHIR. L'curlexemple suivant utilise le paramètre _count de recherche pour renvoyer 100 résultats de recherche historiques par page pour une Patient ressource FHIR dans HealthLake. Pour afficher l'exemple dans son intégralité, faites défiler la souris sur le bouton Copier.

    SigV4

    Autorisation 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

    Exemple d'autorisation SMART sur FHIR pour le type de IdentityProviderConfigurationdonnées.

    {
    "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\"]}"
}

    L'appelant peut attribuer des autorisations dans le lambda d'autorisation. Pour de plus amples informations, veuillez consulter OAuth Éscopes 2.0.

    Le contenu renvoyé par une history interaction est contenu dans une ressource FHIRBundle, dont le type est défini sur. history Il contient l'historique des versions spécifié, trié avec les versions les plus anciennes en dernier et inclut les ressources supprimées. Pour plus d'informations, consultez la Resource Bundledocumentation du FHIR R4.

Lire l'historique des ressources FHIR spécifiques à une version

L'vreadinteraction FHIR effectue une lecture spécifique à la version d'une ressource dans un HealthLake magasin de données. Grâce à cette interaction, vous pouvez visualiser le contenu d'une ressource FHIR tel qu'il était à un moment donné dans le passé.

Note

Si vous utilisez l'historyinteraction FHIR sansvread, renvoie HealthLake toujours la dernière version des métadonnées de la ressource.

HealthLake déclare qu'il prend en charge le versionnement CapabilityStatement.rest.resource.versioningpour chaque ressource prise en charge. Tous les magasins de HealthLake données incluent Resource.meta.versionId (vid) sur toutes les ressources.

Lorsque history l'interaction FHIR est activée (par défaut pour les magasins de données créés après le 25/10/2024 ou par demande pour les anciens magasins de données), la Bundle réponse inclut vid le dans l'élément. location Dans l'exemple suivant, le vid s'affiche sous forme de numéro1. Pour voir l'exemple complet, voir Example bundle/bundle-response (JSON).

"response" : {
    "status" : "201 Created",
    "location" : "Patient/12423/_history/1",
    ...}
Pour lire l'historique des ressources FHIR spécifiques à une version

  1. Collectez HealthLake region et datastoreId valorisez. Pour de plus amples informations, veuillez consulter Obtenir les propriétés du magasin de données.

  2. Déterminez le Resource type de FHIR à lire et à collecter les vid valeurs id et associées. Pour de plus amples informations, veuillez consulter Types de ressource.

  3. Construisez une URL pour la demande en utilisant les valeurs collectées pour HealthLake et FHIR. Pour afficher le chemin complet de l'URL dans l'exemple suivant, faites défiler le curseur sur le bouton Copier.

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

  4. Envoyez la demande . L'historyinteraction FHIR utilise une GET demande avec AWS signature version 4 ou SMART sur autorisation FHIR. L'vreadinteraction suivante renvoie une seule instance avec le contenu spécifié pour la Patient ressource FHIR pour la version des métadonnées de ressource spécifiée par levid. Pour afficher le chemin complet de l'URL dans l'exemple suivant, faites défiler le curseur sur le bouton Copier.

    SigV4

    Autorisation 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

    Exemple d'autorisation SMART sur FHIR pour le type de IdentityProviderConfigurationdonnées.

    {
    "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\"]}"
}

    L'appelant peut attribuer des autorisations dans le lambda d'autorisation. Pour de plus amples informations, veuillez consulter OAuth Éscopes 2.0.