sfctl service

Ermöglicht es, Dienste, Diensttypen und Dienstpakete zu erstellen, zu löschen und zu verwalten.

Befehle

Command BESCHREIBUNG
app-name Ruft den Namen der Service Fabric-Anwendung für einen Dienst ab.
code-package-list Ruft die Liste der Codepakete ab, die auf einem Service Fabric-Knoten bereitgestellt werden.
create Erstellt den angegebenen Service Fabric-Dienst.
delete Löscht einen vorhandene Service Fabric-Dienst.
deployed-type Ruft die Informationen zu einem angegebenen Diensttyp der Anwendung ab, die auf einem Knoten in einem Service Fabric-Cluster bereitgestellt wird.
deployed-type-list Ruft die Liste ab, die die Informationen zu den Diensttypen der Anwendungen enthält, die auf einem Knoten in einem Service Fabric-Cluster bereitgestellt werden.
description Ruft die Beschreibung eines vorhandenen Service Fabric-Diensts ab.
get-container-logs Ruft die Containerprotokolle für Container ab, die auf einem Service Fabric-Knoten bereitgestellt wurden.
health Ruft die Integrität des angegebenen Service Fabric-Diensts ab.
info Ruft die Informationen zu dem speziellen Dienst ab, der zur Service Fabric-Anwendung gehört.
list Ruft die Informationen zu allen Diensten ab, die zu der Anwendung gehören, die durch die Anwendungs-ID angegeben ist.
manifest Ruft das Manifest ab, in dem ein Diensttyp beschrieben ist.
package-deploy Lädt Pakete herunter, die dem angegebenen Dienstmanifest im Imagecache auf dem angegebenen Knoten zugeordnet sind.
package-health Ruft die Informationen über die Integrität eines Dienstpakets für eine bestimmte Anwendung ab, die für einen Service Fabric-Knoten und eine Service Fabric-Anwendung bereitgestellt wird.
package-info Ruft die Liste von Dienstpaketen ab, die auf einem Service Fabric-Knoten bereitgestellt werden und genau mit dem angegebenen Namen übereinstimmen.
package-list Ruft die Liste der Dienstpakete ab, die auf einem Service Fabric-Knoten bereitgestellt werden.
recover Veranlasst den Service Fabric-Cluster zu versuchen, den angegebenen Dienst wiederherzustellen, der derzeit in Quorumverlust gebunden ist.
report-health Sendet einen Integritätsbericht zu dem Service Fabric-Dienst.
resolve Löst eine Service Fabric-Partition auf.
type-list Ruft die Liste ab, die die Informationen zu den Diensttypen enthält, die von einem bereitgestellten Anwendungstyp in einem Service Fabric-Cluster unterstützt werden.
aktualisieren Aktualisiert den angegebenen Dienst mithilfe der angegebenen Updatebeschreibung.

sfctl service app-name

Ruft den Namen der Service Fabric-Anwendung für einen Dienst ab.

Ruft den Namen der Anwendung für den angegebenen Dienst ab. Ein 404 FABRIC_E_SERVICE_DOES_NOT_EXIST-Fehler wird zurückgegeben, wenn ein Dienst mit der angegebenen Dienst-ID nicht vorhanden ist.

Argumente

Argument BESCHREIBUNG
--service-id [erforderlich] Die Identität (ID) des Diensts. Diese ID ist üblicherweise der vollständige Name des Diensts ohne das URI-Schema „fabric“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Wenn der Dienstname beispielsweise "fabric:/myapp/app1/svc1" lautet, würde die Dienstidentität in 6.0+ "myapp~app1~svc1" und in früheren Versionen "myapp/app1/svc1" lauten.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service code-package-list

Ruft die Liste der Codepakete ab, die auf einem Service Fabric-Knoten bereitgestellt werden.

Ruft die Liste der Codepakete ab, die auf einem Service Fabric-Knoten für die jeweilige Anwendung bereitgestellt werden.

Argumente

Argument BESCHREIBUNG
--application-id [erforderlich] Die Identität (ID) der Anwendung. Dies ist üblicherweise der vollständige Name der Anwendung ohne das URI-Schema „fabric:“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Hat eine Anwendung beispielsweise den Namen „fabric://meineapp/app1“, hat die Anwendungsidentität in 6.0 und höher den Wert „meineapp~app1“ und in früheren Versionen den Wert „meineapp/app1“.
--node-name [erforderlich] Der Name des Knotens.
--code-package-name Der Name des Codepakets, das im Dienstmanifest angegeben ist, das als Bestandteil eines Anwendungstyps in einem Service Fabric-Cluster registriert ist.
--service-manifest-name Der Name eines Dienstmanifests, das als Bestandteil eines Anwendungstyps in einem Service Fabric-Cluster registriert ist.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service create

Erstellt den angegebenen Service Fabric-Dienst.

Argumente

