Création d'une ressource FHIR - AWS HealthLake

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.

Création d'une ressource FHIR

L'createinteraction FHIR crée une nouvelle ressource FHIR dans un magasin de HealthLake données. Pour plus d'informations, consultez la createdocumentation de l' RESTful API FHIR R4.

Pour créer une ressource 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 à créer. 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 à créer. Pour afficher le chemin complet de l'URL dans l'exemple suivant, faites défiler le curseur sur le bouton Copier.

    POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource

  4. Construisez un corps JSON pour la demande, en spécifiant les données FHIR de la nouvelle ressource. Dans le cadre de cette procédure, nous utilisons une Patient ressource FHIR. Enregistrez donc le fichier souscreate-patient.json.

    {
    "resourceType": "Patient",
    "identifier": [
        {
            "system": "urn:oid:1.2.36.146.595.217.0.1",
            "value": "12345"
        }
    ],
    "name": [
        {
            "family": "Silva",
            "given": [
                "Ana",
                "Carolina"
            ]
        }
    ],
    "gender": "female",
    "birthDate": "1992-02-10"
}

  5. Envoyez la demande . L'createinteraction FHIR utilise une POST demande avec AWS signature version 4 ou SMART sur autorisation FHIR. Les exemples suivants créent une Patient ressource FHIR en HealthLake utilisant curl ou la HealthLake console. Pour afficher un exemple complet, faites défiler la souris sur le bouton Copier.

    SigV4

    Autorisation SigV4

    curl --request POST \
  'https://healthlake.region.amazonaws.com/datastore/datastore-id/r4/Patient' \
  --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' \
  --data @create-patient.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.

    AWS Console
    Note

    La HealthLake console prend uniquement en charge l'autorisation AWS SigV4.

    1. Connectez-vous à la page Exécuter une requête sur la HealthLake console.

    2. Dans la section Paramètres de requête, effectuez les sélections suivantes.

    • ID du magasin de données : choisissez un identifiant de magasin de données pour générer une chaîne de requête.

    • Type de requête : choisissezCreate.

    • Type de ressource : choisissez le type de ressource FHIR à créer.

    • Corps de la demande : créez un corps JSON pour la demande, en spécifiant les données FHIR de la nouvelle ressource.

    3. Choisissez Exécuter la requête.
Configuration du niveau de validation pour la création de ressources

Lorsque vous créez une ressource FHIR, vous pouvez éventuellement spécifier un en-tête x-amzn-healthlake-fhir-validation-level HTTP pour configurer un niveau de validation pour la ressource. AWS HealthLake prend actuellement en charge les niveaux de validation suivants :

  • strict: Les ressources sont validées en fonction de l'élément de profil de la ressource ou de la spécification R4 si aucun profil n'est présent. Il s'agit du niveau de validation par défaut pour AWS HealthLake.

  • structure-only: Les ressources sont validées par rapport à R4, en ignorant les profils référencés.

  • minimal: Les ressources sont validées de manière minimale, sans tenir compte de certaines règles R4. Les ressources qui échouent aux vérifications de structure requises search/analytics seront mises à jour pour inclure un avertissement d'audit.

Les ressources créées avec le niveau de validation minimal peuvent être ingérées dans une banque de données malgré l'échec de la validation requise pour l'indexation des recherches. Dans ce cas, les ressources seront mises à jour pour inclure une extension spécifique à Healthlake afin de documenter ces échecs :

{
    "url": "http://healthlake.amazonaws.com/fhir/StructureDefinition/validation-issue",
    "valueString": "{\"resourceType\":\"OperationOutcome\",\"issue\":[{\"severity\":\"error\",\"code\":\"processing\",\"details\":{\"text\":\"FHIR resource in payload failed FHIR validation rules.\"},\"diagnostics\":\"FHIR resource in payload failed FHIR validation rules.\"}]}"
}

En outre, l'en-tête de réponse HTTP suivant sera inclus avec la valeur « true » :

x-amzn-healthlake-validation-issues : true
Note

Les données ingérées qui sont mal formées conformément à la spécification R4 peuvent ne pas être consultables comme prévu si ces erreurs sont présentes.