FHIR リソースの作成 - AWS HealthLake

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

FHIR リソースの作成

FHIR createインタラクションは、HealthLake データストアに新しい FHIR リソースを作成します。詳細については、FHIR R4 RESTful API ドキュメントcreateの「」を参照してください。 R4 RESTful

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インタラクションは、AWS 署名バージョン 4 または SMART on FHIR 認可の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 データ型の FHIR 認可の SMART の例。

    {
    "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 リソースタイプを選択します。

    • リクエスト本文 — リクエストの JSON 本文を作成し、新しいリソースの FHIR データを指定します。

    3. [Run query] (クエリの実行) を選択します。
リソース作成の検証レベルの設定

FHIR リソースを作成するときに、オプションで HTTP x-amzn-healthlake-fhir-validation-level ヘッダーを指定して、リソースの検証レベルを設定できます。 AWS HealthLake は現在、次の検証レベルをサポートしています。

  • strict: リソースは、リソースのプロファイル要素、またはプロファイルが存在しない場合は R4 仕様に従って検証されます。これは、 のデフォルトの検証レベルです AWS HealthLake。

  • structure-only: リソースは R4 に対して検証され、参照されるプロファイルは無視されます。

  • minimal: リソースは、特定の R4 ルールを無視して、最小限検証されます。検索/分析に必要な構造チェックに失敗したリソースは、監査の警告を含むように更新されます。

最小限の検証レベルで作成されたリソースは、検索インデックス作成に必要な検証に失敗しても、Datastore に取り込むことができます。この場合、リソースが更新されて 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 仕様に従って誤った形式を取り込んだデータは、これらのエラーが存在する場合、期待どおりに検索できない場合があります。