az postgres server-arc

Notitie

Deze verwijzing maakt deel uit van de arcdata-extensie voor de Azure CLI (versie 2.3.1 of hoger). De extensie installeert automatisch de eerste keer dat u een az postgres server-arc-opdracht uitvoert. Meer informatie over extensies.

Deze opdrachtgroep is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

PostgreSQL-servers met Azure Arc beheren.

Opdracht

Name Description Type Status
az postgres server-arc create

Maak een PostgreSQL-server met Azure Arc.

Toestel Preview uitvoeren
az postgres server-arc delete

Een PostgreSQL-server met Azure Arc verwijderen.

Toestel Preview uitvoeren
az postgres server-arc endpoint

PostgreSQL-servereindpunten met Azure Arc beheren.

Toestel Preview uitvoeren
az postgres server-arc endpoint list

Vermeld PostgreSQL-servereindpunten met Azure Arc.

Toestel Preview uitvoeren
az postgres server-arc list

Een lijst weergeven met PostgreSQL-server met Azure Arc.

Toestel Preview uitvoeren
az postgres server-arc restore

Herstel een PostgreSQL-server met Azure Arc vanuit een back-up van een andere server.

Toestel Preview uitvoeren
az postgres server-arc show

Geef de details weer van een PostgreSQL-server met Azure Arc.

Toestel Preview uitvoeren
az postgres server-arc update

Werk de configuratie van een PostgreSQL-server met Azure Arc bij.

Toestel Preview uitvoeren

az postgres server-arc create

Preview

De opdrachtgroep 'postgres server-arc' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Maak een PostgreSQL-server met Azure Arc.

Als u het wachtwoord van de server wilt instellen, stelt u de omgevingsvariabele in AZDATA_PASSWORD.

az postgres server-arc create --name
                              [--ad-account-name]
                              [--ad-connector-name]
                              [--admin-login-secret]
                              [--cert-private-key-file]
                              [--cert-public-key-file]
                              [--cores-limit]
                              [--cores-request]
                              [--dev]
                              [--dns-name]
                              [--extensions]
                              [--k8s-namespace]
                              [--keytab-secret]
                              [--log-level]
                              [--memory-limit]
                              [--memory-request]
                              [--no-external-endpoint]
                              [--no-wait]
                              [--path]
                              [--port]
                              [--retention-days]
                              [--service-annotations]
                              [--service-cert-secret]
                              [--service-labels]
                              [--service-type]
                              [--storage-class-backups]
                              [--storage-class-data]
                              [--storage-class-logs]
                              [--use-k8s]
                              [--volume-size-backups]
                              [--volume-size-data]
                              [--volume-size-logs]

Voorbeelden

Maak een PostgreSQL-server met Azure Arc.

az postgres server-arc create -n pg1 --k8s-namespace namespace --use-k8s

Vereiste parameters

--name -n

Naam van de PostgreSQL-server met Azure Arc.

Optionele parameters

--ad-account-name

De Naam van het Active Directory-account voor deze PostgreSQL-server met Azure Arc. Dit account moet worden gemaakt vóór de implementatie van dit exemplaar.

--ad-connector-name

De naam van de Active Directory-Verbinding maken or. Deze parameter geeft een intentie aan die moet worden geïmplementeerd met AD-ondersteuning.

--admin-login-secret

Naam van het Kubernetes-geheim om die host te genereren of om aanmeldingsaccountreferenties voor gebruikersbeheerders te hosten.

--cert-private-key-file

Pad naar het bestand met een persoonlijke sleutel met peM-indeling die moet worden gebruikt voor client-SSL-verbindingen.

--cert-public-key-file

Pad naar het bestand met een openbare peM-certificaatsleutel die moet worden gebruikt voor client-SSL-verbindingen.

--cores-limit

Het maximum aantal CPU-kernen dat kan worden gebruikt voor PostgreSQL-server met Azure Arc.

--cores-request

Het minimale aantal CPU-kernen dat per knooppunt beschikbaar moet zijn om de service te plannen.

--dev

Als dit is opgegeven, wordt het beschouwd als een ontwikkelexemplaren en wordt deze niet in rekening gebracht.

--dns-name

De DNS-naam van de service die beschikbaar is voor eindgebruikers om verbinding te maken met deze PostgreSQL-server met Azure Arc (bijvoorbeeld pginstancename.contoso.com).

--extensions

Lijst met door komma's gescheiden extensies die moeten worden ingeschakeld. Als de extensie is ingeschakeld, kan de extensie worden geïnstalleerd via de opdracht CREATE EXTENSION.

--k8s-namespace -k

De Kubernetes-naamruimte waar de PostgreSQL-server met Azure Arc is geïmplementeerd. Als er geen naamruimte is opgegeven, wordt de naamruimte die is gedefinieerd in de kubeconfig gebruikt.

