Freigeben über

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.

 Kern GA
az sf managed-service correlation-scheme create

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

 Kern GA
az sf managed-service correlation-scheme delete

Löschen eines Korrelationsschemas für verwaltete Dienste.

 Kern GA
az sf managed-service correlation-scheme update

Aktualisieren eines Korrelationsschemas für verwaltete Dienste.

 Kern GA
az sf managed-service create

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

 Kern GA
az sf managed-service delete

Löschen eines verwalteten Diensts.

 Kern GA
az sf managed-service list

Listet verwaltete Dienste einer bestimmten verwalteten Anwendung auf.

 Kern GA
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.

 Kern GA
az sf managed-service load-metrics create

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

 Kern GA
az sf managed-service load-metrics delete

Löschen eines verwalteten Diensts.

 Kern GA
az sf managed-service load-metrics update

Aktualisieren eines verwalteten Diensts.

 Kern GA
az sf managed-service show

Rufen Sie einen Dienst ab.

 Kern GA
az sf managed-service update

Aktualisieren eines verwalteten Diensts.

 Kern GA

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 Instanzanzahl -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 beibehalten werden sollen, bevor sie entfernt werden, 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 zuerst -1 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 in der Regel verwendet, wenn der Dienst kein zusätzliches Routing erfordert. 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 häufige Beispiele für Datenfelder, die als benannte Partitionsschlüssel verwendet werden, sind Regionen, Postleitzahlen, Kundengruppen oder andere Geschäftsgrenzen.

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 das Einschränken eines Diensts auf bestimmte Knoten basierend auf den Dienstanforderungen. 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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

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 beibehalten werden sollen, bevor sie entfernt werden, 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 zuerst -1 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 das Einschränken eines Diensts auf bestimmte Knoten basierend auf den Dienstanforderungen. 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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.