az postgres server-arc

Nota

Questo riferimento fa parte dell'estensione arcdata per l'interfaccia della riga di comando di Azure (versione 2.3.1 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az postgres server-arc . Altre informazioni sulle estensioni.

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire i server PostgreSQL abilitati per Azure Arc.

Comandi

Nome Descrizione Tipo Stato
az postgres server-arc create

Creare un server PostgreSQL abilitato per Azure Arc.

Estensione Anteprima
az postgres server-arc delete

Eliminare un server PostgreSQL abilitato per Azure Arc.

Estensione Anteprima
az postgres server-arc endpoint

Gestire gli endpoint server PostgreSQL abilitati per Azure Arc.

Estensione Anteprima
az postgres server-arc endpoint list

Elencare gli endpoint server PostgreSQL abilitati per Azure Arc.

Estensione Anteprima
az postgres server-arc list

Elencare il server PostgreSQL abilitato per Azure Arc.

Estensione Anteprima
az postgres server-arc restore

Ripristinare un server PostgreSQL abilitato per Azure Arc dal backup da un altro server.

Estensione Anteprima
az postgres server-arc show

Visualizzare i dettagli di un server PostgreSQL abilitato per Azure Arc.

Estensione Anteprima
az postgres server-arc update

Aggiornare la configurazione di un server PostgreSQL abilitato per Azure Arc.

Estensione Anteprima

az postgres server-arc create

Anteprima

Il gruppo di comandi 'postgres server-arc' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare un server PostgreSQL abilitato per Azure Arc.

Per impostare la password del server, impostare la variabile di ambiente 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]

Esempio

Creare un server PostgreSQL abilitato per Azure Arc.

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

Parametri necessari

--name -n

Nome del server PostgreSQL abilitato per Azure Arc.

Parametri facoltativi

--ad-account-name

Nome dell'account Active Directory per questo server PostgreSQL abilitato per Azure Arc. Questo account deve essere creato prima della distribuzione di questa istanza.

--ad-connector-name

Nome del Connessione or di Active Directory. Questo parametro indica una finalità da distribuire con il supporto di ACTIVE Directory.

--admin-login-secret

Nome del segreto Kubernetes per generare tale host o ospiterà le credenziali dell'account di accesso dell'amministratore utente.

--cert-private-key-file

Percorso del file contenente una chiave privata del certificato con formattazione PEM da usare per le connessioni SSL client.

--cert-public-key-file

Percorso del file contenente una chiave pubblica del certificato con formattazione PEM da usare per le connessioni SSL client.

--cores-limit

Numero massimo di core CPU che possono essere usati per il server PostgreSQL con abilitazione di Azure Arc.

--cores-request

Numero minimo di core della CPU che devono essere disponibili per ogni nodo per pianificare il servizio.

--dev

Se specificato, viene considerata un'istanza di sviluppo e non verrà fatturata.

--dns-name

Nome DNS del servizio esposto agli utenti finali per connettersi al server PostgreSQL abilitato per Azure Arc, ad esempio pginstancename.contoso.com.

--extensions

Elenco di estensioni delimitato da virgole da abilitare. Una volta abilitata, l'estensione può essere installata tramite il comando 'CREATE EXTENSION'.

--k8s-namespace -k

Spazio dei nomi Kubernetes in cui viene distribuito il server PostgreSQL abilitato per Azure Arc. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--keytab-secret

Nome del segreto Kubernetes che contiene il file keytab per questo server PostgreSQL abilitato per Azure Arc.

--log-level

Imposta l'impostazione log_min_messages per il motore PostgreSQL. I valori validi sono: DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, AVVISO, AVVISO, ERRORE, LOG, FATAL, PANIC.

--memory-limit

Limite di memoria del server PostgreSQL abilitato per Azure Arc come numero seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

--memory-request

La richiesta di memoria del server PostgreSQL abilitato per Azure Arc come numero seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

--no-external-endpoint

Se specificato, non verrà creato alcun servizio esterno. In caso contrario, verrà creato un servizio esterno usando il tipo specificato con l'argomento --service-type o lo stesso tipo di servizio del controller dati.

--no-wait

Non attendere che la distribuzione sia pronta prima della restituzione.

valore predefinito: False
--path

Percorso del file JSON di origine per il server PostgreSQL abilitato per Azure Arc. (Facoltativo).

--port

