Partager via

az postgres server-arc

  • Préversion
  • Référence

Remarque

Cette référence fait partie de l’extension arcdata pour Azure CLI (version 2.3.1 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az postgres server-arc. En savoir plus sur les extensions.

Ce groupe de commandes est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Gérer les serveurs PostgreSQL avec Azure Arc.

Commandes

Nom Description Type État
az postgres server-arc create

Créez un serveur PostgreSQL avec Azure Arc.

 Extension Aperçu
az postgres server-arc delete

Supprimez un serveur PostgreSQL avec Azure Arc.

 Extension Aperçu
az postgres server-arc endpoint

Gérer les points de terminaison de serveur PostgreSQL avec Azure Arc.

 Extension Aperçu
az postgres server-arc endpoint list

Répertorier les points de terminaison de serveur PostgreSQL avec Azure Arc.

 Extension Aperçu
az postgres server-arc list

Répertoriez le serveur PostgreSQL avec Azure Arc.

 Extension Aperçu
az postgres server-arc restore

Restaurez un serveur PostgreSQL avec Azure Arc à partir d’une sauvegarde à partir d’un autre serveur.

 Extension Aperçu
az postgres server-arc show

Affichez les détails d’un serveur PostgreSQL avec Azure Arc.

 Extension Aperçu
az postgres server-arc update

Mettez à jour la configuration d’un serveur PostgreSQL avec Azure Arc.

 Extension Aperçu

az postgres server-arc create

Préversion

Le groupe de commandes « postgres server-arc » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Créez un serveur PostgreSQL avec Azure Arc.

Pour définir le mot de passe du serveur, définissez la variable d’environnement 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]

Exemples

Créez un serveur PostgreSQL avec Azure Arc.

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

Paramètres obligatoires

--name -n

Nom du serveur PostgreSQL avec Azure Arc.

Paramètres facultatifs

--ad-account-name

Nom du compte Active Directory pour ce serveur PostgreSQL avec Azure Arc. Ce compte doit être créé avant le déploiement de cette instance.

--ad-connector-name

Nom du connecteur Active Directory. Ce paramètre indique une intention de déploiement avec la prise en charge d’AD.

--admin-login-secret

Nom du secret Kubernetes pour générer ces hôtes ou hébergera les informations d’identification du compte de connexion administrateur de l’utilisateur.

--cert-private-key-file

Chemin d’accès au fichier contenant une clé privée de certificat au format PEM à utiliser pour les connexions SSL clientes.

--cert-public-key-file

Chemin d’accès au fichier contenant une clé publique de certificat au format PEM à utiliser pour les connexions SSL clientes.

--cores-limit

Nombre maximal de cœurs d’UC qui peuvent être utilisés pour le serveur PostgreSQL avec Azure Arc.

--cores-request

Nombre minimal de cœurs d’UC qui doivent être disponibles par nœud pour planifier le service.

--dev

Si cette valeur est spécifiée, elle est considérée comme une instance de développement et ne sera pas facturée.

--dns-name

Nom DNS du service exposé aux utilisateurs finaux pour se connecter à ce serveur PostgreSQL avec Azure Arc (par exemple, pginstancename.contoso.com).

--extensions

Liste des extensions séparées par des virgules à activer. Une fois activée, l’extension peut être installée via la commande « CREATE EXTENSION ».

--k8s-namespace -k

Espace de noms Kubernetes où le serveur PostgreSQL avec Azure Arc est déployé. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

--keytab-secret

Nom du secret Kubernetes qui contient le fichier keytab pour ce serveur PostgreSQL avec Azure Arc.

--log-level

Définit le paramètre log_min_messages pour le moteur PostgreSQL. Les valeurs valides sont les suivantes : DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC.

--memory-limit

Limite de mémoire du serveur PostgreSQL avec Azure Arc sous la forme d’un nombre suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

--memory-request

Demande de mémoire du serveur PostgreSQL avec Azure Arc sous la forme d’un nombre suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

--no-external-endpoint

Si spécifié, aucun service externe n’est créé. Sinon, un service externe est créé à l’aide du type donné avec l’argument --service-type ou le même type de service que le contrôleur de données.

--no-wait

N’attendez pas que le déploiement soit prêt avant de retourner.

Valeur par défaut: False
--path

Chemin d’accès au fichier json source pour le serveur PostgreSQL avec Azure Arc. Cela est facultatif.

