使用 刪除資源類型 $bulk-delete - AWS HealthLake
使用方式參數範例任務狀態Behavior (行為)稽核記錄限制

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 刪除資源類型 $bulk-delete

AWS HealthLake 支援 $bulk-delete操作，可刪除資料存放區中特定類型的所有資源。當您需要執行下列動作時，此操作特別有用：

  • 執行季節性稽核和清除

  • 大規模管理資料生命週期

  • 移除特定資源類型

  • 遵循資料保留政策

使用方式

您可以使用 POST 方法叫用 $bulk-delete操作：

POST [base]/[ResourceType]/$bulk-delete?hardDelete=false&deleteVersionHistory=false&deleteAuditEvent=true

參數

參數 類型 必要 預設 描述
isHardDelete 布林值 否 false 當為 true 時， 會從儲存體中永久移除資源
deleteVersionHistory 布林值 否 若 isHardDelete 為 false，則為 false；若 isHardDelete 為 true，則為 true 為 true 時， 會刪除所有歷史版本，必須搭配 hardDelete = true 或忽略
deleteAuditEvent 布林值 否 true 為 true 時， 會刪除相關聯的稽核事件
_since string 否 資料存放區建立時間 輸入時， 會根據其lastModified的時間選取開始截止時間以尋找資源。無法與開始或結束搭配使用
start string 否 資料存放區建立時間 輸入時， 會根據資源的lastModified時間選取截止時間來尋找資源。可與 end 搭配使用
end string 否 任務提交時間 輸入時， 會根據其lastModified的時間選取結束截止時間以尋找資源

範例

範例請求

POST [base]/Observation/$bulk-delete?hardDelete=true
回應範例

{
  "resourceType": "OperationOutcome",
  "id": "bulk-delete-job",
  "issue": [
    {
      "severity": "information",
      "code": "informational",
      "diagnostics": "Bulk delete job started successfully. Job ID: 12345678-1234-1234-1234-123456789012"
    }
  ]
}

任務狀態

若要檢查大量刪除任務的狀態：

GET [base]/$bulk-delete/[jobId]

操作會傳回任務狀態資訊：

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "jobId",
      "valueString": "12345678-1234-1234-1234-123456789012"
    },
    {
      "name": "jobStatus",
      "valueString": "COMPLETED"
    },
    {
      "name": "totalResourcesDeleted",
      "valueInteger": 1256
    },
    {
      "name": "startTime",
      "valueInstant": "2023-06-15T10:00:00Z"
    },
    {
      "name": "endTime",
      "valueInstant": "2023-06-15T10:05:23Z"
    }
  ]
}

Behavior (行為)

$bulk-delete 操作：

  1. 以非同步方式處理大量資源

  2. 維護 ACID 交易的資料完整性

  3. 提供具有資源刪除計數的任務狀態追蹤

  4. 支援軟式和硬式刪除模式

  5. 包括刪除活動的完整稽核記錄

  6. 允許選擇性刪除歷史版本和稽核事件

稽核記錄

$bulk-delete 操作會記錄為 StartFHIRBulkDeleteJob 和 DescribeFHIRBulkDeleteJob，其中包含詳細的操作資訊。

限制

  • 硬刪除的資源不會出現在搜尋回應中

  • 透過此操作刪除的資源在處理期間可能暫時無法存取

  • 僅根據歷史版本調整儲存計量 - deleteVersionHistory=false 不會調整資料存放區儲存