Numero di porta in cui il servizio primario viene esposto agli utenti finali.

--retention-days

Periodo di conservazione dei backup, specificato in giorni. I valori consentiti sono compresi tra 0 e 35. Il valore predefinito è 7. L'impostazione del periodo di conservazione su 0 disattiva i backup automatici per PostgreSql con abilitazione di Azure Arc.

--service-annotations

Elenco delimitato da virgole di annotazioni da applicare a tutti i servizi esterni.

--service-cert-secret

Nome del segreto Kubernetes per generare che ospita il certificato SSL.

--service-labels

Elenco delimitato da virgole di etichette da applicare a tutti i servizi esterni.

--service-type

Tipo per il servizio primario.

--storage-class-backups

Classe di archiviazione da usare per i volumi permanenti di backup.

--storage-class-data

Classe di archiviazione da usare per i volumi permanenti di dati.

--storage-class-logs

Classe di archiviazione da usare per i volumi permanenti di log.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

--volume-size-backups

Dimensioni del volume di archiviazione da usare per i backup come numero positivo seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

--volume-size-data

Dimensioni del volume di archiviazione da usare per i dati come numero positivo seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

--volume-size-logs

Dimensioni del volume di archiviazione da usare per i log come numero positivo seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az postgres server-arc delete

Anteprima

Il gruppo di comandi 'postgres server-arc' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare un server PostgreSQL abilitato per Azure Arc.

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

Esempio

Eliminare un server PostgreSQL abilitato per Azure Arc.

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

Parametri necessari

--name -n

Nome del server PostgreSQL abilitato per Azure Arc.

Parametri facoltativi

--force -f

Eliminare il server PostgreSQL abilitato per Azure Arc senza confermare.

valore predefinito: False
--k8s-namespace -k

Spazio dei nomi Kubernetes in cui viene distribuito il server PostgreSQL abilitato per Azure Arc. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az postgres server-arc list

Anteprima

Il gruppo di comandi 'postgres server-arc' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare il server PostgreSQL abilitato per Azure Arc.

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

Esempio

Elencare il server PostgreSQL abilitato per Azure Arc.

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

Parametri facoltativi

--k8s-namespace -k

Spazio dei nomi Kubernetes in cui vengono distribuiti i server PostgreSQL abilitati per Azure Arc. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az postgres server-arc restore

Anteprima

Il gruppo di comandi 'postgres server-arc' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ripristinare un server PostgreSQL abilitato per Azure Arc dal backup da un altro server.

Per impostare la password del server, impostare la variabile di ambiente 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]

Esempio

Ripristinare un server PostgreSQL abilitato per Azure Arc.

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

Parametri necessari

--k8s-namespace -k

Spazio dei nomi Kubernetes che contiene PostgreSql abilitato per Azure Arc. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--name -n

Nome del server PostgreSQL abilitato per Azure Arc da creare.

--source-server

Nome del server PostgreSQL abilitato per Azure Arc da cui eseguire il ripristino.

Parametri facoltativi

--dry-run

Se impostato, convalida le risorse di origine e di destinazione e l'ora, senza eseguire il ripristino. I tempi di ripristino più recenti e più recenti vengono restituiti nello stato dell'attività di ripristino.

valore predefinito: False
--no-wait

Non attendere che la distribuzione sia pronta prima della restituzione.

valore predefinito: False
--storage-class-backups

Classe di archiviazione da usare per i volumi permanenti di backup.

--storage-class-data

Classe di archiviazione da usare per i volumi permanenti di dati.

--storage-class-logs

Classe di archiviazione da usare per i volumi permanenti di log.

--time -t

Punto nel tempo del server di origine che verrà ripristinato per creare il nuovo server PostgreSQL abilitato per Azure Arc. Deve essere maggiore o uguale al valore di data/ora di ripristino meno recente del database di origine. L'ora deve essere nel formato seguente: 'AAAA-MM-GGTHH:MM:SSZ'. Se non viene specificato alcun tempo, verrà ripristinato il backup più recente.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

--volume-size-backups

Dimensioni del volume di archiviazione da usare per i backup come numero positivo seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

--volume-size-data

Dimensioni del volume di archiviazione da usare per i dati come numero positivo seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

--volume-size-logs

Dimensioni del volume di archiviazione da usare per i log come numero positivo seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az postgres server-arc show

Anteprima

