本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# CMS 合规性功能
<a name="reference-compliance-cms"></a>

AWS HealthLake 提供的功能可帮助您满足 CMS（医疗保险和医疗补助服务中心）互操作性和合规性要求。这些功能使您能够按内容管理系统类别跟踪 API 使用情况，然后报告使用情况指标以实现合规性。

**Topics**
+ [CMS 互操作端点](#cms-interoperability-endpoints)
+ [增强了 CMS 合规性 CloudWatch 指标](#cms-cloudwatch-metrics)

## CMS 互操作端点
<a name="cms-interoperability-endpoints"></a>

### 概述
<a name="cms-endpoints-overview"></a>

HealthLake 提供了四个 CMS 互操作性端点，它们对应于 CMS 规定的 API 类别。 HealthLake 数据存储的底层基本 URL 不会改变。这些端点只是提供了一种对您的 API 调用进行分类和跟踪的方法，以便进行 CMS 报告。

### 用途
<a name="cms-endpoints-purpose"></a>

这些互操作性端点的主要目的是使客户能够：
+ 按内容管理系统类别@@ **轻松跟踪** API 交易
+ **自动报告** CMS 合规性的使用量指标
+ 只需最少的更改即可@@ **维护**现有的 FHIR 工作流程

无论您使用互操作性端点还是标准的 FHIR 端点，所有 API 调用的功能都是一样的，唯一的区别是如何按指标对交易进行分类。 CloudWatch 

### 支持的 CMS 互操作端点
<a name="cms-supported-endpoints"></a>


| 内容管理系统类别 | 互操作性端点 | 示例用法 | 
| --- | --- | --- | 
| 患者通道 | /patientaccess/v2/r4 | baseURL/patientaccess/v2/r4/Patient/123 | 
| 提供商访问权限 | /​provideraccess/v2/r4 | baseURL/​provideraccess/v2/r4/Observation?patient=123 | 
| 付款人对付款人 | /payertopayerdx/v2/r4 | baseURL/payertopayerdx/v2/r4/Practitioner/456 | 
| 先前的身份验证服务 | /priorauthservice/v2/r4 | baseURL/priorauthservice/v2/r4/ExplanationOfBenefit?patient=789 | 

### 互操作性端点的工作原理
<a name="cms-endpoints-how-it-works"></a>

**标准 HealthLake API 调用：**

```
baseURL/resourceType/[id]
baseURL/resourceType?[parameters]
```

**使用 CMS 互操作性端点：**

```
baseURL/interoperability-endpoint/resourceType/[id]
baseURL/interoperability-endpoint/resourceType?[parameters]
```

只需在您的基本 URL 和资源类型之间插入互操作性端点路径即可。互操作性端点路径之后的所有内容都与您当前的 API 调用完全相同。

### 用法示例
<a name="cms-endpoints-examples"></a>

#### 示例 1：患者访问 API
<a name="cms-example-patient-access"></a>

**当前的 API 调用（仍然有效）：**

```
curl -X GET \
  https://healthlake.us-east-1.amazonaws.com/datastore/abc123/r4/Patient/123 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/fhir+json"
```

**使用患者访问互操作性端点（用于 CMS 跟踪）：**

```
curl -X GET \
  https://healthlake.us-east-1.amazonaws.com/datastore/abc123/patientaccess/v2/r4/Patient/123 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/fhir+json"
```

**要点：**
+ 基本网址保持不变：`https://healthlake.us-east-1.amazonaws.com/datastore/abc123`
+ 已插入互操作性端点：`/patientaccess/v2/r4`
+ 资源路径未更改：`/Patient/123`
+ **两个呼叫都返回相同的响应**
+ 互操作性端点调用将在下方`URIType=patient-access`自动跟踪 CloudWatch
+ POST、PUT、PATCH、DELETE 操作的工作原理相同。
+ 请求正文保持不变。

### 端点翻译参考
<a name="cms-endpoint-translation"></a>


| 互操作性端点 | 翻译为 | 内容管理系统类别 | 
| --- | --- | --- | 
| baseURL/patientaccess/v2/r4/Patient | baseURL/r4/Patient | 患者通道 | 
| baseURL/​provideraccess/v2/r4/Observation | baseURL/r4/Observation | 提供商访问权限 | 
| baseURL/payertopayerdx/v2/r4/Practitioner/456 | baseURL/r4/Practitioner/456 | 付款人对付款人 Data Exchange | 
| baseURL/priorauthservice/v2/r4/ExplanationOfBenefit?patient=789 | baseURL/r4/ExplanationOfBenefit?patient=789 | 事先授权 | 

### 重要提示
<a name="cms-endpoints-important-notes"></a>
+ **无功能差异**：互操作性端点和标准 FHIR 端点返回相同的响应并支持相同的操作
+ **基本 URL 未更改：您的 HealthLake 数据存储端点保持不变**
+ **简单集成**：在基本 URL 和资源类型之间插入互操作性端点路径
+ **自动跟踪**： CloudWatch 指标根据使用的互操作性端点自动对呼叫进行分类
+ **向后兼容**：没有互操作端点的现有 API 调用可以继续正常工作

## 增强了 CMS 合规性 CloudWatch 指标
<a name="cms-cloudwatch-metrics"></a>

### 概述
<a name="cms-metrics-overview"></a>

当您使用 CMS 互操作性端点时， HealthLake 会自动生成带有额外维度的增强 CloudWatch 指标，以支持 CMS 报告要求。这些指标按呼叫者身份、应用程序和特定于 CMS 的 URI 类型跟踪 API 使用情况，**无需进行任何其他配置**。

### 工作原理
<a name="cms-metrics-how-it-works"></a>

当你使用互操作性端点进行 API 调用时：

```
# This call...
curl https://healthlake.us-east-1.amazonaws.com/datastore/abc123/patientaccess/v2/r4/Patient/123

# Automatically generates metrics with:
# - URIType: "patient-access"
# - Sub: extracted from your bearer token (SMART on FHIR datastores only)
# - ClientId: extracted from your bearer token (SMART on FHIR datastores only)
# - Plus all standard dimensions (DatastoreId, Operation, etc.)
```

**不需要额外的代码或配置。**只需使用互操作性端点，即可自动捕获增强的指标。

**注意**  
对于非 Smart on FHIR 数据存储，仍会捕获`URIType`维度，从而允许您按内容管理系统类别跟踪 API 使用情况。`Sub`和`ClientId`维度仅在使用包含这些声明的不记名令牌进行 FHIR 身份验证的 SMART 时可用。

### 新的指标维度
<a name="cms-metrics-dimensions"></a>

使用互操作性端点时`DatastoreId`，`DatastoreType`除了现有维度（、、`Operation`）之外，还会自动添加以下维度：


| 维度 | 说明 | 示例值 | 来源 | 
| --- | --- | --- | --- | 
| URIType | CMS 合规性类别 | patient-access, provider-access, payer-to-payer, prior-authorization | 根据互操作性端点路径自动确定 | 
| Sub | 来电者身份 | 用户/实体标识符 | 摘自不记名代币索赔 sub | 
| ClientId | 应用程序标识符 | portal\$1app, ehr\$1system | 摘自不记名代币索赔 client\$1id | 

### 可用指标
<a name="cms-available-metrics"></a>

现在，使用互操作性终端节点时，所有现有 HealthLake 指标都包含其他维度：
+ **CallCount**-API 调用总数
+ **延迟**-API 响应时间（以毫秒为单位）
+ **UserErrors**-4xx 个客户端错误的计数
+ **SystemErrors**-5xx 服务器错误计数
+ **Throttles**-受限制的请求数
+ **SuccessfulRequests**-成功的 API 调用次数

### 在中查询指标 CloudWatch
<a name="cms-querying-metrics"></a>

#### CloudWatch 见解查询示例
<a name="cms-cloudwatch-insights-example"></a>

**按应用程序查询所有 Patient Access API 调用：**

```
SELECT SUM(CallCount)
FROM "AWS/HealthLake"
WHERE DatastoreId = '75c1cf9b0d71cd38fec8f7fb317c4c1a'
    AND URIType = 'patient-access'
GROUP BY ClientId
```