--keytab-secret

De naam van het Kubernetes-geheim dat het keytab-bestand voor deze PostgreSQL-server met Azure Arc bevat.

--log-level

Hiermee stelt u de log_min_messages-instelling voor de PostgreSQL-engine in. Geldige waarden zijn: DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC.

--memory-limit

De geheugenlimiet van de PostgreSQL-server met Azure Arc als een getal gevolgd door Ki (kilobytes), Mi (megabytes) of Gi (gigabytes).

--memory-request

De geheugenaanvraag van de PostgreSQL-server met Azure Arc als een getal gevolgd door Ki (kilobytes), Mi (megabytes) of Gi (gigabytes).

--no-external-endpoint

Indien opgegeven, wordt er geen externe service gemaakt. Anders wordt een externe service gemaakt met behulp van het type dat is opgegeven met het argument --service-type of hetzelfde servicetype als de gegevenscontroller.

--no-wait

Wacht niet totdat de implementatie gereed is voordat u terugkeert.

standaardwaarde: False
--path

Het pad naar het JSON-bronbestand voor de PostgreSQL-server met Azure Arc. Dit is optioneel.

--port

Het poortnummer waarop de primaire service beschikbaar is voor de eindgebruikers.

--retention-days

Bewaarperiode voor back-ups, opgegeven in dagen. Toegestane waarden zijn 0 tot 35. De standaardwaarde is 7. Als u de bewaarperiode instelt op 0, worden automatische back-ups uitgeschakeld voor PostgreSql met Azure Arc.

--service-annotations

Door komma's gescheiden lijst met aantekeningen die van toepassing zijn op alle externe services.

--service-cert-secret

Naam van het Kubernetes-geheim om het SSL-certificaat te genereren.

--service-labels

Door komma's gescheiden lijst met labels die moeten worden toegepast op alle externe services.

--service-type

Het type voor de primaire service.

--storage-class-backups

De opslagklasse die moet worden gebruikt voor het maken van back-ups van permanente volumes.

--storage-class-data

De opslagklasse die moet worden gebruikt voor permanente gegevensvolumes.

--storage-class-logs

De opslagklasse die moet worden gebruikt voor permanente logboekvolumes.

--use-k8s

Gebruik lokale Kubernetes-API's om deze actie uit te voeren.

--volume-size-backups

De grootte van het opslagvolume dat moet worden gebruikt voor back-ups als een positief getal gevolgd door Ki (kilobytes), Mi (megabytes) of Gi (gigabytes).

--volume-size-data

De grootte van het opslagvolume dat moet worden gebruikt voor gegevens als een positief getal gevolgd door Ki (kilobytes), Mi (megabytes) of Gi (gigabytes).

--volume-size-logs

De grootte van het opslagvolume dat moet worden gebruikt voor logboeken als een positief getal gevolgd door Ki (kilobytes), Mi (megabytes) of Gi (gigabytes).

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az postgres server-arc delete

Preview

De opdrachtgroep 'postgres server-arc' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een PostgreSQL-server met Azure Arc verwijderen.

az postgres server-arc delete --name
                              [--force]
                              [--k8s-namespace]
                              [--use-k8s]

Voorbeelden

Een PostgreSQL-server met Azure Arc verwijderen.

az postgres server-arc delete -n pg1 --k8s-namespace namespace --use-k8s

Vereiste parameters

--name -n

Naam van de PostgreSQL-server met Azure Arc.

Optionele parameters

--force -f

Verwijder de PostgreSQL-server met Azure Arc zonder bevestiging.

standaardwaarde: False
--k8s-namespace -k

De Kubernetes-naamruimte waar de PostgreSQL-server met Azure Arc is geïmplementeerd. Als er geen naamruimte is opgegeven, wordt de naamruimte die is gedefinieerd in de kubeconfig gebruikt.

--use-k8s

Gebruik lokale Kubernetes-API's om deze actie uit te voeren.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az postgres server-arc list

Preview

De opdrachtgroep 'postgres server-arc' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een lijst weergeven met PostgreSQL-server met Azure Arc.

az postgres server-arc list [--k8s-namespace]
                            [--use-k8s]

Voorbeelden

Een lijst weergeven met PostgreSQL-server met Azure Arc.

az postgres server-arc list --k8s-namespace namespace --use-k8s

Optionele parameters

--k8s-namespace -k

De Kubernetes-naamruimte waar de PostgreSQL-servers met Azure Arc zijn geïmplementeerd. Als er geen naamruimte is opgegeven, wordt de naamruimte die is gedefinieerd in de kubeconfig gebruikt.

--use-k8s

Gebruik lokale Kubernetes-API's om deze actie uit te voeren.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az postgres server-arc restore

