sfctl partition

Wykonywanie zapytań o partycje dla dowolnej usługi i zarządzanie nimi.

Polecenia

Polecenie	opis
utrata danych	Ten interfejs API spowoduje utratę danych dla określonej partycji.
stan utraty danych	Pobiera postęp operacji utraty danych partycji rozpoczętej przy użyciu interfejsu API StartDataLoss.
zdrowie	Pobiera kondycję określonej partycji usługi Service Fabric.
informacje o	Pobiera informacje o partycji usługi Service Fabric.
lista	Pobiera listę partycji usługi Service Fabric.
ładowanie	Pobiera informacje o obciążeniu określonej partycji usługi Service Fabric.
resetowanie obciążenia	Resetuje bieżące obciążenie partycji usługi Service Fabric.
utrata kworum	Wywołuje utratę kworum dla danej partycji usługi stanowej.
kworum-loss-status	Pobiera postęp operacji utraty kworum na partycji rozpoczętej przy użyciu interfejsu API StartQuorumLoss.
odzyskiwanie	Wskazuje klaster usługi Service Fabric, który powinien spróbować odzyskać określoną partycję, która jest obecnie zablokowana w utracie kworum.
odzyskaj wszystko	Wskazuje klaster usługi Service Fabric, który powinien spróbować odzyskać wszystkie usługi (w tym usługi systemowe), które są obecnie zablokowane w utracie kworum.
report-health	Wysyła raport o kondycji partycji usługi Service Fabric.
restart	Ten interfejs API uruchomi ponownie niektóre lub wszystkie repliki lub wystąpienia określonej partycji.
stan ponownego uruchomienia	Pobiera postęp operacji PartitionRestart rozpoczętej przy użyciu polecenia StartPartitionRestart.
svc-name	Pobiera nazwę usługi Service Fabric dla partycji.

sfctl partition data-loss

Ten interfejs API spowoduje utratę danych dla określonej partycji.

Spowoduje to wywołanie interfejsu API OnDataLossAsync partycji. Ten interfejs API spowoduje utratę danych dla określonej partycji. Spowoduje to wyzwolenie wywołania interfejsu API OnDataLoss partycji. Rzeczywista utrata danych będzie zależeć od określonej wartości DataLossMode.

• PartialDataLoss: tylko kworum replik są usuwane, a wartości OnDataLoss są wyzwalane dla partycji, ale rzeczywista utrata danych zależy od obecności replikacji w locie.
• FullDataLoss: Wszystkie repliki są usuwane, dlatego wszystkie dane zostaną utracone, a wyzwalane są metryki OnDataLoss. Ten interfejs API powinien być wywoływany tylko z usługą stanową jako obiekt docelowy. Wywoływanie tego interfejsu API za pomocą usługi systemowej jako elementu docelowego nie jest zalecane.

Uwaga

Po wywołaniu tego interfejsu API nie można go cofnąć. Wywołanie metody CancelOperation spowoduje zatrzymanie wykonywania i oczyszczenie stanu systemu wewnętrznego. Nie spowoduje to przywrócenia danych, jeśli polecenie postępuje wystarczająco daleko, aby spowodować utratę danych. Wywołaj interfejs API GetDataLossProgress za pomocą tego samego identyfikatora OperationId, aby zwrócić informacje na temat operacji rozpoczętej z tym interfejsem API.

Argumenty

Argument	opis
--data-loss-mode [Wymagane]	To wyliczenie jest przekazywane do interfejsu API StartDataLoss, aby wskazać typ utraty danych do wywołania.
--operation-id [Wymagane]	Identyfikator GUID identyfikujący wywołanie tego interfejsu API. Jest on przekazywany do odpowiedniego interfejsu API getProgress.
--partition-id [Wymagane]	Tożsamość partycji.
--service-id [Wymagane]	Tożsamość usługi. Ten identyfikator jest zazwyczaj pełną nazwą usługi bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa usługi to "fabric:/myapp/app1/svc1", tożsamość usługi to "myapp~app1~svc1" w wersji 6.0+ i "myapp/app1/svc1" w poprzednich wersjach.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