Argument Beschreibung
--app-id [erforderlich] Die Identität (ID) der Anwendung. Dies ist üblicherweise der vollständige Name der Anwendung ohne das URI-Schema „fabric:“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Hat eine Anwendung beispielsweise den Namen „fabric://meineapp/app1“, hat die Anwendungsidentität in 6.0 und höher den Wert „meineapp~app1“ und in früheren Versionen den Wert „meineapp/app1“.
--name (Erforderlich) Der Name des Diensts. Dies muss ein untergeordnetes Element der Anwendungs-ID sein. Dies ist der vollständige Name einschließlich des URI fabric\:. Beispielsweise ist der Dienst fabric\:/A/B ein untergeordnetes Element der Anwendung fabric\:/A.
--service-type [erforderlich] Den Name des Diensttyps.
--activation-mode Der Aktivierungsmodus für das Dienstpaket.
--constraints Die Platzierungseinschränkungen als Zeichenfolge. Platzierungseinschränkungen sind boolesche Ausdrücke für Knoteneigenschaften und ermöglichen es, einen Dienst entsprechend den Dienstanforderungen auf bestimmte Knoten einzuschränken. Soll ein Dienst z. B. auf Knoten platziert werden, für die Blau als Knotenfarbe (NodeType) festgelegt ist, geben Sie Folgendes an: " NodeColor == blue".
--correlated-service Der Name des Zieldiensts, dem der Dienst zugeordnet werden soll.
--correlation Ordnen Sie den Dienst über eine Ausrichtungsaffinität einem vorhandenen Dienst zu.
--dns-name Der DNS-Name des Diensts, der erstellt werden soll. Für diese Einstellung muss der Service Fabric-DNS-Systemdienst aktiviert sein.
--instance-count Die Anzahl von Instanzen. Dies gilt für nur zustandslose Dienste.
--int-scheme Gibt an, dass der Dienst über einen Bereich von ganzen Zahlen ohne Vorzeichen einheitlich partitioniert werden muss.
--int-scheme-count Die Anzahl von Partitionen, die im Ganzzahlschlüsselbereich erstellt werden sollen, wenn ein einheitliches ganzzahliges Partitionsschemas verwendet wird.
--int-scheme-high Das Ende des Ganzzahlschlüsselbereichs, wenn ein einheitliches ganzzahliges Partitionsschema verwendet wird.
--int-scheme-low Der Anfang des Ganzzahlschlüsselbereichs, wenn ein einheitliches ganzzahliges Partitionsschema verwendet wird.
--load-metrics JSON-codierte Liste der Metriken, die zum knotenübergreifenden Lastenausgleich für Dienste verwendet werden.
--min-replica-set-size Die Mindestgröße der Replikatgruppe als Zahl. Dies gilt nur für zustandsbehaftete Dienste.
--move-cost Gibt die Verschiebungskosten für den Dienst an. Mögliche Werte sind: 'Zero', 'Low', 'Medium', 'High', 'VeryHigh'.
--named-scheme Gibt an, dass der Dienst mehrere benannte Partitionen haben muss.
--named-scheme-list JSON-codierte Liste mit Namen, über die der Dienst partitioniert werden soll, wenn das benannte Partitionsschema verwendet wird.
--no-persisted-state Bei „true“ gibt dieses Argument an, dass der Dienst keinen persistenten Zustand aufweist, der auf dem lokalen Datenträger gespeichert ist, oder den Zustand nur im Arbeitsspeicher speichert.
--placement-policy-list JSON-codierte Liste mit Platzierungsrichtlinien für den Dienst und alle zugehörigen Domänennamen. Richtlinien können aus einer der folgenden Angaben oder deren Kombination bestehenNonPartiallyPlaceServicePreferPrimaryDomain, RequireDomain, RequireDomainDistribution.
--quorum-loss-wait Die maximale Dauer (in Sekunden), für die eine Partition den Zustand für Quorumverlust haben darf. Dies gilt nur für zustandsbehaftete Dienste.
--replica-restart-wait Die Dauer (in Sekunden) zwischen einem Ausfall eines Replikats und dem Erstellen eines neuen Replikats. Dies gilt nur für zustandsbehaftete Dienste.
--scaling-policies JSON-codierte Liste von Skalierungsrichtlinien für diesen Dienst.
--service-placement-time Die Dauer, für die Replikate InBuild bleiben können, bevor gemeldet wird, dass der Build hängt. Dies gilt nur für zustandsbehaftete Dienste.
--singleton-scheme Gibt an, dass der Dienst nur eine einzige Partition haben darf oder ein nicht partitionierter Dienst sein muss.
--stand-by-replica-keep Die maximale Dauer (in Sekunden), für die StandBy-Replikate beibehalten werden, bevor sie entfernt werden. Dies gilt nur für zustandsbehaftete Dienste.
--stateful Gibt an, dass der Dienst ein zustandsbehafteter Dienst ist.
--stateless Gibt an, dass der Dienst ein zustandsloser Dienst ist.
--target-replica-set-size Die Zielgröße der Replikatgruppe als Zahl. Dies gilt nur für zustandsbehaftete Dienste.
--timeout -t Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service delete

Löscht einen vorhandene Service Fabric-Dienst.

Ein Dienst muss erstellt worden sein, bevor er gelöscht werden kann. Service Fabric versucht standardmäßig, Dienstreplikate auf ordnungsgemäße Weise zu schließen und den Dienst dann zu löschen. Wenn es aber Probleme mit dem ordnungsgemäßen Schließen eines Replikats gibt, kann der Löschvorgang sehr lange dauern oder abstürzen. Verwenden Sie das optionale Flag „ForceRemove“, um die ordnungsgemäße Schließsequenz zu überspringen und das Löschen des Diensts zu erzwingen.

Argumente

Argument BESCHREIBUNG
--service-id [erforderlich] Die Identität (ID) des Diensts. Diese ID ist üblicherweise der vollständige Name des Diensts ohne das URI-Schema „fabric“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Wenn der Dienstname beispielsweise "fabric:/myapp/app1/svc1" lautet, würde die Dienstidentität in 6.0+ "myapp~app1~svc1" und in früheren Versionen "myapp/app1/svc1" lauten.
--force-remove Erzwingt ein Entfernen einer Service Fabric-Anwendung oder eines Service Fabric-Diensts, ohne den Ablauf für das ordnungsgemäße Herunterfahren zu durchlaufen. Dieser Parameter kann für ein erzwungenes Löschen einer Anwendung oder eines Diensts verwendet werden, für die oder den beim Löschen ein Timeout aufgetreten ist, weil Probleme im Dienstcode ein ordnungsgemäßes Schließen von Replikaten verhindern.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service deployed-type

