Uitleg over ScaleIO REST API-parameters

Instantie:
========================
Opmerking: alle eigenschappen hier zijn verbonden met het deltamechanisme - de manier om per object een query te verzenden over de wijzigingen ten opzichte van de laatste keer dat een dergelijke query is verzonden. Het werkt als volgt:

Voor elk objecttype slaan we de nieuwste versie op, het is een incrementele teller, elke keer dat een object wordt gewijzigd, wordt de versie verhoogd.

Elk object weet wat de versie was van de laatste keer dat het werd gewijzigd. De klant verstuurt het verzoek met de laatste versie die hij kent.

MDM antwoordt met een lijst van alle objecten die na die versie zijn bijgewerkt.
Lijst met objecten die sinds die versie
zijn verwijderd Laatste versie verzonden

Voorbeeld voor een dergelijke query (voor ProtectionDomain): 

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

isDirty - de versie op sommige objecten is gewijzigd terwijl de MDM het antwoord heeft gemaakt, vuile vlag die wordt ingesteld als er wijzigingen zijn tijdens het genereren van de reactie (om de client aan te moedigen eerder een vervolgverzoek te verzenden)


Last<Object>Version - "serial number" van de laatste delta die per object is verzonden. De volgende delta-query moet deze waarde bevatten en zal vanaf dit punt delta verzenden.

 sessionTag - sessietag die wordt gebruikt voor aanvraag voor deltamechanisme Kan worden gewijzigd door MDM (bijvoorbeeld wanneer switch-MDM plaatsvindt). sessionTag is de teller voor het opnieuw starten van MDM. Als deze niet overeenkomt, betekent dit dat MDM opnieuw is gestart. Als de client of MDM opnieuw is gestart, wordt een volledig antwoord met alle objecten verzonden.


System:
========================
capacityTimeLeftInDays - De resterende tijd totdat de licentie verloopt

enterpriseFeaturesEnabled - Geeft aan of enterprise-functies zijn ingeschakeld, onderdeel van licentiegegevens. Voorbeeld van functies voor bedrijven: snapshots, QoS De standaardwaarde is TRUE.

isInitialLicense - Is de huidige licentie die bij initialisatie aan het systeem is toegewezen.
 managementClientSecureCommunicationEnabled - Is beveiligde communicatie MDM <=> Clients (CLI, REST, UI) ingeschakeld.

mdmToSdsPolicy - MDM <=> SDS communicatiebeleid (regulier/geverifieerd)

upgradeState: of de systeemupgrade wordt uitgevoerd en wat de status ervan is.

remoteReadOnlyLimitState: markering die aangeeft dat een externe client alleen querybewerkingen mag uitvoeren op MDMrestrictedSdcModeEnabled: geeft aan of gebruikers op externe clients beperkt zijn tot alleen-lezen toegang (enabled=read-only access; disabled=volledige lees-/schrijftoegang)

SDS:
========================
rfcacheErrorInconsistentCacheConfiguration - Of er een fout is opgetreden in de rfCache-configuratie.

rfcacheErrorInconsistentSourceConfiguration - Of er een fout is opgetreden op het rfCache-bronapparaat.

rmcacheFrozen - Of de leescache is bevroren (= tijdelijk niet gebruikt)

rmcacheMemoryAllocationState - Status van het geheugentoewijzingsproces (in uitvoering/gereed)

rmcacheSizeInKb - Grootte van de leescache op die SDS

sdsDecoupled - of de SDS zich in een ontkoppelde status bevindt.

sdsReceiveBufferAllocationFailures - Teller van buffertoewijzingsfouten op SDS (helpt bij het identificeren van problemen met prestatievermindering)
========================

Volume:
========================
consistentieGroupId - Identifier die wordt toegewezen aan alle snapshots die met één opdracht worden gemaakt (ze zijn consistent binnen de groep)

mappingToAllSdcsEnabled : of het volume is toegewezen aan alle SDC's (verouderd!!)



deviceList
===============
longSuccessfulIos : teller voor het oplossen van problemen met IO's op schijf die langer duurde dan verwacht, maar toch succesvol is beëindigd. Helpt bij het identificeren van defecte schijven.


activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs
activeNormRebuildCapacityInKb
========================
Counters die achterwaartse rebuild vertegenwoordigen die wordt geactiveerd vanuit de NORMALE status (AKA normal-need-rebuild) - wanneer primair en secundair verschillende waarden hebben, maar de schrijfbewerking niet hebben gedaan, dus we kunnen elke waarde van deze twee kiezen.
De teller "Banen" vertegenwoordigt enkele kammen; actief - kammen die nu in beweging zijn, "MovingIn" - wat betekent dat dit de doel-SDS is.


/api/instances/Sds/relationships/Statistics
===============
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb - XXXCapacityInKb is de FYSIEKE capaciteit, XXXVacInKb is de TOEGEWEZEN capaciteit.
Het verschil is aanzienlijk bij thin volumes en snapshots. Denk aan een dun volume van 10 TB, met 1 TB geschreven data erop, dus toegewezen = 10 TB, fysiek = 1 TB

in onderhoudCapacityInKb
in onderhoudVacInKb
Capaciteit die in onderhoud is (op de SDS die in onderhoudsmodus is)


normRebuildCapacityInKb - Capaciteit die wordt beschouwd als "normale-need-rebuild"

normRebuildReadBwc - Bandbreedte van leesbewerkingen als onderdeel van "rebuild from normal" (er is hetzelfde voor schrijfbewerkingen, om de een of andere reden niet in de lijst)

pendingMovingInNormRebuildJobs
pendingMovingOutNormrebuildJobs - Kammen die opnieuw moeten worden opgebouwd, maar in de wachtrij staan.

  rmPendingAllocatedInKb - Capaciteit die is gemarkeerd voor verwijdering (bijvoorbeeld tijdens apparaat/SDS verwijderen)

semi-ProtectedVacInKb - De "andere kant" van de capaciteit in onderhoud

ThinCapacityAllocationInKm -dit moet ThinCapacityAlallocated InKb zijn.  Het is een REST API-bug, die in 3 wordt opgelost.



"OscillatingCounterParameters" en "OscillatingCounter"
 "OscillatingCounterWindowParameters" en "OscillatingCounterWindow"
===============

Elke oscillerende teller bestaat uit drie schuifvensters kort, gemiddeld, lang, elk geconfigureerd met drempelwaarde en venstergrootte (in seconden)

Zodra de drempelwaarde binnen het huidige venster is bereikt, wordt de relevante waarschuwing afgegeven.

 

Vandaar dat "OscillatingCounterParameters" 3 "OscillatingCounterWindowParameters" bevat;
" OscillatingCounter" bevat 3 "OscillatingCounterWindow".
===============