sfctl partition data-loss-status

Pobiera postęp operacji utraty danych partycji rozpoczętej przy użyciu interfejsu API StartDataLoss.

Pobiera postęp operacji utraty danych rozpoczętej z wartością StartDataLoss przy użyciu identyfikatora OperationId.

Argumenty

Argument	opis
--operation-id [Wymagane]	Identyfikator GUID identyfikujący wywołanie tego interfejsu API. Jest on przekazywany do odpowiedniego interfejsu API getProgress.
--partition-id [Wymagane]	Tożsamość partycji.
--service-id [Wymagane]	Tożsamość usługi. Ten identyfikator jest zazwyczaj pełną nazwą usługi bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa usługi to "fabric:/myapp/app1/svc1", tożsamość usługi to "myapp~app1~svc1" w wersji 6.0+ i "myapp/app1/svc1" w poprzednich wersjach.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

kondycja partycji sfctl

Pobiera kondycję określonej partycji usługi Service Fabric.

Użyj elementu EventsHealthStateFilter, aby filtrować kolekcję zdarzeń kondycji zgłoszonych w usłudze na podstawie stanu kondycji. Użyj replicasHealthStateFilter, aby filtrować kolekcję obiektów ReplicaHealthState na partycji. Jeśli określisz partycję, która nie istnieje w magazynie kondycji, to żądanie zwróci błąd.

Argumenty

Argument	opis
--partition-id [Wymagane]	Tożsamość partycji.
--events-health-state-filter	Umożliwia filtrowanie kolekcji obiektów HealthEvent zwracanych na podstawie stanu kondycji. Możliwe wartości tego parametru obejmują wartość całkowitą jednego z następujących stanów kondycji. Zwracane są tylko zdarzenia zgodne z filtrem. Wszystkie zdarzenia są używane do oceny zagregowanego stanu kondycji. Jeśli nie zostanie określony, zwracane są wszystkie wpisy. Wartości stanu to wyliczenie oparte na flagach, więc wartość może być kombinacją tych wartości uzyskanych przy użyciu operatora bitowego OR. Jeśli na przykład podana wartość to 6, zwracane są wszystkie zdarzenia z wartością HealthState ok (2) i Ostrzeżenie (4). - Wartość domyślna — wartość domyślna. Pasuje do dowolnego stanu kondycji. Wartość jest równa zero. - Brak — filtr, który nie jest zgodny z żadną wartością HealthState. Służy do zwracania żadnych wyników w danej kolekcji stanów. Wartość to 1. - Ok — filtr zgodny z danymi wejściowymi z wartością HealthState ok. Wartość to 2. - Ostrzeżenie — filtr zgodny z danymi wejściowymi z wartością HealthState Ostrzeżenie. Wartość to 4. - Błąd — filtr zgodny z danymi wejściowymi z wartością HealthState Error. Wartość to 8. - Wszystkie — filtr, który pasuje do danych wejściowych z dowolną wartością HealthState. Wartość to 65535.
--exclude-health-statistics	Wskazuje, czy statystyki kondycji powinny być zwracane w ramach wyniku zapytania. Wartość false domyślnie. Statystyki pokazują liczbę jednostek podrzędnych w stanie kondycji Ok, Ostrzeżenie i Błąd.
--replicas-health-state-filter	Umożliwia filtrowanie kolekcji obiektów ReplicaHealthState na partycji. Wartość można uzyskać z elementów członkowskich lub operacji bitowych na elementach członkowskich HealthStateFilter. Zostaną zwrócone tylko repliki zgodne z filtrem. Wszystkie repliki będą używane do oceny zagregowanego stanu kondycji. Jeśli nie zostanie określony, zostaną zwrócone wszystkie wpisy. Wartości stanu to wyliczenie oparte na flagach, więc wartość może być kombinacją tych wartości uzyskanych przy użyciu operatora bitowego "OR". Jeśli na przykład podana wartość to 6, zostaną zwrócone wszystkie zdarzenia z wartością HealthState OK (2) i Ostrzeżenie (4). Możliwe wartości tego parametru obejmują wartość całkowitą jednego z następujących stanów kondycji. - Wartość domyślna — wartość domyślna. Pasuje do dowolnego stanu kondycji. Wartość jest równa zero. - Brak — filtr, który nie jest zgodny z żadną wartością HealthState. Służy do zwracania żadnych wyników w danej kolekcji stanów. Wartość to 1. - Ok — filtr zgodny z danymi wejściowymi z wartością HealthState ok. Wartość to 2. - Ostrzeżenie — filtr zgodny z danymi wejściowymi z wartością HealthState Ostrzeżenie. Wartość to 4. - Błąd — filtr zgodny z danymi wejściowymi z wartością HealthState Error. Wartość to 8. - Wszystkie — filtr, który pasuje do danych wejściowych z dowolną wartością HealthState. Wartość to 65535.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

