Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Leggere la cronologia delle risorse FHIR
L'`history`interazione FHIR recupera la cronologia di una particolare risorsa FHIR in un archivio dati. HealthLake Utilizzando questa interazione, è possibile determinare in che modo il contenuto di una risorsa FHIR è cambiato nel tempo. È anche utile, in coordinamento con i registri di controllo, per vedere lo stato di una risorsa prima e dopo la modifica. Le interazioni `create` FHIR danno come `delete` risultato una versione storica della risorsa da salvare. `update` Per ulteriori informazioni, vedere la documentazione [https://hl7.org/fhir/R4/http.html#history](https://hl7.org/fhir/R4/http.html#history)dell'API **FHIR R4 RESTful **.
**Nota**
È possibile disattivare tipi di risorse `history` FHIR specifici. Per annullare l'iscrizione, crea un caso utilizzando [AWS Support Center Console](https://console.aws.amazon.com/support/home#/). Per creare il tuo caso, accedi al tuo Account AWS e scegli **Crea caso**.
**Per leggere la cronologia delle risorse FHIR**
1. Colleziona HealthLake `region` e `datastoreId` valorizza. Per ulteriori informazioni, consulta [Ottenere le proprietà dell'archivio dati](managing-data-stores-describe.md).
1. Determina il tipo di FHIR `Resource` per leggere e raccogliere il `id` valore associato. Per ulteriori informazioni, consulta [Tipi di risorse](reference-fhir-resource-types.md).
1. Costruisci un URL per la richiesta utilizzando i valori raccolti per HealthLake `region` e. `datastoreId` Includi anche il `Resource` tipo FHIR, i relativi parametri di ricerca associati `id` e facoltativi. Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante **Copia**.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id/_history{?[parameters]}
```
**HealthLake parametri di ricerca supportati per l'interazione FHIR `history`**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/healthlake/latest/devguide/managing-fhir-resources-read-history.html)
1. Inviare la richiesta . L'`history`interazione FHIR utilizza una `GET` richiesta con autorizzazione [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) o SMART on FHIR. L'`curl`esempio seguente utilizza il parametro `_count` search per restituire 100 risultati di ricerca storici per pagina per una risorsa FHIR `Patient` in. HealthLake Per visualizzare l'intero esempio, scorri il pulsante **Copia**.
------
#### [ SigV4 ]
Autorizzazione 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 ]
Esempio di autorizzazione SMART on FHIR per il tipo di dati [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html).
```
{
"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\"]}"
}
```
Il chiamante può assegnare le autorizzazioni nella lambda di autorizzazione. Per ulteriori informazioni, consulta [OAuth Cannocchiali 2.0](reference-smart-on-fhir-oauth-scopes.md).
------
Il contenuto restituito da un'`history`interazione è contenuto in una risorsa FHIR`Bundle`, con tipo impostato su. `history` Contiene la cronologia delle versioni specificata, ordinata in base alle ultime versioni più vecchie e include le risorse eliminate. Per ulteriori informazioni, vedere la documentazione [https://hl7.org/fhir/R4/bundle.html](https://hl7.org/fhir/R4/bundle.html)di **FHIR R4**.
## Leggere la cronologia delle risorse FHIR specifiche della versione
L'`vread`interazione FHIR esegue una lettura specifica della versione di una risorsa in un archivio dati. HealthLake Utilizzando questa interazione, è possibile visualizzare il contenuto di una risorsa FHIR com'era in un determinato momento del passato.
**Nota**
Se si utilizza l'`history`interazione FHIR *senza*`vread`, restituisce HealthLake sempre la versione più recente dei metadati della risorsa.
HealthLake dichiara il supporto per il controllo delle versioni per ogni risorsa supportata [https://hl7.org/fhir/R4/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.versioning](https://hl7.org/fhir/R4/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.versioning). Tutti gli archivi HealthLake dati includono `Resource.meta.versionId` (`vid`) su tutte le risorse.
Quando `history` l'interazione FHIR è abilitata (per impostazione predefinita per gli archivi dati creati dopo il 25/10/2024 o su richiesta per gli archivi dati più vecchi), la `Bundle` risposta include l'elemento `vid` come parte dell'elemento. [https://hl7.org/fhir/R4/bundle-definitions.html#Bundle.entry.response.location](https://hl7.org/fhir/R4/bundle-definitions.html#Bundle.entry.response.location) Nell'esempio seguente, viene visualizzato come numero. `vid` `1` Per visualizzare l'esempio completo, vedi Example [bundle/bundle-response](https://build.fhir.org/bundle-response.json.html) (JSON).
```
"response" : {
"status" : "201 Created",
"location" : "Patient/12423/_history/1",
...}
```
**Per leggere la cronologia delle risorse FHIR specifica della versione**
1. Raccolta e valori HealthLake `region`. `datastoreId` Per ulteriori informazioni, consulta [Ottenere le proprietà dell'archivio dati](managing-data-stores-describe.md).
1. Determina il `Resource` tipo di FHIR da leggere e raccogliere i `vid` valori `id` e i valori associati. Per ulteriori informazioni, consulta [Tipi di risorse](reference-fhir-resource-types.md).
1. Costruisci un URL per la richiesta utilizzando i valori raccolti per HealthLake e FHIR. Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante **Copia**.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id/_history/vid
```
1. Inviare la richiesta . L'`history`interazione FHIR utilizza una `GET` richiesta con autorizzazione [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) o SMART on FHIR. La seguente `vread` interazione restituisce una singola istanza con il contenuto specificato per la `Patient` risorsa FHIR per la versione dei metadati della risorsa specificata da. `vid` Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante **Copia**.
------
#### [ SigV4 ]
Autorizzazione 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 ]
Esempio di autorizzazione SMART on FHIR per il tipo di dati [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html).
```
{
"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\"]}"
}
```
Il chiamante può assegnare le autorizzazioni nella lambda di autorizzazione. Per ulteriori informazioni, consulta [OAuth Cannocchiali 2.0](reference-smart-on-fhir-oauth-scopes.md).
------