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'`history`interaction 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 [https://hl7.org/fhir/R4/http.html#history](https://hl7.org/fhir/R4/http.html#history)documentation 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](https://console.aws.amazon.com/support/home#/). 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](managing-data-stores-describe.md).
1. Déterminez le type de FHIR `Resource` à lire et collectez la `id` valeur associée. Pour de plus amples informations, veuillez consulter [Types de ressources](reference-fhir-resource-types.md).
1. Créez une URL pour la demande en utilisant les valeurs collectées pour HealthLake `region` et`datastoreId`. 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`**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/healthlake/latest/devguide/managing-fhir-resources-read-history.html)
1. Envoyez la demande . L'`history`interaction FHIR utilise une `GET` demande avec [AWS signature version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) ou SMART sur autorisation FHIR. L'`curl`exemple 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 [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)donné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](reference-smart-on-fhir-oauth-scopes.md).
------
Le contenu renvoyé par une `history` interaction est contenu dans une ressource FHIR`Bundle`, 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 [https://hl7.org/fhir/R4/bundle.html](https://hl7.org/fhir/R4/bundle.html)documentation du **FHIR R4**.
## Lire l'historique des ressources FHIR spécifiques à une version
L'`vread`interaction 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'`history`interaction FHIR *sans*`vread`, renvoie HealthLake toujours la dernière version des métadonnées de la ressource.
HealthLake déclare qu'il prend en charge le versionnement [https://hl7.org/fhir/R4/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.versioning](https://hl7.org/fhir/R4/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.versioning)pour 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. [https://hl7.org/fhir/R4/bundle-definitions.html#Bundle.entry.response.location](https://hl7.org/fhir/R4/bundle-definitions.html#Bundle.entry.response.location) Dans l'exemple suivant, le `vid` s'affiche sous forme de numéro`1`. Pour voir l'exemple complet, voir [Example bundle/bundle-response (JSON](https://build.fhir.org/bundle-response.json.html)).
```
"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](managing-data-stores-describe.md).
1. 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 ressources](reference-fhir-resource-types.md).
1. 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
```
1. Envoyez la demande . L'`history`interaction FHIR utilise une `GET` demande avec [AWS signature version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) ou SMART sur autorisation FHIR. L'`vread`interaction 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 le`vid`. 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 [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)donné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](reference-smart-on-fhir-oauth-scopes.md).
------