sfctl partition info

Pobiera informacje o partycji usługi Service Fabric.

Pobiera informacje o określonej partycji. Odpowiedź zawiera identyfikator partycji, informacje o schemacie partycjonowania, klucze obsługiwane przez partycję, stan, kondycję i inne szczegóły dotyczące partycji.

Argumenty

Argument	opis
--partition-id [Wymagane]	Tożsamość partycji.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

sfctl partition list

Pobiera listę partycji usługi Service Fabric.

Odpowiedź zawiera identyfikator partycji, informacje o schemacie partycjonowania, klucze obsługiwane przez partycję, stan, kondycję i inne szczegóły dotyczące partycji.

Argumenty

Argument	opis
--service-id [Wymagane]	Tożsamość usługi. Ten identyfikator jest zazwyczaj pełną nazwą usługi bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa usługi to "fabric:/myapp/app1/svc1", tożsamość usługi to "myapp~app1~svc1" w wersji 6.0+ i "myapp/app1/svc1" w poprzednich wersjach.
--continuation-token	Parametr tokenu kontynuacji służy do uzyskiwania następnego zestawu wyników. Token kontynuacji z niepustą wartością jest uwzględniany w odpowiedzi interfejsu API, gdy wyniki z systemu nie mieszczą się w jednej odpowiedzi. Po przekazaniu tej wartości do następnego wywołania interfejsu API interfejs API zwraca następny zestaw wyników. Jeśli nie ma dalszych wyników, token kontynuacji nie zawiera wartości. Wartość tego parametru nie powinna być zakodowana pod adresem URL.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

ładowanie partycji sfctl

Pobiera informacje o obciążeniu określonej partycji usługi Service Fabric.

Zwraca informacje o obciążeniu określonej partycji. Odpowiedź zawiera listę raportów ładowania partycji usługi Service Fabric. Każdy raport zawiera nazwę, wartość i ostatni zgłoszony czas metryki ładowania w formacie UTC.

Argumenty

Argument	opis
--partition-id [Wymagane]	Tożsamość partycji.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

sfctl partition load-reset

Resetuje bieżące obciążenie partycji usługi Service Fabric.

Resetuje bieżące obciążenie partycji usługi Service Fabric do domyślnego ładowania dla usługi.

Argumenty

Argument	opis
--partition-id [Wymagane]	Tożsamość partycji.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

sfctl partition quorum-loss

Wywołuje utratę kworum dla danej partycji usługi stanowej.

Ten interfejs API jest przydatny w przypadku tymczasowej sytuacji utraty kworum w usłudze. Wywołaj interfejs API GetQuorumLossProgress za pomocą tego samego identyfikatora OperationId, aby zwrócić informacje na temat operacji rozpoczętej z tym interfejsem API. Można to wywołać tylko na stanowych usługach utrwalone (HasPersistedState==true). Nie należy używać tego interfejsu API w przypadku usług bezstanowych ani stanowych usług tylko w pamięci.

