Criando um recurso FHIR - AWS HealthLake

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criando um recurso FHIR

A create interação FHIR cria um novo recurso FHIR em um armazenamento de dados. HealthLake Para obter informações adicionais, consulte a createdocumentação da API FHIR R4 RESTful .

Para criar um recurso FHIR

  1. Colecione HealthLake region e datastoreId valorize. Para obter mais informações, consulte Obter propriedades do datastore.

  2. Determine o tipo de FHIR Resource a ser criado. Para obter mais informações, consulte Tipos de recursos.

  3. Crie uma URL para a solicitação usando os valores coletados para HealthLake region datastoreId e. Inclua também o Resource tipo FHIR a ser criado. Para ver todo o caminho do URL no exemplo a seguir, role até o botão Copiar.

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

  4. Crie um corpo JSON para a solicitação, especificando os dados FHIR para o novo recurso. Para fins deste procedimento, estamos usando um Patient recurso FHIR, então salve o arquivo como. create-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. Envie a solicitação . A create interação FHIR usa uma POST solicitação com AWS Signature Version 4 ou SMART na autorização FHIR. Os exemplos a seguir criam um Patient recurso FHIR HealthLake usando o curl ou o console. HealthLake Para ver um exemplo inteiro, role até o botão Copiar.

    SigV4

    Autorização 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

    SMART no exemplo de autorização FHIR para o tipo de IdentityProviderConfigurationdados.

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

    O chamador pode atribuir permissões na autorização lambda. Para obter mais informações, consulte OAuth escopos 2.0.

    AWS Console
    nota

    O HealthLake console suporta somente a autorização AWS SigV4.

    1. Faça login na página Executar consulta no HealthLake console.

    2. Na seção Configurações da consulta, faça as seguintes seleções.

    • ID do armazenamento de dados — escolha um ID do armazenamento de dados para gerar uma sequência de caracteres de consulta.

    • Tipo de consulta — escolhaCreate.

    • Tipo de recurso — escolha o tipo de recurso FHIR a ser criado.

    • Corpo da solicitação — construa um corpo JSON para a solicitação, especificando os dados FHIR para o novo recurso.

    3. Selecione Executar consulta.
Configurando o nível de validação para criação de recursos

Ao criar um recurso FHIR, você pode especificar opcionalmente um cabeçalho x-amzn-healthlake-fhir-validation-level HTTP para configurar um nível de validação para o recurso. AWS HealthLake atualmente suporta os seguintes níveis de validação:

  • strict: os recursos são validados de acordo com o elemento de perfil do recurso ou com a especificação R4 se nenhum perfil estiver presente. Esse é o nível de validação padrão para AWS HealthLake.

  • structure-only: os recursos são validados em relação ao R4, ignorando quaisquer perfis referenciados.

  • minimal: os recursos são validados minimamente, ignorando certas regras do R4. Os recursos que falharem nas verificações de estrutura exigidas search/analytics serão atualizados para incluir um aviso para auditoria.

Os recursos criados com o nível mínimo de validação podem ser ingeridos em um Datastore, apesar da falha na validação necessária para a indexação de pesquisas. Nesse caso, os recursos serão atualizados para incluir uma extensão específica do Healthlake para documentar essas falhas:

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

Além disso, o seguinte cabeçalho de resposta HTTP será incluído com o valor “true”:

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

Os dados ingeridos que estão malformados de acordo com a especificação R4 podem não ser pesquisáveis conforme o esperado se esses erros estiverem presentes.