Explication des paramètres de l’API REST ScaleIO

Instance :
========================
Remarque : Toutes les propriétés ici sont connectées au mécanisme delta, c’est-à-dire le moyen d’envoyer une requête par objet sur les modifications apportées depuis la dernière fois qu’une telle requête a été envoyée. Cela fonctionne comme suit :

Pour chaque type d’objet, nous stockons la dernière version c’est un compteur incrémental, chaque fois qu’un objet est modifié, la version est augmentée.

Chaque objet sait quelle était la version de la dernière fois qu’il a été modifié. Le client envoie la demande avec la dernière version qu’il connaît.

MDM répond avec une liste de tous les objets qui ont été mis à jour après cette version.
Liste des objets supprimés depuis cette version
Dernière version envoyée

Exemple pour une telle requête (pour ProtectionDomain) : 

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

isDirty : la version de certains objets a été modifiée pendant que le MDM créait la réponse, balise dirty qui est définie s’il y a eu des modifications lors de la génération de la réponse (pour encourager le client à envoyer une demande de suivi plus tôt)


Last<Object Version> : numéro de série du dernier delta envoyé par objet. La requête delta suivante doit contenir cette valeur et enverra delta à partir de ce point.

 sessionTag : balise de session utilisée pour la demande de mécanisme delta Peut être modifiée par le MDM (par exemple lorsque le MDM de commutateur se produit). sessionTag est le compteur de redémarrages du MDM. S’il est incompatible, cela signifie que le MDM a été redémarré. Si le client ou le MDM a été redémarré, une réponse complète contenant tous les objets est envoyée.


System :
========================
capacityTimeLeftInDays : durée restante avant l’expiration de

la licence enterpriseFeaturesEnabled : indique si les fonctionnalités d’entreprise sont activées, ce qui fait partie des informations relatives à la licence. Exemple de fonctionnalités d’entreprise : snapshots, QoS La valeur par défaut est TRUE .

isInitialLicense : la licence actuelle est celle attribuée au système lors de l’initialisation.
 managementClientSecureCommunicationEnabled : la communication sécurisée MDM <=> Clients (CLI, REST, IU) est-elle activée.

mdmToSdsPolicy - MDM <=> politique de communication SDS (régulière/authentifiée)

upgradeState : indique si la mise à niveau du système est en cours et quel est son état.

remoteReadOnlyLimitState : balise qui indique qu’un client distant est uniquement autorisé à effectuer des opérations de requête sur MDMrestrictedSdcModeEnabled : indique si les utilisateurs des clients distants sont limités à un accès en lecture seule (enabled=read-only access ; disabled=full read/write access

SDS :
========================
rfcacheErrorInconsistentCacheConfiguration : indique s’il y a une erreur dans la configuration rfCache.

rfcacheErrorInconsistentSourceConfiguration : indique s’il y a une erreur dans l’appareil source rfCache.

rmcacheFrozen : si le cache de lecture est gelé (= temporaire, non utilisé)

rmcacheMemoryAllocationState : état du processus d’allocation de mémoire (en cours/terminé)

rmcacheSizeInKb : taille du cache de lecture sur ce SDS

sdsDecoupled : indique si le SDS est dans un état découplé.

sdsReceiveBufferAllocationFailures : compteur d’échecs d’allocation de mémoire tampon sur le SDS (permet d’identifier les problèmes de dégradation des performances)
========================

Volume :
========================
consistencyGroupId : ID attribué à tous les snapshots pris dans une seule commande (ils sont cohérents dans le groupe)

mappingToAllSdcsEnabled : indique si le volume est mappé à tous les SDC (obsolète !!)



deviceList
===============
longSuccessfulIos : compteur de dépannage pour les E/S sur le disque qui ont pris plus de temps que prévu, mais qui se sont quand même terminées avec succès. Permet d’identifier les disques défectueux.


activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs
activeNormRebuildCapacityInKb
========================
Compteurs représentant la reconstruction en amont déclenchée à partir de l’état NORMAL (AKA normal-need-rebuild) - lorsque le primaire et le secondaire ont des valeurs différentes, mais n’ont pas accusé de réception de l’écriture, nous pouvons donc choisir n’importe quelle valeur de ces deux.
Le compteur « Jobs » représente quelques peignes ; active - peignes qui sont en mouvement en ce moment, « MovingIn » - ce qui signifie qu’il s’agit du SDS cible.


/api/instances/Sds/relationships/Statistics
===============
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb - XXXCapacityInKb est la capacité PHYSIQUE, XXXVacInKb est la capacité ALLOUÉE.
La différence est significative entre les volumes dynamiques et les snapshots : considérons un volume dynamique de 10 To, avec 1 To de données écrites dessus, donc alloué = 10 To, physique = 1 To

in-MaintenanceCapacityInKb
in-MaintenanceVacInKb
Capacité en maintenance (sur le SDS qui est en mode maintenance)


normRebuildCapacityInKb : capacité considérée comme « normal-need-rebuild »

normRebuildReadBwc - Bande passante des lectures dans le cadre de la « reconstruction à partir de la normale » (il y a la même chose pour les écritures, pour une raison quelconque qui n’est pas dans la liste)

pendingMovingInNormRebuildJobs
pendingMovingOutNormrebuildJobs - Peignes qui devraient être reconstruits, mais qui attendent dans la file d’attente.

  rmPendingAllocatedInKb : capacité marquée pour suppression (par exemple, lors de la suppression de l’appareil/du SDS)

semi-ProtectedVacInKb : « l’autre côté » de la capacité en maintenance

ThinCapacityAllocatedInKm : il doit s’agir de ThinCapacityAllocatedInKb.  Il s’agit d’un bug de l’API REST, qui sera corrigé dans la version 3.



« OscillatingCounterParameters » et « OscillatingCounter »
 « OscillatingCounterWindowParameters » et « OscillatingCounterWindow"
===============

Chaque compteur oscillant se compose de trois fenêtres coulissantes courtes, moyennes, longues, chacune est configurée avec la taille du seuil et de la fenêtre (en secondes)

Une fois le seuil atteint dans la fenêtre en cours, l’alerte correspondante est émise.

 
Par conséquent,
« OscillatingCounterParameters » contient 3 « OscillatingCounterWindowParameters » ;
 » OscillatingCounter » contient 3 « OscillatingCounterWindow ».
===============