Argumenty

Argument	opis
--operation-id [Wymagane]	Identyfikator GUID identyfikujący wywołanie tego interfejsu API. Jest on przekazywany do odpowiedniego interfejsu API getProgress.
--partition-id [Wymagane]	Tożsamość partycji.
--kworum-loss-duration [Wymagane]	Ilość czasu, przez który partycja będzie przechowywana w utracie kworum. Należy to określić w sekundach.
--quorum-loss-mode [Wymagane]	To wyliczenie jest przekazywane do interfejsu API StartQuorumLoss, aby wskazać typ utraty kworum do wywołania.
--service-id [Wymagane]	Tożsamość usługi. Ten identyfikator jest zazwyczaj pełną nazwą usługi bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa usługi to "fabric:/myapp/app1/svc1", tożsamość usługi to "myapp~app1~svc1" w wersji 6.0+ i "myapp/app1/svc1" w poprzednich wersjach.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

sfctl partition quorum-loss-status

Pobiera postęp operacji utraty kworum na partycji rozpoczętej przy użyciu interfejsu API StartQuorumLoss.

Pobiera postęp operacji utraty kworum rozpoczętej z wartością StartQuorumLoss przy użyciu podanego identyfikatora OperationId.

Argumenty

Argument	opis
--operation-id [Wymagane]	Identyfikator GUID identyfikujący wywołanie tego interfejsu API. Jest on przekazywany do odpowiedniego interfejsu API getProgress.
--partition-id [Wymagane]	Tożsamość partycji.
--service-id [Wymagane]	Tożsamość usługi. Ten identyfikator jest zazwyczaj pełną nazwą usługi bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa usługi to "fabric:/myapp/app1/svc1", tożsamość usługi to "myapp~app1~svc1" w wersji 6.0+ i "myapp/app1/svc1" w poprzednich wersjach.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

odzyskiwanie partycji sfctl

Wskazuje klaster usługi Service Fabric, który powinien spróbować odzyskać określoną partycję, która jest obecnie zablokowana w utracie kworum.

Tę operację należy wykonać tylko wtedy, gdy wiadomo, że nie można odzyskać replik, które nie działają. Nieprawidłowe użycie tego interfejsu API może spowodować potencjalną utratę danych.

Argumenty

Argument	opis
--partition-id [Wymagane]	Tożsamość partycji.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

sfctl partition recover-all

Wskazuje klaster usługi Service Fabric, który powinien spróbować odzyskać wszystkie usługi (w tym usługi systemowe), które są obecnie zablokowane w utracie kworum.

Tę operację należy wykonać tylko wtedy, gdy wiadomo, że nie można odzyskać replik, które nie działają. Nieprawidłowe użycie tego interfejsu API może spowodować potencjalną utratę danych.

Argumenty

Argument	opis
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

sfctl partition report-health

Wysyła raport o kondycji partycji usługi Service Fabric.

Zgłasza stan kondycji określonej partycji usługi Service Fabric. Raport musi zawierać informacje o źródle raportu o kondycji i właściwości, na której jest raportowany. Raport jest wysyłany do partycji bramy usługi Service Fabric, która przekazuje do magazynu kondycji. Raport może zostać zaakceptowany przez bramę, ale odrzucony przez magazyn kondycji po dodatkowej weryfikacji. Na przykład magazyn kondycji może odrzucić raport z powodu nieprawidłowego parametru, takiego jak nieaktualny numer sekwencji. Aby sprawdzić, czy raport został zastosowany w magazynie kondycji, sprawdź, czy raport jest wyświetlany w sekcji zdarzeń.

Argumenty

