az postgres flexible-server replica

Verwalten von Lesereplikaten.

Befehle

Name Beschreibung Typ Status
az postgres flexible-server replica create

Erstellen Sie ein Lesereplikat für einen Server.

 Core GA
az postgres flexible-server replica list

Listet alle lesereplikate für einen bestimmten Server auf.

 Core GA
az postgres flexible-server replica promote

Beenden Sie die Replikation eines Lesereplikats, und stufen Sie es auf einen unabhängigen Server oder als primärer Server höher.

 Core GA

az postgres flexible-server replica create

Erstellen Sie ein Lesereplikat für einen Server.

az postgres flexible-server replica create --name
                                           --resource-group
                                           --source-server
                                           [--acquire-policy-token]
                                           [--change-reference]
                                           [--identity]
                                           [--key]
                                           [--location]
                                           [--no-wait]
                                           [--performance-tier]
                                           [--private-dns-zone]
                                           [--sku-name]
                                           [--storage-size]
                                           [--storage-type {PremiumV2_LRS}]
                                           [--subnet]
                                           [--tags]
                                           [--tier]
                                           [--vnet]
                                           [--yes]
                                           [--zone]

Beispiele

Erstellen Sie ein Lesereplikat "testreplica" für "testserver" mit öffentlichem oder privatem Zugriff in der angegebenen Zone und am angegebenen Speicherort, falls verfügbar.

az postgres flexible-server replica create --name testreplica -g testGroup --source-server testserver --zone 3 --location testLocation

Erstellen Sie ein Lesereplikat "testreplica" für "testserver" mit privatem Zugriff mithilfe vorhandener Netzwerkressourcen.

az postgres flexible-server replica create --name testreplica -g testGroup \
  --source-server testserver --zone 3 --location testLocation \
  --vnet newVnet --subnet newSubnet \
  --private-dns-zone testdns.postgres.database.azure.com \
  --tags "key=value"

Erstellen Sie ein Lesereplikat "testreplica" für "testserver" mit öffentlichem oder privatem Zugriff am angegebenen Speicherort, falls verfügbar. Da die Zone nicht übergeben wird, nimmt sie automatisch die Zone am Replikatspeicherort auf, die sich von dem Quellserver unterscheidet, sofern verfügbar, andernfalls wird die Zone wie der Quellserver am Replikatspeicherort verwendet, falls verfügbar, andernfalls wird die Zone als "Keine" festgelegt, d. h. keine Einstellung.

az postgres flexible-server replica create --name testreplica -g testgroup --source-server testserver --location testLocation

Erstellen Sie ein Lesereplikat "testreplica" für "testserver" mit benutzerdefinierter --storage-size und --sku.

az postgres flexible-server replica create --name testreplica -g testgroup --source-server testserver --sku-name Standard_D4ds_v5 --storage-size 256

Erstellen Sie ein Lesereplikat "testreplica" für "testserver", wobei sich "testreplica" in einer anderen Ressourcengruppe "newTestGroup" befindet. Hier --resource-group ist für die Ressourcengruppe des Lesereplikats, und --source-server muss als Ressourcenbezeichner übergeben werden.

az postgres flexible-server replica create --name testreplicaserver -g newTestGroup         --source-server /subscriptions/{sourceSubscriptionId}/resourceGroups/{sourceResourceGroup}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{sourceServer} --location testLocation

Erforderliche Parameter

--name -n

Name des lesereplikats.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--source-server

Der Name oder die Ressourcen-ID des Quellservers, aus dem wiederhergestellt werden soll.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--identity

Der Name oder die Ressourcen-ID der vom Benutzer zugewiesenen Identität für die Datenverschlüsselung.

--key

Der Ressourcenbezeichner des Primärschlüsselschlüssels für die Datenverschlüsselung.

--location -l

Location. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--performance-tier

Leistungsebene des Servers.

--private-dns-zone

Dieser Parameter gilt nur für einen Server mit privatem Zugriff und ist bei Verwendung von ---vnet oder --subnet erforderlich. Der Name oder die Ressourcen-ID einer vorhandenen privaten DNS-Zone. Sie können eine private DNS-Zone aus derselben Ressourcengruppe, einer anderen Ressourcengruppe oder einem anderen Abonnement verwenden. Wenn Sie eine Zone aus einer anderen Ressourcengruppe oder einem anderen Abonnement verwenden möchten, geben Sie den Ressourcenbezeichner an.

