Explicación de los parámetros de la API REST de ScaleIO
Summary: Explicación de algunos parámetros de la API REST en ScaleIO
This article applies to
This article does not apply to
This article is not tied to any specific product.
Not all product versions are identified in this article.
Instructions
Instance:
========================
Nota: todas las propiedades aquí están conectadas al mecanismo delta, la forma de enviar una consulta por objeto sobre los cambios desde la última vez que se envió dicha consulta. Funciona de la siguiente manera:
Para cada tipo de objeto, almacenamos la última versión, es un contador incremental, cada vez que se cambia un objeto, la versión aumenta.
Cada objeto sabe cuál fue la versión la última vez que se modificó. El cliente envía la solicitud con la última versión que conoce.
MDM responde con una lista de todos los objetos que se actualizaron después de esa versión.
Lista de objetos eliminados desde esa versión
Última versión enviada
Ejemplo para una consulta de este tipo (para ProtectionDomain):
GET /api/types/ProtectionDomain/instances?systemId={system id}&sessionTag={session tag}&lastVersion={last version}
isDirty : la versión de algunos objetos cambió mientras el MDM creó la respuesta, marca de desactualización que se establece si hubo cambios durante la generación de respuestas (para alentar al cliente a enviar una solicitud de seguimiento antes)
Última<versión del objeto> : el "número de serie" del último delta enviado por objeto. La siguiente consulta delta debe contener este valor y enviará delta desde este punto.
sessionTag: etiqueta de sesión utilizada para la solicitud del mecanismo delta Es posible que MDM la cambie (por ejemplo, cuando se produce el MDM de switch). sessionTag es el contador de reinicios de MDM; si no coincide, significa que MDM se reinició. Si se reinició el cliente o el MDM, se enviará una respuesta completa que contiene todos los objetos.
System:
========================
capacityTimeLeftInDays : la cantidad de tiempo que queda hasta que caduque
la licencia enterpriseFeaturesEnabled: indica si las características empresariales están habilitadas, parte de la información de licencia. Ejemplo de funciones empresariales: instantáneas, QoS El valor predeterminado es TRUE .
isInitialLicense : es la licencia actual que se asigna al sistema en la inicialización.
managementClientSecureCommunicationEnabled: es una comunicación segura MDM <=> clientes (CLI, REST, UI) habilitados.
mdmToSdsPolicy : MDM <=> política de comunicación de SDS (regular/autenticada)
upgradeState: indica si la actualización del sistema está en curso y cuál es su estado.
remoteReadOnlyLimitState: marca que indica que un cliente remoto solo puede realizar operaciones de consulta en MDMrestrictedSdcModeEnabled: indica si los usuarios de clientes remotos están restringidos al acceso de solo lectura (habilitado = acceso de solo lectura; deshabilitado = acceso completo de lectura/escritura)
SDS:
========================
rfcacheErrorInconsistentCacheConfiguration: indica si hay un error en la configuración de rfCache.
rfcacheErrorInconsistentSourceConfiguration: indica si hay un error en el dispositivo de origen rfCache.
rmcacheFrozened : si la caché de lectura está congelada (= temporalmente no se usa)
rmcacheMemoryAllocationState: estado del proceso de asignación de memoria (en curso/terminado)
rmcacheSizeInKb: tamaño de la caché de lectura en ese SDS
sdsDesacoplado: si el SDS está en un estado desacoplado.
sdsReceiveBufferAllocationFailures: contador de fallas de asignación de buffer en SDS (ayuda a identificar problemas de degradación del rendimiento)
========================
Volume:
========================
consistencyGroupId : identificador que se asigna a todas las instantáneas tomadas en un solo comando (son coherentes en todo el grupo)
mappingToAllSdcsEnabled : indica si el volumen está asignado a todos los SDC (en desuso!!)
deviceList
=============== longSuccessfulIos :
contador de solución de problemas de I/O al disco que tardaron más de lo esperado, pero aun así finalizaron correctamente. Ayuda a identificar los discos que no funcionan correctamente.
activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs
activeNormRebuildCapacityInKb
========================
Counters que representan la reconstrucción hacia atrás activada desde el estado NORMAL (también conocido como normal-need-rebuild), cuando el primario y el secundario tienen valores diferentes, pero no confirmaron la escritura, por lo que podemos elegir cualquier valor de estos dos.
El contador "Trabajos" representa algunos peines; active: peines que están en movimiento en este momento, "MovingIn", lo que significa que este es el SDS de destino.
/api/instances/Sds/relationships/Statistics
===============
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb - XXXCapacityInKb es la capacidad FÍSICA, XXXVacInKb es la capacidad ALLOCATED.
La diferencia es significativa en los volúmenes delgados y las instantáneas: considere un volumen delgado de 10 TB, con datos escritos de 1 TB, por lo que se asigna=10 TB, físico=1 TB
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb
Capacidad que está en mantenimiento (en el SDS que está en modo de mantenimiento)
normRebuildCapacityInKb: capacidad que se considera "normal-necesita-reconstrucción"
normRebuildReadBwc - Ancho de banda de lecturas como parte de la "reconstrucción desde la normalidad" (hay lo mismo para las escrituras, por alguna razón no está en la lista)
pendingMovingInNormRebuildJobs
pendingMovingOutNormrebuildJobs - Peines que deberían ser reconstruidos, pero que están esperando en cola.
rmPendingAllocatedInKb: capacidad marcada para la eliminación (p. ej., durante la eliminación del dispositivo/SDS)
semi-ProtectedVacInKb: el "otro lado" de la capacidad en mantenimiento
ThinCapacityAllocatedInKm: debe ser ThinCapacityAllocatedInKb. Es un error de la API REST, que se corregirá en 3.
"OscillatingCounterParameters" y "OscillatingCounter"
"OscillatingCounterWindowParameters" y "OscillatingCounterWindow"
===============
Cada contador oscilante consta de tres ventanas deslizantes cortas, medias y largas, cada una está configurada con un umbral y un tamaño de ventana (en segundos)
Una vez que se alcanza el umbral dentro de la ventana actual, se emite la alerta correspondiente.
Por lo tanto,
"OscillatingCounterParameters" contiene 3 "OscillatingCounterWindowParameters";
" OscillatingCounter" contiene 3 "OscillatingCounterWindow".
===============
========================
Nota: todas las propiedades aquí están conectadas al mecanismo delta, la forma de enviar una consulta por objeto sobre los cambios desde la última vez que se envió dicha consulta. Funciona de la siguiente manera:
Para cada tipo de objeto, almacenamos la última versión, es un contador incremental, cada vez que se cambia un objeto, la versión aumenta.
Cada objeto sabe cuál fue la versión la última vez que se modificó. El cliente envía la solicitud con la última versión que conoce.
MDM responde con una lista de todos los objetos que se actualizaron después de esa versión.
Lista de objetos eliminados desde esa versión
Última versión enviada
Ejemplo para una consulta de este tipo (para ProtectionDomain):
GET /api/types/ProtectionDomain/instances?systemId={system id}&sessionTag={session tag}&lastVersion={last version}
isDirty : la versión de algunos objetos cambió mientras el MDM creó la respuesta, marca de desactualización que se establece si hubo cambios durante la generación de respuestas (para alentar al cliente a enviar una solicitud de seguimiento antes)
Última<versión del objeto> : el "número de serie" del último delta enviado por objeto. La siguiente consulta delta debe contener este valor y enviará delta desde este punto.
sessionTag: etiqueta de sesión utilizada para la solicitud del mecanismo delta Es posible que MDM la cambie (por ejemplo, cuando se produce el MDM de switch). sessionTag es el contador de reinicios de MDM; si no coincide, significa que MDM se reinició. Si se reinició el cliente o el MDM, se enviará una respuesta completa que contiene todos los objetos.
System:
========================
capacityTimeLeftInDays : la cantidad de tiempo que queda hasta que caduque
la licencia enterpriseFeaturesEnabled: indica si las características empresariales están habilitadas, parte de la información de licencia. Ejemplo de funciones empresariales: instantáneas, QoS El valor predeterminado es TRUE .
isInitialLicense : es la licencia actual que se asigna al sistema en la inicialización.
managementClientSecureCommunicationEnabled: es una comunicación segura MDM <=> clientes (CLI, REST, UI) habilitados.
mdmToSdsPolicy : MDM <=> política de comunicación de SDS (regular/autenticada)
upgradeState: indica si la actualización del sistema está en curso y cuál es su estado.
remoteReadOnlyLimitState: marca que indica que un cliente remoto solo puede realizar operaciones de consulta en MDMrestrictedSdcModeEnabled: indica si los usuarios de clientes remotos están restringidos al acceso de solo lectura (habilitado = acceso de solo lectura; deshabilitado = acceso completo de lectura/escritura)
SDS:
========================
rfcacheErrorInconsistentCacheConfiguration: indica si hay un error en la configuración de rfCache.
rfcacheErrorInconsistentSourceConfiguration: indica si hay un error en el dispositivo de origen rfCache.
rmcacheFrozened : si la caché de lectura está congelada (= temporalmente no se usa)
rmcacheMemoryAllocationState: estado del proceso de asignación de memoria (en curso/terminado)
rmcacheSizeInKb: tamaño de la caché de lectura en ese SDS
sdsDesacoplado: si el SDS está en un estado desacoplado.
sdsReceiveBufferAllocationFailures: contador de fallas de asignación de buffer en SDS (ayuda a identificar problemas de degradación del rendimiento)
========================
Volume:
========================
consistencyGroupId : identificador que se asigna a todas las instantáneas tomadas en un solo comando (son coherentes en todo el grupo)
mappingToAllSdcsEnabled : indica si el volumen está asignado a todos los SDC (en desuso!!)
deviceList
=============== longSuccessfulIos :
contador de solución de problemas de I/O al disco que tardaron más de lo esperado, pero aun así finalizaron correctamente. Ayuda a identificar los discos que no funcionan correctamente.
activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs
activeNormRebuildCapacityInKb
========================
Counters que representan la reconstrucción hacia atrás activada desde el estado NORMAL (también conocido como normal-need-rebuild), cuando el primario y el secundario tienen valores diferentes, pero no confirmaron la escritura, por lo que podemos elegir cualquier valor de estos dos.
El contador "Trabajos" representa algunos peines; active: peines que están en movimiento en este momento, "MovingIn", lo que significa que este es el SDS de destino.
/api/instances/Sds/relationships/Statistics
===============
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb - XXXCapacityInKb es la capacidad FÍSICA, XXXVacInKb es la capacidad ALLOCATED.
La diferencia es significativa en los volúmenes delgados y las instantáneas: considere un volumen delgado de 10 TB, con datos escritos de 1 TB, por lo que se asigna=10 TB, físico=1 TB
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb
Capacidad que está en mantenimiento (en el SDS que está en modo de mantenimiento)
normRebuildCapacityInKb: capacidad que se considera "normal-necesita-reconstrucción"
normRebuildReadBwc - Ancho de banda de lecturas como parte de la "reconstrucción desde la normalidad" (hay lo mismo para las escrituras, por alguna razón no está en la lista)
pendingMovingInNormRebuildJobs
pendingMovingOutNormrebuildJobs - Peines que deberían ser reconstruidos, pero que están esperando en cola.
rmPendingAllocatedInKb: capacidad marcada para la eliminación (p. ej., durante la eliminación del dispositivo/SDS)
semi-ProtectedVacInKb: el "otro lado" de la capacidad en mantenimiento
ThinCapacityAllocatedInKm: debe ser ThinCapacityAllocatedInKb. Es un error de la API REST, que se corregirá en 3.
"OscillatingCounterParameters" y "OscillatingCounter"
"OscillatingCounterWindowParameters" y "OscillatingCounterWindow"
===============
Cada contador oscilante consta de tres ventanas deslizantes cortas, medias y largas, cada una está configurada con un umbral y un tamaño de ventana (en segundos)
Una vez que se alcanza el umbral dentro de la ventana actual, se emite la alerta correspondiente.
Por lo tanto,
"OscillatingCounterParameters" contiene 3 "OscillatingCounterWindowParameters";
" OscillatingCounter" contiene 3 "OscillatingCounterWindow".
===============
Affected Products
PowerFlex SoftwareProducts
PowerFlex SoftwareArticle Properties
Article Number: 000019987
Article Type: How To
Last Modified: 12 Sept 2025
Version: 4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.