az sf managed-service

  • Referenz

Verwalten von Diensten, die auf einem verwalteten Azure Service Fabric-Cluster ausgeführt werden. Nur ARM-bereitgestellte Dienste unterstützen.

Befehle

Name Beschreibung Typ Status
az sf managed-service correlation-scheme

Verwalten Sie Korrelationsschemas von Diensten, die auf einem verwalteten Azure Service Fabric-Cluster ausgeführt werden. Nur ARM-bereitgestellte Dienste unterstützen.

 Kernspeicher Allgemein verfügbar
az sf managed-service correlation-scheme create

Erstellen Sie ein neues Korrelationsschema für verwaltete Dienste in einem verwalteten Azure Service Fabric-Cluster.

 Kernspeicher Allgemein verfügbar
az sf managed-service correlation-scheme delete

Löschen eines Korrelationsschemas für verwaltete Dienste.

 Kernspeicher Allgemein verfügbar
az sf managed-service correlation-scheme update

Aktualisieren eines Korrelationsschemas für verwaltete Dienste.

 Kernspeicher Allgemein verfügbar
az sf managed-service create

Erstellen Sie einen neuen verwalteten Dienst in einem verwalteten Azure Service Fabric-Cluster.

 Kernspeicher Allgemein verfügbar
az sf managed-service delete

Löschen eines verwalteten Diensts.

 Kernspeicher Allgemein verfügbar
az sf managed-service list

Listet verwaltete Dienste einer bestimmten verwalteten Anwendung auf.

 Kernspeicher Allgemein verfügbar
az sf managed-service load-metrics

Verwalten von Dienstlademetriken, die auf einem verwalteten Azure Service Fabric-Cluster ausgeführt werden. Nur ARM-bereitgestellte Dienste unterstützen.

 Kernspeicher Allgemein verfügbar
az sf managed-service load-metrics create

Erstellen Sie eine neue Metrik zum Laden des verwalteten Diensts in einem verwalteten Azure Service Fabric-Cluster.

 Kernspeicher Allgemein verfügbar
az sf managed-service load-metrics delete

Löschen eines verwalteten Diensts.

 Kernspeicher Allgemein verfügbar
az sf managed-service load-metrics update

Aktualisieren eines verwalteten Diensts.

 Kernspeicher Allgemein verfügbar
az sf managed-service show

Rufen Sie einen Dienst ab.

 Kernspeicher Allgemein verfügbar
az sf managed-service update

Aktualisieren eines verwalteten Diensts.

 Kernspeicher Allgemein verfügbar

az sf managed-service create

Erstellen Sie einen neuen verwalteten Dienst in einem verwalteten Azure Service Fabric-Cluster.

az sf managed-service create --application
                             --cluster-name
                             --name
                             --resource-group
                             --service-type
                             --state {Stateful, Stateless}
                             [--activation-mode]
                             [--default-move-cost {High, Low, Medium, Zero}]
                             [--has-persisted-state {false, true}]
                             [--high-key]
                             [--instance-count]
                             [--keep-duration]
                             [--low-key]
                             [--min-inst-pct]
                             [--min-instance-count]
                             [--min-replica]
                             [--partition-count]
                             [--partition-names]
                             [--partition-scheme {Named, Singleton, UniformInt64Range}]
                             [--placement-constraints]
                             [--plcmt-time-limit]
                             [--quorum-loss-wait]
                             [--replica-restart-wait]
                             [--tags]
                             [--target-replica]

Beispiele

Erstellen Sie einen neuen zustandslosen verwalteten Dienst "testService1" mit Instanzenanzahl -1 (auf allen Knoten).

az sf managed-service create -g testRG -c testCluster --application-name testApp --state stateless --service-name testService \
  --service-type testStateless --instance-count -1 --partition-scheme singleton

Erstellen Sie einen neuen zustandsbehafteten Dienst "testService2" mit einem Ziel von 5 Knoten.

az sf managed-service create -g testRG -c testCluster --application-name testApp --state stateful --service-name testService2 --has-persisted-state \
  --service-type testStatefulType --min-replica-set-size 3 --target-replica-set-size 5 --partition-scheme uniformint64range --partition-count 1 --low-key 0 --high-key 25

Erforderliche Parameter

--application --application-name

Geben Sie den Namen des Diensts an.

--cluster-name -c

