az postgres flexible-server replica

Gérer les réplicas en lecture.

Commandes

Nom Description Type État
az postgres flexible-server replica create

Crée un réplica en lecture pour un serveur.

Core GA
az postgres flexible-server replica list

Liste tous les réplicas en lecture d’un serveur donné.

Core GA
az postgres flexible-server replica promote

Arrêtez la réplication d’un réplica en lecture et promouvez-le vers un serveur indépendant ou en tant que serveur principal.

Core GA

az postgres flexible-server replica create

Crée un réplica en lecture pour un serveur.

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]

Exemples

Créez un réplica en lecture « testreplica » pour « testserver » avec accès public ou privé dans la zone et l’emplacement spécifiés si disponible.

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

Créez un réplica en lecture « testreplica » pour « testserver » avec un accès privé à l’aide de ressources réseau existantes.

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"

Créez un réplica en lecture « testreplica » pour « testserver » avec un accès public ou privé à l’emplacement spécifié si disponible. Étant donné que la zone n’est pas passée, elle récupère automatiquement la zone à l’emplacement du réplica différent du serveur source, le cas échéant, elle récupère la zone identique à celle du serveur source dans l’emplacement du réplica si disponible, sinon elle définit la zone comme Aucun, c’est-à-dire aucune préférence.

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

Créez un réplica en lecture « testreplica » pour « testserver » avec une taille personnalisée --storage-size et --sku.

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

Créez un réplica en lecture « testreplica » pour « testserver », où « testreplica » se trouve dans un autre groupe de ressources « newTestGroup ». Ici, --resource-group est destiné au groupe de ressources du réplica en lecture, et --source-server doit être passé en tant qu’identificateur de ressource.

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

Paramètres obligatoires

--name -n

Nom du réplica en lecture.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--source-server

Nom ou identificateur de ressource du serveur source à partir duquel effectuer la restauration.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--identity

Nom ou identificateur de ressource de l’identité affectée par l’utilisateur pour le chiffrement des données.

--key

Identificateur de ressource de la clé de coffre de clés primaire pour le chiffrement des données.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--performance-tier

Niveau de performances du serveur.

--private-dns-zone

Ce paramètre s’applique uniquement à un serveur disposant d’un accès privé et est requis lors de l’utilisation de --vnet ou --subnet. Nom ou identificateur de ressource d’une zone DNS privée existante. Vous pouvez utiliser une zone DNS privée à partir du même groupe de ressources, d’un autre groupe de ressources ou d’un autre abonnement. Si vous souhaitez utiliser une zone à partir d’un autre groupe de ressources ou d’un autre abonnement, indiquez son identificateur de ressource.

--sku-name

Nom de la référence SKU de calcul. Suit la convention Standard_{nom de machine virtuelle}. Exemples : Standard_B1ms.

--storage-size

Capacité de stockage du serveur. Le minimum est de 32 Gio et le maximum est de 16 Tio.

--storage-type

Type de stockage pour le réplica en lecture. La valeur autorisée est PremiumV2_LRS. La valeur par défaut est que le réplica en lecture corresponde au type de stockage du serveur principal.

Propriété Valeur
Valeurs acceptées: PremiumV2_LRS
--subnet

Nom ou identificateur d’un sous-réseau existant. Si vous souhaitez utiliser un sous-réseau à partir d’un autre groupe de ressources ou d’un autre abonnement, indiquez son identificateur de ressource au lieu du nom.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--tier

Niveau de calcul du serveur. Valeurs acceptées : Burstable, GeneralPurpose, MemoryOptimized.

--vnet

Nom ou identificateur d’un réseau virtuel existant. Si vous souhaitez utiliser un réseau virtuel à partir d’un autre groupe de ressources ou d’un autre abonnement, indiquez un identificateur de ressource. Le nom doit avoir entre 2 et 64 caractères. Le nom doit commencer par une lettre ou un chiffre et se terminer par une lettre, un chiffre ou un trait de soulignement, et il ne peut contenir que des lettres, des chiffres, des traits de soulignement, des points ou des traits d’union.

--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
--zone -z

Zone de disponibilité dans laquelle approvisionner la ressource.

Paramètres globaux
--debug

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

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriété Valeur
Valeur par défaut: False

az postgres flexible-server replica list

Liste tous les réplicas en lecture d’un serveur donné.

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

Exemples

Répertoriez tous les réplicas en lecture pour le serveur maître « testserver ».

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom du serveur. Le nom ne peut contenir que des lettres minuscules, des chiffres et le caractère de trait d’union (-). 3 caractères minimum et 63 caractères maximum.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
Paramètres globaux
--debug

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

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

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

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

--verbose

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

Propriété Valeur
Valeur par défaut: False

az postgres flexible-server replica promote

Arrêtez la réplication d’un réplica en lecture et promouvez-le vers un serveur indépendant ou en tant que serveur principal.

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]

Exemples

Arrêtez la réplication sur « testreplica » et promouvez-la comme un serveur en lecture/écriture autonome.

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

Arrêtez la réplication sur « testreplica » et promouvez-la comme un serveur en lecture/écriture autonome avec la synchronisation de données forcée.

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

Arrêtez la réplication sur « testreplica » et promouvez-la vers le serveur principal avec la synchronisation planifiée des données. Le réplica que vous promomettez doit avoir le point de terminaison virtuel du lecteur affecté, ou vous recevrez une erreur lors de la promotion.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom du réplica en lecture.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--promote-mode

Qu’il s’agisse de promouvoir le réplica en lecture vers un serveur indépendant ou de le promouvoir en tant que serveur principal.

Propriété Valeur
Valeur par défaut: standalone
Valeurs acceptées: standalone, switchover
--promote-option

Indique s’il faut synchroniser les données avant de promouvoir le réplica en lecture ou promouvoir dès que possible.

Propriété Valeur
Valeur par défaut: planned
Valeurs acceptées: forced, planned
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

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

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

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

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

--verbose

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

Propriété Valeur
Valeur par défaut: False