Ruft die Informationen zu einem angegebenen Diensttyp der Anwendung ab, die auf einem Knoten in einem Service Fabric-Cluster bereitgestellt wird.

Ruft die Liste ab, die die Informationen zu einem bestimmten Diensttyp der Anwendungen enthält, die auf einem Knoten in einem Service Fabric-Cluster bereitgestellt werden. Die Antwort enthält den Namen des Diensttyps, dessen Registrierungsstatus, das für dessen Registrierung verwendete Codepaket und die Aktivierungs-ID des Dienstpakets. Jeder Eintrag stellt eine Aktivierung eines Diensttyps dar, die durch die Aktivierung-ID unterschieden werden.

Argumente

Argument BESCHREIBUNG
--application-id [erforderlich] Die Identität (ID) der Anwendung. Dies ist üblicherweise der vollständige Name der Anwendung ohne das URI-Schema „fabric:“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Hat eine Anwendung beispielsweise den Namen „fabric://meineapp/app1“, hat die Anwendungsidentität in 6.0 und höher den Wert „meineapp~app1“ und in früheren Versionen den Wert „meineapp/app1“.
--node-name [erforderlich] Der Name des Knotens.
--service-type-name [erforderlich] Gibt den Namen eines Service Fabric-Diensttyps an.
--service-manifest-name Der Name des Dienstmanifests, um die Liste der bereitgestellten Diensttypinformationen zu filtern. Wenn dieser angegeben ist, enthält die Antwort nur die Informationen zu Diensttypen, die in diesem Dienstmanifest definiert sind.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service deployed-type-list

Ruft die Liste ab, die die Informationen zu den Diensttypen der Anwendungen enthält, die auf einem Knoten in einem Service Fabric-Cluster bereitgestellt werden.

Ruft die Liste ab, die die Informationen zu den Diensttypen der Anwendungen enthält, die auf einem Knoten in einem Service Fabric-Cluster bereitgestellt werden. Die Antwort enthält den Namen des Diensttyps, dessen Registrierungsstatus, das für dessen Registrierung verwendete Codepaket und die Aktivierungs-ID des Dienstpakets.

Argumente

Argument BESCHREIBUNG
--application-id [erforderlich] Die Identität (ID) der Anwendung. Dies ist üblicherweise der vollständige Name der Anwendung ohne das URI-Schema „fabric:“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Hat eine Anwendung beispielsweise den Namen „fabric://meineapp/app1“, hat die Anwendungsidentität in 6.0 und höher den Wert „meineapp~app1“ und in früheren Versionen den Wert „meineapp/app1“.
--node-name [erforderlich] Der Name des Knotens.
--service-manifest-name Der Name des Dienstmanifests, um die Liste der bereitgestellten Diensttypinformationen zu filtern. Wenn dieser angegeben ist, enthält die Antwort nur die Informationen zu Diensttypen, die in diesem Dienstmanifest definiert sind.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service description

Ruft die Beschreibung eines vorhandenen Service Fabric-Diensts ab.

Ruft die Beschreibung eines vorhandenen Service Fabric-Diensts ab. Ein Dienst muss erstellt worden sein, bevor seine Beschreibung abgerufen werden kann.

Argumente

Argument BESCHREIBUNG
--service-id [erforderlich] Die Identität (ID) des Diensts. Diese ID ist üblicherweise der vollständige Name des Diensts ohne das URI-Schema „fabric“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Wenn der Dienstname beispielsweise "fabric:/myapp/app1/svc1" lautet, würde die Dienstidentität in 6.0+ "myapp~app1~svc1" und in früheren Versionen "myapp/app1/svc1" lauten.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service get-container-logs

Ruft die Containerprotokolle für Container ab, die auf einem Service Fabric-Knoten bereitgestellt wurden.

Ruft die Containerprotokolle für Container ab, die auf einem Service Fabric-Knoten für das jeweilige Codepaket bereitgestellt wurden.

Argumente

Argument BESCHREIBUNG
--application-id [erforderlich] Die Identität (ID) der Anwendung. Dies ist üblicherweise der vollständige Name der Anwendung ohne das URI-Schema „fabric:“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Hat eine Anwendung beispielsweise den Namen „fabric://meineapp/app1“, hat die Anwendungsidentität in 6.0 und höher den Wert „meineapp~app1“ und in früheren Versionen den Wert „meineapp/app1“.
--code-package-name [erforderlich] Der Name des Codepakets, das im Dienstmanifest angegeben ist, das als Bestandteil eines Anwendungstyps in einem Service Fabric-Cluster registriert ist.
--node-name [erforderlich] Der Name des Knotens.
--service-manifest-name [erforderlich] Der Name eines Dienstmanifests, das als Bestandteil eines Anwendungstyps in einem Service Fabric-Cluster registriert ist.
--previous Gibt an, ob Containerprotokolle von beendeten oder inaktiven Containern der Codepaketinstanz abgerufen werden.
--tail Die Anzahl der Zeilen, die am Ende der Protokolle angezeigt werden sollen. Der Standardwert ist 100. „all“, um die vollständige Protokolle anzuzeigen.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service health

Ruft die Integrität des angegebenen Service Fabric-Diensts ab.

Ruft die Integritätsinformationen des angegebenen Diensts ab. Verwenden Sie „EventsHealthStateFilter“, um die Sammlung der Integritätsereignisse (HealthEvents), die für den Dienst gemeldet wurden, anhand des Integritätsstatus zu filtern. Verwenden Sie „PartitionsHealthStateFilter“, um die zurückgegebene Sammlung von Partitionen zu filtern. Geben Sie einen Dienst an, der nicht im Integritätsspeicher vorhanden ist, gibt diese Anforderung einen Fehler zurück.

Argumente

