Массово удалить

  • Статья

"$bulk-delete" позволяет асинхронно удалять ресурсы с сервера FHIR. Операция массового удаления может выполняться на уровне системы или для отдельного типа ресурса.

  • Системный уровень: выполнение операции на уровне системы позволяет удалять ресурсы FHIR во всех типах ресурсов на сервере FHIR.

      DELETE  /$bulkDelete

  • Отдельный тип ресурса: выполнение операции с отдельными типами ресурсов позволяет удалять сопоставления ресурсов FHIR с указанным типом ресурса в URL-адресе.

      DELETE /<Resource Type>/$bulkDelete

Примечание.

Массовое удаление — это операция, которую следует использовать с осторожностью. Ресурсы в службе FHIR после удаления не могут быть отменить изменения.

Операция массового удаления в настоящее время находится в общедоступной предварительной версии. Дополнительные сведения см. в разделе "Отказ от ответственности".

Важно!

Предварительные версии API и пакеты SDK предоставляются без соглашения об уровне обслуживания. Рекомендуется не использовать их для рабочих нагрузок. Некоторые функции могут не поддерживаться или могут иметь ограниченные возможности. Дополнительные сведения см . в дополнительных условиях использования для предварительных версий Microsoft Azure.

Заголовки

Операция массового удаления требует двух параметров заголовка

  • Принять: application/fhir+json
  • Предпочитать: ответ-async

Параметры запроса

Параметры запроса позволяют фильтровать необработанные ресурсы, которые вы планируете удалить. Для поддержки фильтрации параметры запроса службы FHIR:

Параметр запроса Значение по умолчанию Description
_hardDelete False Для удаления ресурса, включая версию журнала, передайте значение true.
_purgeHistory False Позволяет удалять версии журнала, связанные с ресурсом.
Поддерживаемые параметры поиска службы FHIR Позволяет указать критерии поиска и ресурсы, соответствующие условиям поиска, удаляются. Пример: address:contains=Meadow subject:Patient.birthdate=1987-02-20

Все параметры запроса являются необязательными.

ответ $bulk-delete

После выполнения запроса на массовое удаление ресурсов FHIR в ответ необходимо получить заголовок Content-Location с абсолютным URL-адресом конечной точки для последующих запросов состояния, таких как конечная точка опроса.

Конечная точка опроса. Запрос к конечной точке опроса имеет один из четырех результатов в зависимости от состояния задания массового удаления. Результат предоставляется в ответе OperationOutcome из FHIR

  1. Задания выполняются: этот результат указывает, что задание выполняется. Код состояния 202
  2. Завершено: этот результат указывает, что задание успешно завершено. По завершении информация о количестве удаленных ресурсов будет предоставляться на уровне отдельного типа ресурса. Код состояния 200
  3. Отменено. Это задание указывает, что задание результата отменено пользователем и предоставляет сведения о количестве ресурсов, удаленных на уровне отдельного типа ресурса. Код состояния 200
  4. Сбой: это состояние состояния задания завершилось сбоем. Код состояния зависит от типа сбоя.

Пример запроса и ответа для определения запроса состояния:

{{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

Возможности REST API FHIR для службы FHIR служб данных Azure Health

FHIR® является зарегистрированным товарным знаком HL7 и используется с разрешением HL7 .