Argument	opis
--health-property [Required]	Właściwość informacji o kondycji. Jednostka może mieć raporty o kondycji dla różnych właściwości. Właściwość jest ciągiem, a nie stałym wyliczeniem, aby umożliwić reporterowi elastyczne kategoryzowanie warunku stanu wyzwalającego raport. Na przykład reporter o identyfikatorze SourceId "LocalWatchdog" może monitorować stan dostępnego dysku w węźle, dzięki czemu może zgłaszać właściwość "AvailableDisk" w tym węźle. Ten sam reporter może monitorować łączność węzła, dzięki czemu może zgłosić właściwość "Łączność" w tym samym węźle. W magazynie kondycji te raporty są traktowane jako oddzielne zdarzenia kondycji dla określonego węzła. Wraz z identyfikatorem SourceId właściwość jednoznacznie identyfikuje informacje o kondycji.
--health-state [Wymagane]	Możliwe wartości to: "Invalid", "Ok", "Warning", "Error", "Unknown".
--partition-id [Wymagane]	Tożsamość partycji.
--source-id [Wymagane]	Nazwa źródłowa identyfikująca składnik client/watchdog/system, który wygenerował informacje o kondycji.
--opis	Opis informacji o kondycji. Reprezentuje on dowolny tekst używany do dodawania czytelnych informacji o raporcie. Maksymalna długość ciągu opisu wynosi 4096 znaków. Jeśli podany ciąg będzie dłuższy, zostanie on automatycznie obcięty. Po obcięciu ostatnie znaki opisu zawierają znacznik "[Obcięte]", a łączny rozmiar ciągu to 4096 znaków. Obecność znacznika wskazuje użytkownikom, że wystąpił obcięcie. Pamiętaj, że po obcięciu opis zawiera mniej niż 4096 znaków z oryginalnego ciągu.
--bezpośredni	Flaga wskazująca, czy raport powinien być wysyłany natychmiast. Raport kondycji jest wysyłany do aplikacji bramy usługi Service Fabric, która przekazuje do magazynu kondycji. Jeśli ustawienie Natychmiastowe ma wartość true, raport jest wysyłany natychmiast z bramy HTTP do magazynu kondycji, niezależnie od ustawień klienta sieci szkieletowej używanych przez aplikację usługi HTTP Gateway. Jest to przydatne w przypadku raportów krytycznych, które powinny być wysyłane tak szybko, jak to możliwe. W zależności od czasu i innych warunków wysyłanie raportu może nadal zakończyć się niepowodzeniem, na przykład jeśli brama HTTP jest zamknięta lub komunikat nie dociera do bramy. Jeśli ustawienie Natychmiastowe ma wartość false, raport jest wysyłany na podstawie ustawień klienta kondycji z bramy HTTP. W związku z tym zostanie ona wsadowa zgodnie z konfiguracją HealthReportSendInterval. Jest to zalecane ustawienie, ponieważ umożliwia klientowi kondycji optymalizowanie komunikatów raportowania kondycji do magazynu kondycji oraz przetwarzania raportów o kondycji. Domyślnie raporty nie są wysyłane natychmiast.
--remove-when-expired	Wartość wskazująca, czy raport jest usuwany z magazynu kondycji po wygaśnięciu. W przypadku ustawienia wartości true raport zostanie usunięty z magazynu kondycji po wygaśnięciu. Jeśli ustawiono wartość false, raport jest traktowany jako błąd po wygaśnięciu. Wartość tej właściwości jest domyślnie fałsz. W przypadku okresowego raportowania klientów należy ustawić wartość RemoveWhenExpired false (wartość domyślna). W ten sposób reporter ma problemy (np. zakleszczenie) i nie może zgłosić, jednostka jest oceniana z powodu błędu po wygaśnięciu raportu kondycji. Oznacza to, że jednostka jest w stanie Kondycja błędu.
--sequence-number	Numer sekwencji tego raportu kondycji jako ciąg liczbowy. Numer sekwencji raportów jest używany przez magazyn kondycji do wykrywania nieaktualnych raportów. Jeśli nie zostanie określony, numer sekwencji jest generowany automatycznie przez klienta kondycji po dodaniu raportu.
--timeout -t	Wartość domyślna: 60.
--Ttl	Czas trwania, dla którego ten raport o kondycji jest prawidłowy. To pole używa formatu ISO8601 do określania czasu trwania. Gdy klienci będą okresowo raportować, powinni wysyłać raporty o wyższej częstotliwości niż czas wygaśnięcia. Jeśli klienci raportują o przejściu, mogą ustawić czas wygaśnięcia na nieskończoność. Po wygaśnięciu czasu wygaśnięcia zdarzenie kondycji zawierające informacje o kondycji zostanie usunięte ze sklepu kondycji, jeśli wartość RemoveWhenExpired ma wartość true lub zostanie obliczona w przypadku błędu, jeśli element RemoveWhenExpired ma wartość false. Jeśli nie zostanie określony, czas wygaśnięcia domyślnie ma wartość nieskończoną.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