Argument BESCHREIBUNG
--service-id [erforderlich] Die Identität (ID) des Diensts. Diese ID ist üblicherweise der vollständige Name des Diensts ohne das URI-Schema „fabric“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Wenn der Dienstname beispielsweise "fabric:/myapp/app1/svc1" lautet, würde die Dienstidentität in 6.0+ "myapp~app1~svc1" und in früheren Versionen "myapp/app1/svc1" lauten.
--events-health-state-filter Ermöglicht das Filtern der Collection zurückgegebener HealthEvent-Objekte anhand des Integritätsstatus. Die möglichen Werte für diesen Parameter entsprechen dem jeweiligen ganzzahligen Wert von einem der folgenden Integritätsstatus. Es werden nur Ereignisse zurückgegeben, die dem Filter entsprechen. Alle Ereignisse werden verwendet, um den aggregierten Integritätsstatus auszuwerten. Ist kein Filter angegeben, werden alle Einträge zurückgegeben. Ein Statuswert ist eine flagbasierte Enumeration, sodass der Wert eine Kombination der Werte sein kann, die mit dem bitweisen OR-Operator abgerufen werden. Ist der angegebene Wert beispielsweise gleich „6“, werden alle Ereignisse zurückgegeben, für die „HealthState“ den Wert für OK (2) oder Warnung (4) hat.
– Default: Standardwert. Stimmt mit jedem Integritätsstatus (HealthState) überein. Der Wert ist gleich null.
– None: Filter, der mit keinem Wert für „HealthState“ übereinstimmt. Wird verwendet, um keine Ergebnisse für eine angegebene Statussammlung zurückzugeben. Der Wert ist "1".
– Ok: Filter, der mit Eingaben übereinstimmt, für die „HealthState“ den Wert „Ok“ hat. Der Wert ist "2".
– Warning: Filter, der mit Eingaben übereinstimmt, für die „HealthState“ den Wert „Warning“ hat. Der Wert ist "4".
– Error: Filter, der mit Eingaben übereinstimmt, für die „HealthState“ den Wert „Error“ hat. Der Wert ist gleich „8“.
– All: Filter, der mit Eingaben übereinstimmt, die einen beliebigen Wert für „HealthState“ haben. Der Wert ist gleich „65535“.
--exclude-health-statistics Gibt an, ob die Integritätsstatistiken als Bestandteil des Abfrageergebnisses zurückgegeben werden sollen. Der Standardwert ist gleich „False“. Die Statistiken zeigen die Anzahl von untergeordneten Entitäten, die einen der Integritätszustände „Ok“, „Warning“ oder „Error“ aufweisen.
--partitions-health-state-filter Ermöglicht es, die Partitions-Integritätszustandsobjekte, die im Ergebnis einer Dienstintegritätsabfrage zurückgegeben werden, anhand des Integritätszustands zu filtern. Die möglichen Werte für diesen Parameter entsprechen dem jeweiligen ganzzahligen Wert von einem der folgenden Integritätsstatus. Es werden nur Partitionen zurückgegeben, die dem Filter entsprechen. Alle Partitionen werden verwendet, um den aggregierten Integritätszustand auszuwerten. Ist kein Filter angegeben, werden alle Einträge zurückgegeben. Ein Statuswert ist eine flagbasierte Enumeration, sodass der Wert eine Kombination der Werte sein kann, die mit dem bitweisen OR-Operator abgerufen werden. Ist der angegebene Wert beispielsweise gleich „6“, wird der Integritätszustand von Partitionen zurückgegeben, für die „HealthState“ den Wert „OK (2)“ oder „Warnung (4)“ aufweist.
– Default: Standardwert. Stimmt mit jedem Integritätsstatus (HealthState) überein. Der Wert ist gleich null.
– None: Filter, der mit keinem Wert für „HealthState“ übereinstimmt. Wird verwendet, um keine Ergebnisse für eine angegebene Statussammlung zurückzugeben. Der Wert ist "1".
– Ok: Filter, der mit Eingaben übereinstimmt, für die „HealthState“ den Wert „Ok“ hat. Der Wert ist "2".
– Warning: Filter, der mit Eingaben übereinstimmt, für die „HealthState“ den Wert „Warning“ hat. Der Wert ist "4".
– Error: Filter, der mit Eingaben übereinstimmt, für die „HealthState“ den Wert „Error“ hat. Der Wert ist gleich „8“.
– All: Filter, der mit Eingaben übereinstimmt, die einen beliebigen Wert für „HealthState“ haben. Der Wert ist gleich „65535“.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service info

Ruft die Informationen zu dem speziellen Dienst ab, der zur Service Fabric-Anwendung gehört.

Gibt die Informationen zu dem angegebenen Dienst zurück, der zu der angegebenen Service Fabric-Anwendung gehört.

Argumente

Argument BESCHREIBUNG
--application-id [erforderlich] Die Identität (ID) der Anwendung. Dies ist üblicherweise der vollständige Name der Anwendung ohne das URI-Schema „fabric:“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Hat eine Anwendung beispielsweise den Namen „fabric://meineapp/app1“, hat die Anwendungsidentität in 6.0 und höher den Wert „meineapp~app1“ und in früheren Versionen den Wert „meineapp/app1“.
--service-id [erforderlich] Die Identität (ID) des Diensts. Diese ID ist üblicherweise der vollständige Name des Diensts ohne das URI-Schema „fabric“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Wenn der Dienstname beispielsweise "fabric:/myapp/app1/svc1" lautet, würde die Dienstidentität in 6.0+ "myapp~app1~svc1" und in früheren Versionen "myapp/app1/svc1" lauten.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service list

Ruft die Informationen zu allen Diensten ab, die zu der Anwendung gehören, die durch die Anwendungs-ID angegeben ist.

Gibt die Informationen zu allen Diensten zurück, die zu der Anwendung gehören, die durch die Anwendungs-ID angegeben ist.

