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

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

AWS HealthLake は FHIR リソースの PATCH オペレーションをサポートするようになりました。これにより、リソース全体を更新することなく、追加、置換、または削除する特定の要素をターゲットにしてリソースを変更できます。このオペレーションは、リモートクライアントや帯域幅が制限されているクライアントで、ネットワークの使用量を減らすために特に役立ちます。このオペレーションは、以下が必要な場合に特に役立ちます。

使用状況

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

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

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

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

HealthLake は、RFC 6902 に従って次の 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": "************",
      "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"
  }
]

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

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

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

レスポンス例

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

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": "************",
      "use": "home"
    }
  ],
  "meta": {
    "versionId": "2",
    "lastUpdated": "2025-05-05T10:10:10Z"
  }
}

JSON パッチパスの構文

パスパラメータは JSON ポインタ構文 (RFC 6901) を使用します。

行動

PATCH オペレーション：

エラー処理

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

注意

PATCH オペレーションの詳細については、FHIR R4 PATCH ドキュメントを参照してください。