FHIR 리소스 생성 - AWS HealthLake

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

FHIR 리소스 생성

FHIR create 상호 작용은 HealthLake 데이터 스토어에 새 FHIR 리소스를 생성합니다. 자세한 내용은 FHIR R4 RESTful API 설명서create의 섹션을 참조하세요.

FHIR 리소스를 생성하려면

  1. HealthLake region 및 datastoreId 값을 수집합니다. 자세한 내용은 데이터 스토어 속성 가져오기 단원을 참조하십시오.

  2. Resource 생성할 FHIR 유형을 결정합니다. 자세한 내용은 리소스 유형 단원을 참조하십시오.

  3. HealthLake region 및에 대해 수집된 값을 사용하여 요청에 대한 URL을 구성합니다datastoreId. 생성할 FHIR Resource 유형도 포함합니다. 다음 예제에서 전체 URL 경로를 보려면 복사 버튼을 스크롤합니다.

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

  4. 요청에 대한 JSON 본문을 구성하여 새 리소스에 대한 FHIR 데이터를 지정합니다. 이 절차의 목적상 FHIR Patient 리소스를 사용하므로 파일을 로 저장합니다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. 요청을 보냅니다. FHIR create 상호 작용은 FHIR 권한 부여에서 AWS 서명 버전 4 또는 SMART와 함께 POST 요청을 사용합니다. 다음 예제에서는 curl 또는 HealthLake 콘솔을 사용하여 HealthLake에서 FHIR Patient 리소스를 생성합니다. 전체 예제를 보려면 복사 버튼을 스크롤합니다.

    SigV4

    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

    IdentityProviderConfiguration 데이터 형식에 대한 SMART on FHIR 권한 부여 예제입니다.

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

    호출자는 권한 부여 Lambda에 권한을 할당할 수 있습니다. 자세한 내용은 OAuth 2.0 범위 단원을 참조하십시오.

    AWS Console
    참고

    HealthLake 콘솔은 AWS SigV4 권한 부여만 지원합니다.

    1. HealthLake 콘솔의 쿼리 실행 페이지에 로그인합니다.

    2. 쿼리 설정 섹션에서 다음을 선택합니다.

    • 데이터 스토어 ID - 쿼리 문자열을 생성할 데이터 스토어 ID를 선택합니다.

    • 쿼리 유형 -를 선택합니다Create.

    • 리소스 유형 - 생성할 FHIR 리소스 유형을 선택합니다.

    • 요청 본문 - 새 리소스에 대한 FHIR 데이터를 지정하여 요청에 대한 JSON 본문을 구성합니다.

    3. 쿼리 실행을 선택합니다.
리소스 생성을 위한 검증 수준 구성

FHIR 리소스를 생성할 때 선택적으로 x-amzn-healthlake-fhir-validation-level HTTP 헤더를 지정하여 리소스에 대한 검증 수준을 구성할 수 있습니다.는 AWS HealthLake 현재 다음 검증 수준을 지원합니다.

  • strict: 리소스는 리소스의 프로필 요소 또는 프로필이 없는 경우 R4 사양에 따라 검증됩니다. 이는의 기본 검증 수준입니다 AWS HealthLake.

  • structure-only: 리소스는 R4에 대해 검증되며 참조된 프로파일은 무시합니다.

  • minimal: 리소스는 특정 R4 규칙을 무시하고 최소한으로 검증됩니다. 검색/분석에 필요한 구조 검사에 실패한 리소스는 감사 경고를 포함하도록 업데이트됩니다.

최소 검증 수준으로 생성된 리소스는 검색 인덱싱에 필요한 검증에 실패하더라도 데이터 스토어에 수집될 수 있습니다. 이 경우 해당 실패를 문서화하기 위한 Healthlake별 확장을 포함하도록 리소스가 업데이트됩니다.

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

또한 다음 HTTP 응답 헤더는 "true" 값과 함께 포함됩니다.

x-amzn-healthlake-validation-issues : true
참고

R4 사양에 따라 잘못된 형식으로 수집된 데이터는 이러한 오류가 있는 경우 예상대로 검색하지 못할 수 있습니다.