Объяснение параметров ScaleIO REST API

Instance:
========================
Note - Все свойства здесь связаны с механизмом delta - способом отправки запроса на объект об изменениях с момента последней отправки такого запроса. Это работает следующим образом:

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

Каждый объект знает, какой была версия при последнем изменении. Клиент отправляет запрос с последней версией, которую он знает.

MDM возвращает список всех объектов, которые были обновлены после этой версии.
Список объектов, удаленных с момента создания этой версии
Последняя версия отправлена

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

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

isDirty - версия некоторых объектов изменилась, когда MDM создал ответ, флаг dirty, который устанавливается, если во время генерации ответа произошли изменения (чтобы побудить клиента отправить повторный запрос раньше)

<Last Object>Version - "серийный номер" последней дельты, отправленной на
объект. Следующий разностный запрос должен содержать это значение, и из этой точки будет отправлено различие.

 sessionTag - тег сеанса, используемый для запроса механизма изменений Может быть изменен MDM (например, при переключении MDM). sessionTag — это счетчик перезапуска MDM. Если он не совпадает, это означает, что MDM был перезапущен. Если клиент или MDM были перезапущены, будет отправлен полный ответ, содержащий все объекты.


System:
========================
capacityTimeLeftInDays — время, оставшееся до истечения

срока действия лицензии enterpriseFeaturesEnabled — указывает, включены ли корпоративные функции, входит в сведения о лицензировании. Пример корпоративных функций — моментальные снимки, качество обслуживания Значение по умолчанию: TRUE.

isInitialLicense — текущая лицензия, назначенная системе при инициализации.
 managementClientSecureCommunicationEnabled — защищенная

связь MDM <=> клиенты (интерфейс командной строки, REST, пользовательский интерфейс). mdmToSdsPolicy - MDM <=> политика связи SDS (обычная/аутентифицированная)

upgradeState — Выполняется ли обновление системы и каково ее состояние.

remoteReadOnlyLimitState — флаг, указывающий, что удаленному клиенту разрешено выполнять операции запросов только с MDMrestrictedSdcModeEnabled — указывает, ограничен ли доступ пользователей удаленных клиентов только для чтения (enabled = доступ только для чтения; disabled = полный доступ для чтения/записи)

SDS:
========================
rfcacheErrorInconsistentCacheConfiguration — наличие ошибки в конфигурации rfCache.

rfcacheErrorInconsistentSourceConfiguration — наличие ошибки в исходном устройстве rfCache.

rmcacheFrozen — замороженн ли кэш чтения (= временно не используется)

rmcacheMemoryAllocationState — состояние процесса выделения памяти (выполняется/готово)

rmcacheSizeInKb — размер кэша чтения в этой SDS

sdsDecoupled — находится ли SDS в несвязанном состоянии.

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

Volume:
========================
consistencyGroupId — идентификатор, который присваивается всем моментальным снимкам, созданным в рамках одной команды (они согласованы во всей группе);

mappingToAllSdcsEnabled — сопоставляется том со всеми SDC (устарело!!);



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


activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs activeNormRebuildJobs
activeNormRebuildCapacityInKb
========================
счетчики, представляющие обратное перестроение, запущенное из состояния NORMAL (также известное как normal-need-rebuild) - когда первичная и вторичная стороны имеют разные значения, но не подтвердили запись, поэтому мы можем выбрать любое значение из этих двух.
Счетчик «Задания» представляет собой несколько гребней; active - гребни, которые находятся в движении прямо сейчас, "MovingIn" - означает, что это целевые SDS.


/api/instances/Sds/relationships/Statistics
===============
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb - XXXCapacityInKb - это ФИЗИЧЕСКАЯ емкость, XXXVacInKb - ВЫДЕЛЕННАЯ емкость.
Разница значительна для «тонких» томов и снимков — рассмотрим тонкий том емкостью 10 Тбайт с 1 Тбайт записанных на нем данных, поэтому выделено = 10 Тбайт, физический = 1 Тбайт

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


normRebuildCapacityInKb — емкость, которая считается «нормальной необходимостью восстановления»

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

pendingMovingInNormRebuildJobs
pendingMovingMovingOutNormrebuildJobs - Гребни, которые должны быть перестроены, но ожидают в очереди.

  rmPendingAllocatedInKb — емкость, помеченная для удаления (например, во время удаления устройства/SDS)

semi-ProtectedVacInKb — «другая сторона» емкости в обслуживании

ThinCapacityAllocatedInKm — она должна быть ThinCapacityAllocatedInKb.  Это ошибка REST API, которая будет исправлена в пункте 3.



"OscillatingCounterParameters" и "OscillatingCounter"
 "OscillatingCounterWindowParameters" и "OscillatingCounterWindow"
===============

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

только пороговое значение достигается в текущем окне, выдается соответствующее оповещение.

 
Следовательно,
"OscillatingCounterParameters" содержит 3 "OscillatingCounterWindowParameters";
" OscillatingCounter" содержит 3 "OscillatingCounterWindow."
===============