Восстановление или окончательное удаление элементов (предварительная версия)

Fabric поддерживает мягкое удаление и восстановление отдельных элементов в пределах рабочих областей. При удалении поддерживаемого элемента он вводит период хранения, в течение которого участники рабочей области, члены и администраторы могут восстановить его. Эта защита помогает предотвратить случайную потерю данных, предоставив вам возможность восстановить элементы до их окончательного удаления.

В этой статье вы узнаете, как настроить хранение элементов, восстановить удаленные элементы и окончательно удалить элементы до истечения срока хранения.

Общие сведения о том, как работает хранение рабочих областей и элементов, см. в статье "Хранение и восстановление" в Fabric.

Необходимые условия

• Чтобы настроить параметры хранения элементов, вам потребуется роль администратора клиента .
• Чтобы восстановить удаленные элементы, вам потребуется по крайней мере разрешения участника рабочей области . См. статью "Разрешения" для полной матрицы разрешений.
• Для окончательного удаления восстанавливаемых элементов требуются разрешения администратора рабочей области .

Настройка периода хранения для удаленных элементов

По умолчанию при включении восстановления элементов в параметрах клиента Структура сохраняет удаленные элементы в течение семи дней. Срок хранения (от 7 до 90 дней) можно изменить с помощью параметра клиента Item Recovery .

1. На портале администрирования перейдите в раздел "Параметры арендатора>" "Восстановление элементов".
2. Включите параметр и введите количество дней для периода хранения (от 7 до 90 дней).
3. Нажмите кнопку "Применить".

Восстановление удаленного элемента

Хотя удаленный элемент находится в периоде хранения, участники рабочей области, члены и администраторы могут восстановить его и его свойства.

Используйте корзину для восстановления элемента в рабочей области

Корзина рабочей области — это специальное представление в каждой рабочей области, где можно просматривать, восстанавливать или окончательно удалять временно удаленные элементы.

1. Откройте рабочую область, содержащую удаленный элемент.
2. Выберите Корзина в панели навигации рабочей области.
3. Найдите элемент, который требуется восстановить. Для поиска определенных элементов можно использовать параметры фильтра и поиска.
4. Выберите элемент, а затем выберите "Восстановить " на панели инструментов.

Восстановленный элемент снова появится в исходной рабочей области со своими свойствами, конфигурациями и связями без изменений.

Восстановление элемента с помощью REST API

Используйте REST API для программного восстановления удаленных элементов.

Запрос:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/recoverableItems/{itemId}/recover

Параметры:

• workspaceId — уникальный идентификатор рабочей области, содержащей удаленный элемент.
• itemId — уникальный идентификатор элемента для восстановления.

Example:

curl --request POST \
  --url https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/recoverableItems/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2/recover \
  --header 'Authorization: Bearer {token}'

Ответ.

• 200 ОК — элемент успешно восстановлен.
• 404 Not Found — элемент не найден или больше не найден в период восстановления.
• 403 Запрещено . У пользователя нет разрешения на восстановление элемента.

Окончательное удаление восстанавливаемого элемента

Хотя удаленный элемент находится в сроке хранения, его можно окончательно удалить, если у вас есть разрешения администратора рабочей области.

Использование корзины рабочей области для окончательного удаления элемента

1. Откройте рабочую область, содержащую удаленный элемент.
2. Выберите Корзину для мусора из панели навигации рабочей области.
3. Найдите элемент, который нужно удалить окончательно.
4. Выберите элемент, а затем нажмите кнопку "Удалить окончательно " на панели инструментов.

Вам будет предложено подтвердить постоянное удаление. После подтверждения элемент и его содержимое больше не восстанавливаются.

Использование REST API для окончательного удаления элемента

Используйте REST API для программного удаления элементов за период хранения.

Запрос:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/recoverableItems/{itemId}

Параметры:

• workspaceId — уникальный идентификатор рабочей области, содержащей удаленный элемент.
• itemId — уникальный идентификатор элемента для окончательного удаления.

Example:

curl --request DELETE \
  --url https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/recoverableItems/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2 \
  --header 'Authorization: Bearer {token}'

Связанный контент

• Хранение и восстановление в Fabric
• Настроить и управлять хранением рабочей области
• Управление рабочими областями
• Обзор портала администрирования