Geben Sie den Namen des Clusters an, wenn er nicht angegeben wird, mit dem Namen der Ressourcengruppe identisch.

--name --service-name

Geben Sie den Namen des Diensts an.

--resource-group -g

Geben Sie den Ressourcengruppennamen an. Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--service-type --type

Geben Sie den Diensttypnamen der Anwendung an, sie sollte im Anwendungsmanifest vorhanden sein.

--state

Geben Sie an, ob der Dienst statuslos oder statuslos ist.

Zulässige Werte: Stateful, Stateless

Optionale Parameter

--activation-mode --package-activation-mode --service-package-activation-mode

Geben Sie den Aktivierungsmodus des Dienstpakets an.

--default-move-cost

Geben Sie die Standardkosten für eine Verschiebung an. Höhere Kosten machen es weniger wahrscheinlich, dass der Clusterressourcen-Manager das Replikat verschieben wird, wenn versucht wird, den Cluster auszugleichen.

Zulässige Werte: High, Low, Medium, Zero
--has-persisted-state

Bestimmt, ob es sich um einen beständigen Dienst handelt, der Status auf dem lokalen Datenträger speichert. Wenn dies der Fall ist, ist der Wert dieser Eigenschaft "true", wenn dies nicht "false" ist.

Zulässige Werte: false, true
--high-key

Geben Sie die obere Grenze des Partitionsschlüsselbereichs an, der zwischen der Partition "Count" aufgeteilt werden soll. Dies wird nur mit dem UniformInt64-Partitionsschema verwendet.

--instance-count

Geben Sie die Instanzanzahl für den zustandslosen Dienst an. Wenn -1 verwendet wird, bedeutet dies, dass sie auf allen Knoten ausgeführt wird.

--keep-duration --stand-by-keep-duration --stand-by-replica-keep-duration

Geben Sie die Definition an, wie lange StandBy-Replikate vor dem Entfernen Standard beibehalten werden sollen, dargestellt im ISO 8601-Format "hh:mm:ss".

--low-key

Geben Sie die untere Grenze des Partitionsschlüsselbereichs an, der zwischen der Partition "Count" aufgeteilt werden soll. Dies wird nur mit dem UniformInt64-Partitionsschema verwendet.

--min-inst-pct --min-instance-percentage

Geben Sie den minimalen Prozentsatz von InstanceCount an, der der Sicherheitsüberprüfung "EnsureAvailability" bei Vorgängen wie Upgrade oder Deaktivierung des Knotens entsprechen muss. Die tatsächliche Zahl, die verwendet wird, ist max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Hinweis: Wenn InstanceCount auf -1 festgelegt ist, während der MinInstancePercentage-Berechnung wird -1 zuerst in die Anzahl der Knoten konvertiert, auf denen die Instanzen gemäß den Platzierungseinschränkungen für den Dienst platziert werden dürfen. Zulässige Werte liegen zwischen 0 und 100.

--min-instance-count

Geben Sie die Mindestanzahl von Instanzen an, die der Sicherheitsüberprüfung "EnsureAvailability" bei Vorgängen wie upgraden oder Deaktivieren des Knotens entsprechen müssen. Die tatsächliche Zahl, die verwendet wird, ist max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Hinweis: Wenn InstanceCount auf -1 festgelegt ist, wird bei der MinInstanceCount-Berechnung -1 zuerst in die Anzahl der Knoten konvertiert, auf denen die Instanzen gemäß den Platzierungseinschränkungen für den Dienst platziert werden dürfen.

--min-replica --min-replica-set-size

Geben Sie die Mindestreplikatsatzgröße für den zustandsbehafteten Dienst an.

--partition-count

Geben Sie die Anzahl der Partitionen an. Dies wird nur mit dem UniformInt64-Partitionsschema verwendet.

--partition-names

Geben Sie das Array für die Namen der Partitionen an. Dies wird nur mit dem Schema der benannten Partition verwendet.

--partition-scheme

Geben Sie an, welches Partitionsschema verwendet werden soll. Singleton-Partitionen werden normalerweise verwendet, wenn für den Dienst kein zusätzliches Routing benötigt wird. UniformInt64 bedeutet, dass jede Partition einen Bereich von Int64-Schlüsseln besitzt. Benannt wird in der Regel für Dienste mit Daten, die in einem gebundenen Satz zusammengefasst werden können. Einige allgemeine Beispiele für Datenfelder, die als Schlüssel für namensbasierte Partitionen verwendet werden, sind Regionen, Postleitzahlen, Kundengruppen oder andere geschäftliche Grenzen.

