az postgres flexible-server replica

Zarządzanie replikami do odczytu.

Polecenia

Nazwa	Opis	Typ	Stan
az postgres flexible-server replica create	Utwórz replikę do odczytu dla serwera.	Core	ogólna dostępność
az postgres flexible-server replica list	Wyświetl listę wszystkich replik do odczytu dla danego serwera.	Core	ogólna dostępność
az postgres flexible-server replica promote	Zatrzymaj replikację repliki do odczytu i podwyższ jej poziom do niezależnego serwera lub jako serwera podstawowego.	Core	ogólna dostępność

az postgres flexible-server replica create

Zmiana powodująca niezgodność

To polecenie spowoduje zatrzymanie tworzenia nowych zasobów sieciowych lub zmian istniejących wymaganych do działania serwera, takich jak sieci wirtualne, podsieci, zakresy adresów IP itp. Zamiast tego będzie wymagać od użytkowników dostarczenia niezbędnych zasobów sieciowych utworzonych wcześniej przy użyciu odpowiednich poleceń z modułu az network .

Utwórz replikę do odczytu dla serwera.

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

Przykłady

Utwórz replikę do odczytu "testreplicaserver" dla "testserver" z dostępem publicznym lub prywatnym w określonej strefie i lokalizacji, jeśli jest dostępna.

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

Utwórz replikę do odczytu "testreplicaserver" z nową podsiecią "testserver" z dostępem prywatnym.

az postgres flexible-server replica create --name testreplicaserver -g testGroup \
  --source-server testserver --zone 3 --location testLocation \
  --vnet newVnet --subnet newSubnet \
  --address-prefixes 172.0.0.0/16 --subnet-prefixes 172.0.0.0/24 \
  --private-dns-zone testDNS.postgres.database.azure.com \
  --tags "key=value"

Utwórz replikę do odczytu "testreplicaserver" dla "testserver" z dostępem publicznym lub prywatnym w określonej lokalizacji, jeśli jest dostępna. Ponieważ strefa nie jest przekazywana, automatycznie pobiera strefę w lokalizacji repliki, która różni się od serwera źródłowego, jeśli jest dostępna, inne będą pobierać strefę taką samą jak serwer źródłowy w lokalizacji repliki, jeśli jest dostępna, inne ustawi strefę jako Brak, tj. Brak preferencji

az postgres flexible-server replica create --name testreplicaserver -g testGroup --source-server testserver --location testLocation

Utwórz replikę do odczytu "testreplicaserver" dla polecenia "testserver" z niestandardowym parametrem --storage-size i --sku.

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

Utwórz replikę do odczytu "testreplicaserver" dla "testserver", gdzie "testreplicaserver" znajduje się w innej grupie zasobów "newTestGroup". Tutaj parametr --resource-group jest przeznaczony dla grupy zasobów repliki do odczytu, a parametr --source-server musi zostać przekazany jako identyfikator zasobu.

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

Parametry wymagane

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--source-server

Nazwa lub identyfikator zasobu serwera źródłowego do przywrócenia.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość	Wartość
Grupa parametrów:	Global Policy Arguments

--address-prefixes

Przestarzałe

Argument "--address-prefixes" został wycofany i zostanie usunięty w następnej wersji zmiany powodującej niezgodność (2.87.0) zaplanowanej na czerwiec 2026 r.

Prefiks adresu IP używany podczas tworzenia nowej sieci wirtualnej w formacie CIDR. Wartość domyślna to 10.0.0.0/16.

--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość	Wartość
Grupa parametrów:	Global Policy Arguments

--identity

Nazwa lub identyfikator zasobu tożsamości przypisanej przez użytkownika na potrzeby szyfrowania danych.

--key

Identyfikator zasobu podstawowego klucza magazynu kluczy na potrzeby szyfrowania danych.

--location -l

Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--name -n

Nazwa repliki do odczytu.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość	Wartość
Domyślna wartość:	False

--performance-tier

Warstwa wydajności serwera.

--private-dns-zone

Ten parametr dotyczy tylko serwera z dostępem prywatnym. Nazwa lub identyfikator nowej lub istniejącej prywatnej strefy DNS. Możesz użyć prywatnej strefy DNS z tej samej grupy zasobów, innej grupy zasobów lub innej subskrypcji. Jeśli chcesz użyć strefy z innej grupy zasobów lub subskrypcji, podaj identyfikator zasobu. Interfejs wiersza polecenia tworzy nową prywatną strefę DNS w tej samej grupie zasobów co sieć wirtualna, jeśli nie zostanie podana przez użytkowników.

--replica-name

Przestarzałe

