Пояснення параметрів ScaleIO REST API

Instance:
========================
Note - Всі властивості тут пов'язані з дельта-механізмом - способом відправки запиту на об'єкт про зміни з моменту останнього надсилання такого запиту. Це працює наступним чином:

для кожного типу об'єкта ми зберігаємо останню версію це інкрементний лічильник, кожен раз, коли об'єкт змінюється, версія збільшується.

Кожен об'єкт знає, якою була версія минулого разу, коли він був модифікований. Клієнт надсилає запит з останньою версією, яку він знає.

MDM відповідає списком усіх об'єктів, які було оновлено після цієї версії.
Список об'єктів, видалених з цієї версії
Остання надіслана

версія Приклад для такого запиту (для ProtectionDomain): 

GET /api/types/ProtectionDomain/instances?systemId={ідентифікатор системи}&sessionTag={тег сеансу}&lastVersion={остання версія}

isDirty - версія на деяких об'єктах змінювалася, поки MDM створював відповідь, брудний прапор, який встановлюється, якщо під час генерації відповіді були зміни (щоб заохотити клієнта надіслати наступний запит раніше)


Last<Object>Version - "серійний номер" останньої дельти, відправленої на Об'єкт. Наступний дельта-запит повинен містити це значення, і буде відправляти дельту з цієї точки.

 sessionTag – тег сеансу, який використовується для запиту дельта-механізму. Може бути змінений MDM (наприклад, коли відбувається перемикання MDM). sessionTag — це лічильник перезапусків MDM, якщо він не співпадає, це означає, що MDM було перезапущено. Якщо клієнт або MDM було перезапущено, буде надіслано повну відповідь, яка містить усі об'єкти.


System:
========================
capacityTimeLeftInDays - Проміжок часу, що залишився до закінчення

терміну дії ліцензії enterpriseFeaturesEnabled - Вказує, чи включені корпоративні функції, частина інформації про ліцензування. Приклад функцій підприємства - знімки, QoS Значення за замовчуванням - TRUE.

isInitialLicense - Це поточна ліцензія, яка призначена системі при ініціалізації.
 managementClientSecureCommunicationEnabled - Чи ввімкнено безпечний зв'язок MDM <=> Clients (CLI, REST, UI).

mdmToSdsPolicy - MDM <=> Політика зв'язку SDS (звичайна/аутентифікована)

upgradeState - Чи виконується оновлення системи та який його стан.

remoteReadOnlyLimitState - Прапорець, який вказує, що віддаленому клієнту дозволено виконувати операції запиту лише на MDMrestrictedSdcModeEnabled - Вказує, чи обмежені користувачі на віддалених клієнтах доступом лише для читання (enabled=доступ лише для читання; disabled=повний доступ для читання/запису)

SDS:
========================
rfcacheErrorInconsistentCacheConfiguration - Чи є помилка в конфігурації rfCache.

rfcacheErrorInconsentSourceConfiguration - Чи є помилка на вихідному пристрої rfCache.

rmcacheFrozen - Чи заморожений кеш читання (= тимчасово не використовується)

rmcacheMemoryAllocationState - Стан процесу розподілу пам'яті (в процесі/виконано)

rmcacheSizeInKb - Розмір кешу читання на тому SDS

sdsDecoupled - чи знаходиться SDS в розв'язаному стані.

sdsReceiveBufferAllocationFailures - Лічильник помилок розподілу буфера на SDS (допомагає виявити проблеми зниження продуктивності)
========================

Volume:
========================
consistencyGroupId - Ідентифікатор, який призначається всім знімкам, зробленим в одній команді (вони узгоджені по всій групі)

mappingToAllSdcsEnabled - Чи відображено том на всі SDC (застаріло!!)



deviceList
===============
longSuccessfulIos - лічильник усунення несправностей для IOs на диск, який зайняв більше часу, ніж очікувалося, але все одно закінчився успішно. Допомагає виявити несправності дисків.


activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs
activeNormRebuildCapacityInKb
========================Counters,
що представляють зворотну перебудову, викликану зі стану NORMAL (AKA normal-need-rebuild) - коли первинне та вторинне мають різні значення, але не ACK' записують, тому ми можемо вибрати будь-яке значення з цих двох.
Лічильник "Jobs" представляє деякі гребінці; активні - гребінці, які прямо зараз в русі, "MovingIn" - це означає, що це цільовий SDS.


/api/instances/Sds/relationships/Statistics
===============
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb - XXXCapacityInKb - ФІЗИЧНА ємність, XXXVacInKb - ВИДІЛЕНА ємність.
Різниця значна в тонких обсягах і знімках - розглянемо тонкий том 10 ТБ, з записаними даними на ньому 1 ТБ, тому виділено=10 ТБ, фізичним=1 ТБ

in-MaintenanceCapacityInKb
in-MaintenanceVacInKb
Ємність, яка знаходиться в обслуговуванні (на SDS, що знаходиться в режимі обслуговування)


normRebuildInKb - Ємність, яка вважається нормою "нормальна-потреба-перебудова"

normRebuildReadBwc - Пропускна здатність читань в рамках "перебудувати з нормального" (є таке ж для запису, чомусь немає в списку)

pendingMovingInNormRebuildJobs
pendingMovingOutNormrebuildJobs - Гребінці, які повинні бути перебудовані, але чекають в черзі.

  rmPendingAllocationInKb - Ємність, яка позначена для видалення (наприклад, під час видалення пристрою/SDS)

semi-ProtectedVacInKb - "інша сторона" ємності в обслуговуванні

ThinCapacityAllocationInKm - це має бути ThinCapacityAllocationInKb.  Це помилка REST API, яка буде виправлена в 3.



"OscillatingCounterParameters" та "OscillatingCounter"
 "OscillatingCounterWindowParameters" і "OscillatingCounterWindow"===============


Кожен осцилюючий лічильник складається з трьох ковзних вікон коротких, середніх, довгих, кожне налаштовується з порогом і розміром вікна (в секундах)Як

тільки поріг досягається в поточному вікні, видається відповідне попередження.

 
Отже,
"OscillatingCounterParameters" містить 3 "OscillatingCounterWindowParameters";
" OscillatingCounter» містить 3 "OscillatingCounterWindow".
===============