ЕКС: Збереження CAS в ECS
Summary: Ця стаття присвячена утриманню CAS в ECS. Він також описує розширене утримання для додатків CAS: утримання на основі подій, призупинення судових розглядів і мінімальний/максимальний губернатор ...
Instructions
min/max Це витяг з ECS Data Access Guide, який можна знайти та завантажити тут: Сторінка продукту ECS Appliance
Збереження CAS в ECS
Кліпса CAS C-Clip може мати період зберігання, який регулює тривалість часу. Асоційований об'єкт зберігається в сховищі ECS, перш ніж програма зможе його видалити.
Терміни зберігання
Періоди утримання призначаються в C-Clip для об'єкта додатком CAS.
Наприклад, якщо фінансовий документ повинен зберігатися протягом трьох років з дати його створення, то
в C-Clip, пов'язаному з фінансовим документом, вказується трирічний термін зберігання. Також можна
вказати, що документ зберігається безстроково.
Політики утримання (класи утримання)
Примітка: Концепція класів утримання Centera зіставляється з політиками збереження в ECS, у цій
документації використовуються політики збереження.
Політики збереження дають змогу фіксувати випадки використання збереження та застосовувати їх до C-Clips. Наприклад,
різні типи документів можуть мати різний термін зберігання. Вам можуть знадобитися
такі періоди зберігання:
- Фінансових: 3 роки
- Юридичних: 5 років
- Електронна пошта: 6 місяців
Коли політика збереження застосовується до кількох C-Clips, шляхом зміни політики. Термін зберігання
змінюється для всіх об'єктів, на які поширюється поліс.
Політики збереження пов'язані з просторами імен в ECS і визнаються програмою CAS
як класи збереження.
Утримання на рівні ковша ECS та CAS
Утримання на рівні ковша не є стандартним утриманням пулу в Centera. У ECS утримання CAS за замовчуванням постійно дорівнює
нулю.
Період зберігання за замовчуванням в об'єктах, написаних без збереження на рівні об'єкта в просторах імен відповідності
.
Починаючи з ECS 3.0, коли програма записує C-Clips без збереження об'єктів у сегмент ECS CAS
у просторі імен відповідності, і цей сегмент має значення збереження (наприклад, 6 місяців),
C-Clips буде призначено період зберігання за замовчуванням нескінченний (-1). C-Clips ніколи не
можна видалити, оскільки їх ефективний період зберігання є найдовшим між двома: періодом
зберігання на рівні сегмента та збереженням на рівні об'єкта за замовчуванням.
Пріоритет CAS
Коли до об'єкта CAS в ECS застосовуються кілька періодів зберігання, період зберігання з більшим
значенням має пріоритет незалежно від того, як було застосовано зберігання.
Як застосовувати утримання CAS
Ви можете визначити політики збереження для просторів імен на порталі ECS або за допомогою ECS Management
API. Перегляньте розділ Налаштування політик збереження простору імен.
Ваша зовнішня програма CAS може призначити C-Clip
фіксований період зберігання або політику зберігання під час її створення.
Застосовуючи періоди зберігання через API, вказуйте період у секундах.
Примітка: ECS CAS бере час створення C-Clip для всіх обчислень, пов'язаних зі збереженням, а
не час міграції.
Як створювати політики збереження за допомогою ECS Management API.
Ви можете створювати періоди зберігання та політики за допомогою ECS, короткий опис яких наведено
нижче.
| Метод | Опис |
|---|---|
| PUT /object/bucket/{bucketName}/retention | Значення утримання для сегмента визначає обов'язковий період зберігання, який застосовується до кожного об'єкта в сегменті . Якщо ви встановили період зберігання в 1 рік, об'єкт із сегмента не можна видаляти протягом одного року. |
| GET /object/bucket/{bucketName}/retention | Повертає період зберігання, який наразі встановлено для вказаного сегмента . |
| Збереження POST /object/namespaces/namespace/{namespace}/ |
Для просторів імен параметр збереження діє як політика, де кожна політика є парою <Ім'я>:<Період> зберігання. Ви можете визначити кілька політик збереження для простору імен і призначити політику за іменем об'єкту в просторі імен. Це дозволяє змінювати період зберігання набору об'єктів, яким призначена однакова політика шляхом зміни відповідної політики. |
| PUT /object/namespaces/namespace/{namespace}/ retention/{class} |
Оновлює період для періоду зберігання, пов'язаного з простором імен. |
| Збереження GET /object/namespaces/namespace/{namespace}/ |
Повертає політику збереження, визначену для простору імен. |
Докладнішу інформацію про ECS Management API можна знайти в ознайомленні з ECS Management REST API
у розділі ECS Data Access Guide.
Розширене утримання для додатків CAS: утримання на основі подій, призупинення судових розглядів та регулятор min/max
Описано розширені функції збереження, доступні в API CAS, які підтримуються ECS.
Клієнтські додатки використовують CAS API для реалізації стратегій утримання. Коли робочі навантаження CAS мігруються
на ECS, обізнаність ECS про функції CAS API дозволяє програмам клієнта продовжувати
працювати з перенесеними даними. У ECS без окремої ліцензії доступні такі функції розширеного управління збереженням (ARM):
- Утримання на основі подій: можливість налаштувати об'єкт через його C-Clip для застосування (ініціювання) періоду зберігання або політики збереження,
коли додаток CAS отримує зазначену подію. - Утримання судового розгляду: можливість запобігти видаленню об'єкта, якщо програма CAS застосувала
до об'єкта судове утримання через свій C-Clip. Додаток CAS може застосувати до об'єкта до 100
судових призупинень шляхом створення та застосування унікальних ідентифікаторів судового утримання. - Мін/Макс губернатор: Можливість для адміністратора встановлювати ліміти на рівні сегмента для фіксованого періоду зберігання
або змінного періоду зберігання. Змінний період зберігання – це період, який використовується для підтримки
збереження на основі подій. У ECS адміністратори системи або простору імен можуть встановлювати значення за допомогою порталу ECS
. Програмісти можуть використовувати ECS Management API для встановлення значень.
Примітка: ARM підтримується для застарілих даних CAS, записаних з будь-якою схемою іменування, яка мігрується
на ECS.
Регулятор min/max для утримання на рівні відра CAS
На порталі ECS знайдіть сегмент CAS і натисніть Редагувати. Усі функції, показані на екрані
нижче, доступні лише для CAS, за винятком функції Bucket Retention Period . Утримання
ковша«Період» — це стандартна функція утримання ковша ECS, яка підтримується на всіх типах сегментів ECS.
Особливості утримання ковша CAS пояснюються в наступній таблиці.
| Ознака | Опис |
|---|---|
| Примусове утримання | Якщо цю функцію ввімкнено, жоден об'єкт CAS не може бути створений без інформації про збереження (період або політику). Спроба зберегти такий об'єкт повертає помилку. Якщо його ввімкнено, можна не налаштовувати період зберігання сегмента навіть у середовищі з підтримкою відповідності. Примітка: Коли Centera в режимі CE+ переходить на ECS, на сегменті за замовчуванням увімкнено функцію Enforce Retention . |
| Період зберігання відра |
Якщо вказано період зберігання відра, то застосовується довший період, якщо існує як період зберігання на рівні відра, так і на рівні об'єкта. У середовищі з підтримкою відповідності період зберігання сегмента є обов'язковим, якщо не застосовується примусове збереження інформації в об'єкті . Однак після налаштування період зберігання сегмента не можна скинути, навіть якщо використовується примусове збереження інформації в об'єкті. |
| Мінімальний фіксований період зберігання |
Ця функція регулює терміни зберігання, зазначені в об'єктах. Якщо термін зберігання об'єкта виходить за межі, зазначені тут, то спроба записати об'єкт не вдається. Використовуючи політики збереження, мінімальні/максимальні налаштування не застосовуються. Вибір параметра «Нескінченність » для параметра «Мінімальний фіксований період зберігання » означає, що всі значення утримання мають бути нескінченними. Вибір if для параметра «Максимальний фіксований період зберігання » означає, що максимального ліміту немає. Мінімальні/максимальні обмеження утримання застосовуються до будь-якого C-Clip, записаного в сегмент. Якщо кліп переноситься будь-яким стороннім інструментом на основі SDK, що збереження має бути в межах обмежень, інакше виникає помилка. |
| Максимальний фіксований термін зберігання |
|
| Мінімальний змінний період зберігання |
Ця функція регулює змінні періоди зберігання, зазначені в об'єктах, що використовують подію на основі подій. утримання (EBR). У EBR встановлюється базовий період утримання і запрограмована функція спрацьовування має можливість збільшувати період утримання при спрацьовуванні тригера. Якщо новий період зберігання об'єкта виходить за межі, зазначені тут, то спроба записати об'єкт у відповідь на тригер зазнає невдачі. Під час використання політик збереження мінімальні/максимальні налаштування не застосовуються. Вибір параметра «Нескінченність » для мінімального періоду зберігання змінних означає, що всі значення утримання мають бути нескінченними. Вибір if для параметра «Максимальний змінний період зберігання » означає, що максимального ліміту немає. Мінімальні/максимальні обмеження утримання застосовуються до будь-якого C-Clip, записаного в сегмент. Якщо кліп переноситься будь-яким стороннім інструментом на основі SDK, збереження має бути в межах дозволеного, інакше виникає помилка. |
| Максимальний варіативний період зберігання |
Примітка: Якщо системний адміністратор або програміст не встановив жодних значень для фіксованих і
змінних періодів зберігання, функція отримання ECS Management API не поверне значення для
мінімальних/максимальних налаштувань. Параметр «Примусово зберігати інформацію» в C-Clip поверне значення false за замовчуванням
.
Утримання на основі подій
Збереження на основі події (EBR) – це інструкція, яка визначає, що запис не може бути видалений до події
та протягом певного періоду після події. У CAS EBR — це C-Clip із зазначеним базовим
періодом зберігання або політикою збереження та тригером, визначеним програмою, який може встановлювати довший
період зберігання під час спрацьовування тригера. Період утримання починається лише тоді, коли спрацьовує тригер.
Якщо C-Clip позначено як EBR, його не можна видалити до події, якщо не використовується привілейоване видалення
.
При використанні EBR життєвий цикл C-Clip виглядає наступним чином:
- Create: програма створює новий C-Clip і позначає його як такий, що знаходиться під EBR. Програма
може передбачати фіксований період зберігання, який діє як мінімальне утримання, і вона повинна передбачати період зберігання або політику
зберігання на основі події. - Тригерна подія: Додаток ініціює подію, яка є відправною точкою періоду зберігання на основі
події або політики утримання. Додаток може призначити новий період зберігання на основі
події, якщо він довший, ніж той, що був призначений на момент створення CClip
. - Видалити: Коли програма намагається видалити C-Clip, повинні бути виконані наступні умови:
Термін зберігання політики (простору імен) минув
Термін зберігання
сегмента минув Фіксований термін зберігання минув
Подію було активовано
Термін дії як EBR, встановленого на момент створення, так і будь-яких подальших змін (розширень) на момент події закінчилися
На наступному малюнку показані три можливі сценарії для C-Clip під EBR:
- C1 має фіксоване або мінімальне утримання, термін дії якого вже минув до того, як подія була активована.
- С2 має фіксоване або мінімальне утримання, яке закінчується до закінчення терміну дії EBR.
- С3 має фіксоване або мінімальне утримання, яке закінчиться після закінчення терміну дії EBR.

