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

FHIR 리소스 삭제

FHIR delete 상호 작용은 HealthLake 데이터 스토어에서 기존 FHIR 리소스를 제거합니다. 자세한 내용은 FHIR R4 RESTful API 설명서delete의 섹션을 참조하세요.

FHIR 리소스를 삭제하려면

조건에 따라 FHIR 리소스 삭제

조건부 삭제는 특정 FHIR 리소스 ID를 모르지만 삭제하려는 리소스에 대한 다른 식별 정보가 있는 경우에 특히 유용합니다.

조건부 삭제를 사용하면 논리적 FHIR ID가 아닌 검색 기준에 따라 기존 리소스를 삭제할 수 있습니다. 서버는 삭제 요청을 처리할 때 리소스 유형에 대한 표준 검색 기능을 사용하여 검색을 수행하여 요청에 대한 단일 논리적 ID를 확인합니다.

조건부 삭제 작동 방식

서버의 작업은 검색한 일치 항목 수에 따라 달라집니다.

대응 시나리오

AWS HealthLake 는 다음과 같은 응답 패턴으로 조건부 삭제 작업을 처리합니다.

성공한 작업

ID 기반 조건부 삭제

추가 파라미터(createdAt, _tag또는 )id를 사용하여를 기반으로 조건부 삭제를 수행하는 경우_lastUpdated:

Non-ID-Based 조건부 삭제

id가 제공되지 않거나 createdAt, 또는 이외의 파라미터를 사용하는 경우_tag_lastUpdated:

충돌 상황

여러 시나리오에서 412개의 사전 조건 실패 응답이 발생합니다.

성공적인 조건부 삭제의 예

다음 예시에서는 특정 기준에 따라 환자 리소스를 삭제합니다.

DELETE https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?name=peter&birthdate=2000-01-01&phone=1234567890

이 요청은 다음과 같은 환자 리소스를 삭제합니다.

모범 사례

를 사용하여 한 요청에서 여러 FHIR 리소스 삭제 _count

기본적으로 조건부 삭제를 수행하려면 검색 기준이 정확히 하나의 리소스와 일치해야 합니다. 단일 요청에서 일치하는 여러 리소스를 삭제하려면 _count 쿼리 파라미터를 포함합니다. _count이 있으면 HealthLake는 요청을 배치 작업으로 처리합니다. 일치하는 리소스를 검색하고 삭제한 다음 리소스당 상태가 batch-response 포함된 Bundle 유형의 FHIR200로 HTTP를 반환합니다.

요청 예제

다음 요청은 태그가 지정된 일치하는 Coverage 리소스를 삭제합니다. inactive

DELETE https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Coverage?_tag=inactive&_count=50

배치 응답 형식

를 포함하는 요청은 batch-response 200를 사용하여 HTTP를 _count 반환합니다Bundle. 각 항목은 일치하는 리소스 하나에 대한 결과를 보고합니다.

모든 FHIR 검색과 마찬가지로 리소스가 일치하고 삭제되는 순서는 기본 검색 결과의 순서를 따릅니다. 검색 기준에 _sort 파라미터를 포함하지 않는 한 검색은이 순서를 보장하지 않습니다. 페이지 매김 배치 삭제 간에 결정적 순서가 필요한 경우를 지정합니다_sort. 자세한 내용은 검색 파라미터 단원을 참조하십시오.

응답 내에서 Bundle항목 순서도 보장되지 않습니다. 항목 위치에 의존response하지 않고 항목의에 있는 location 필드를 사용하여 각 항목을 리소스와 일치시킵니다.

부분 성공(버전 충돌)

검색과 삭제 사이에 리소스를 수정할 수 있습니다. 성공적으로 삭제된 리소스는를 반환하고204, 충돌하는 리소스는 동일한 412를 반환합니다Bundle.

{
  "resourceType": "Bundle",
  "type": "batch-response",
  "entry": [
    {
      "response": {
        "status": "204",
        "location": "Coverage/b807f9ff-2872-45df-9325-0b2efe42e554"
      }
    },
    {
      "response": {
        "status": "412",
        "location": "Coverage/5287b322-d7e5-4688-bd55-022067db4d0f",
        "outcome": {
          "resourceType": "OperationOutcome",
          "issue": [
            {
              "severity": "error",
              "code": "exception",
              "diagnostics": "Resource was modified by another operation. Retry the request."
            }
          ]
        }
      }
    }
  ]
}

페이지 매김을 사용하여 더 많은 일치 항목 삭제

단일 요청은 최대 한 페이지의 일치 항목을 삭제합니다. 일치하는 리소스가 더 많이 남아 있는 경우 응답에는 next 관계와 URL이 link 있는가 Bundle 포함됩니다. HTTP DELETE 요청을 해당 URL로 전송하여 다음 페이지를 삭제하고 응답에 더 이상 next 링크가 포함되지 않을 때까지 반복합니다. next 링크 뒤에가 아닌 DELETE (원래 요청과 동일한 메서드)가와 연결되어야 합니다GET.

{
  "resourceType": "Bundle",
  "type": "batch-response",
  "link": [
    {
      "relation": "next",
      "url": "https://healthlake.us-east-1.amazonaws.com/...<page_token>"
    }
  ],
  "entry": [
    {
      "response": {
        "status": "204",
        "location": "Patient/4aeffdc9-6ac5-46ff-be10-bf8bd74dfecc"
      }
    }
  ]
}

FHIR 권한 부여 동작에 대한 SMART

FHIR 권한 부여에서 SMART를 구성하는 방법에 대한 자세한 내용은 섹션을 참조하세요FHIR의 SMART.

서비스 할당량 적용 방법

배치 조건부 삭제에는 자체 서비스 할당량이 없습니다. 각 요청은 수행하는 검색 및 삭제 상호 작용과 동일한 기존 HealthLake 할당량을 사용하므로 단일 요청은 여러 할당량을 사용합니다.

처리량은 데이터 스토어의 쓰기 용량에 의해 관리됩니다. 계정의 할당량 한도 내에서 처리량을 관리하려면 더 작은 _count 값으로 더 많은 요청을 실행하거나 더 큰 _count 값으로 더 좁은 검색을 사용합니다. 계정의 현재 검색 및 쓰기 용량 제한은 섹션을 참조하세요엔드포인트 및 할당량.

고려 사항