Argumente

Argument BESCHREIBUNG
--application-id [erforderlich] Die Identität (ID) der Anwendung. Dies ist üblicherweise der vollständige Name der Anwendung ohne das URI-Schema „fabric:“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Hat eine Anwendung beispielsweise den Namen „fabric://meineapp/app1“, hat die Anwendungsidentität in 6.0 und höher den Wert „meineapp~app1“ und in früheren Versionen den Wert „meineapp/app1“.
--continuation-token Der Parameter „continuation-token“ (Fortsetzungstoken) wird dazu verwendet, den nächsten Satz von Ergebnissen abzurufen. Ein Fortsetzungstoken mit einem nicht leeren Wert wird in die Antwort der API eingefügt, wenn die Ergebnisse aus dem System nicht in eine einzige Antwort passen. Wird dieser Wert an den nächsten API-Aufruf übergeben, gibt die API den nächsten Satz von Ergebnissen zurück. Gibt es keine weiteren Ergebnisse, enthält das Fortsetzungstoken keinen Wert. Der Wert dieses Parameters darf nicht als URL codiert sein.
--service-type-name Der Diensttypname, der zum Filtern der Dienste verwendet wird, die abgefragt werden sollen.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service manifest

Ruft das Manifest ab, in dem ein Diensttyp beschrieben ist.

Ruft das Manifest ab, in dem ein Diensttyp beschrieben ist. Die Antwort enthält den XML-Code des Dienstmanifests als Zeichenfolge.

Argumente

Argument BESCHREIBUNG
--application-type-name [erforderlich] Der Name des Anwendungstyps.
--application-type-version [erforderlich] Die Version des Anwendungstyps.
--service-manifest-name [erforderlich] Der Name eines Dienstmanifests, das als Bestandteil eines Anwendungstyps in einem Service Fabric-Cluster registriert ist.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service package-deploy

Lädt Pakete herunter, die dem angegebenen Dienstmanifest im Imagecache auf dem angegebenen Knoten zugeordnet sind.

Argumente

Argument Beschreibung
--app-type-name [erforderlich] Der Name des Anwendungsmanifests für das entsprechende angeforderte Dienstmanifest.
--app-type-version [erforderlich] Die Version des Anwendungsmanifests für das entsprechende angeforderte Dienstmanifest.
--node-name [erforderlich] Der Name des Knotens.
--service-manifest-name [erforderlich] Der Name des Dienstmanifests, das den herunterzuladenden Paketen zugeordnet ist.
--share-policy JSON-codierte Liste mit Freigaberichtlinien. Jedes Freigaberichtlinienelement besteht aus einem Name- und Scope-Element. Das Name-Element entspricht dem Namen des Code-, Konfigurations- oder Datenpakets, das für die Freigabe bestimmt ist. Das Scope-Element kann entweder „None“, „All“, „Code“, „Config“ oder „Data“ enthalten.
--timeout -t Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service package-health

Ruft die Informationen über die Integrität eines Dienstpakets für eine bestimmte Anwendung ab, die für einen Service Fabric-Knoten und eine Service Fabric-Anwendung bereitgestellt wird.

Ruft die Informationen über die Integrität eines Dienstpakets für eine bestimmte Anwendung ab, die für einen Service Fabric-Knoten bereitgestellt wird. Verwenden Sie EventsHealthStateFilter, um optional basierend auf dem Integritätszustand nach der Sammlung von HealthEvent-Objekten zu filtern, die für das bereitgestellte Dienstpaket gemeldet wurden.

Argumente

Argument BESCHREIBUNG
--application-id [erforderlich] Die Identität (ID) der Anwendung. Dies ist üblicherweise der vollständige Name der Anwendung ohne das URI-Schema „fabric:“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Hat eine Anwendung beispielsweise den Namen „fabric://meineapp/app1“, hat die Anwendungsidentität in 6.0 und höher den Wert „meineapp~app1“ und in früheren Versionen den Wert „meineapp/app1“.
--node-name [erforderlich] Der Name des Knotens.
--service-package-name [erforderlich] Der Name des Dienstpakets.
--events-health-state-filter Ermöglicht das Filtern der Collection zurückgegebener HealthEvent-Objekte anhand des Integritätsstatus. Die möglichen Werte für diesen Parameter entsprechen dem jeweiligen ganzzahligen Wert von einem der folgenden Integritätsstatus. Es werden nur Ereignisse zurückgegeben, die dem Filter entsprechen. Alle Ereignisse werden verwendet, um den aggregierten Integritätsstatus auszuwerten. Ist kein Filter angegeben, werden alle Einträge zurückgegeben. Ein Statuswert ist eine flagbasierte Enumeration, sodass der Wert eine Kombination der Werte sein kann, die mit dem bitweisen OR-Operator abgerufen werden. Ist der angegebene Wert beispielsweise gleich „6“, werden alle Ereignisse zurückgegeben, für die „HealthState“ den Wert für OK (2) oder Warnung (4) hat.
– Default: Standardwert. Stimmt mit jedem Integritätsstatus (HealthState) überein. Der Wert ist gleich null.
– None: Filter, der mit keinem Wert für „HealthState“ übereinstimmt. Wird verwendet, um keine Ergebnisse für eine angegebene Statussammlung zurückzugeben. Der Wert ist "1".
– Ok: Filter, der mit Eingaben übereinstimmt, für die „HealthState“ den Wert „Ok“ hat. Der Wert ist "2".
– Warning: Filter, der mit Eingaben übereinstimmt, für die „HealthState“ den Wert „Warning“ hat. Der Wert ist "4".
– Error: Filter, der mit Eingaben übereinstimmt, für die „HealthState“ den Wert „Error“ hat. Der Wert ist gleich „8“.
– All: Filter, der mit Eingaben übereinstimmt, die einen beliebigen Wert für „HealthState“ haben. Der Wert ist gleich „65535“.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service package-info

