Objaśnienie parametrów interfejsu API REST ScaleIO
Summary: Wyjaśnienie niektórych parametrów interfejsu API Rest w 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 - Wszystkie właściwości są tutaj połączone z mechanizmem delta - sposobem wysyłania zapytania na obiekt o zmiany od ostatniego wysłania takiego zapytania. Działa to w następujący sposób:
Dla każdego typu obiektu przechowujemy najnowszą wersję, jest to licznik przyrostowy, za każdym razem, gdy obiekt jest zmieniany, wersja jest zwiększana.
Każdy obiekt wie, jaka była wersja podczas ostatniej modyfikacji. Klient wysyła zapytanie z ostatnią wersją, którą zna.
MDM odpowiada listą wszystkich obiektów, które zostały uaktualnione po wprowadzeniu tej wersji.
Lista obiektów usuniętych od tej wersji
Ostatnia wysłana
wersja Przykład takiego zapytania (dla ProtectionDomain):
GET /api/types/ProtectionDomain/instances?systemId={system id}&sessionTag={session tag}&lastVersion={last version}
isDirty - wersja niektórych obiektów została zmieniona podczas tworzenia odpowiedzi przez MDM, flaga brudnego, która jest ustawiana, jeśli nastąpiły zmiany podczas generowania odpowiedzi (aby zachęcić klienta do szybszego wysłania żądania uzupełniającego)
Last<Object>Version - "numer seryjny" ostatniej delty wysłanej na obiekt. Następne zapytanie różnicowe powinno zawierać tę wartość i wyśle różnicę z tego punktu.
sessionTag — tag sesji używany do żądania mechanizmu różnicowego Może zostać zmieniony przez MDM (na przykład po przełączeniu MDM). sessionTag to licznik ponownych uruchomień MDM, jeśli jest niezgodny, oznacza to, że MDM zostało uruchomione ponownie. Jeśli klient lub rozwiązanie MDM zostało uruchomione ponownie, zostanie wysłana pełna odpowiedź zawierająca wszystkie obiekty.
System:
========================
capacityTimeLeftInDays — czas pozostały do wygaśnięcia
licencji enterpriseFeaturesEnabled — wskazuje, czy funkcje korporacyjne są włączone, co jest częścią informacji o licencji. Przykład funkcji przedsiębiorstwa — migawki, QoS Wartość domyślna to TRUE.
isInitialLicense - Czy bieżąca licencja jest przypisana do systemu podczas inicjalizacji.
managementClientSecureCommunicationEnabled — czy bezpieczna komunikacja MDM <=> klienci (CLI, REST, UI) włączone.
mdmToSdsPolicy — MDM <=> zasady komunikacji SDS (zwykłe/uwierzytelnione)
upgradeState — czy trwa aktualizacja systemu i jaki jest jej stan.
remoteReadOnlyLimitState — flaga wskazująca, że klient zdalny może wykonywać operacje zapytań tylko w programie MDMrestrictedSdcModeEnabled — wskazuje, czy użytkownicy na klientach zdalnych są ograniczeni do dostępu tylko do odczytu (enabled=dostęp tylko do odczytu; disabled=pełny dostęp do odczytu/zapisu)
SDS:
========================
rfcacheErrorInconsistentCacheConfiguration — czy wystąpił błąd w konfiguracji rfCache.
rfcacheErrorInconsistentSourceConfiguration — czy w urządzeniu źródłowym rfCache występuje błąd.
rmcacheFrozen — czy pamięć podręczna odczytu jest zamrożona (= tymczasowo nieużywana)
rmcacheMemoryAllocationState — stan procesu alokacji pamięci (w toku/zakończony)
rmcacheSizeInKb — rozmiar pamięci podręcznej odczytu na tym serwerze SDS
sdsDecoupled — czy serwer SDS jest w stanie oddzielonym.
sdsReceiveBufferAllocationFailures — licznik niepowodzeń alokacji buforu w SDS (pomaga zidentyfikować problemy ze spadkiem wydajności)
========================
Volume:
========================
consistencyGroupId — identyfikator przypisany do wszystkich migawek wykonanych w jednym poleceniu (są one spójne w całej grupie)
mappingToAllSdcsEnabled — określa, czy wolumin jest mapowany na wszystkie SDC (przestarzałe!!)
deviceList
===============
longSuccessfulIos - licznik rozwiązywania problemów dla operacji we/wy na dysku, który trwał dłużej niż oczekiwano, ale mimo to zakończył się pomyślnie. Pomaga zidentyfikować uszkodzone dyski.
activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs activeNormRebuildCapacityInKb
========================
Liczniki reprezentujące odbudowę wsteczną wyzwalaną ze stanu NORMAL (AKA normal-need-rebuild) — gdy podstawowe i pomocnicze mają różne wartości, ale nie zostały zatwierdzone przez ACK'ed zapis, więc możemy wybrać dowolną wartość z tych dwóch.
Licznik "Zadania" reprezentuje niektóre grzebienie; active - grzebienie, które są w tej chwili w ruchu, "MovingIn" - co oznacza, że jest to docelowy SDS.
/api/instances/Sds/relationships/Statistics
===============
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb — XXXCapacityInKb to pojemność FIZYCZNA, XXXVacInKb to pojemność PRZYDZIELONA.
Różnica jest znacząca w przypadku woluminów elastycznych i migawek — rozważmy wolumin elastyczny o pojemności 10 TB z zapisanymi danymi o pojemności 1 TB, więc przydzielony=10 TB, fizyczny=1 TB
w trakcie konserwacjiCapacityInKb
w trakcie konserwacjiVacInKb
Pojemność w trakcie konserwacji (na serwerze SDS, który jest w trybie konserwacji)
normRebuildCapacityInKb — pojemność uznawana za normę "normalnej potrzeby odbudowy"
- Przepustowość odczytów w ramach "rebuild from normal" (to samo dotyczy zapisów, z jakiegoś powodu nie ma ich na liście)
pendingMovingInNormRebuildJobs
pendingMovingOutNormrebuildJobs - Grzebienie, które powinny zostać odbudowane, ale czekają w kolejce.
rmPendingAllocatedInKb - Pojemność, która jest oznaczona do usunięcia (np. podczas usuwania urządzenia/SDS)
semi-ProtectedVacInKb - "druga strona" pojemności w konserwacji
ThinCapacityAllocatedInKm -powinno to być ThinCapacityAllocatedInKb. Jest to błąd interfejsu API REST, który zostanie naprawiony w wersji 3.
"OscillatingCounterParameters" i "OscillatingCounter"
"OscillatingCounterWindowParameters" i "OscillatingCounterWindow"
===============
Każdy licznik oscylacyjny składa się z trzech przesuwanych okien krótkich, średnich, długich, każde jest skonfigurowane z progiem i rozmiarem okna (w sekundach)
Po osiągnięciu progu w bieżącym oknie zostanie wydany odpowiedni alert.
W związku z tym "OscillatingCounterParameters" zawiera 3 "OscillatingCounterWindowParameters";
" OscillatingCounter" zawiera 3 "OscillatingCounterWindow".
===============
========================
Note - Wszystkie właściwości są tutaj połączone z mechanizmem delta - sposobem wysyłania zapytania na obiekt o zmiany od ostatniego wysłania takiego zapytania. Działa to w następujący sposób:
Dla każdego typu obiektu przechowujemy najnowszą wersję, jest to licznik przyrostowy, za każdym razem, gdy obiekt jest zmieniany, wersja jest zwiększana.
Każdy obiekt wie, jaka była wersja podczas ostatniej modyfikacji. Klient wysyła zapytanie z ostatnią wersją, którą zna.
MDM odpowiada listą wszystkich obiektów, które zostały uaktualnione po wprowadzeniu tej wersji.
Lista obiektów usuniętych od tej wersji
Ostatnia wysłana
wersja Przykład takiego zapytania (dla ProtectionDomain):
GET /api/types/ProtectionDomain/instances?systemId={system id}&sessionTag={session tag}&lastVersion={last version}
isDirty - wersja niektórych obiektów została zmieniona podczas tworzenia odpowiedzi przez MDM, flaga brudnego, która jest ustawiana, jeśli nastąpiły zmiany podczas generowania odpowiedzi (aby zachęcić klienta do szybszego wysłania żądania uzupełniającego)
Last<Object>Version - "numer seryjny" ostatniej delty wysłanej na obiekt. Następne zapytanie różnicowe powinno zawierać tę wartość i wyśle różnicę z tego punktu.
sessionTag — tag sesji używany do żądania mechanizmu różnicowego Może zostać zmieniony przez MDM (na przykład po przełączeniu MDM). sessionTag to licznik ponownych uruchomień MDM, jeśli jest niezgodny, oznacza to, że MDM zostało uruchomione ponownie. Jeśli klient lub rozwiązanie MDM zostało uruchomione ponownie, zostanie wysłana pełna odpowiedź zawierająca wszystkie obiekty.
System:
========================
capacityTimeLeftInDays — czas pozostały do wygaśnięcia
licencji enterpriseFeaturesEnabled — wskazuje, czy funkcje korporacyjne są włączone, co jest częścią informacji o licencji. Przykład funkcji przedsiębiorstwa — migawki, QoS Wartość domyślna to TRUE.
isInitialLicense - Czy bieżąca licencja jest przypisana do systemu podczas inicjalizacji.
managementClientSecureCommunicationEnabled — czy bezpieczna komunikacja MDM <=> klienci (CLI, REST, UI) włączone.
mdmToSdsPolicy — MDM <=> zasady komunikacji SDS (zwykłe/uwierzytelnione)
upgradeState — czy trwa aktualizacja systemu i jaki jest jej stan.
remoteReadOnlyLimitState — flaga wskazująca, że klient zdalny może wykonywać operacje zapytań tylko w programie MDMrestrictedSdcModeEnabled — wskazuje, czy użytkownicy na klientach zdalnych są ograniczeni do dostępu tylko do odczytu (enabled=dostęp tylko do odczytu; disabled=pełny dostęp do odczytu/zapisu)
SDS:
========================
rfcacheErrorInconsistentCacheConfiguration — czy wystąpił błąd w konfiguracji rfCache.
rfcacheErrorInconsistentSourceConfiguration — czy w urządzeniu źródłowym rfCache występuje błąd.
rmcacheFrozen — czy pamięć podręczna odczytu jest zamrożona (= tymczasowo nieużywana)
rmcacheMemoryAllocationState — stan procesu alokacji pamięci (w toku/zakończony)
rmcacheSizeInKb — rozmiar pamięci podręcznej odczytu na tym serwerze SDS
sdsDecoupled — czy serwer SDS jest w stanie oddzielonym.
sdsReceiveBufferAllocationFailures — licznik niepowodzeń alokacji buforu w SDS (pomaga zidentyfikować problemy ze spadkiem wydajności)
========================
Volume:
========================
consistencyGroupId — identyfikator przypisany do wszystkich migawek wykonanych w jednym poleceniu (są one spójne w całej grupie)
mappingToAllSdcsEnabled — określa, czy wolumin jest mapowany na wszystkie SDC (przestarzałe!!)
deviceList
===============
longSuccessfulIos - licznik rozwiązywania problemów dla operacji we/wy na dysku, który trwał dłużej niż oczekiwano, ale mimo to zakończył się pomyślnie. Pomaga zidentyfikować uszkodzone dyski.
activeMovingInNormRebuildJobs
activeMovingOutNormRebuildJobs activeNormRebuildCapacityInKb
========================
Liczniki reprezentujące odbudowę wsteczną wyzwalaną ze stanu NORMAL (AKA normal-need-rebuild) — gdy podstawowe i pomocnicze mają różne wartości, ale nie zostały zatwierdzone przez ACK'ed zapis, więc możemy wybrać dowolną wartość z tych dwóch.
Licznik "Zadania" reprezentuje niektóre grzebienie; active - grzebienie, które są w tej chwili w ruchu, "MovingIn" - co oznacza, że jest to docelowy SDS.
/api/instances/Sds/relationships/Statistics
===============
in-MaintenanceCapacityInKb
in-MaintenanceVacInKb — XXXCapacityInKb to pojemność FIZYCZNA, XXXVacInKb to pojemność PRZYDZIELONA.
Różnica jest znacząca w przypadku woluminów elastycznych i migawek — rozważmy wolumin elastyczny o pojemności 10 TB z zapisanymi danymi o pojemności 1 TB, więc przydzielony=10 TB, fizyczny=1 TB
w trakcie konserwacjiCapacityInKb
w trakcie konserwacjiVacInKb
Pojemność w trakcie konserwacji (na serwerze SDS, który jest w trybie konserwacji)
normRebuildCapacityInKb — pojemność uznawana za normę "normalnej potrzeby odbudowy"
- Przepustowość odczytów w ramach "rebuild from normal" (to samo dotyczy zapisów, z jakiegoś powodu nie ma ich na liście)
pendingMovingInNormRebuildJobs
pendingMovingOutNormrebuildJobs - Grzebienie, które powinny zostać odbudowane, ale czekają w kolejce.
rmPendingAllocatedInKb - Pojemność, która jest oznaczona do usunięcia (np. podczas usuwania urządzenia/SDS)
semi-ProtectedVacInKb - "druga strona" pojemności w konserwacji
ThinCapacityAllocatedInKm -powinno to być ThinCapacityAllocatedInKb. Jest to błąd interfejsu API REST, który zostanie naprawiony w wersji 3.
"OscillatingCounterParameters" i "OscillatingCounter"
"OscillatingCounterWindowParameters" i "OscillatingCounterWindow"
===============
Każdy licznik oscylacyjny składa się z trzech przesuwanych okien krótkich, średnich, długich, każde jest skonfigurowane z progiem i rozmiarem okna (w sekundach)
Po osiągnięciu progu w bieżącym oknie zostanie wydany odpowiedni alert.
W związku z tym "OscillatingCounterParameters" zawiera 3 "OscillatingCounterWindowParameters";
" OscillatingCounter" zawiera 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.