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

PATCH オペレーションによるリソースの変更

AWS HealthLake は FHIR リソースの PATCH オペレーションをサポートしているため、リソース全体を更新することなく、特定の要素をターゲットにして追加、置換、または削除することで、リソースを変更できます。このオペレーションは、以下が必要な場合に特に役立ちます。

サポートされているパッチ形式

AWS HealthLake は 2 つの標準 PATCH 形式をサポートしています。

JSON パッチ (RFC 6902)

JSON ポインタ構文を使用して、リソース構造内の要素の位置で要素をターゲットにします。

Content-Type: application/json-patch+json

FHIRPath パッチ (FHIR R4 仕様)

FHIRPath 式を使用して、コンテンツと関係によって要素をターゲットにし、パッチ適用に対する FHIR ネイティブアプローチを提供します。

Content-Type: application/fhir+json

使用方法

Direct PATCH オペレーション

PATCH オペレーションは、PATCH HTTP メソッドを使用して FHIR リソースで直接呼び出すことができます。

PATCH [base]/[resource-type]/[id]{?_format=[mime-type]}

バンドル内のパッチ

パッチオペレーションは、タイプ batchまたは の FHIR バンドル内のエントリとして含めることができるためtransaction、1 つのリクエストでパッチオペレーションを他の FHIR インタラクション (作成、読み取り、更新、削除) と組み合わせることができます。

JSON パッチ形式

サポートされているオペレーション

パス構文

JSON パッチは JSON ポインタ構文 (RFC 6901) を使用します。

例

複数のオペレーションによる直接 JSON パッチリクエスト

PATCH [base]/Patient/example
Content-Type: application/json-patch+json
If-Match: W/"1"

[
  {
    "op": "replace",
    "path": "/name/0/family",
    "value": "Smith"
  },
  {
    "op": "add",
    "path": "/telecom/-",
    "value": {
      "system": "phone",
      "value": "555-555-5555",
      "use": "home"
    }
  },
  {
    "op": "remove",
    "path": "/address/0"
  },
  {
    "op": "move",
    "from": "/name/0/family",
    "path": "/name/1/family"
  },
  {
    "op": "test",
    "path": "/gender",
    "value": "male"
  },
  {
    "op": "copy",
    "from": "/name/0",
    "path": "/name/1"
  }
]

単一のオペレーションによる直接 JSON パッチリクエスト

PATCH [base]/Patient/example
Content-Type: application/json-patch+json

[
  {
    "op": "replace",
    "path": "/active",
    "value": false
  }
]

バンドルの JSON パッチ

base64 でエンコードされた JSON パッチペイロードを含むバイナリリソースを使用します。

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [{
    "resource": {
      "resourceType": "Binary",
      "contentType": "application/json-patch+json",
      "data": "W3sib3AiOiJhZGQiLCJwYXRoIjoiL2JpcnRoRGF0ZSIsInZhbHVlIjoiMTk5MC0wMS0wMSJ9XQ=="
    },
    "request": {
      "method": "PATCH",
      "url": "Patient/123"
    }
  }]
}

FHIRPath パッチ形式

サポートされているオペレーション

パス構文

FHIRPath Patch は、以下をサポートする FHIRPath 式を使用します。

例

Direct FHIRPath パッチリクエスト

PATCH [base]/Patient/123
Content-Type: application/fhir+json
Authorization: ...

{
  "resourceType": "Parameters",
  "parameter": [{
    "name": "operation",
    "part": [
      { "name": "type", "valueCode": "add" },
      { "name": "path", "valueString": "Patient" },
      { "name": "name", "valueString": "birthDate" },
      { "name": "value", "valueDate": "1990-01-01" }
    ]
  }]
}

バンドルの FHIRPath パッチ

Parameters リソースを のエントリリソースとして使用しますmethod: PATCH。

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [{
    "resource": {
      "resourceType": "Parameters",
      "parameter": [{
        "name": "operation",
        "part": [
          { "name": "type", "valueCode": "add" },
          { "name": "path", "valueString": "Patient" },
          { "name": "name", "valueString": "birthDate" },
          { "name": "value", "valueDate": "1990-01-01" }
        ]
      }]
    },
    "request": {
      "method": "PATCH",
      "url": "Patient/123"
    }
  }]
}

リクエストヘッダー

レスポンス例

オペレーションは、更新されたリソースに新しいバージョン情報を返します。

HTTP/1.1 200 OK
Content-Type: application/fhir+json
ETag: W/"2"
Last-Modified: Mon, 05 May 2025 10:10:10 GMT

{
  "resourceType": "Patient",
  "id": "example",
  "active": true,
  "name": [
    {
      "family": "Smith",
      "given": ["John"]
    }
  ],
  "telecom": [
    {
      "system": "phone",
      "value": "555-555-5555",
      "use": "home"
    }
  ],
  "meta": {
    "versionId": "2",
    "lastUpdated": "2025-05-05T10:10:10Z"
  }
}

行動

PATCH オペレーション:

エラー処理

オペレーションは、次のエラー条件を処理します。

機能の概要

制限事項

その他のリソース

PATCH オペレーションの詳細については、以下を参照してください。