CMS 규정 준수 기능 - AWS HealthLake
CMS 상호 운용성 엔드포인트CMS 규정 준수를 위한 향상된 CloudWatch 지표

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CMS 규정 준수 기능

AWS HealthLake 는 CMS(Centers for Medicare & MasterCard Services) 상호 운용성 및 규정 준수 요구 사항을 충족하는 데 도움이 되는 기능을 제공합니다. 이러한 기능을 사용하면 CMS 범주별로 API 사용량을 추적한 다음 규정 준수를 위해 사용량 지표를 보고할 수 있습니다.

CMS 상호 운용성 엔드포인트

개요

HealthLake는 CMS 필수 API 범주에 해당하는 4개의 CMS 상호 운용성 엔드포인트를 제공합니다. HealthLake 데이터 스토어의 기본 기본 URL은 변경되지 않습니다. 이러한 엔드포인트는 CMS 보고 목적으로 API 호출을 분류하고 추적하는 방법을 제공합니다.

용도

이러한 상호 운용성 엔드포인트의 주요 목적은 고객이 다음을 수행할 수 있도록 하는 것입니다.

  • CMS 범주별로 API 트랜잭션을 쉽게 추적

  • CMS 규정 준수를 위한 사용량 지표 자동 보고

  • 최소한의 변경으로 기존 FHIR 워크플로 유지 관리

상호 운용성 엔드포인트를 사용하든 표준 FHIR 엔드포인트를 사용하든 모든 API 호출은 동일하게 작동합니다. 유일한 차이점은 트랜잭션이 CloudWatch 지표로 분류되는 방식입니다.

지원되는 CMS 상호 운용성 엔드포인트

CMS 범주 상호 운용성 엔드포인트 사용 예
환자 액세스 /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

상호 운용성 엔드포인트 작동 방식

표준 HealthLake API 호출:

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

CMS 상호 운용성 엔드포인트 사용:

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

상호 운용성 엔드포인트 경로는 기본 URL과 리소스 유형 사이에 간단히 삽입됩니다. 상호 운용성 엔드포인트 경로 이후의 모든 것은 현재 API 호출과 정확히 동일하게 유지됩니다.

사용 예제

예제 1: 환자 액세스 API

현재 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"

요점:

  • 기본 URL은 다음과 같이 유지됩니다. https://healthlake.us-east-1.amazonaws.com/datastore/abc123

  • 상호 운용성 엔드포인트 삽입: /patientaccess/v2/r4

  • 리소스 경로 변경되지 않음: /Patient/123

  • 두 호출 모두 동일한 응답을 반환합니다.

  • 상호 운용성 엔드포인트 호출은 CloudWatchURIType=patient-access의에서 자동으로 추적됩니다.

  • POST, PUT, PATCH, DELETE 작업은 동일하게 작동합니다.

  • 요청 본문은 변경되지 않습니다.

엔드포인트 번역 참조

상호 운용성 엔드포인트 변환 대상 CMS 범주
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 지급인 간 데이터 교환
baseURL/priorauthservice/v2/r4/ExplanationOfBenefit?patient=789 baseURL/r4/ExplanationOfBenefit?patient=789 사전 승인

중요 정보

  • 기능적 차이 없음: 상호 운용성 엔드포인트와 표준 FHIR 엔드포인트는 동일한 응답을 반환하고 동일한 작업을 지원합니다.

  • 기본 URL 변경되지 않음: HealthLake 데이터 스토어 엔드포인트는 동일하게 유지됩니다.

  • 단순 통합: 기본 URL과 리소스 유형 사이에 상호 운용성 엔드포인트 경로 삽입

  • 자동 추적: CloudWatch 지표는 사용된 상호 운용성 엔드포인트별로 호출을 자동으로 분류합니다.

  • 역호환성: 상호 운용성 엔드포인트가 없는 기존 API 호출은 정상적으로 계속 작동합니다.

CMS 규정 준수를 위한 향상된 CloudWatch 지표

개요

CMS 상호 운용성 엔드포인트를 사용하면 HealthLake는 CMS 보고 요구 사항을 지원하기 위해 추가 차원과 함께 향상된 CloudWatch 지표를 자동으로 내보냅니다. 이러한 지표는 추가 구성 없이 호출자 ID, 애플리케이션 및 CMS별 URI 유형별로 API 사용량을 추적합니다.

작동 방식

상호 운용성 엔드포인트를 사용하여 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.)

추가 코드나 구성은 필요하지 않습니다. 상호 운용성 엔드포인트를 사용하면 향상된 지표가 자동으로 캡처됩니다.

참고

FHIR 데이터 스토어의 비 SMART의 경우 URIType차원이 계속 캡처되므로 CMS 범주별로 API 사용량을 추적할 수 있습니다. Sub 및 ClientId차원은 이러한 클레임이 포함된 보유자 토큰과 함께 FHIR 인증에서 SMART를 사용할 때만 사용할 수 있습니다.

새로운 지표 차원

기존 차원(DatastoreId, DatastoreType, Operation) 외에도 상호 운용성 엔드포인트를 사용할 때 다음 차원이 자동으로 추가됩니다.

차원 설명 예제 값 소스
URIType CMS 규정 준수 범주 patient-access, provider-access, payer-to-payer, prior-authorization 상호 운용성 엔드포인트 경로에서 자동으로 결정됨
하위 발신자 자격 증명 사용자/엔터티 식별자 보유자 토큰 sub 클레임에서 추출됨
ClientId 애플리케이션 식별자 portal_app, ehr_system 보유자 토큰 client_id 클레임에서 추출됨

사용 가능한 지표

이제 모든 기존 HealthLake 지표에 상호 운용성 엔드포인트를 사용할 때 추가 차원이 포함됩니다.

  • CallCount - 총 API 호출 수

  • 지연 시간 - 밀리초 단위의 API 응답 시간

  • UserErrors - 4xx 클라이언트 오류 수

  • SystemErrors - 5xx 서버 오류 수

  • 제한 - 제한된 요청 수

  • SuccessfulRequests - 성공한 API 호출 수

CloudWatch에서 지표 쿼리

CloudWatch Insights 쿼리 예제

애플리케이션별로 모든 환자 액세스 API 호출을 쿼리합니다.

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