ponowne uruchomienie partycji sfctl

Ten interfejs API uruchomi ponownie niektóre lub wszystkie repliki lub wystąpienia określonej partycji.

Ten interfejs API jest przydatny do testowania trybu failover. Jeśli jest używana do określania lokalizacji docelowej partycji usługi bezstanowej, parametr RestartPartitionMode musi mieć wartość AllReplicasOrInstances. Wywołaj interfejs API GetPartitionRestartProgress przy użyciu tego samego identyfikatora OperationId, aby uzyskać postęp.

Argumenty

Argument	opis
--operation-id [Wymagane]	Identyfikator GUID identyfikujący wywołanie tego interfejsu API. Jest on przekazywany do odpowiedniego interfejsu API getProgress.
--partition-id [Wymagane]	Tożsamość partycji.
--restart-partition-mode [Wymagane]	Opisz partycje do ponownego uruchomienia.
--service-id [Wymagane]	Tożsamość usługi. Ten identyfikator jest zazwyczaj pełną nazwą usługi bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa usługi to "fabric:/myapp/app1/svc1", tożsamość usługi to "myapp~app1~svc1" w wersji 6.0+ i "myapp/app1/svc1" w poprzednich wersjach.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

sfctl partition restart-status

Pobiera postęp operacji PartitionRestart rozpoczętej przy użyciu polecenia StartPartitionRestart.

Pobiera postęp metody PartitionRestart rozpoczętej z startpartitionRestart przy użyciu podanego identyfikatora OperationId.

Argumenty

Argument	opis
--operation-id [Wymagane]	Identyfikator GUID identyfikujący wywołanie tego interfejsu API. Jest on przekazywany do odpowiedniego interfejsu API getProgress.
--partition-id [Wymagane]	Tożsamość partycji.
--service-id [Wymagane]	Tożsamość usługi. Ten identyfikator jest zazwyczaj pełną nazwą usługi bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa usługi to "fabric:/myapp/app1/svc1", tożsamość usługi to "myapp~app1~svc1" w wersji 6.0+ i "myapp/app1/svc1" w poprzednich wersjach.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

sfctl partition svc-name

Pobiera nazwę usługi Service Fabric dla partycji.

Pobiera nazwę usługi dla określonej partycji. Zwracany jest błąd 404, jeśli identyfikator partycji nie istnieje w klastrze.

Argumenty

Argument	opis
--partition-id [Wymagane]	Tożsamość partycji.
--timeout -t	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. Wartość domyślna: 60.

Argumenty globalne

Argument	opis
--debugować	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Pokaż ten komunikat pomocy i zakończ pracę.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json.
--zapytanie	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--gadatliwy	Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Następne kroki

• Skonfiguruj interfejs wiersza polecenia usługi Service Fabric.
• Dowiedz się, jak używać interfejsu wiersza polecenia usługi Service Fabric przy użyciu przykładowych skryptów.