Argument "--replica-name" został wycofany i zostanie usunięty w następnej wersji zmiany powodującej niezgodność (2.87.0) zaplanowanej na czerwiec 2026 r. Zamiast tego użyj "--name".

Nazwa repliki do odczytu.

--sku-name

Nazwa jednostki SKU obliczeniowej. Zgodnie z konwencją Standard_{nazwa maszyny wirtualnej}. Przykłady: Standard_B1ms.

--storage-size

Pojemność magazynu serwera. Minimum to 32 GiB, a maksimum to 16 TiB.

--storage-type

Typ magazynu repliki do odczytu. Dozwolona wartość jest PremiumV2_LRS. Wartość domyślna to replika do odczytu zgodna z typem magazynu serwera podstawowego.

Właściwość	Wartość
Dopuszczalne wartości:	PremiumV2_LRS

--subnet

Nazwa lub identyfikator zasobu nowej lub istniejącej podsieci. Jeśli chcesz użyć podsieci z innej grupy zasobów lub subskrypcji, podaj identyfikator zasobu zamiast nazwy. Należy pamiętać, że podsieć zostanie delegowana do serwerów elastycznych. Po delegowaniu tej podsieci nie można używać dla żadnego innego typu zasobów Azure.

--subnet-prefixes

Przestarzałe

Argument "--subnet-prefixes" został wycofany i zostanie usunięty w następnej wersji zmiany powodującej niezgodność (2.87.0) zaplanowanej na czerwiec 2026 r.

Prefiks adresu IP podsieci do użycia podczas tworzenia nowej podsieci w formacie CIDR. Wartość domyślna to 10.0.0.0/24.

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--tier

Warstwa obliczeniowa serwera. Zaakceptowane wartości: Burstable, GeneralPurpose, MemoryOptimized.

--vnet

Nazwa lub identyfikator nowej lub istniejącej sieci wirtualnej. Jeśli chcesz użyć sieci wirtualnej z innej grupy zasobów lub subskrypcji, podaj identyfikator zasobu. Nazwa musi zawierać od 2 do 64 znaków. Nazwa musi zaczynać się literą lub cyfrą, kończyć literą, cyfrą lub podkreśleniami i może zawierać tylko litery, cyfry, podkreślenia, kropki lub łączniki.

--yes -y

Nie monituj o potwierdzenie.

Właściwość	Wartość
Domyślna wartość:	False

--zone -z

Strefa dostępności, do której należy aprowizować zasób.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

az postgres flexible-server replica list

Wyświetl listę wszystkich replik do odczytu dla danego serwera.

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

Przykłady

Wyświetl listę wszystkich replik do odczytu dla serwera głównego "testserver".

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--name -n

Nazwa serwera. Nazwa może zawierać tylko małe litery, cyfry i znak łącznika (-). Minimalnie 3 znaki i maksymalnie 63 znaki.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

az postgres flexible-server replica promote

Zatrzymaj replikację repliki do odczytu i podwyższ jej poziom do niezależnego serwera lub jako serwera podstawowego.

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]

Przykłady

Zatrzymaj replikację na "testreplicaserver" i podwyższ jej poziom jako autonomiczny serwer odczytu/zapisu.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver

Zatrzymaj replikację na "testreplicaserver" i podwyższ jej poziom do autonomicznego serwera odczytu/zapisu z wymuszoną synchronizacją danych.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver --promote-mode standalone --promote-option forced

Zatrzymaj replikację na "testreplicaserver" i podwyższ jej poziom do serwera podstawowego z zaplanowaną synchronizacją danych. Promująca się replika musi mieć przypisany wirtualny punkt końcowy czytnika lub zostanie wyświetlony błąd podczas podwyższania poziomu.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver --promote-mode switchover --promote-option planned

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość	Wartość
Grupa parametrów:	Global Policy Arguments

--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość	Wartość
Grupa parametrów:	Global Policy Arguments

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--name -n

Nazwa repliki do odczytu.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--promote-mode

Czy podwyższyć poziom repliki do odczytu do niezależnego serwera, czy podwyższyć poziom go jako serwer podstawowy.

Właściwość	Wartość
Domyślna wartość:	standalone
Dopuszczalne wartości:	standalone, switchover

--promote-option

Niezależnie od tego, czy dane mają być synchronizowane przed podwyższeniem poziomu repliki do odczytu, czy jak najszybciej.

Właściwość	Wartość
Domyślna wartość:	planned
Dopuszczalne wartości:	forced, planned

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--yes -y

Nie monituj o potwierdzenie.

Właściwość	Wartość
Domyślna wartość:	False

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False