Vysvětlení parametrů rozhraní REST API ScaleIO

Instance:
========================
Note – Všechny vlastnosti jsou zde propojeny s rozdílovým mechanismem – způsobem, jak odeslat dotaz na objekt o změnách od posledního odeslání takového dotazu. Funguje to následovně:

Pro každý typ objektu ukládáme nejnovější verzi, je to přírůstkový čítač, při každé změně objektu se verze zvýší.

Každý objekt ví, jaká byla verze, kdy byla naposledy upravena. Klient odešle požadavek s poslední verzí, kterou zná.

MDM odpoví seznamem všech objektů, které byly po této verzi aktualizovány.
Seznam objektů odstraněných od této verze
Poslední odeslaná

verze Příklad takového dotazu (pro ProtectionDomain): 

GET /api/types/ProtectionDomain/instances?systemId={system id}&sessionTag={session tag}&lastVersion={last version}

isDirty – verze některých objektů se změnila, když MDM vytvářel odpověď, příznak dirt, který se nastaví, pokud během generování odpovědi dojde ke změnám (aby klient odeslal následný požadavek dříve)


Last<Object>Version – "sériové číslo" posledního rozdílu odeslaného na objekt. Další rozdílový dotaz by měl obsahovat tuto hodnotu a od tohoto okamžiku

odešle rozdíl. sessionTag – značka relace používaná pro požadavek rozdílového mechanismu Může být změněna MDM (například když dojde k přepnutí MDM). sessionTag je čítač restartování MDM, pokud se neshoduje, znamená to, že MDM byl restartován. Pokud byl klient nebo MDM restartován, odešle se úplná odpověď, která obsahuje všechny objekty.


System:
========================
capacityTimeLeftInDays – doba zbývající do vypršení platnosti

licence enterpriseFeaturesEnabled – Označuje, jestli jsou povolené podnikové funkce, které jsou součástí licenčních informací. Příklad podnikových funkcí – snapshoty, QoS Výchozí hodnota je TRUE .

isInitialLicense – Aktuální licence je ta, která byla systému přiřazena při inicializaci.
 managementClientSecureCommunicationEnabled – je zabezpečená komunikace MDM <=> klienti (CLI, REST, UI) povoleni.

mdmToSdsPolicy – MDM <=> zásady komunikace SDS (pravidelné/ověřené)

upgradeState – Určuje, zda probíhá upgrade systému a jaký je jeho stav.

remoteReadOnlyLimitState – Příznak, který označuje, že vzdálený klient může provádět operace dotazů pouze na MDMrestrictedSdcModeEnabled – Označuje, zda mají uživatelé na vzdálených klientech omezený přístup jen pro čtení (enabled = přístup jen pro čtení; disabled=úplný přístup pro čtení a zápis).

SDS:
========================
rfcacheErrorInconsistentCacheConfiguration - Zda došlo k chybě v konfiguraci rfCache.

rfcacheErrorInconsistentSourceConfiguration – Zda došlo k chybě ve zdrojovém zařízení rfCache.

rmcacheFrozen – Určuje, zda je mezipaměť pro čtení zmrazena (= dočasně se nepoužívá)

rmcacheMemoryAllocationState – Stav procesu přidělování paměti (probíhá/hotovo)

rmcacheSizeInKb – Velikost mezipaměti pro čtení na tomto disku SDS

sdsDecoupled – zda je SDS v odděleném stavu.

sdsReceiveBufferAllocationFailures – Počítadlo selhání přidělení vyrovnávací paměti na SDS (pomáhá identifikovat problémy se snížením výkonu)
========================

Volume:
========================
consistencyGroupId – identifikátor, který je přiřazen všem snímkům pořízeným jedním příkazem (jsou konzistentní v rámci skupiny)

mappingToAllSdcsEnabled – Určuje, zda je svazek namapován na všechny SDC (zastaralé!!)



deviceList
===============
longSuccessfulIos – počítadlo řešení potíží pro vstupně-výstupní operace na disk, které trvaly déle, než se očekávalo, ale přesto skončily úspěšně. Pomáhá identifikovat vadné disky.


activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs activeNormRebuildCapacityInKb

========================
Counters představující zpětné opětovné sestavení aktivované ze stavu NORMAL (AKA normal-need-rebuild) - když primární a sekundární mají různé hodnoty, ale nepotvrdily zápis, takže můžeme vybrat libovolnou hodnotu z těchto dvou.
Počítadlo "Jobs" představuje některé hřebeny; aktivní - hřebeny, které jsou právě v pohybu, "MovingIn" - což znamená, že se jedná o cílový SDS.


/api/instances/Sds/relations/Statistics
===============
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb - XXXCapacityInKb je FYZICKÁ kapacita, XXXVacInKb je PŘIDĚLENÁ kapacita.
Rozdíl je významný u tenkých svazků a snapshotů – uvažujme 10TB tenký svazek s 1 TB zapsaných dat, takže alokace = 10 TB, physical = 1 TB

in-MaintenanceCapacityInKb
in-MaintenanceVacInKb
Kapacita, která je v údržbě (na SDS, který je v režimu údržby)


normRebuildCapacityInKb – kapacita, která je považována za "normální-potřebu-přebudovat"

normRebuildReadBwc - Šířka pásma čtení v rámci "opětovného sestavení z normálu" (totéž platí pro zápisy, z nějakého důvodu není v seznamu)

pendingMovingInNormRebuildJobs
pendingMovingOutNormrebuildJobs – Hřebeny, které by měly být přestavěny, ale čekají ve frontě.

  rmPendingAllocatedInKb – Kapacita, která je označena k odebrání (např. při odebrání zařízení/SDS)

semi-ProtectedVacInKb – "druhá strana" kapacity v údržbě

ThinCapacityAllocatedInKm – měla by to být ThinCapacityAllocatedInKb.  Jedná se o chybu REST API, která bude opravena ve verzi 3.



"OscillatingCounterParameters" a "OscillatingCounter"
 "OscillatingCounterWindowParameters" a "OscillatingCounterWindow"
===============

Každý oscilační čítač se skládá ze tří posuvných oken krátká, střední, dlouhá, každé je nakonfigurováno s prahovou hodnotou a velikostí okna (v sekundách)

Jakmile je prahové hodnoty dosaženo v aktuálním okně, vydá se příslušná výstraha.

 

Proto "OscillatingCounterParameters" obsahuje 3 "OscillatingCounterWindowParameters";
" OscillatingCounter" obsahuje 3 "OscillatingCounterWindow".
===============