大量刪除
`$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 |
所有查詢參數都是選擇性的。
$bulk-delete 回應
提出大量刪除 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 的權限搭配使用。