--sku-name

Der Name der Compute-SKU. Folgt der Konvention Standard_{VM name}. Beispiele: Standard_B1ms.

--storage-size

Die Speicherkapazität des Servers. Der Mindestwert beträgt 32 GiB und max. 16 TiB.

--storage-type

Speichertyp für das Lesereplikat. Zulässiger Wert ist PremiumV2_LRS. Der Standardwert ist, dass das Lesereplikat dem Speichertyp des primären Servers entspricht.

Eigenschaft Wert
Zulässige Werte: PremiumV2_LRS
--subnet

Name oder Bezeichner eines vorhandenen Subnetzes. Wenn Sie ein Subnetz aus einer anderen Ressourcengruppe oder einem anderen Abonnement verwenden möchten, geben Sie den Ressourcenbezeichner anstelle des Namens an.

--tags

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

--tier

Computeebene des Servers. Akzeptierte Werte: Burstable, GeneralPurpose, MemoryOptimized.

--vnet

Name oder Bezeichner eines vorhandenen virtuellen Netzwerks. Wenn Sie ein vnet aus einer anderen Ressourcengruppe oder einem anderen Abonnement verwenden möchten, geben Sie bitte einen Ressourcenbezeichner an. Der Name muss zwischen 2 und 64 Zeichen bestehen. Der Name muss mit einem Buchstaben oder einer Zahl beginnen, mit einem Buchstaben, einer Zahl oder einem Unterstrich enden und darf nur Buchstaben, Zahlen, Unterstriche, Punkte oder Bindestriche enthalten.

--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
--zone -z

Verfügbarkeitszone, in der die Ressource bereitgestellt werden soll.

Globale Parameter
--debug

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False

az postgres flexible-server replica list

Listet alle lesereplikate für einen bestimmten Server auf.

az postgres flexible-server replica list [--ids]
                                         [--name]
                                         [--resource-group]
                                         [--subscription]

Beispiele

Listet alle Lesereplikate für den Masterserver "testserver" auf.

az postgres flexible-server replica list -g testgroup -n testserver

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Name des Servers. Der Name kann nur Kleinbuchstaben, Zahlen und den Bindestrich (-) enthalten. Mindestens 3 Zeichen und maximal 63 Zeichen.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
Globale Parameter
--debug

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--verbose

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

Eigenschaft Wert
Standardwert: False

az postgres flexible-server replica promote

Beenden Sie die Replikation eines Lesereplikats, und stufen Sie es auf einen unabhängigen Server oder als primärer Server höher.

az postgres flexible-server replica promote [--acquire-policy-token]
                                            [--change-reference]
                                            [--ids]
                                            [--name]
                                            [--promote-mode {standalone, switchover}]
                                            [--promote-option {forced, planned}]
                                            [--resource-group]
                                            [--subscription]
                                            [--yes]

Beispiele

Beenden Sie die Replikation auf "testreplica", und fördern Sie sie als eigenständigen Lese-/Schreibserver.

az postgres flexible-server replica promote -g testgroup -n testreplica

Beenden Sie die Replikation auf "testreplica", und fördern Sie sie mit erzwungener Datensynchronisierung als eigenständigen Lese-/Schreibserver.

az postgres flexible-server replica promote -g testgroup -n testreplica --promote-mode standalone --promote-option forced

Beenden Sie die Replikation auf "testreplica", und fördern Sie sie mit geplanter Datensynchronisierung auf den primären Server. Das Replikat, das Sie bewerben, muss der virtuelle Reader-Endpunkt zugewiesen sein, oder Sie erhalten eine Fehlermeldung bei der Heraufstufung.

az postgres flexible-server replica promote -g testgroup -n testreplica --promote-mode switchover --promote-option planned

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Name des lesereplikats.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--promote-mode

Gibt an, ob Lesereplikate auf einen unabhängigen Server heraufstufen oder als Primärserver höher stufen sollen.

Eigenschaft Wert
Standardwert: standalone
Zulässige Werte: standalone, switchover
--promote-option

Unabhängig davon, ob Daten synchronisiert werden sollen, bevor Sie das Lesereplikat höher stufen oder so schnell wie möglich höher stufen.

Eigenschaft Wert
Standardwert: planned
Zulässige Werte: forced, planned
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--verbose

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

Eigenschaft Wert
Standardwert: False