--port

Numéro de port sur lequel le service principal est exposé aux utilisateurs finaux.

--retention-days

Période de rétention de sauvegarde, spécifiée en jours. Les valeurs autorisées sont comprises entre 0 et 35. La valeur par défaut est 7. La définition de la période de rétention sur 0 désactive les sauvegardes automatiques pour PostgreSql avec Azure Arc.

--service-annotations

Liste séparée par des virgules d’annotations à appliquer à tous les services externes.

--service-cert-secret

Nom du secret Kubernetes à générer qui héberge le certificat SSL.

--service-labels

Liste séparée par des virgules d’étiquettes à appliquer à tous les services externes.

--service-type

Type du service principal.

--storage-class-backups

Classe de stockage à utiliser pour les volumes persistants de sauvegarde.

--storage-class-data

Classe de stockage à utiliser pour les volumes persistants de données.

--storage-class-logs

Classe de stockage à utiliser pour les volumes persistants de journaux.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

--volume-size-backups

Taille du volume de stockage à utiliser pour les sauvegardes en tant que nombre positif suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

--volume-size-data

Taille du volume de stockage à utiliser pour les données en tant que nombre positif suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

--volume-size-logs

Taille du volume de stockage à utiliser pour les journaux comme nombre positif suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

az postgres server-arc delete

Préversion

Le groupe de commandes « postgres server-arc » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Supprimez un serveur PostgreSQL avec Azure Arc.

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

Exemples

Supprimez un serveur PostgreSQL avec Azure Arc.

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

Paramètres obligatoires

--name -n

Nom du serveur PostgreSQL avec Azure Arc.

Paramètres facultatifs

--force -f

Supprimez le serveur PostgreSQL avec Azure Arc sans confirmation.

Valeur par défaut: False
--k8s-namespace -k

Espace de noms Kubernetes où le serveur PostgreSQL avec Azure Arc est déployé. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

az postgres server-arc list

Préversion

Le groupe de commandes « postgres server-arc » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Répertoriez le serveur PostgreSQL avec Azure Arc.

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

Exemples

Répertoriez le serveur PostgreSQL avec Azure Arc.

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

Paramètres facultatifs

--k8s-namespace -k

Espace de noms Kubernetes où les serveurs PostgreSQL avec Azure Arc sont déployés. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

az postgres server-arc restore

Préversion

Le groupe de commandes « postgres server-arc » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Restaurez un serveur PostgreSQL avec Azure Arc à partir d’une sauvegarde à partir d’un autre serveur.

Pour définir le mot de passe du serveur, définissez la variable d’environnement 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]

Exemples

Restaurez un serveur PostgreSQL avec Azure Arc.

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

Paramètres obligatoires

--k8s-namespace -k

Espace de noms Kubernetes qui contient PostgreSql avec Azure Arc. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

--name -n

Nom du serveur PostgreSQL avec Azure Arc à créer.

--source-server

Nom du serveur PostgreSQL avec Azure Arc à partir duquel effectuer la restauration.

Paramètres facultatifs

--dry-run

Si elle est définie, valide les ressources source et de destination et l’heure, sans effectuer la restauration. Les heures de restauration les plus anciennes et les plus récentes sont retournées dans l’état de la tâche de restauration.

Valeur par défaut: False
--no-wait

N’attendez pas que le déploiement soit prêt avant de retourner.

Valeur par défaut: False
--storage-class-backups

Classe de stockage à utiliser pour les volumes persistants de sauvegarde.

--storage-class-data

Classe de stockage à utiliser pour les volumes persistants de données.

--storage-class-logs

Classe de stockage à utiliser pour les volumes persistants de journaux.

--time -t

Point dans le temps du serveur source qui sera restauré pour créer le nouveau serveur PostgreSQL avec Azure Arc. Doit être supérieur ou égal à la valeur de date/heure de restauration la plus ancienne de la base de données source. L’heure doit être au format suivant : « AAAA-MM-DDTHH :MM :SSZ ». Si aucune heure n’est fournie, la sauvegarde la plus récente est restaurée.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

--volume-size-backups

Taille du volume de stockage à utiliser pour les sauvegardes en tant que nombre positif suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

--volume-size-data

Taille du volume de stockage à utiliser pour les données en tant que nombre positif suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

--volume-size-logs

Taille du volume de stockage à utiliser pour les journaux comme nombre positif suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

