Explicação dos parâmetros da API REST do ScaleIO
Summary: Explicação de alguns parâmetros da API REST no 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:
========================
Note - Todas as propriedades aqui estão conectadas ao mecanismo delta - a maneira de enviar uma consulta por objeto sobre as alterações da última vez que tal consulta foi enviada. Ele funciona da seguinte forma:
Para cada tipo de objeto, armazenamos a versão mais recente é um contador incremental, toda vez que um objeto é alterado, a versão é aumentada.
Cada objeto sabe qual foi a versão da última vez que foi modificada. O cliente envia a solicitação com a última versão que conhece.
O MDM responde com uma lista de todos os objetos que foram atualizados após essa versão.
Lista de objetos excluídos desde essa versão
Última versão enviada
Exemplo para tal consulta (para ProtectionDomain):
GET /api/types/ProtectionDomain/instances?systemId={system id}&sessionTag={session tag}&lastVersion={last version}
isDirty — a versão em alguns objetos foi alterada enquanto o MDM criou a resposta, indicador sujo que é definido se houver alterações durante a geração da resposta (para incentivar o cliente a enviar uma solicitação de acompanhamento mais cedo)
Last<Object Version> - "número de série" do último delta enviado por Object. A próxima consulta delta deve conter esse valor e enviará delta a partir desse ponto.
sessionTag - etiqueta de sessão usada para solicitação do mecanismo delta Pode ser alterada pelo MDM (por exemplo, quando ocorre o MDM do switch). sessionTag é o contador de reinicializações do MDM, se for incompatível, significa que o MDM foi reiniciado. Se o client ou MDM foi reiniciado, uma resposta completa que contém todos os objetos será enviada.
System:
========================
capacityTimeLeftInDays - O tempo restante até a licença expirar
enterpriseFeaturesEnabled - Indica se os recursos corporativos estão ativados, parte das informações de licenciamento. Exemplo de recursos corporativos — snapshots, QoS O valor padrão é TRUE.
isInitialLicense - A licença atual é a atribuída ao sistema na inicialização.
managementClientSecureCommunicationEnabled - A comunicação segura MDM <=> Clients (CLI, REST, UI) está ativada.
mdmToSdsPolicy — MDM <=> política de comunicação do SDS (regular/autenticada)
upgradeState — se o upgrade do sistema está em andamento e qual é o estado dele.
remoteReadOnlyLimitState — indicador que indica que um client remoto só tem permissão para executar operações de consulta no MDMrestrictedSdcModeEnabled — indica se os usuários em clients remotos estão restritos ao acesso somente leitura (enabled=read-only access; disabled=full read/write access)
SDS:
========================
rfcacheErrorInconsistentCacheConfiguration - Se há um erro na configuração do rfCache.
rfcacheErrorInconsistentSourceConfiguration - Se há um erro no dispositivo de origem rfCache.
rmcacheFrozen - Se o cache de leitura está congelado (= temporário não usado)
rmcacheMemoryAllocationState - Estado do processo de alocação de memória (em andamento/concluído)
rmcacheSizeInKb - Tamanho do cache de leitura nesse SDS
sdsDecoupled - se o SDS está em um estado dissociado.
sdsReceiveBufferAllocationFailures - Contador de falhas de alocação de buffer no SDS (ajuda a identificar problemas de degradação de desempenho)
========================
Volume:
========================
consistencyGroupId - identificador atribuído a todos os snapshots obtidos em um único comando (eles são consistentes em todo o grupo)
mappingToAllSdcsEnabled — se o volume está mapeado para todos os SDCs (obsoleto!!)
deviceList
===============
longSuccessfulIos - contador de solução de problemas de E/S para disco que levou mais tempo do que o esperado, mas ainda terminou com êxito. Ajuda a identificar discos com defeito.
activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs
activeNormRebuildCapacityInKb
========================
Counters representando a reconstrução para trás acionada do estado NORMAL (também conhecido como normal-need-rebuild) - quando primário e secundário têm valores diferentes, mas não ACK'ed a gravação, então podemos escolher qualquer valor desses dois.
O contador "Jobs" representa alguns pentes; ativo - pentes que estão em movimento agora, "MovingIn" - o que significa que este é o SDS de destino.
/api/instances/Sds/relationships/Statistics
=============== in-MaintenanceCapacityInKb
in-MaintenanceVacInKb - XXXCapacityInKb é a capacidade FÍSICA, XXXVacInKb é a capacidade ALOCADA.
A diferença é significativa em volumes thin e snapshots - considere um volume thin de 10 TB, com dados gravados de 1 TB, então alocado = 10 TB, físico = 1 TB
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb
Capacidade que está em manutenção (no SDS que está no modo de manutenção)
normRebuildCapacityInKb - Capacidade considerada "normal-need-rebuild"
normRebuildReadBwc - Largura de banda de leituras como parte de "rebuild from normal" (há o mesmo para gravações, por algum motivo não na lista)
pendingMovingInNormRebuildJobs
pendingMovingOutNormrebuildJobs - Combs que deveriam ser reconstruídos, mas estão aguardando na fila.
rmPendingAllocatedInKb - Capacidade marcada para remoção (por exemplo, durante a remoção do dispositivo/SDS)
semi-ProtectedVacInKb - O "outro lado" da capacidade em manutenção
ThinCapacityAllocatedInKm - deve ser ThinCapacityAllocatedInKb. É um bug da API REST, que será corrigido em 3.
"OscillatingCounterParameters" e "OscillatingCounter"
"OscillatingCounterWindowParameters" e "OscillatingCounterWindow"
===============
Cada contador oscilante consiste em três janelas deslizantes curtas, médias, longas, cada uma é configurada com limite e tamanho da janela (em segundos)
Uma vez que o limite é atingido dentro da janela atual, o alerta relevante é emitido.
Assim,
"OscillatingCounterParameters" contém 3 "OscillatingCounterWindowParameters";
" OscillatingCounter" contém 3 "OscillatingCounterWindow".
===============
========================
Note - Todas as propriedades aqui estão conectadas ao mecanismo delta - a maneira de enviar uma consulta por objeto sobre as alterações da última vez que tal consulta foi enviada. Ele funciona da seguinte forma:
Para cada tipo de objeto, armazenamos a versão mais recente é um contador incremental, toda vez que um objeto é alterado, a versão é aumentada.
Cada objeto sabe qual foi a versão da última vez que foi modificada. O cliente envia a solicitação com a última versão que conhece.
O MDM responde com uma lista de todos os objetos que foram atualizados após essa versão.
Lista de objetos excluídos desde essa versão
Última versão enviada
Exemplo para tal consulta (para ProtectionDomain):
GET /api/types/ProtectionDomain/instances?systemId={system id}&sessionTag={session tag}&lastVersion={last version}
isDirty — a versão em alguns objetos foi alterada enquanto o MDM criou a resposta, indicador sujo que é definido se houver alterações durante a geração da resposta (para incentivar o cliente a enviar uma solicitação de acompanhamento mais cedo)
Last<Object Version> - "número de série" do último delta enviado por Object. A próxima consulta delta deve conter esse valor e enviará delta a partir desse ponto.
sessionTag - etiqueta de sessão usada para solicitação do mecanismo delta Pode ser alterada pelo MDM (por exemplo, quando ocorre o MDM do switch). sessionTag é o contador de reinicializações do MDM, se for incompatível, significa que o MDM foi reiniciado. Se o client ou MDM foi reiniciado, uma resposta completa que contém todos os objetos será enviada.
System:
========================
capacityTimeLeftInDays - O tempo restante até a licença expirar
enterpriseFeaturesEnabled - Indica se os recursos corporativos estão ativados, parte das informações de licenciamento. Exemplo de recursos corporativos — snapshots, QoS O valor padrão é TRUE.
isInitialLicense - A licença atual é a atribuída ao sistema na inicialização.
managementClientSecureCommunicationEnabled - A comunicação segura MDM <=> Clients (CLI, REST, UI) está ativada.
mdmToSdsPolicy — MDM <=> política de comunicação do SDS (regular/autenticada)
upgradeState — se o upgrade do sistema está em andamento e qual é o estado dele.
remoteReadOnlyLimitState — indicador que indica que um client remoto só tem permissão para executar operações de consulta no MDMrestrictedSdcModeEnabled — indica se os usuários em clients remotos estão restritos ao acesso somente leitura (enabled=read-only access; disabled=full read/write access)
SDS:
========================
rfcacheErrorInconsistentCacheConfiguration - Se há um erro na configuração do rfCache.
rfcacheErrorInconsistentSourceConfiguration - Se há um erro no dispositivo de origem rfCache.
rmcacheFrozen - Se o cache de leitura está congelado (= temporário não usado)
rmcacheMemoryAllocationState - Estado do processo de alocação de memória (em andamento/concluído)
rmcacheSizeInKb - Tamanho do cache de leitura nesse SDS
sdsDecoupled - se o SDS está em um estado dissociado.
sdsReceiveBufferAllocationFailures - Contador de falhas de alocação de buffer no SDS (ajuda a identificar problemas de degradação de desempenho)
========================
Volume:
========================
consistencyGroupId - identificador atribuído a todos os snapshots obtidos em um único comando (eles são consistentes em todo o grupo)
mappingToAllSdcsEnabled — se o volume está mapeado para todos os SDCs (obsoleto!!)
deviceList
===============
longSuccessfulIos - contador de solução de problemas de E/S para disco que levou mais tempo do que o esperado, mas ainda terminou com êxito. Ajuda a identificar discos com defeito.
activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs
activeNormRebuildCapacityInKb
========================
Counters representando a reconstrução para trás acionada do estado NORMAL (também conhecido como normal-need-rebuild) - quando primário e secundário têm valores diferentes, mas não ACK'ed a gravação, então podemos escolher qualquer valor desses dois.
O contador "Jobs" representa alguns pentes; ativo - pentes que estão em movimento agora, "MovingIn" - o que significa que este é o SDS de destino.
/api/instances/Sds/relationships/Statistics
=============== in-MaintenanceCapacityInKb
in-MaintenanceVacInKb - XXXCapacityInKb é a capacidade FÍSICA, XXXVacInKb é a capacidade ALOCADA.
A diferença é significativa em volumes thin e snapshots - considere um volume thin de 10 TB, com dados gravados de 1 TB, então alocado = 10 TB, físico = 1 TB
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb
Capacidade que está em manutenção (no SDS que está no modo de manutenção)
normRebuildCapacityInKb - Capacidade considerada "normal-need-rebuild"
normRebuildReadBwc - Largura de banda de leituras como parte de "rebuild from normal" (há o mesmo para gravações, por algum motivo não na lista)
pendingMovingInNormRebuildJobs
pendingMovingOutNormrebuildJobs - Combs que deveriam ser reconstruídos, mas estão aguardando na fila.
rmPendingAllocatedInKb - Capacidade marcada para remoção (por exemplo, durante a remoção do dispositivo/SDS)
semi-ProtectedVacInKb - O "outro lado" da capacidade em manutenção
ThinCapacityAllocatedInKm - deve ser ThinCapacityAllocatedInKb. É um bug da API REST, que será corrigido em 3.
"OscillatingCounterParameters" e "OscillatingCounter"
"OscillatingCounterWindowParameters" e "OscillatingCounterWindow"
===============
Cada contador oscilante consiste em três janelas deslizantes curtas, médias, longas, cada uma é configurada com limite e tamanho da janela (em segundos)
Uma vez que o limite é atingido dentro da janela atual, o alerta relevante é emitido.
Assim,
"OscillatingCounterParameters" contém 3 "OscillatingCounterWindowParameters";
" OscillatingCounter" contém 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.