Для несумісних просторів імен привілейовані команди видалення можуть перевизначати фіксоване та змінне
збереження для EBR.
При застосуванні утримання EBR він повинен відповідати налаштуванням Min/Max Governor для змінного
періоду зберігання.
У таблиці показані функції CAS API для утримання на основі подій
| Функція | Опис |
| FPClip_EnableEBRWithClass | Ця функція встановлює, що C-Clip має право приймати майбутню подію, і дозволяє призначити клас збереження на основі події (EBR) CClip під час створення C-Clip. |
| FPClip_EnableEBRWithPeriod | Ця функція встановлює, що C-Clip має право приймати майбутню подію, і дає змогу призначити період утримання на основі події (EBR) для C-Clip під час створення C-Clip. |
| FPClip_IsEBREnabled | Ця функція повертає логічне значення, щоб вказати, чи ввімкнено CClip для збереження на основі події (EBR). |
| FPClip_GetEBRClassName | Ця функція отримує ім'я збереження на основі події (EBR). політику, призначену C-Clip. |
| FPClip_GetEBREventTime | Ця функція повертає час події, встановлений на C-Clip, коли було активовано подію збереження на основі події (EBR) для цього C-Clip. |
| FPClip_GetEBRPeriod | Ця функція повертає значення (у секундах) періоду збереження на основі події (EBR), пов'язаного з C-Clip. |
| FPClip_TriggerEBREvent | Ця функція ініціює подію C-Clip, для якої було ввімкнено збереження на основі події (EBR). |
| FPClip_TriggerEBREventWithClass | Ця функція ініціює подію C-Clip, для якої було ввімкнено збереження на основі подій (EBR), і призначає CClip нову політику EBR. |
| FPClip_TriggerEBREventWithPeriod | Ця функція ініціює подію C-Clip, для якої було ввімкнено збереження на основі події (EBR), і призначає CClip новий період EBR. |
Призупинення судового розгляду
Призупинення судового розгляду дозволяє програмам CAS тимчасово запобігти видаленню C-Clip. Призупинення судового розгляду корисне
для даних, які є предметом офіційного розслідування, повістки до суду або запиту і які не можуть бути
видалені до завершення розслідування. Як тільки немає необхідності зберігати дані, програма може звільнити призупинення
судового розгляду, і звичайна поведінка зберігання відновлюється. Додаток
CAS розміщує та знімає судовий затримувач на рівні C-Clip.
Примітка: Навіть привілейоване видалення не може видалити C-Clip під час судового розгляду.
Один C-Clip може перебувати під кількома судовими утриманнями. Додаток повинен генерувати унікальні ідентифікатори судових
утримань і мати можливість відстежувати конкретні судові утримання, пов'язані з C-Clip. Програма
не може надіслати запит до C-Clip для отримання цієї інформації. Є лише функція, яка визначає стан утримання C-Clip
. Якщо на C-Clip є одне або кілька судових утримань, ця функція
повертає true, в іншому випадку вона помилкова.
При використанні судового утримання, життєвий цикл C-Clip виглядає наступним чином:
- Творити: Програма створює новий C-Clip і забезпечує фіксований та/або період зберігання на основі
події. - Встановити призупинення судового розгляду: Програма переводить C-Clip на паузу. Ця програма може відрізнятися
від програми, яка написала C-Clip. - Судовий розгляд справи призупинено: Програма випускає C-Clip. Ця програма може відрізнятися
від програми, яка встановлює призупинення судового розгляду або пише C-Clip. - Видалити: Коли програма намагається видалити C-Clip, повинні бути виконані наступні умови:
Інших судових розглядів щодо C-Clip немає.
Термін зберігання полісів минув.
Стандартний термін утримання відра минув. (Стандартне утримання сегмента доступне для всіх типів об'єктів ECS, але не рекомендується для CAS.)
Фіксований період зберігання минув (лише функція CAS).
Термін дії утримання на основі подій минув (лише функція CAS).
На наступному малюнку показані три можливі сценарії для C-Clip, поміщеного в судовий розгляд:
- С1 має фіксоване утримання, термін дії якого вже закінчився, коли його ставлять на утримання.
- С2 має фіксоване утримання, яке закінчується під час утримання.
- У C3 є фіксоване утримання, яке закінчується після звільнення утримання.

C-Clip може мати кілька призначених судових затримок. У такому разі для кожного судового утримання
потрібен окремий виклик API з унікальним ідентифікатором для призупинення судового розгляду.
Примітка: Максимальний розмір ID судового утримання становить 64 символи. Максимальна кількість ідентифікаторів
судового утримання на C-Clip становить 100. Ці обмеження забезпечуються API CAS.
У таблиці наведено функції CAS API для проведення судових спорів
| Функція | Опис |
|---|---|
| FPClip_GetRetentionHold | Ця функція визначає стан утримання C-Clips і повертає true або false. |
| FPClip_SetRetentionHold | Ця функція встановлює або скидає утримання на C-Clip. Для кількох судових призупинень надайте унікальний ідентифікатор призупинення судового розгляду для кожного утримання. У разі кількох утримань здійснюйте по одному дзвінку на ідентифікатор. |
Additional Information
Наведені нижче теми, пов'язані з CAS, детально описані в ECS Data Access Guide і будуть розділені на різні КБ:
- КС: Збереження CAS в ECS - KB 538782
- Збереження CAS
- Розширене утримання для додатків CAS: утримання на основі подій, призупинення судових розглядів та регулятор min/max
- ЕКС: Налаштування політик збереження простору імен для CAS - KB 538786
- ЕКС: Налаштування відерного списку контролю доступу (ACL) для CAS - KB 538789
- ЕКС: API керування ECS, які підтримують користувачів CAS - KB 538790
- ЕКС: Коди помилок CAS (Centera) SDK - KB 427034