az postgres server-arc show

Préversion

Le groupe de commandes « postgres server-arc » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Affichez les détails d’un serveur PostgreSQL avec Azure Arc.

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

Exemples

Affichez les détails d’un serveur PostgreSQL avec Azure Arc.

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

Paramètres obligatoires

--name -n

Nom du serveur PostgreSQL avec Azure Arc.

Paramètres facultatifs

--k8s-namespace -k

Espace de noms Kubernetes où le serveur PostgreSQL avec Azure Arc est déployé. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

--path

Chemin d’accès où la spécification complète du serveur PostgreSQL avec Azure Arc doit être écrite. Si elle est omise, la spécification est écrite en sortie standard.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

az postgres server-arc update

Préversion

Le groupe de commandes « postgres server-arc » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Mettez à jour la configuration d’un serveur PostgreSQL avec 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]

Exemples

Mettez à jour la configuration d’un serveur PostgreSQL avec Azure Arc.

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

Activez les extensions pour un serveur PostgreSQL avec Azure Arc existant.

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

Supprimez les extensions d’un serveur PostgreSQL avec Azure Arc.

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

Paramètres obligatoires

--name -n

Nom du serveur PostgreSQL avec Azure Arc en cours de mise à jour. Le nom sous lequel votre instance est déployée ne peut pas être modifié.

Paramètres facultatifs

--cert-private-key-file

Chemin d’accès au fichier contenant une clé privée de certificat au format PEM à utiliser pour les connexions SSL clientes.

--cert-public-key-file

Chemin d’accès au fichier contenant une clé publique de certificat au format PEM à utiliser pour les connexions SSL clientes.

--cores-limit

Nombre maximal de cœurs d’UC pour le serveur PostgreSQL avec Azure Arc qui peut être utilisé par nœud. Pour supprimer le cores_limit, spécifiez sa valeur sous forme de chaîne vide.

--cores-request

Nombre minimal de cœurs d’UC qui doivent être disponibles par nœud pour planifier le service. Pour supprimer le cores_request, spécifiez sa valeur en tant que chaîne vide.

--dev

Si cette valeur est spécifiée, elle est considérée comme une instance de développement et ne sera pas facturée.

--extensions

Liste des extensions séparées par des virgules à activer. Pour ajouter ou supprimer une nouvelle extension, mettez à jour la liste existante des extensions. Une fois activée, l’extension peut être installée via la commande « CREATE EXTENSION ».

--k8s-namespace -k

Espace de noms Kubernetes où le serveur PostgreSQL avec Azure Arc est déployé. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

--keytab-secret

Nom du secret Kubernetes qui contient le fichier keytab pour ce serveur PostgreSQL avec Azure Arc.

--log-level

Définit le paramètre log_min_messages pour le moteur PostgreSQL. Les valeurs valides sont les suivantes : DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC.

--memory-limit

Limite de mémoire pour le serveur PostgreSQL avec Azure Arc sous la forme d’un nombre suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets). Pour supprimer le memory_limit, spécifiez sa valeur sous forme de chaîne vide.

--memory-request

Demande de mémoire pour le serveur PostgreSQL avec Azure Arc sous la forme d’un nombre suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets). Pour supprimer le memory_request, spécifiez sa valeur en tant que chaîne vide.

--no-external-endpoint

Si spécifié, aucun service externe n’est créé. Sinon, un service externe est créé à l’aide du type donné avec l’argument --service-type ou le même type de service que le contrôleur de données.

--no-wait

N’attendez pas que le déploiement soit prêt avant de retourner.

Valeur par défaut: False
--path

Chemin d’accès au fichier json source pour le serveur PostgreSQL avec Azure Arc. Cela est facultatif.

--port

Numéro de port sur lequel le service principal est exposé aux utilisateurs finaux.

--retention-days

Période de rétention de sauvegarde, spécifiée en jours. Les valeurs autorisées sont comprises entre 0 et 35. La valeur par défaut est 7. La définition de la période de rétention sur 0 désactive les sauvegardes automatiques pour PostgreSql avec Azure Arc.

--service-annotations

Liste séparée par des virgules d’annotations à appliquer à tous les services externes.

--service-cert-secret

Nom du secret Kubernetes à générer qui héberge le certificat SSL.

--service-labels

Liste séparée par des virgules d’étiquettes à appliquer à tous les services externes.

--service-type

Type du service principal.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.