Preview

De opdrachtgroep 'postgres server-arc' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Herstel een PostgreSQL-server met Azure Arc vanuit een back-up van een andere server.

Als u het wachtwoord van de server wilt instellen, stelt u de omgevingsvariabele in AZDATA_PASSWORD.

az postgres server-arc restore --k8s-namespace
                               --name
                               --source-server
                               [--dry-run]
                               [--no-wait]
                               [--storage-class-backups]
                               [--storage-class-data]
                               [--storage-class-logs]
                               [--time]
                               [--use-k8s]
                               [--volume-size-backups]
                               [--volume-size-data]
                               [--volume-size-logs]

Voorbeelden

Een PostgreSQL-server met Azure Arc herstellen.

az postgres server-arc restore -n <to-pg> --source-server <from-pg> --k8s-namespace namespace --use-k8s

Vereiste parameters

--k8s-namespace -k

De Kubernetes-naamruimte die PostgreSql met Azure Arc bevat. Als er geen naamruimte is opgegeven, wordt de naamruimte die is gedefinieerd in de kubeconfig gebruikt.

--name -n

De naam van de PostgreSQL-server met Azure Arc die moet worden gemaakt.

--source-server

De naam van de PostgreSQL-server met Azure Arc waaruit u wilt herstellen.

Optionele parameters

--dry-run

Als deze optie is ingesteld, valideert u de bron- en doelresources en de tijd, zonder de herstelbewerking uit te voeren. De vroegste en meest recente hersteltijden worden geretourneerd in de status van de hersteltaak.

standaardwaarde: False
--no-wait

Wacht niet totdat de implementatie gereed is voordat u terugkeert.

standaardwaarde: False
--storage-class-backups

De opslagklasse die moet worden gebruikt voor het maken van back-ups van permanente volumes.

--storage-class-data

De opslagklasse die moet worden gebruikt voor permanente gegevensvolumes.

--storage-class-logs

De opslagklasse die moet worden gebruikt voor permanente logboekvolumes.

--time -t

Het tijdstip van de bronserver die wordt hersteld om de nieuwe PostgreSQL-server met Azure Arc te maken. Moet groter dan of gelijk zijn aan de vroegste hersteldatum/tijdwaarde van de brondatabase. De tijd moet de volgende notatie hebben: 'JJJJ-MM-DDTHH:MM:SSZ'. Als er geen tijd is opgegeven, wordt de meest recente back-up hersteld.

--use-k8s

Gebruik lokale Kubernetes-API's om deze actie uit te voeren.

--volume-size-backups

De grootte van het opslagvolume dat moet worden gebruikt voor back-ups als een positief getal gevolgd door Ki (kilobytes), Mi (megabytes) of Gi (gigabytes).

--volume-size-data

De grootte van het opslagvolume dat moet worden gebruikt voor gegevens als een positief getal gevolgd door Ki (kilobytes), Mi (megabytes) of Gi (gigabytes).

--volume-size-logs

De grootte van het opslagvolume dat moet worden gebruikt voor logboeken als een positief getal gevolgd door Ki (kilobytes), Mi (megabytes) of Gi (gigabytes).

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az postgres server-arc show

Preview

De opdrachtgroep 'postgres server-arc' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Geef de details weer van een PostgreSQL-server met Azure Arc.

az postgres server-arc show --name
                            [--k8s-namespace]
                            [--path]
                            [--use-k8s]

Voorbeelden

Geef de details weer van een PostgreSQL-server met Azure Arc.

az postgres server-arc show -n pg1 --k8s-namespace namespace --use-k8s

Vereiste parameters

--name -n

Naam van de PostgreSQL-server met Azure Arc.

Optionele parameters

--k8s-namespace -k

De Kubernetes-naamruimte waar de PostgreSQL-server met Azure Arc is geïmplementeerd. Als er geen naamruimte is opgegeven, wordt de naamruimte die is gedefinieerd in de kubeconfig gebruikt.

--path

Een pad waarin de volledige specificatie voor de PostgreSQL-server met Azure Arc moet worden geschreven. Als u dit weglaat, wordt de specificatie naar de standaarduitvoer geschreven.

--use-k8s

Gebruik lokale Kubernetes-API's om deze actie uit te voeren.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az postgres server-arc update

Preview

De opdrachtgroep 'postgres server-arc' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Werk de configuratie van een PostgreSQL-server met Azure Arc bij.

az postgres server-arc update --name
                              [--cert-private-key-file]
                              [--cert-public-key-file]
                              [--cores-limit]
                              [--cores-request]
                              [--dev]
                              [--extensions]
                              [--k8s-namespace]
                              [--keytab-secret]
                              [--log-level]
                              [--memory-limit]
                              [--memory-request]
                              [--no-external-endpoint]
                              [--no-wait]
                              [--path]
                              [--port]
                              [--retention-days]
                              [--service-annotations]
                              [--service-cert-secret]
                              [--service-labels]
                              [--service-type]
                              [--use-k8s]