Il gruppo di comandi 'postgres server-arc' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Visualizzare i dettagli di un server PostgreSQL abilitato per Azure Arc.

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

Esempio

Visualizzare i dettagli di un server PostgreSQL abilitato per Azure Arc.

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

Parametri necessari

--name -n

Nome del server PostgreSQL abilitato per Azure Arc.

Parametri facoltativi

--k8s-namespace -k

Spazio dei nomi Kubernetes in cui viene distribuito il server PostgreSQL abilitato per Azure Arc. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--path

Percorso in cui deve essere scritta la specifica completa per il server PostgreSQL abilitato per Azure Arc. Se omesso, la specifica verrà scritta nell'output standard.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az postgres server-arc update

Anteprima

Il gruppo di comandi 'postgres server-arc' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare la configurazione di un server PostgreSQL abilitato per Azure Arc.

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]

Esempio

Aggiornare la configurazione di un server PostgreSQL abilitato per Azure Arc.

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

Abilitare le estensioni per un server PostgreSQL abilitato per Azure Arc esistente.

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

Rimuovere le estensioni da un server PostgreSQL abilitato per Azure Arc.

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

Parametri necessari

--name -n

Nome del server PostgreSQL abilitato per Azure Arc che viene aggiornato. Il nome con cui viene distribuita l'istanza non può essere modificato.

Parametri facoltativi

--cert-private-key-file

Percorso del file contenente una chiave privata del certificato con formattazione PEM da usare per le connessioni SSL client.

--cert-public-key-file

Percorso del file contenente una chiave pubblica del certificato con formattazione PEM da usare per le connessioni SSL client.

--cores-limit

Numero massimo di core CPU per il server PostgreSQL abilitato per Azure Arc che può essere usato per ogni nodo. Per rimuovere cores_limit, specificare il valore come stringa vuota.

--cores-request

Numero minimo di core della CPU che devono essere disponibili per ogni nodo per pianificare il servizio. Per rimuovere cores_request, specificare il valore come stringa vuota.

--dev

Se specificato, viene considerata un'istanza di sviluppo e non verrà fatturata.

--extensions

Elenco di estensioni delimitato da virgole da abilitare. Per aggiungere o rimuovere una nuova estensione, aggiornare l'elenco di estensioni esistente. Una volta abilitata, l'estensione può essere installata tramite il comando 'CREATE EXTENSION'.

--k8s-namespace -k

Spazio dei nomi Kubernetes in cui viene distribuito il server PostgreSQL abilitato per Azure Arc. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--keytab-secret

Nome del segreto Kubernetes che contiene il file keytab per questo server PostgreSQL abilitato per Azure Arc.

--log-level

Imposta l'impostazione log_min_messages per il motore PostgreSQL. I valori validi sono: DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, AVVISO, AVVISO, ERRORE, LOG, FATAL, PANIC.

--memory-limit

Limite di memoria per il server PostgreSQL abilitato per Azure Arc come numero seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte). Per rimuovere memory_limit, specificare il valore come stringa vuota.

--memory-request

Richiesta di memoria per il server PostgreSQL abilitato per Azure Arc come numero seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte). Per rimuovere memory_request, specificare il valore come stringa vuota.

--no-external-endpoint

Se specificato, non verrà creato alcun servizio esterno. In caso contrario, verrà creato un servizio esterno usando il tipo specificato con l'argomento --service-type o lo stesso tipo di servizio del controller dati.

--no-wait

Non attendere che la distribuzione sia pronta prima della restituzione.

valore predefinito: False
--path

Percorso del file JSON di origine per il server PostgreSQL abilitato per Azure Arc. (Facoltativo).

--port

Numero di porta in cui il servizio primario viene esposto agli utenti finali.

--retention-days

Periodo di conservazione dei backup, specificato in giorni. I valori consentiti sono compresi tra 0 e 35. Il valore predefinito è 7. L'impostazione del periodo di conservazione su 0 disattiva i backup automatici per PostgreSql con abilitazione di Azure Arc.

--service-annotations

Elenco delimitato da virgole di annotazioni da applicare a tutti i servizi esterni.

--service-cert-secret

Nome del segreto Kubernetes per generare che ospita il certificato SSL.

--service-labels

Elenco delimitato da virgole di etichette da applicare a tutti i servizi esterni.

--service-type

Tipo per il servizio primario.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.