Pobieranie fragmentu kondycji klastra przy użyciu zasad i filtrów zaawansowanych
Pobiera kondycję klastra usługi Service Fabric przy użyciu fragmentów kondycji.
Pobiera kondycję klastra usługi Service Fabric przy użyciu fragmentów kondycji. Ocena kondycji jest wykonywana na podstawie opisu zapytania fragmentu kondycji klastra wejściowego. Opis zapytania umożliwia użytkownikom określenie zasad kondycji do oceny klastra i jego elementów podrzędnych. Użytkownicy mogą określać bardzo elastyczne filtry, aby wybrać jednostki klastra do zwrócenia. Wybór można wykonać na podstawie stanu kondycji jednostek i na podstawie hierarchii. Zapytanie może zwracać wielowymiarowe elementy podrzędne jednostek na podstawie określonych filtrów. Na przykład może zwrócić jedną aplikację o określonej nazwie, a dla tej aplikacji zwracać tylko usługi, które są w obszarze Błąd lub Ostrzeżenie, oraz wszystkie partycje i repliki dla jednej z tych usług.
Żądanie
| Metoda | Identyfikator URI żądania |
|---|---|
| POST | /$/GetClusterHealthChunk?api-version=6.0&timeout={timeout} |
Parametry
| Nazwa | Typ | Wymagane | Lokalizacja |
|---|---|---|---|
api-version |
ciąg | Tak | Zapytanie |
timeout |
liczba całkowita (int64) | Nie | Zapytanie |
ClusterHealthChunkQueryDescription |
ClusterHealthChunkQueryDescription | Nie | Treść |
api-version
Typ: ciąg
Wymagane: Tak
Ustawienie domyślne: 6.0
Wersja interfejsu API. Ten parametr jest wymagany, a jego wartość musi mieć wartość "6.0".
Wersja interfejsu API REST usługi Service Fabric jest oparta na wersji środowiska uruchomieniowego, w której wprowadzono lub zmieniono interfejs API. Środowisko uruchomieniowe usługi Service Fabric obsługuje więcej niż jedną wersję interfejsu API. Jest to najnowsza obsługiwana wersja interfejsu API. Jeśli zostanie przekazana niższa wersja interfejsu API, zwrócona odpowiedź może być inna niż ta udokumentowana w tej specyfikacji.
Ponadto środowisko uruchomieniowe akceptuje każdą wersję, która jest wyższa niż najnowsza obsługiwana wersja do bieżącej wersji środowiska uruchomieniowego. Jeśli więc najnowsza wersja interfejsu API to 6.0, ale jeśli środowisko uruchomieniowe ma wartość 6.1, aby ułatwić pisanie klientów, środowisko uruchomieniowe zaakceptuje wersję 6.1 dla tego interfejsu API. Jednak zachowanie interfejsu API będzie zgodnie z udokumentowaną wersją 6.0.
timeout
Typ: liczba całkowita (int64)
Wymagane: Nie
Ustawienie domyślne: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund.
ClusterHealthChunkQueryDescription
Typ: ClusterHealthChunkQueryDescription
Wymagane: Nie
Opisuje zasady kondycji klastra i aplikacji używane do oceny kondycji klastra i filtrów, aby wybrać, które jednostki klastra mają zostać zwrócone.
Jeśli istnieją zasady kondycji klastra, służy do oceny zdarzeń klastra i węzłów klastra. Jeśli nie istnieje, ocena kondycji używa zasad kondycji klastra zdefiniowanych w manifeście klastra lub domyślnych zasad kondycji klastra.
Domyślnie każda aplikacja jest oceniana przy użyciu określonych zasad kondycji aplikacji zdefiniowanych w manifeście aplikacji lub domyślnych zasad kondycji, jeśli żadne zasady nie są zdefiniowane w manifeście.
Jeśli zostanie określona mapa zasad kondycji aplikacji i ma wpis dla aplikacji, określone zasady kondycji aplikacji są używane do oceny kondycji aplikacji.
Użytkownicy mogą określać bardzo elastyczne filtry, aby wybrać jednostki klastra do uwzględnienia w odpowiedzi. Wybór można wykonać na podstawie stanu kondycji jednostek i na podstawie hierarchii.
Zapytanie może zwracać wielowymiarowe elementy podrzędne jednostek na podstawie określonych filtrów. Na przykład może zwrócić jedną aplikację o określonej nazwie, a dla tej aplikacji zwracać tylko usługi, które są w obszarze Błąd lub Ostrzeżenie, oraz wszystkie partycje i repliki dla jednej z tych usług.
Odpowiedzi
| Kod stanu HTTP | Opis | Response Schema |
|---|---|---|
| 200 (OK) | Pomyślna operacja zwróci kod stanu 200 i żądany fragment kondycji klastra. |
KlasterHealthChunk |
| Wszystkie inne kody stanu | Szczegółowa odpowiedź na błąd. |
FabricError |