sfctl partition
Dotazování a správa oddílů pro libovolnou službu
Příkazy
Příkaz | Popis |
---|---|
ztráta dat | Toto rozhraní API vyvolá ztrátu dat pro zadaný oddíl. |
stav ztráty dat | Načte průběh operace ztráty dat oddílu pomocí rozhraní StartDataLoss API. |
zdravotnictví | Získá stav zadaného oddílu Service Fabric. |
informace | Získá informace o oddílu Service Fabric. |
list | Získá seznam oddílů služby Service Fabric. |
načítání | Získá informace o načtení zadaného oddílu Service Fabric. |
load-reset | Obnoví aktuální zatížení oddílu Service Fabric. |
ztráta kvora | Indukuje ztrátu kvora pro daný oddíl stavové služby. |
stav kvora-ztráta | Získá průběh operace ztráty kvora v oddílu, který začal používat rozhraní API StartQuorumLoss. |
obnovit | Označuje cluster Service Fabric, že by se měl pokusit obnovit konkrétní oddíl, který je aktuálně zablokovaný při ztrátě kvora. |
obnovit vše | Označuje cluster Service Fabric, že by se měl pokusit obnovit všechny služby (včetně systémových služeb), které jsou aktuálně zablokované při ztrátě kvora. |
stav sestavy | Odešle zprávu o stavu v oddílu Service Fabric. |
restart | Toto rozhraní API restartuje některé nebo všechny repliky nebo instance zadaného oddílu. |
restart-status | Získá průběh operace PartitionRestart spuštěn pomocí StartPartitionRestart. |
svc-name | Získá název služby Service Fabric pro oddíl. |
sfctl partition data-loss
Toto rozhraní API vyvolá ztrátu dat pro zadaný oddíl.
Aktivuje volání rozhraní API OnDataLossAsync oddílu. Toto rozhraní API vyvolá ztrátu dat pro zadaný oddíl. Aktivuje volání rozhraní API OnDataLoss oddílu. Skutečná ztráta dat bude záviset na zadaném modulu DataLossMode.
- PartialDataLoss: Odeberou se pouze kvorum replik a onDataLoss se aktivuje pro oddíl, ale skutečná ztráta dat závisí na přítomnosti replikace v letu.
- FullDataLoss: Všechny repliky se odeberou, takže se ztratí všechna data a aktivuje se onDataLoss. Toto rozhraní API by se mělo volat pouze se stavovou službou jako cílem. Volání tohoto rozhraní API se systémovou službou, protože cíl se nedoporučuje.
Poznámka:
Po zavolání tohoto rozhraní API se nedá vrátit zpět. Volání Funkce CancelOperation zastaví pouze provádění a vyčistí stav interního systému. Pokud příkaz dostatečně pokročil, nebude data obnovovat, aby způsobil ztrátu dat. Voláním rozhraní GetDataLossProgress API se stejným ID operace vrátíte informace o operaci spuštěné s tímto rozhraním API.
Argumenty
Argument | Popis |
---|---|
--data-loss-mode [Povinné] | Tento výčet se předá rozhraní API StartDataLoss, které indikuje, jaký typ ztráty dat má vyvolat. |
--operation-id [Povinné] | Identifikátor GUID, který identifikuje volání tohoto rozhraní API. To se předá do odpovídajícího rozhraní GetProgress API. |
--partition-id [Povinné] | Identita oddílu. |
--service-id [Povinné] | Identita služby. Toto ID je obvykle úplný název služby bez schématu URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem ~. Pokud je například název služby fabric:/myapp/app1/svc1, identita služby by byla "myapp~app1~svc1" ve verzi 6.0+ a "myapp/app1/svc1" v předchozích verzích. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition data-loss-status
Načte průběh operace ztráty dat oddílu pomocí rozhraní StartDataLoss API.
Získá průběh operace ztráty dat spuštěna s StartDataLoss pomocí OperationId.
Argumenty
Argument | Popis |
---|---|
--operation-id [Povinné] | Identifikátor GUID, který identifikuje volání tohoto rozhraní API. To se předá do odpovídajícího rozhraní GetProgress API. |
--partition-id [Povinné] | Identita oddílu. |
--service-id [Povinné] | Identita služby. Toto ID je obvykle úplný název služby bez schématu URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem ~. Pokud je například název služby fabric:/myapp/app1/svc1, identita služby by byla "myapp~app1~svc1" ve verzi 6.0+ a "myapp/app1/svc1" v předchozích verzích. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition health
Získá stav zadaného oddílu Service Fabric.
Pomocí eventsHealthStateFilter můžete filtrovat kolekci událostí stavu hlášených ve službě na základě stavu. Pomocí ReplicasHealthStateFilter vyfiltrujte kolekci objektů ReplicaHealthState v oddílu. Pokud zadáte oddíl, který v úložišti stavu neexistuje, tento požadavek vrátí chybu.
Argumenty
Argument | Popis |
---|---|
--partition-id [Povinné] | Identita oddílu. |
--events-health-state-filter | Umožňuje filtrovat kolekci objektů HealthEvent vrácených na základě stavu. Možné hodnoty pro tento parametr zahrnují celočíselnou hodnotu jednoho z následujících stavů. Vrátí se pouze události, které odpovídají filtru. Všechny události se používají k vyhodnocení agregovaného stavu. Pokud není zadáno, vrátí se všechny položky. Hodnoty stavu jsou výčty založené na příznaku, takže hodnota by mohla být kombinací těchto hodnot, získaná pomocí bitového operátoru OR. Pokud je zadaná hodnota například 6, vrátí se všechny události s hodnotou HealthState OK (2) a Warning (4). - Výchozí – Výchozí hodnota. Odpovídá stavu. Hodnota je nula. – Žádné – Filtr, který neodpovídá žádné hodnotě HealthState. Slouží k vrácení žádných výsledků pro danou kolekci stavů. Hodnota je 1. - OK - Filtr, který odpovídá vstupu s hodnotou HealthState OK. Hodnota je 2. - Upozornění – Filtr, který odpovídá vstupu s hodnotou HealthState Warning. Hodnota je 4. - Chyba – Filtr, který odpovídá vstupu s hodnotou HealthState Error. Hodnota je 8. - Vše – Filtr, který odpovídá vstupu s libovolnou hodnotou HealthState. Hodnota je 65535. |
--exclude-health-statistics | Určuje, jestli se má statistika stavu vrátit jako součást výsledku dotazu. Ve výchozím nastavení je false. Statistika zobrazuje počet podřízených entit ve stavu OK, Upozornění a Chyba. |
--replicas-health-state-filter | Umožňuje filtrovat kolekci objektů ReplicaHealthState v oddílu. Hodnotu lze získat ze členů nebo bitové operace u členů HealthStateFilter. Vrátí se pouze repliky, které odpovídají filtru. Všechny repliky se použijí k vyhodnocení agregovaného stavu. Pokud není zadáno, vrátí se všechny položky. Hodnoty stavu jsou výčty založené na příznaku, takže hodnota může být kombinací těchto hodnot získaných pomocí bitového operátoru OR. Pokud je zadaná hodnota například 6, vrátí se všechny události s hodnotou HealthState OK (2) a Warning (4). Možné hodnoty pro tento parametr zahrnují celočíselnou hodnotu jednoho z následujících stavů. - Výchozí – Výchozí hodnota. Odpovídá stavu. Hodnota je nula. – Žádné – Filtr, který neodpovídá žádné hodnotě HealthState. Slouží k vrácení žádných výsledků pro danou kolekci stavů. Hodnota je 1. - OK - Filtr, který odpovídá vstupu s hodnotou HealthState OK. Hodnota je 2. - Upozornění – Filtr, který odpovídá vstupu s hodnotou HealthState Warning. Hodnota je 4. - Chyba – Filtr, který odpovídá vstupu s hodnotou HealthState Error. Hodnota je 8. - Vše – Filtr, který odpovídá vstupu s libovolnou hodnotou HealthState. Hodnota je 65535. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition info
Získá informace o oddílu Service Fabric.
Získá informace o zadaném oddílu. Odpověď zahrnuje ID oddílu, informace o schématu dělení, klíče podporované oddílem, stav, stav a další podrobnosti o oddílu.
Argumenty
Argument | Popis |
---|---|
--partition-id [Povinné] | Identita oddílu. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
seznam oddílů sfctl
Získá seznam oddílů služby Service Fabric.
Odpověď zahrnuje ID oddílu, informace o schématu dělení, klíče podporované oddílem, stav, stav a další podrobnosti o oddílu.
Argumenty
Argument | Popis |
---|---|
--service-id [Povinné] | Identita služby. Toto ID je obvykle úplný název služby bez schématu URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem ~. Pokud je například název služby fabric:/myapp/app1/svc1, identita služby by byla "myapp~app1~svc1" ve verzi 6.0+ a "myapp/app1/svc1" v předchozích verzích. |
--continuation-token | Parametr tokenu pokračování slouží k získání další sady výsledků. Token pro pokračování s neprázdnou hodnotou se zahrne do odpovědi rozhraní API, když se výsledky ze systému nevejdou do jedné odpovědi. Když se tato hodnota předá dalšímu volání rozhraní API, vrátí rozhraní API další sadu výsledků. Pokud neexistují žádné další výsledky, token pokračování neobsahuje hodnotu. Hodnota tohoto parametru by neměla být zakódovaná adresou URL. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition load
Získá informace o načtení zadaného oddílu Service Fabric.
Vrátí informace o zatížení zadaného oddílu. Odpověď obsahuje seznam sestav načítání pro oddíl Service Fabric. Každá sestava obsahuje název metriky načítání, hodnotu a čas posledního nahlášení v UTC.
Argumenty
Argument | Popis |
---|---|
--partition-id [Povinné] | Identita oddílu. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition load-reset
Obnoví aktuální zatížení oddílu Service Fabric.
Obnoví aktuální zatížení oddílu Service Fabric na výchozí zatížení služby.
Argumenty
Argument | Popis |
---|---|
--partition-id [Povinné] | Identita oddílu. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition quorum-loss
Indukuje ztrátu kvora pro daný oddíl stavové služby.
Toto rozhraní API je užitečné pro dočasnou situaci ztráty kvora ve vaší službě. Voláním rozhraní GetQuorumLossProgress API se stejným ID operace vrátíte informace o operaci spuštěné s tímto rozhraním API. To lze volat pouze u stavových trvalých služeb (HasPersistedState==true). Toto rozhraní API nepoužívejte pro bezstavové služby ani stavové služby pouze v paměti.
Argumenty
Argument | Popis |
---|---|
--operation-id [Povinné] | Identifikátor GUID, který identifikuje volání tohoto rozhraní API. To se předá do odpovídajícího rozhraní GetProgress API. |
--partition-id [Povinné] | Identita oddílu. |
--kvorum-ztráta-doba trvání [Povinné] | Doba, po kterou se oddíl bude uchovávat ve ztrátě kvora. To musí být zadáno v sekundách. |
--kvorum-loss-mode [Povinné] | Tento výčet se předá rozhraní API StartQuorumLoss, které indikuje, jaký typ ztráty kvora má vyvolat. |
--service-id [Povinné] | Identita služby. Toto ID je obvykle úplný název služby bez schématu URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem ~. Pokud je například název služby fabric:/myapp/app1/svc1, identita služby by byla "myapp~app1~svc1" ve verzi 6.0+ a "myapp/app1/svc1" v předchozích verzích. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition quorum-loss-status
Získá průběh operace ztráty kvora v oddílu, který začal používat rozhraní API StartQuorumLoss.
Získá průběh operace ztráty kvora spuštěna s StartQuorumLoss pomocí poskytnuté OperationId.
Argumenty
Argument | Popis |
---|---|
--operation-id [Povinné] | Identifikátor GUID, který identifikuje volání tohoto rozhraní API. To se předá do odpovídajícího rozhraní GetProgress API. |
--partition-id [Povinné] | Identita oddílu. |
--service-id [Povinné] | Identita služby. Toto ID je obvykle úplný název služby bez schématu URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem ~. Pokud je například název služby fabric:/myapp/app1/svc1, identita služby by byla "myapp~app1~svc1" ve verzi 6.0+ a "myapp/app1/svc1" v předchozích verzích. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
obnovení oddílu sfctl
Označuje cluster Service Fabric, že by se měl pokusit obnovit konkrétní oddíl, který je aktuálně zablokovaný při ztrátě kvora.
Tato operace by se měla provést pouze v případě, že je známo, že repliky, které jsou vypnuté, nelze obnovit. Nesprávné použití tohoto rozhraní API může způsobit potenciální ztrátu dat.
Argumenty
Argument | Popis |
---|---|
--partition-id [Povinné] | Identita oddílu. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition recover-all
Označuje cluster Service Fabric, že by se měl pokusit obnovit všechny služby (včetně systémových služeb), které jsou aktuálně zablokované při ztrátě kvora.
Tato operace by se měla provést pouze v případě, že je známo, že repliky, které jsou vypnuté, nelze obnovit. Nesprávné použití tohoto rozhraní API může způsobit potenciální ztrátu dat.
Argumenty
Argument | Popis |
---|---|
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition report-health
Odešle zprávu o stavu v oddílu Service Fabric.
Zaznamenává stav zadaného oddílu Service Fabric. Sestava musí obsahovat informace o zdroji sestavy stavu a vlastnosti, na které je hlášena. Sestava se odešle do oddílu brány Service Fabric, který se předá do úložiště stavu. Sestavu může brána přijmout, ale po dodatečném ověření ji odmítne úložiště stavu. Úložiště stavu může například odmítnout sestavu kvůli neplatnému parametru, jako je zastaralé pořadové číslo. Pokud chcete zjistit, jestli se sestava použila v úložišti stavu, zkontrolujte, jestli se sestava zobrazí v části události.
Argumenty
Argument | Popis |
---|---|
--health-property [Povinné] | Vlastnost informací o stavu. Entita může mít sestavy stavu pro různé vlastnosti. Vlastnost je řetězec, nikoli pevný výčet, který umožňuje flexibilitu reporteru zařadit do kategorií stavovou podmínku, která aktivuje sestavu. Například reportér s Id SourceId "LocalWatchdog" může monitorovat stav dostupného disku na uzlu, takže může na tomto uzlu hlásit vlastnost AvailableDisk. Stejný reportér může monitorovat připojení uzlu, takže může na stejném uzlu hlásit vlastnost Připojení. V úložišti stavu se tyto sestavy považují za samostatné události stavu pro zadaný uzel. Spolu s SourceId vlastnost jedinečně identifikuje informace o stavu. |
--health-state [Povinné] | Mezi možné hodnoty patří: Invalid, Ok, Warning, Error, Unknown. |
--partition-id [Povinné] | Identita oddílu. |
--source-id [Povinné] | Název zdroje identifikující komponentu client/watchdog/system, která vygenerovala informace o stavu. |
--popis | Popis informací o stavu. Představuje bezplatný text, který slouží k přidání čitelných informací o sestavě. Maximální délka řetězce popisu je 4096 znaků. Pokud je zadaný řetězec delší, automaticky se zkrátí. Při zkrácení obsahují poslední znaky popisu značku [Zkrácené]" a celková velikost řetězce je 4096 znaků. Přítomnost značky značí uživatelům, že došlo ke zkrácení. Všimněte si, že po zkrácení má popis méně než 4096 znaků z původního řetězce. |
--bezprostřední | Příznak, který označuje, jestli se má sestava odeslat okamžitě. Sestava stavu se odešle do aplikace služby Service Fabric Gateway, která se předá do úložiště stavu. Pokud je hodnota Immediate nastavená na hodnotu true, sestava se odešle okamžitě ze služby HTTP Gateway do úložiště stavu bez ohledu na nastavení klienta infrastruktury, které aplikace služby HTTP Gateway používá. To je užitečné pro kritické sestavy, které by se měly odesílat co nejdříve. V závislosti na načasování a dalších podmínkách může odesílání sestavy selhat, například pokud je brána HTTP zavřená nebo se zpráva nedosáhne k bráně. Pokud je hodnota Immediate nastavená na hodnotu false, sestava se odešle na základě nastavení klienta stavu z brány HTTP. Proto bude dávková podle konfigurace HealthReportSendInterval. Toto je doporučené nastavení, protože umožňuje klientovi stavu optimalizovat zprávy sestav o stavu do úložiště stavu a zpracování sestav stavu. Ve výchozím nastavení se sestavy neodesílají okamžitě. |
--remove-when-expired | Hodnota, která označuje, jestli je sestava po vypršení platnosti odebrána z úložiště stavu. Pokud je nastavená hodnota true, sestava se po vypršení platnosti odebere z úložiště stavu. Pokud je nastavená hodnota false, sestava se při vypršení platnosti považuje za chybu. Hodnota této vlastnosti je ve výchozím nastavení false. Když klienti pravidelně hlásí, měli by nastavit hodnotu RemoveWhenExpired false (výchozí). To znamená, že reportér má problémy (např. zablokování) a nemůže hlásit, entita se vyhodnocuje při chybě, když vyprší platnost sestavy stavu. Tím se entita označí jako v chybovém stavu. |
--sequence-number | Pořadové číslo pro tuto sestavu stavu jako číselný řetězec. Pořadové číslo sestavy používá úložiště stavu k detekci zastaralých sestav. Pokud není zadáno, klient stavu při přidání sestavy automaticky vygeneruje pořadové číslo. |
--timeout -t | Výchozí hodnota: 60. |
--hodnota ttl | Doba trvání, po kterou je tato zpráva o stavu platná. Toto pole používá pro zadání doby trvání formát ISO8601. Když klienti pravidelně hlásí, měli by odesílat sestavy s vyšší frekvencí, než je čas naživo. Pokud se klienti hlásí při přechodu, můžou nastavit dobu, po kterou se bude žít, na nekonečno. Když vyprší platnost časového limitu, událost stavu obsahující informace o stavu se buď odebere z úložiště stavu, pokud je RemoveWhenExpired true nebo vyhodnocena při chybě, pokud RemoveWhenExpired false. Pokud není zadaný, nastaví se výchozí hodnota času na nekonečnou hodnotu. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition restart
Toto rozhraní API restartuje některé nebo všechny repliky nebo instance zadaného oddílu.
Toto rozhraní API je užitečné pro testování převzetí služeb při selhání. Pokud se používá k cílení na bezstavový oddíl služby, RestartPartitionMode musí být AllReplicasOrInstances. K získání průběhu volejte rozhraní GetPartitionRestartProgress API pomocí stejného ID operace.
Argumenty
Argument | Popis |
---|---|
--operation-id [Povinné] | Identifikátor GUID, který identifikuje volání tohoto rozhraní API. To se předá do odpovídajícího rozhraní GetProgress API. |
--partition-id [Povinné] | Identita oddílu. |
--restart-partition-mode [Povinné] | Popište, které oddíly se mají restartovat. |
--service-id [Povinné] | Identita služby. Toto ID je obvykle úplný název služby bez schématu URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem ~. Pokud je například název služby fabric:/myapp/app1/svc1, identita služby by byla "myapp~app1~svc1" ve verzi 6.0+ a "myapp/app1/svc1" v předchozích verzích. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition restart-status
Získá průběh operace PartitionRestart spuštěn pomocí StartPartitionRestart.
Získá průběh PartitionRestart zahájen s StartPartitionRestart pomocí poskytnuté Id operace.
Argumenty
Argument | Popis |
---|---|
--operation-id [Povinné] | Identifikátor GUID, který identifikuje volání tohoto rozhraní API. To se předá do odpovídajícího rozhraní GetProgress API. |
--partition-id [Povinné] | Identita oddílu. |
--service-id [Povinné] | Identita služby. Toto ID je obvykle úplný název služby bez schématu URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem ~. Pokud je například název služby fabric:/myapp/app1/svc1, identita služby by byla "myapp~app1~svc1" ve verzi 6.0+ a "myapp/app1/svc1" v předchozích verzích. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl partition svc-name
Získá název služby Service Fabric pro oddíl.
Získá název služby pro zadaný oddíl. Pokud ID oddílu v clusteru neexistuje, vrátí se chyba 404.
Argumenty
Argument | Popis |
---|---|
--partition-id [Povinné] | Identita oddílu. |
--timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
Globální argumenty
Argument | Popis |
---|---|
--ladicí | Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. |
--help -h | Zobrazte tuto zprávu nápovědy a ukončete ji. |
--output -o | Výstupní formát Povolené hodnoty: json, jsonc, table, tsv. Výchozí hodnota: json. |
--dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
--užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
Další kroky
- Nastavení rozhraní příkazového řádku Service Fabric
- Naučte se používat Service Fabric CLI pomocí ukázkových skriptů.