Zulässige Werte: Named, Singleton, UniformInt64Range
Standardwert: singleton
--placement-constraints

Geben Sie die Platzierungseinschränkungen als Zeichenfolge an. Platzierungseinschränkungen sind boolesche Ausdrücke für Knoteneigenschaften und ermöglichen es, einen Dienst entsprechend den Dienstanforderungen auf bestimmte Knoten einzuschränken. Wenn Sie beispielsweise einen Dienst auf Knoten platzieren möchten, auf denen NodeType blau ist, geben Sie Folgendes an: "NodeColor == blue)".

--plcmt-time-limit --service-placement-time-limit

Geben Sie die Dauer an, für die Replikate inBuild bleiben können, bevor der Build hängen bleibt, dargestellt im ISO 8601-Format "hh:mm:ss".

--quorum-loss-wait --quorum-loss-wait-duration

Geben Sie die maximale Dauer an, für die eine Partition in einem Zustand des Quorumverlusts sein darf, dargestellt im ISO 8601-Format "hh:mm:ss".

--replica-restart-wait --replica-restart-wait-duration

Geben Sie die Dauer zwischen dem Ablauf eines Replikats und dem Erstellen eines neuen Replikats an, dargestellt im ISO 8601-Format "hh:mm:ss".

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--target-replica --target-replica-set-size

Geben Sie die Größe des Zielreplikatsatzes für den zustandsbehafteten Dienst an.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sf managed-service delete

Löschen eines verwalteten Diensts.

az sf managed-service delete --application
                             --cluster-name
                             --name
                             --resource-group

Beispiele

Verwalteter Dienst löschen.

az sf managed-service delete -g testRG -c testCluster --application-name testApp --service-name testService

Erforderliche Parameter

--application --application-name

Geben Sie den Namen des Diensts an.

--cluster-name -c

Geben Sie den Namen des Clusters an, wenn er nicht angegeben wird, mit dem Namen der Ressourcengruppe identisch.

--name --service-name

Geben Sie den Namen des Diensts an.

--resource-group -g

Geben Sie den Ressourcengruppennamen an. Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sf managed-service list

Listet verwaltete Dienste einer bestimmten verwalteten Anwendung auf.

az sf managed-service list --application
                           --cluster-name
                           --resource-group

Beispiele

Verwaltete Dienste auflisten.

az sf managed-service list -g testRG -c testCluster --application-name testApp

Erforderliche Parameter

--application --application-name

Geben Sie den Namen des Diensts an.

--cluster-name -c

Geben Sie den Namen des Clusters an, wenn er nicht angegeben wird, mit dem Namen der Ressourcengruppe identisch.

--resource-group -g

Geben Sie den Ressourcengruppennamen an. Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sf managed-service show

Rufen Sie einen Dienst ab.

az sf managed-service show --application
                           --cluster-name
                           --name
                           --resource-group

Beispiele

Zeigen Sie die Eigenschaften eines verwalteten Diensts in einem verwalteten Azure Service Fabric-Cluster an.

az sf managed-service show -g testRG -c testCluster --application-name testApp --service-name testService

Erforderliche Parameter

--application --application-name

Geben Sie den Namen des Diensts an.

--cluster-name -c

Geben Sie den Namen des Clusters an, wenn er nicht angegeben wird, mit dem Namen der Ressourcengruppe identisch.

--name --service-name

Geben Sie den Namen des Diensts an.

--resource-group -g

Geben Sie den Ressourcengruppennamen an. Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sf managed-service update

Aktualisieren eines verwalteten Diensts.

az sf managed-service update --application
                             --cluster-name
                             --name
                             --resource-group
                             [--default-move-cost {High, Low, Medium, Zero}]
                             [--instance-count]
                             [--keep-duration]
                             [--min-inst-pct]
                             [--min-instance-count]
                             [--min-replica]
                             [--placement-constraints]
                             [--plcmt-time-limit]
                             [--quorum-loss-wait]
                             [--replica-restart-wait]
                             [--tags]
                             [--target-replica]

Beispiele

Aktualisieren des verwalteten Zustandslosen Diensts.

