大量刪除
`$bulk-delete' 可讓您以非同步方式從 FHIR 伺服器刪除資源。 大量刪除作業可以在系統層級或針對個別資源類型執行。
系統層級:在系統層級執行作業可跨 FHIR 伺服器中的所有資源類型刪除 FHIR 資源。
DELETE /$bulkDelete
個別資源類型:針對個別資源類型執行作業時,允許刪除對應至 URL 中指定資源類型的 FHIR 資源。
DELETE /<Resource Type>/$bulkDelete
注意
大量刪除是一項要謹慎使用的作業。 一旦刪除後,就無法還原 FHIR 服務中的資源。
大量刪除作業目前為公開預覽狀態。 如需詳細資料,請檢閱免責聲明。
重要
提供的預覽 API 和 SDK 並無服務等級協定。 建議您不要將其用於生產工作負載。 部分功能可能不受支援,或是在功能上有所限制。 如需詳細資訊,請參閱 Microsoft Azure 預覽版增補使用規定。
大量刪除作業需要兩個標頭參數
- 接受:application/fhir+json
- 偏好:respond-async
查詢參數可讓您篩選您想要刪除的原始資源。 為了支援篩選,FHIR 服務查詢參數如下:
查詢參數 | 預設值 | 說明 |
---|---|---|
_hardDelete | False | 若要刪除包含歷程記錄版本的資源,請傳遞 true 值。 |
_purgeHistory | False | 允許刪除與資源相關聯的歷程記錄版本。 |
FHIR 服務支援的搜尋參數 | 允許指定搜尋準則,而符合搜尋準則的資源會遭到刪除。範例:address:contains=Meadow subject:Patient.birthdate=1987-02-20 |
所有查詢參數都是選擇性的。
提出大量刪除 FHIR 資源的要求之後,您應該會在回應中收到 Content-Location 標頭,內含後續狀態要求的端點絕對 URL,例如輪詢端點。
輪詢端點:視大量刪除作業的狀態而定,對輪詢端點的要求共有四種結果。 結果會在 FHIR 回應的 OperationOutcome 內提供
- 進行中的作業:此結果表明作業正在進行中。 狀態碼 202
- 已完成:此結果表明作業已順利完成。 完成時,刪除的資源數目資訊會在個別資源類型層級提供。 狀態碼 200
- 已取消:此結果表明使用者取消作業,並提供在個別資源類型層級刪除的資源數目相關資訊。 狀態碼 200
- 失敗:此結果表明作業失敗。 狀態碼取決於失敗類型。
用於判斷狀態要求的範例要求和回應:
{{fhir_url}}/_operations/bulk-delete/<id>
成功完成刪除作業的範例回應。
{
"resourceType": "Parameters",
"parameter": [
{
"name": "ResourceDeletedCount",
"part": [
{
"name": "Practitioner",
"valueDecimal": 10.0
},
{
"name": "Specimen",
"valueDecimal": 7.0
},
{
"name": "Device",
"valueDecimal": 3.0
}
]
}
]
}
在本文中,您已了解如何大量刪除 FHIR 服務中的資源。 如需支援的 FHIR 功能相關資訊,請參閱
FHIR® 是 HL7 的註冊商標,可與 HL7 的權限搭配使用。