Ruft die Liste von Dienstpaketen ab, die auf einem Service Fabric-Knoten bereitgestellt werden und genau mit dem angegebenen Namen übereinstimmen.

Gibt die Informationen zu den Dienstpaketen zurück, die auf einem Service Fabric-Knoten für die jeweilige Anwendung bereitgestellt werden. Diese Ergebnisse sind Teil der Dienstpakete, deren Name genau dem als Parameter angegebenen Dienstpaketnamen entspricht.

Argumente

Argument BESCHREIBUNG
--application-id [erforderlich] Die Identität (ID) der Anwendung. Dies ist üblicherweise der vollständige Name der Anwendung ohne das URI-Schema „fabric:“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Hat eine Anwendung beispielsweise den Namen „fabric://meineapp/app1“, hat die Anwendungsidentität in 6.0 und höher den Wert „meineapp~app1“ und in früheren Versionen den Wert „meineapp/app1“.
--node-name [erforderlich] Der Name des Knotens.
--service-package-name [erforderlich] Der Name des Dienstpakets.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service package-list

Ruft die Liste der Dienstpakete ab, die auf einem Service Fabric-Knoten bereitgestellt werden.

Gibt die Informationen zu den Dienstpaketen zurück, die auf einem Service Fabric-Knoten für die jeweilige Anwendung bereitgestellt werden.

Argumente

Argument BESCHREIBUNG
--application-id [erforderlich] Die Identität (ID) der Anwendung. Dies ist üblicherweise der vollständige Name der Anwendung ohne das URI-Schema „fabric:“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Hat eine Anwendung beispielsweise den Namen „fabric://meineapp/app1“, hat die Anwendungsidentität in 6.0 und höher den Wert „meineapp~app1“ und in früheren Versionen den Wert „meineapp/app1“.
--node-name [erforderlich] Der Name des Knotens.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service recover

Veranlasst den Service Fabric-Cluster zu versuchen, den angegebenen Dienst wiederherzustellen, der derzeit in Quorumverlust gebunden ist.

Veranlasst den Service Fabric-Cluster zu versuchen, den angegebenen Dienst wiederherzustellen, der derzeit in Quorumverlust gebunden ist. Dieser Vorgang sollte nur ausgeführt werden, wenn bekannt ist, dass die Replikate, die ausgefallen sind, nicht wiederhergestellt werden können. Eine falsche Verwendung dieser API kann dazu führen, dass Daten verloren gehen.

Argumente

Argument BESCHREIBUNG
--service-id [erforderlich] Die Identität (ID) des Diensts. Diese ID ist üblicherweise der vollständige Name des Diensts ohne das URI-Schema „fabric“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Wenn der Dienstname beispielsweise "fabric:/myapp/app1/svc1" lautet, würde die Dienstidentität in 6.0+ "myapp~app1~svc1" und in früheren Versionen "myapp/app1/svc1" lauten.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service report-health

Sendet einen Integritätsbericht zu dem Service Fabric-Dienst.

Meldet den Integritätszustand des angegebenen Service Fabric-Diensts. Der Bericht muss die Informationen über die Quelle des Integritätsberichts und die Eigenschaft enthalten, auf die sich der Bericht bezieht. Der Bericht wird an einen Service Fabric-Gatewaydienst gesendet, der diesen an den Integritätsspeicher weiterleitet. Der Bericht wird möglicherweise vom Gateway akzeptiert, aber nach zusätzlicher Überprüfung vom Integritätsspeicher abgelehnt. Beispielsweise kann der Integritätsspeicher den Bericht aufgrund eines ungültigen Parameters wie etwa einer veralteten Sequenznummer ablehnen. Um festzustellen, ob der Bericht im Integritätsspeicher angewendet wurde, überprüfen Sie, ob der Bericht in den Integritätsereignissen des Diensts angezeigt wird.

Argumente

Argument BESCHREIBUNG
--health-property [erforderlich] Die Eigenschaft der Integritätsinformationen.

Eine Entität kann Integritätsberichte für verschiedene Eigenschaften enthalten. Die Eigenschaft ist eine Zeichenfolge und keine feste Enumeration, um dem Reporter Flexibilität zu ermöglichen und entsprechend die Zustandsbedingung zu kategorisieren, die den Bericht auslöst. Beispielsweise kann ein Reporter mit der SourceId „LocalWatchdog“ den Zustand des verfügbaren Datenträgers auf einem Knoten überwachen und folglich die AvailableDisk-Eigenschaft auf diesem Knoten melden. Der gleiche Reporter kann die Knotenkonnektivität überwachen und folglich eine Connectivity-Eigenschaft auf dem gleichen Knoten melden. Im Integritätsspeicher werden diese Berichte als separate Integritätsereignisse für den angegebenen Knoten behandelt. Zusammen mit der SourceId identifiziert die Eigenschaft eindeutig die Integritätsinformationen.
--health-state [erforderlich] Mögliche Werte sind: 'Invalid', 'Ok', 'Warning', 'Error', 'Unknown'.
--service-id [erforderlich] Die Identität (ID) des Diensts.

Dies ist üblicherweise der vollständige Name des Dienstes ohne das URI-Schema 'fabric:'. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Wenn der Dienstname beispielsweise "fabric:/myapp/app1/svc1" lautet, würde die Dienstidentität in 6.0+ "myapp~app1~svc1" und in früheren Versionen "myapp/app1/svc1" lauten.
--source-id [erforderlich] Der Quellenname, der die Client-, Watchdog- oder Systemkomponente identifiziert, die die Integritätsinformationen generiert hat.
--description Die Beschreibung der Integritätsinformationen.