az sf managed-service update -g testRG -c testCluster --application-name testApp --service-name testService --min-instance-count 2 \
  --min-instance-percentage 20

Aktualisieren des verwalteten zustandsbehafteten Diensts.

az sf managed-service update -g testRG -c testCluster --application-name testApp --service-name testService2 --service-placement-time-limit '00:11:00' \
  --stand-by-replica-keep-duration '00:11:00' --replica-restart-wait-duration '00:11:00' --quorum-loss-wait-duration '00:11:00'

Erforderliche Parameter

--application --application-name

Geben Sie den Namen des Diensts an.

--cluster-name -c

Geben Sie den Namen des Clusters an, wenn er nicht angegeben wird, mit dem Namen der Ressourcengruppe identisch.

--name --service-name

Geben Sie den Namen des Diensts an.

--resource-group -g

Geben Sie den Ressourcengruppennamen an. Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--default-move-cost

Geben Sie die Standardkosten für eine Verschiebung an. Höhere Kosten machen es weniger wahrscheinlich, dass der Clusterressourcen-Manager das Replikat verschieben wird, wenn versucht wird, den Cluster auszugleichen.

Zulässige Werte: High, Low, Medium, Zero
--instance-count

Geben Sie die Instanzanzahl für den zustandslosen Dienst an. Wenn -1 verwendet wird, bedeutet dies, dass sie auf allen Knoten ausgeführt wird.

--keep-duration --stand-by-keep-duration --stand-by-replica-keep-duration

Geben Sie die Definition an, wie lange StandBy-Replikate vor dem Entfernen Standard beibehalten werden sollen, dargestellt im ISO 8601-Format "hh:mm:ss".

--min-inst-pct --min-instance-percentage

Geben Sie den minimalen Prozentsatz von InstanceCount an, der der Sicherheitsüberprüfung "EnsureAvailability" bei Vorgängen wie Upgrade oder Deaktivierung des Knotens entsprechen muss. Die tatsächliche Zahl, die verwendet wird, ist max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Hinweis: Wenn InstanceCount auf -1 festgelegt ist, während der MinInstancePercentage-Berechnung wird -1 zuerst in die Anzahl der Knoten konvertiert, auf denen die Instanzen gemäß den Platzierungseinschränkungen für den Dienst platziert werden dürfen. Zulässige Werte liegen zwischen 0 und 100.

--min-instance-count

Geben Sie die Mindestanzahl von Instanzen an, die der Sicherheitsüberprüfung "EnsureAvailability" bei Vorgängen wie upgraden oder Deaktivieren des Knotens entsprechen müssen. Die tatsächliche Zahl, die verwendet wird, ist max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Hinweis: Wenn InstanceCount auf -1 festgelegt ist, wird bei der MinInstanceCount-Berechnung -1 zuerst in die Anzahl der Knoten konvertiert, auf denen die Instanzen gemäß den Platzierungseinschränkungen für den Dienst platziert werden dürfen.

--min-replica --min-replica-set-size

Geben Sie die Mindestreplikatsatzgröße für den zustandsbehafteten Dienst an.

--placement-constraints

Geben Sie die Platzierungseinschränkungen als Zeichenfolge an. Platzierungseinschränkungen sind boolesche Ausdrücke für Knoteneigenschaften und ermöglichen es, einen Dienst entsprechend den Dienstanforderungen auf bestimmte Knoten einzuschränken. Wenn Sie beispielsweise einen Dienst auf Knoten platzieren möchten, auf denen NodeType blau ist, geben Sie Folgendes an: "NodeColor == blue)".

--plcmt-time-limit --service-placement-time-limit

Geben Sie die Dauer an, für die Replikate inBuild bleiben können, bevor der Build hängen bleibt, dargestellt im ISO 8601-Format "hh:mm:ss".

--quorum-loss-wait --quorum-loss-wait-duration

Geben Sie die maximale Dauer an, für die eine Partition in einem Zustand des Quorumverlusts sein darf, dargestellt im ISO 8601-Format "hh:mm:ss".

--replica-restart-wait --replica-restart-wait-duration

Geben Sie die Dauer zwischen dem Ablauf eines Replikats und dem Erstellen eines neuen Replikats an, dargestellt im ISO 8601-Format "hh:mm:ss".

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--target-replica --target-replica-set-size

Geben Sie die Größe des Zielreplikatsatzes für den zustandsbehafteten Dienst an.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.