Voorbeelden

Werk de configuratie van een PostgreSQL-server met Azure Arc bij.

az postgres server-arc update --path ./spec.json -n pg1 --k8s-namespace namespace --use-k8s

Schakel extensies in voor een bestaande PostgreSQL-server met Azure Arc.

az postgres server-arc update -n pg1 --extensions 'pgaudit,pg_partman' --k8s-namespace namespace --use-k8s

Verwijder extensies van een PostgreSQL-server met Azure Arc.

az postgres server-arc update -n pg1 --extensions "''" --k8s-namespace namespace --use-k8s

Vereiste parameters

--name -n

Naam van de PostgreSQL-server met Azure Arc die wordt bijgewerkt. De naam waaronder uw exemplaar is geïmplementeerd, kan niet worden gewijzigd.

Optionele parameters

--cert-private-key-file

Pad naar het bestand met een persoonlijke sleutel met peM-indeling die moet worden gebruikt voor client-SSL-verbindingen.

--cert-public-key-file

Pad naar het bestand met een openbare peM-certificaatsleutel die moet worden gebruikt voor client-SSL-verbindingen.

--cores-limit

Het maximum aantal CPU-kernen voor PostgreSQL-server met Azure Arc dat per knooppunt kan worden gebruikt. Als u de cores_limit wilt verwijderen, geeft u de waarde op als lege tekenreeks.

--cores-request

Het minimale aantal CPU-kernen dat per knooppunt beschikbaar moet zijn om de service te plannen. Als u de cores_request wilt verwijderen, geeft u de waarde op als lege tekenreeks.

--dev

Als dit is opgegeven, wordt het beschouwd als een ontwikkelexemplaren en wordt deze niet in rekening gebracht.

--extensions

Lijst met door komma's gescheiden extensies die moeten worden ingeschakeld. Als u een nieuwe extensie wilt toevoegen of verwijderen, werkt u de bestaande lijst met extensies bij. Als de extensie is ingeschakeld, kan de extensie worden geïnstalleerd via de opdracht CREATE EXTENSION.

--k8s-namespace -k

De Kubernetes-naamruimte waar de PostgreSQL-server met Azure Arc is geïmplementeerd. Als er geen naamruimte is opgegeven, wordt de naamruimte die is gedefinieerd in de kubeconfig gebruikt.

--keytab-secret

De naam van het Kubernetes-geheim dat het keytab-bestand voor deze PostgreSQL-server met Azure Arc bevat.

--log-level

Hiermee stelt u de log_min_messages-instelling voor de PostgreSQL-engine in. Geldige waarden zijn: DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC.

--memory-limit

De geheugenlimiet voor PostgreSQL-server met Azure Arc als een getal gevolgd door Ki (kilobytes), Mi (megabytes) of Gi (gigabytes). Als u de memory_limit wilt verwijderen, geeft u de waarde op als lege tekenreeks.

--memory-request

De geheugenaanvraag voor postgreSQL-server met Azure Arc als een getal gevolgd door Ki (kilobytes), Mi (megabytes) of Gi (gigabytes). Als u de memory_request wilt verwijderen, geeft u de waarde op als lege tekenreeks.

--no-external-endpoint

Indien opgegeven, wordt er geen externe service gemaakt. Anders wordt een externe service gemaakt met behulp van het type dat is opgegeven met het argument --service-type of hetzelfde servicetype als de gegevenscontroller.

--no-wait

Wacht niet totdat de implementatie gereed is voordat u terugkeert.

standaardwaarde: False
--path

Het pad naar het JSON-bronbestand voor de PostgreSQL-server met Azure Arc. Dit is optioneel.

--port

Het poortnummer waarop de primaire service beschikbaar is voor de eindgebruikers.

--retention-days

Bewaarperiode voor back-ups, opgegeven in dagen. Toegestane waarden zijn 0 tot 35. De standaardwaarde is 7. Als u de bewaarperiode instelt op 0, worden automatische back-ups uitgeschakeld voor PostgreSql met Azure Arc.

--service-annotations

Door komma's gescheiden lijst met aantekeningen die van toepassing zijn op alle externe services.

--service-cert-secret

Naam van het Kubernetes-geheim om het SSL-certificaat te genereren.

--service-labels

Door komma's gescheiden lijst met labels die moeten worden toegepast op alle externe services.

--service-type

Het type voor de primaire service.

--use-k8s

Gebruik lokale Kubernetes-API's om deze actie uit te voeren.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.