Hierbei handelt es sich um Freitext, mit dem von Menschen lesbare Informationen über den Bericht hinzugefügt werden können. Die maximale Zeichenlänge für die Beschreibung beträgt 4096 Zeichen. Wenn die angegebene Zeichenfolge länger ist, wird sie automatisch abgeschnitten. Wird diese abgeschnitten, enthalten die letzten Zeichen der Beschreibung einen Marker „[abgeschnitten]“, und die gesamte Zeichenfolgenlänge beträgt 4096 Zeichen. Das Vorhandensein des Markers ist ein Hinweis für Benutzer, dass abgeschnittene Zeichenfolgen vorkommen. Beachten Sie, dass die Beschreibung bei abgeschnittenen Zeichenfolgen weniger als 4096 Zeichen von der ursprünglichen Zeichenfolge enthält.
--immediate Ein Flag, das angibt, ob der Bericht sofort gesendet werden soll.

Ein Integritätsbericht wird an eine Service Fabric-Gatewayanwendung gesendet, die diesen an den Integritätsspeicher weiterleitet. Wenn „Immediate“ auf „true“ festgelegt ist, wird der Bericht sofort vom HTTP-Gateway an den Integritätsspeicher gesendet, unabhängig von den Fabric-Clienteinstellungen, die die HTTP-Gatewayanwendung verwendet. Dies ist für kritische Berichte hilfreich, die schnellstmöglich gesendet werden sollen. Abhängig von der zeitlichen Steuerung und anderen Bedingungen können beim Senden des Berichts trotzdem möglicherweise Fehler auftreten, z.B., wenn das HTTP-Gateway geschlossen ist oder die Meldung das Gateway nicht erreicht. Wenn „Immediate“ auf „false“ festgelegt ist, wird der Bericht basierend auf den Integritätsclienteinstellungen vom HTTP-Gateway gesendet. Aus diesem Grund wird der Bericht entsprechend der HealthReportSendInterval-Konfiguration batchweise verarbeitet. Dies ist die empfohlene Einstellung, da der Integritätsclient die Optimierung von Meldungen des Integritätsberichts für den Integritätsspeicher sowie die Verarbeitung von Integritätsberichten ermöglicht. Standardmäßig werden Berichte nicht sofort gesendet.
--remove-when-expired Ein Wert, der angibt, ob der Bericht aus dem Integritätsspeicher entfernt wird, wenn er abläuft.

Wenn dieser Wert auf „true“ festgelegt ist, wird der Bericht aus dem Integritätsspeicher entfernt, nachdem er abgelaufen ist. Wenn dieser Wert auf „false“ festgelegt ist, wird der Bericht als Fehler behandelt, wenn er abgelaufen ist. Der Wert dieser Eigenschaft ist standardmäßig auf „false“ festgelegt. Wenn Clients in regelmäßigen Abständen Berichte erstellen, sollte RemoveWhenExpired auf „false“ (Standardwert) festgelegt sein. Denn falls der Reporter Probleme (z.B. Deadlocks) haben und keine Berichte erstellen können sollte, wird die Entität entsprechend auf Fehler ausgewertet, wenn der Integritätsbericht abläuft. Hierdurch wird die Entität nicht als in einem fehlerhaften Integritätszustand befindlich gekennzeichnet.
--sequence-number Die Sequenznummer für diesen Integritätsbericht als numerische Zeichenfolge.

Die Sequenznummer des Berichts wird vom Integritätsspeicher zur Erkennung veralteter Berichte verwendet. Wenn diese nicht angegeben ist, wird beim Hinzufügen eines Berichts automatisch eine Sequenznummer vom Integritätsclient generiert.
--timeout -t Standardwert: 60.
--ttl Die Dauer, für die dieser Integritätsbericht gültig ist. Bei diesem Feld wird das ISO8601-Format zur Angabe der Dauer verwendet.

Wenn Clients in regelmäßigen Abständen Berichte erstellen, sollten sie Berichte in einem höherer Intervall als die Gültigkeitsdauer senden. Wenn Clients Berichte zur Übertragung erstellen, können sie die Gültigkeitsdauer auf einen unbegrenzten Wert festlegen. Wenn die Gültigkeitsdauer abläuft, wird das Integritätsereignis, das die Integritätsinformationen enthält, entweder aus dem Integritätsspeicher entfernt, sofern RemoveWhenExpired auf „true“ festgelegt ist, oder auf Fehler ausgewertet, sofern RemoveWhenExpired auf „false“ festgelegt ist. Wenn kein Wert angegeben ist, wird die Gültigkeitsdauer standardmäßig auf einen unbegrenzten Wert festgelegt.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service resolve

Löst eine Service Fabric-Partition auf.

Lösen Sie eine Service Fabric-Dienstpartition auf, um die Endpunkte der Dienstreplikate abzurufen.

Argumente

