ScaleIO REST API 参数说明

Instance：
========================
注意 - 此处的所有属性都连接到增量机制 - 该机制用于发送每个对象的查询，以了解自上次发送此类查询以来的更改。它的工作原理如下：

对于每个对象类型，我们存储最新版本，它是一个增量计数器，每次更改对象时，版本都会增加。

每个对象知道上次修改时的版本。客户端使用他知道的最后一个版本发送请求。

MDM 使用在该版本之后更新的所有对象的列表进行响应。
自该版本
以来删除的对象列表 发送

的最新版本 此类查询的示例（对于 ProtectionDomain）：

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

isDirty - 在 MDM 创建响应时某些对象上的版本已更改，如果在响应生成过程中发生更改，则设置脏标记（以鼓励客户端更快地发送后续请求）


Last<Object>Version — 每个对象发送的最后一个增量的“序列号”。下一个增量查询应包含此值，并将从此时开始发送增量。

sessionTag — 用于增量机制请求的会话标记 MDM 可能会更改（例如，当切换 MDM 时）。sessionTag 是 MDM 重新启动计数器，如果不匹配，则表示 MDM 已重新启动。如果客户端或 MDM 已重新启动，则将发送包含所有对象的完整响应。


System：
========================
capacityTimeLeftInDays — 许可证到期

前剩余的时间量 enterpriseFeaturesEnabled — 指示是否已启用企业功能，这是许可信息的一部分。企业功能示例 — 快照、QoS 默认值为 TRUE。

isInitialLicense - 当前许可证是在初始化时分配给系统的许可证。
managementClientSecureCommunicationEnabled — 是否启用

了安全通信 MDM <=> 客户端（CLI、REST、UI）。 mdmToSdsPolicy - MDM <=> SDS 通信策略（常规/经过身份验证）

upgradeState — 系统升级是否正在进行以及其状态是什么。

remoteReadOnlyLimitState - 指示仅允许远程客户端在 MDMrestrictedSdcModeEnabled上执行查询操作的标志 - 指示远程客户端上的用户是否被限制为只读访问权限（启用 = 只读访问;禁用 = 完全读/写访问）

SDS：
========================
rfcacheErrorInconsistentCacheConfiguration — rfCache 配置中是否存在错误。

rfcacheErrorInconsistentSourceConfiguration - rfCache 源设备中是否存在错误。

rmcacheFrozen - 读缓存是否冻结（= 临时未使用）

rmcacheMemoryAllocationState - 内存分配过程的状态（正在进行/已完成）

rmcacheSizeInKb — 该 SDS

上的读取缓存的大小 sdsDecoupled — SDS 是否处于解耦状态。

sdsReceiveBufferAllocationFailures - SDS 上的缓冲区分配失败计数器（有助于识别性能降级问题）
========================

Volume：
========================
consistencyGroupId — 分配给在单个命令中创建的所有快照的标识符（它们在组中是一致的）

mappingToAllSdcsEnabled — 卷是否映射到所有 SDC（已弃用!!）



deviceList
===============
longSuccessfulIos - 磁盘的 IO 故障排除计数器，花费的时间比预期的要长，但仍成功结束。帮助识别出现故障的磁盘。


activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs
activeNormRebuildCapacityInKb
========================
Counters 表示从 NORMAL 状态触发的向后重建（又名 normal-need-rebuild）- 当主和辅助具有不同的值，但没有执行写入时，因此我们可以选择这两个值的任何值。
“Jobs”计数器代表一些梳子;active— 现在处于移动状态的梳子，“MovingIn”— 表示这是目标 SDS。


/api/instances/Sds/relationships/Statistics
===============
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb - XXXCapacityInKb 是 PHYSICAL 容量，XXXVacInKb 是 ALLOCATED 容量。
差异在精简卷和快照中是显著的 - 考虑一个 10TB 的精简卷，上面有 1TB 写入的数据，so allocated=10TB， physical=1TB

in-MaintenanceCapacityInKb
in-MaintenanceVacInKb
Capacity that is in maintenance （on the SDS that is maintenance mode）


normRebuildCapacityInKb - Capacity that is considered “normal-need-rebuild”

normRebuildReadBwc - 作为“从正常重建”的一部分的读取带宽（写入也是如此，出于某种原因不在列表中）

pendingMovingInNormRebuildJobs
pendingMovingOutNormrebuildJobs - 应该重建但在队列中等待的梳子。

  rmPendingAllocatedInKb - 标记为删除的容量（例如，在删除设备/SDS 期间）

semi-ProtectedVacInKb - 维护

中容量的“另一端” ThinCapacityAllocatedInKm - 应为 ThinCapacityAllocatedInKb。  这是一个 REST API 错误，将在 3 中修复。



“OscillatingCounterParameters”和“OscillatingCounter”
“OscillatingCounterWindowParameters”和“OscillatingCounterWindow”
===============

每个振荡计数器由三个滑动窗口组成，短、中、长，每个滑动窗口都配置了阈值和窗口大小（以秒为单位）

一旦在当前窗口中达到阈值，就会发出相关警报。


因此，“
OscillatingCounterParameters”包含 3 个“OscillatingCounterWindowParameters”;
OscillatingCounter“包含 3 个”OscillatingCounterWindow”。
===============