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

# HealthLake の FHIR R4 `$attribution-status`オペレーション
<a name="reference-fhir-operations-attribution-status"></a>

特定のメンバーの属性ステータスを取得し、患者に関連するすべての属性リソースを含むバンドルを返します。このオペレーションは、[FHIR メンバー属性 (ATR) リスト IG 2.1.0 実装の一部です。](https://build.fhir.org/ig/HL7/davinci-atr/spec.html)

## Endpoint
<a name="attribution-status-endpoint"></a>

```
POST [base]/Group/[id]/$attribution-status
```

## リクエストパラメーター
<a name="attribution-status-parameters"></a>

オペレーションでは、次のオプションパラメータを使用できます。


| パラメータ | Type | 説明 | 
| --- | --- | --- | 
| memberId | 識別子 | 属性ステータスがリクエストされたメンバーの MemberId  | 
| patientReference | リファレンス | プロデューサーのシステム内の患者リソースへの参照 | 

**注記**  
検証目的で`patientReference`、 `memberId`または のいずれか、または両方を指定できます。

## リクエスト例
<a name="attribution-status-request-example"></a>

```
{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "memberId",
      "valueIdentifier": {
        "system": "http://example.org",
        "value": "MBR123456789"
      }
    },
    {
      "name": "patientReference",
      "valueReference": {
        "reference": "Patient/patient-123",
        "display": "John Doe"
      }
    }
  ]
}
```

## 応答
<a name="attribution-status-response"></a>

患者に関連する属性リソースを含むバンドルを返します。


| [リソース]  | カーディナリティ | ロケーション | 
| --- | --- | --- | 
| 患者 | 1..1 | Group.member.entity | 
| カバレッジ | 0..1 | Group.member.extension:coverageReference | 
| Organization/Practitioner/PractitionerRole | 0..1 | Group.member.extension:attributedProvider | 
| 任意のリソース | 0..1 | Group.member.extension:associatedData | 

### レスポンス例
<a name="attribution-status-response-example"></a>

```
{
  "resourceType": "Bundle",
  "id": "bundle-response",
  "meta": {
    "lastUpdated": "2014-08-18T01:43:33Z"
  },
  "type": "collection",
  "entry": [
    {
      "fullUrl": "http://example.org/fhir/Patient/12423",
      "resource": {
        "resourceType": "Patient",
        "id": "12423",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2014-08-18T01:43:31Z"
        },
        "active": true,
        "name": [
          {
            "use": "official",
            "family": "Chalmers",
            "given": ["Peter", "James"]
          }
        ],
        "gender": "male",
        "birthDate": "1974-12-25"
      }
    },
    {
      "fullUrl": "http://example.org/fhir/Coverage/123456",
      "resource": {
        "resourceType": "Coverage",
        "id": "1"
        // ... additional Coverage resource details
      }
    },
    {
      "fullUrl": "http://example.org/fhir/Organization/666666",
      "resource": {
        "resourceType": "Organization",
        "id": "2"
        // ... additional Organization resource details
      }
    }
  ]
}
```

## エラー処理
<a name="attribution-status-error-handling"></a>

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


| エラー | HTTP ステータス | 説明 | 
| --- | --- | --- | 
| 無効なオペレーションリクエスト | 400 | 非準拠のリクエストパラメータまたは構造 | 
| グループリソースが見つかりません | 404 | 指定されたグループ ID は存在しません | 
| 患者リソースが見つかりません | 404 | 指定された患者リファレンスは存在しません | 

## 認可とセキュリティ
<a name="attribution-status-authorization"></a>

SMART スコープの要件  
クライアントには、グループリソースおよび関連する属性リソースを読み取るための適切な権限が必要です  
標準の FHIR 認可メカニズムがすべてのオペレーションに適用されます