Argument BESCHREIBUNG
--service-id [erforderlich] Die Identität (ID) des Diensts. Diese ID ist üblicherweise der vollständige Name des Diensts ohne das URI-Schema „fabric“. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Wenn der Dienstname beispielsweise "fabric:/myapp/app1/svc1" lautet, würde die Dienstidentität in 6.0+ "myapp~app1~svc1" und in früheren Versionen "myapp/app1/svc1" lauten.
--partition-key-type Schlüsseltyp für die Partition. Dieser Parameter ist erforderlich, wenn das Partitionsschema für den Dienst gleich „Int64Range“ oder „Named“ ist. Die folgenden Werte sind möglich. – None (1): Gibt an, dass der Parameter „PartitionKeyValue“ nicht angegeben ist. Dies ist für die Partitionen gültig, deren Partitionsschema als „Singleton“ festgelegt ist. Dies ist der Standardwert. Der Wert ist "1". – Int64Range (2): Gibt an, dass der Wert des Parameters „PartitionKeyValue“ ein int64-Partitionsschlüssel ist. Dies ist für die Partitionen gültig, deren Partitionsschema als „Int64Range“ festgelegt ist. Der Wert ist "2". – Named (3): Gibt an, dass der Wert des Parameters „PartitionKeyValue“ ein Name der Partition ist. Dies ist für die Partitionen gültig, deren Partitionsschema als „Named“ festgelegt ist. Der Wert ist "3".
--partition-key-value Der Partitionsschlüssel. Dieses Argument ist erforderlich, wenn das Partitionsschema für den Dienst gleich „Int64Range“ oder „Named“ ist. Dies ist nicht die Partitions-ID, sondern entweder der ganzzahlige Schlüsselwert oder der Name der Partitions-ID. Wenn Ihr Dienst beispielsweise Bereichspartitionen von 0 bis 10 verwendet, dann wäre PartitionKeyValue eine ganze Zahl in diesem Bereich. Fragen Sie die Dienstbeschreibung ab, auf den Bereich oder Namen anzuzeigen.
--previous-rsp-version Der Wert im „Version“-Feld der Antwort, die zuvor empfangen wurde. Dieses Argument ist erforderlich, wenn der Benutzer weiß, dass das zuvor abgerufene Ergebnis veraltet ist.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service type-list

Ruft die Liste ab, die die Informationen zu den Diensttypen enthält, die von einem bereitgestellten Anwendungstyp in einem Service Fabric-Cluster unterstützt werden.

Ruft die Liste ab, die die Informationen zu den Diensttypen enthält, die von einem bereitgestellten Anwendungstyp in einem Service Fabric-Cluster unterstützt werden. Der angegebene Anwendungstyp muss vorhanden sein. Andernfalls wird der Status 404 zurückgegeben.

Argumente

Argument BESCHREIBUNG
--application-type-name [erforderlich] Der Name des Anwendungstyps.
--application-type-version [erforderlich] Die Version des Anwendungstyps.
--timeout -t Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden. Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

sfctl service update

Aktualisiert den angegebenen Dienst mithilfe der angegebenen Updatebeschreibung.

Argumente

Argument BESCHREIBUNG
--service-id [erforderlich] Die Identität (ID) des Diensts. Dies ist üblicherweise der vollständige Name des Dienstes ohne das URI-Schema 'fabric:'. Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Wenn der Dienstname beispielsweise "fabric:/myapp/app1/svc1" lautet, würde die Dienstidentität in 6.0+ "myapp~app1~svc1" und in früheren Versionen "myapp/app1/svc1" lauten.
--constraints Die Platzierungseinschränkungen als Zeichenfolge. Platzierungseinschränkungen sind boolesche Ausdrücke für Knoteneigenschaften und ermöglichen es, einen Dienst entsprechend den Dienstanforderungen auf bestimmte Knoten einzuschränken. Soll ein Dienst z. B. auf Knoten platziert werden, für die Blau als Knotenfarbe (NodeType) festgelegt ist, geben Sie Folgendes an: "NodeColor == blue".
--correlated-service Der Name des Zieldiensts, dem der Dienst zugeordnet werden soll.
--correlation Ordnen Sie den Dienst über eine Ausrichtungsaffinität einem vorhandenen Dienst zu.
--instance-count Die Anzahl von Instanzen. Dies gilt für nur zustandslose Dienste.
--load-metrics JSON-codierte Liste der Metriken, die zum knotenübergreifenden Lastenausgleich verwendet werden.
--min-replica-set-size Die Mindestgröße der Replikatgruppe als Zahl. Dies gilt nur für zustandsbehaftete Dienste.
--move-cost Gibt die Verschiebungskosten für den Dienst an. Mögliche Werte sind: 'Zero', 'Low', 'Medium', 'High', 'VeryHigh'.
--placement-policy-list JSON-codierte Liste mit Platzierungsrichtlinien für den Dienst und alle zugehörigen Domänennamen. Richtlinien können aus einer der folgenden Angaben oder deren Kombination bestehenNonPartiallyPlaceServicePreferPrimaryDomain, RequireDomain, RequireDomainDistribution.
--quorum-loss-wait Die maximale Dauer (in Sekunden), für die eine Partition den Zustand für Quorumverlust haben darf. Dies gilt nur für zustandsbehaftete Dienste.
--replica-restart-wait Die Dauer (in Sekunden) zwischen einem Ausfall eines Replikats und dem Erstellen eines neuen Replikats. Dies gilt nur für zustandsbehaftete Dienste.
--scaling-policies JSON-codierte Liste von Skalierungsrichtlinien für diesen Dienst.
--service-placement-time Die Dauer, für die Replikate InBuild bleiben können, bevor gemeldet wird, dass der Build hängt. Dies gilt nur für zustandsbehaftete Dienste.
--stand-by-replica-keep Die maximale Dauer (in Sekunden), für die StandBy-Replikate beibehalten werden, bevor sie entfernt werden. Dies gilt nur für zustandsbehaftete Dienste.
--stateful Gibt an, dass der Zieldienst ein zustandsbehafteter Dienst ist.
--stateless Gibt an, dass der Zieldienst ein zustandsloser Dienst ist.
--target-replica-set-size Die Zielgröße der Replikatgruppe als Zahl. Dies gilt nur für zustandsbehaftete Dienste.
--timeout -t Standardwert: 60.

Globale Argumente

Argument BESCHREIBUNG
--debug Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
--help -h Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
--output -o Ausgabeformat. Zulässige Werte: json, jsonc, table, tsv. Standardwert: json.
--query JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
--verbose Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

Nächste Schritte

  • Einrichten der Service Fabric-Befehlszeilenschnittstelle
  • Informationen zum Verwenden der Service Fabric-Befehlszeilenschnittstelle mit den Beispielskripts