Leggere la cronologia delle risorse FHIR - AWS HealthLake
Leggere la cronologia specifica della versione

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'historyinterazione 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 historydell'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. 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.

  2. Determina il tipo di FHIR Resource per leggere e raccogliere il id valore associato. Per ulteriori informazioni, consulta Tipi di risorsa.

  3. 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
    Parametro Descrizione
    _count : integer Il numero massimo di risultati di ricerca in una pagina. Il server restituirà il numero richiesto o il numero massimo di risultati di ricerca consentito per impostazione predefinita per l'archivio dati, a seconda di quale sia inferiore.
    _since : instant Include solo le versioni delle risorse create in un determinato istante o successivamente.
    _at : date(Time) Includi solo le versioni delle risorse che erano correnti in un determinato momento durante il periodo di tempo specificato nel valore di data e ora. Per ulteriori informazioni, consulta datela documentazione dell' RESTfulAPI HL7 FHIR.

  4. Inviare la richiesta . L'historyinterazione FHIR utilizza una GET richiesta con autorizzazione AWS Signature Version 4 o SMART on FHIR. L'curlesempio 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 IdentityProviderConfiguration.

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

    Il contenuto restituito da un'historyinterazione è contenuto in una risorsa FHIRBundle, 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 Resource Bundledi FHIR R4.

Leggere la cronologia delle risorse FHIR specifiche della versione

L'vreadinterazione 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'historyinterazione FHIR senzavread, restituisce HealthLake sempre la versione più recente dei metadati della risorsa.

HealthLake dichiara il supporto per il controllo delle versioni per ogni risorsa supportata 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. location Nell'esempio seguente, viene visualizzato come numero. vid 1 Per visualizzare l'esempio completo, vedi Example bundle/bundle-response (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.

  2. Determina il Resource tipo di FHIR da leggere e raccogliere i vid valori id e i valori associati. Per ulteriori informazioni, consulta Tipi di risorsa.

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

  4. Inviare la richiesta . L'historyinterazione FHIR utilizza una GET richiesta con autorizzazione AWS Signature Version 4 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 IdentityProviderConfiguration.

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