az postgres flexible-server | Microsoft Learn

Exemples

Créer un serveur flexible PostgreSQL avec des paramètres personnalisés

az postgres flexible-server create --location northeurope --resource-group testGroup \
  --name testserver --admin-user username --admin-password password \
  --sku-name Standard_B1ms --tier Burstable --public-access 153.24.26.117 --storage-size 128 \
  --tags "key=value" --version 13 --high-availability Enabled --zone 1 \
  --standby-zone 3

Créez un serveur flexible PostgreSQL avec les paramètres par défaut et l’accès public activés par défaut. Le groupe de ressources, le nom du serveur, le nom d’utilisateur, le mot de passe et la base de données par défaut seront créés par l’interface CLI

az postgres flexible-server create

Créez un serveur flexible PostgreSQL avec accès public et ajoutez la plage d’adresses IP pour avoir accès à ce serveur. Le paramètre --public-access peut être « All », « None », <startIpAddress>ou <startIpAddress>-<endIpAddress>

az postgres flexible-server create --resource-group testGroup --name testserver --public-access 125.23.54.31-125.23.54.35

Créez un serveur flexible PostgreSQL avec accès privé. Si le réseau virtuel et le sous-réseau fournis n’existent pas, le réseau virtuel et le sous-réseau avec les préfixes d’adresse spécifiés sont créés.

az postgres flexible-server create --resource-group testGroup --name testserver --vnet myVnet --subnet mySubnet --address-prefixes 10.0.0.0/16 --subnet-prefixes 10.0.0.0/24

Créez un serveur flexible PostgreSQL à l’aide d’un nouvel ID de ressource de sous-réseau et d’un nouvel ID de ressource de zone DNS privée. Le sous-réseau et la zone DNS peuvent être créés dans un abonnement ou un groupe de ressources différent.

az postgres flexible-server create \
  --resource-group testGroup --name testserver \
  --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNetName}/subnets/{SubnetName} \
  --private-dns-zone /subscriptions/{SubID}/resourceGroups/{resourceGroup}/providers/Microsoft.Network/privateDnsZones/testPostgreSQLFlexibleDnsZone.private.postgres.database.azure.com \
  --address-prefixes 172.0.0.0/16 --subnet-prefixes 172.0.0.0/24

Créez un serveur flexible PostgreSQL à l’aide de ressources réseau existantes dans le même groupe de ressources. Le sous-réseau fourni ne doit pas contenir d’autres ressources déjà déployées. Il est délégué à Microsoft.DBforPostgreSQL/flexibleServers, en l’absence de délégation existante. La zone DNS privée est liée au réseau virtuel si elle n’est pas déjà liée.

# create vnet
az network vnet create --resource-group testGroup --name testVnet --location testLocation --address-prefixes 172.0.0.0/16
# create subnet
az network vnet subnet create --resource-group testGroup --vnet-name testVnet --address-prefixes 172.0.0.0/24 --name testSubnet
# create private dns zone
az network private-dns zone create -g testGroup -n testDNS.private.postgres.database.azure.com
az postgres flexible-server create --resource-group testGroup \
  --name testserver --location testLocation \
  --subnet /subscriptions/{SubId}/resourceGroups/{testGroup}/providers/Microsoft.Network/virtualNetworks/tesetVnet/subnets/testSubnet \
  --private-dns-zone /subscriptions/{SubId}/resourceGroups/{testGroup}/providers/Microsoft.Network/privateDnsZones/testDNS.postgres.database.azure.com\
az postgres flexible-server create --resource-group testGroup --name testserver \
  --vnet testVnet --subnet testSubnet --location testLocation \
  --private-dns-zone /subscriptions/{SubId}/resourceGroups/{testGroup}/providers/Microsoft.Network/privateDnsZones/testDNS.postgres.database.azure.com

Créez un serveur flexible PostgreSQL à l’aide des ressources réseau existantes dans le groupe de ressources/abonnement différent.

az postgres flexible-server create --resource-group testGroup \
   --name testserver --location testLocation \
  --subnet /subscriptions/{SubId2}/resourceGroups/{testGroup2}/providers/Microsoft.Network/virtualNetworks/tesetVnet/subnets/testSubnet \
  --private-dns-zone /subscriptions/{SubId2}/resourceGroups/{testGroup2}/providers/Microsoft.Network/privateDnsZones/testDNS.postgres.database.azure.com

Créez un serveur flexible PostgreSQL avec chiffrement des données.

# create keyvault
az keyvault create -g testGroup -n testVault --location testLocation \
  --enable-purge-protection true
# create key in keyvault and save its key identifier
keyIdentifier=$(az keyvault key create --name testKey -p software \
  --vault-name testVault --query key.kid -o tsv)
# create identity and save its principalId
identityPrincipalId=$(az identity create -g testGroup --name testIdentity \
  --location testLocation --query principalId -o tsv)
# add testIdentity as an access policy with key permissions 'Wrap Key', 'Unwrap Key', 'Get' and 'List' inside testVault
az keyvault set-policy -g testGroup -n testVault --object-id $identityPrincipalId \
  --key-permissions wrapKey unwrapKey get list
# create flexible server with data encryption enabled
az postgres flexible-server create -g testGroup -n testServer --location testLocation \
  --key $keyIdentifier --identity testIdentity

Créez un serveur flexible PostgreSQL avec l’authentification Active Directory ainsi que l’authentification par mot de passe.

# create flexible server with aad auth and password auth enabled
az postgres flexible-server create -g testGroup -n testServer --location testLocation \
  --active-directory-auth Enabled

Créez un serveur flexible PostgreSQL avec l’authentification Active Directory uniquement.

# create flexible server with aad only auth and password auth disabled
az postgres flexible-server create -g testGroup -n testServer --location testLocation \
  --active-directory-auth Enabled --password-auth Disabled

Créez un serveur flexible PostgreSQL avec l’accès public et la sauvegarde géoredondante activée et ajoutez la plage d’adresses IP pour avoir accès à ce serveur. Le paramètre --public-access peut être « All », « None », <startIpAddress>ou <startIpAddress>-<endIpAddress>

az postgres flexible-server create --resource-group testGroup --name testserver --geo-redundant-backup Enabled --public-access 125.23.54.31-125.23.54.35

Créez un serveur flexible PostgreSQL avec le chiffrement des données pour le serveur géo-exécuté avec sauvegarde.

# create keyvault
az keyvault create -g testGroup -n testVault --location testLocation \
  --enable-purge-protection true
# create key in keyvault and save its key identifier
keyIdentifier=$(az keyvault key create --name testKey -p software \
  --vault-name testVault --query key.kid -o tsv)
# create identity and save its principalId
identityPrincipalId=$(az identity create -g testGroup --name testIdentity \
  --location testLocation --query principalId -o tsv)
# add testIdentity as an access policy with key permissions 'Wrap Key', 'Unwrap Key', 'Get' and 'List' inside testVault
az keyvault set-policy -g testGroup -n testVault --object-id $identityPrincipalId \
  --key-permissions wrapKey unwrapKey get list
# create keyvault in geo-paired region
az keyvault create -g testGroup -n geoVault --location geoPairedLocation \
  --enable-purge-protection true
# create key in keyvault and save its key identifier
geoKeyIdentifier=$(az keyvault key create --name geoKey -p software \
  --vault-name geoVault --query key.kid -o tsv)
# create identity in geo-raired location and save its principalId
geoIdentityPrincipalId=$(az identity create -g testGroup --name geoIdentity \
  --location geoPairedLocation --query principalId -o tsv)
# add testIdentity as an access policy with key permissions 'Wrap Key', 'Unwrap Key', 'Get' and 'List' inside testVault
az keyvault set-policy -g testGroup -n geoVault --object-id $geoIdentityPrincipalId \
  --key-permissions wrapKey unwrapKey get list
# create flexible server with data encryption enabled for geo-backup Enabled server
az postgres flexible-server create -g testGroup -n testServer --location testLocation --geo-redundant-backup Enabled \
  --key $keyIdentifier --identity testIdentity --backup-key $geoKeyIdentifier --backup-identity geoIdentity

Paramètres facultatifs

--active-directory-auth

Indique si l’authentification Azure Active Directory est activée.

valeurs acceptées: Disabled, Enabled

valeur par défaut: Disabled

--address-prefixes

Préfixe d’adresse IP à utiliser lors de la création d’un réseau virtuel au format CIDR. La valeur par défaut est 10.0.0.0/16.

--admin-password -p

Mot de passe de l’administrateur. 8 caractères minimum et maximum 128 caractères. Le mot de passe doit contenir des caractères de trois des catégories suivantes : Lettres majuscules, lettres minuscules, chiffres et caractères non alphanumériques.

--admin-user -u

Nom d’utilisateur administrateur du serveur. Une fois défini, il ne peut pas être modifié.

valeur par défaut: sanecheetah3

--backup-identity

Nom ou ID de ressource de l’identité utilisateur de la géo-sauvegarde pour le chiffrement des données. L’identité doit se trouver dans la même région que la région de sauvegarde.

--backup-key

ID de ressource de la clé de coffre de clés de géo-sauvegarde pour le chiffrement des données. La clé doit se trouver dans la même région que la région de sauvegarde.

--backup-retention

Nombre de jours pendant lesquels une sauvegarde est conservée. Plage de 7 à 35 jours. La valeur par défaut est 7 jours.

valeur par défaut: 7

--database-name -d

Nom de la base de données à créer lors de l’approvisionnement du serveur de base de données.

--geo-redundant-backup

Indique si la sauvegarde géoredondante est activée ou non.

valeurs acceptées: Disabled, Enabled

valeur par défaut: Disabled

--high-availability

Activez (ZoneRedundant ou SameZone) ou désactivez la fonctionnalité de haute disponibilité.

valeurs acceptées: Disabled, SameZone, ZoneRedundant

valeur par défaut: Disabled

--identity

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

--key

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

--location -l

Lieu. Valeurs provenant de : az account list-locations . Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location> .

--name -n

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

--password-auth

Indique si l’authentification par mot de passe est activée.

valeurs acceptées: Disabled, Enabled

valeur par défaut: Enabled

--private-dns-zone

Ce paramètre s’applique uniquement à un serveur avec accès privé. Nom ou ID de la zone DNS privée nouvelle ou existante. Vous pouvez utiliser la zone dns privée à partir du même groupe de ressources, d’un groupe de ressources différent ou d’un abonnement différent. Si vous souhaitez utiliser une zone d’un autre groupe de ressources ou abonnement, indiquez l’ID de ressource. L’interface CLI crée une zone DNS privée dans le même groupe de ressources que le réseau virtuel si elle n’est pas fournie par les utilisateurs.

--public-access

Détermine l’accès public. Entrez une seule ou plage d’adresses IP à inclure dans la liste des adresses IP autorisées. Les plages d’adresses IP doivent être séparées par des tirets et ne contenir aucun espace. La spécification de 0.0.0.0 autorise l’accès public à partir de toutes les ressources déployées dans Azure pour accéder à votre serveur. Le fait de le définir sur « None » définit le serveur en mode d’accès public, mais ne crée pas de règle de pare-feu.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--sku-name

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

valeur par défaut: Standard_D2s_v3

--standby-zone

Informations de zone de disponibilité du serveur de secours lorsque la haute disponibilité est activée.

--storage-size

Capacité de stockage du serveur. La valeur minimale est de 32 Gio et la valeur maximale est de 16 Tio.

valeur par défaut: 128

--subnet

Nom ou ID de ressource d’un sous-réseau nouveau ou existant. Si vous souhaitez utiliser un sous-réseau d’un autre groupe de ressources ou abonnement, indiquez l’ID de ressource au lieu du nom. Notez que le sous-réseau sera délégué à flexibleServers. Après la délégation, ce sous-réseau ne peut pas être utilisé pour tout autre type de ressources Azure.

--subnet-prefixes

Préfixe d’adresse IP de sous-réseau à utiliser lors de la création d’un sous-réseau au format CIDR. La valeur par défaut est 10.0.0.0/24.

--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.

valeur par défaut: GeneralPurpose

--version

Version principale du serveur.

valeur par défaut: 13

--vnet

Nom ou ID d’un réseau virtuel nouveau ou existant. Si vous souhaitez utiliser un réseau virtuel à partir d’un groupe de ressources ou d’un abonnement différent, fournissez un ID de ressource. Le nom doit comporter 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

Ne pas demander de confirmation.

valeur par défaut: False

--zone -z

Zone de disponibilité dans laquelle provisionner la ressource.

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

Exemples

Supprimer un serveur flexible.

az postgres flexible-server delete --resource-group testGroup --name testserver

Supprimez un serveur flexible sans invite ni confirmation.

az postgres flexible-server delete --resource-group testGroup --name testserver --yes

Paramètres facultatifs

--ids

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

--name -n

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

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--subscription

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

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

Exemples

Géorestaurer le serveur d’accès public « testserver » sur un nouveau serveur « testserverNew » à l’emplacement « newLocation » avec accès public.

az postgres flexible-server geo-restore --resource-group testGroup --name testserverNew --source-server testserver --location newLocation

Géorestaurer le serveur d’accès privé « testserver » en tant que nouveau serveur « testserverNouveau » avec un nouveau sous-réseau. Un nouveau réseau virtuel, un nouveau sous-réseau et une nouvelle zone DNS privée pour le serveur restauré seront provisionnés. Reportez-vous à la commande « flexible-server create » pour plus de scénarios d’accès privé.

az postgres flexible-server geo-restore --resource-group testGroup --name testserverNew \
  --source-server testserver --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 --location newLocation

Paramètres obligatoires

--location -l

Lieu. Valeurs provenant de : az account list-locations . Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location> .

--source-server

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

Paramètres facultatifs

--address-prefixes

Préfixe d’adresse IP à utiliser lors de la création d’un réseau virtuel au format CIDR. La valeur par défaut est 10.0.0.0/16.

--backup-identity

Nom ou ID de ressource de l’identité utilisateur de la géo-sauvegarde pour le chiffrement des données. L’identité doit se trouver dans la même région que la région de sauvegarde.

--backup-key

ID de ressource de la clé de coffre de clés de géo-sauvegarde pour le chiffrement des données. La clé doit se trouver dans la même région que la région de sauvegarde.

--geo-redundant-backup

Indique si la sauvegarde géoredondante est activée ou non.

valeurs acceptées: Disabled, Enabled

valeur par défaut: Disabled

--identity

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

--ids

--key

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

--name -n

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

--no-wait

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

valeur par défaut: False

--private-dns-zone

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--subnet

--subnet-prefixes

Préfixe d’adresse IP de sous-réseau à utiliser lors de la création d’un sous-réseau au format CIDR. La valeur par défaut est 10.0.0.0/24.

--subscription

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

--vnet

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

--zone -z

Zone de disponibilité dans laquelle provisionner la ressource.

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

Exemples

Répertorier tous les serveurs flexibles PostgreSQL d’un abonnement.

az postgres flexible-server list

Répertorier tous les serveurs flexibles PostgreSQL dans un groupe de ressources.

az postgres flexible-server list --resource-group testGroup

Répertorier tous les serveurs flexibles PostgreSQL dans un groupe de ressources au format table.

az postgres flexible-server list --resource-group testGroup --output table

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

Exemples

Redémarrez un serveur flexible.

az postgres flexible-server restart --resource-group testGroup --name testserver

Redémarrer un serveur avec basculement planifié

az postgres flexible-server restart --resource-group testGroup --name testserver --failover Planned

Redémarrer un serveur avec basculement forcé

az postgres flexible-server restart --resource-group testGroup --name testserver --failover Forced

Paramètres facultatifs

--failover

Forcé ou basculement planifié pour l’opération de redémarrage du serveur. Valeurs autorisées : Forcé, Planifié.

--ids

--name -n

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

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--subscription

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

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

az postgres flexible-server restore --source-server
                                    [--address-prefixes]
                                    [--backup-identity]
                                    [--backup-key]
                                    [--geo-redundant-backup {Disabled, Enabled}]
                                    [--identity]
                                    [--ids]
                                    [--key]
                                    [--name]
                                    [--no-wait]
                                    [--private-dns-zone]
                                    [--resource-group]
                                    [--restore-time]
                                    [--subnet]
                                    [--subnet-prefixes]
                                    [--subscription]
                                    [--vnet]
                                    [--yes]
                                    [--zone]

Exemples

Restaurez « testserver » à un point dans le temps spécifique en tant que nouveau serveur « testserverNew ».

az postgres flexible-server restore --resource-group testGroup --name testserverNew --source-server testserver --restore-time "2017-06-15T13:10:00Z"

Restaurez « testserver » à un point dans le temps actuel en tant que nouveau serveur « testserverNew ».

az postgres flexible-server restore --resource-group testGroup --name testserverNew --source-server testserver

Paramètres obligatoires

--source-server

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

Paramètres facultatifs

--address-prefixes

Préfixe d’adresse IP à utiliser lors de la création d’un réseau virtuel au format CIDR. La valeur par défaut est 10.0.0.0/16.

--backup-identity

Nom ou ID de ressource de l’identité utilisateur de la géo-sauvegarde pour le chiffrement des données. L’identité doit se trouver dans la même région que la région de sauvegarde.

--backup-key

ID de ressource de la clé de coffre de clés de géo-sauvegarde pour le chiffrement des données. La clé doit se trouver dans la même région que la région de sauvegarde.

--geo-redundant-backup

Indique si la sauvegarde géoredondante est activée ou non.

valeurs acceptées: Disabled, Enabled

valeur par défaut: Disabled

--identity

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

--ids

--key

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

--name -n

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

--no-wait

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

valeur par défaut: False

--private-dns-zone

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--restore-time

Point dans le temps UTC à partir duquel effectuer la restauration (format ISO8601), par exemple, 2017-04-26T02:10:00+00:00La valeur par défaut est définie sur l’heure actuelle.

valeur par défaut: 2023-09-11T12:10:46+00:00

--subnet

--subnet-prefixes

Préfixe d’adresse IP de sous-réseau à utiliser lors de la création d’un sous-réseau au format CIDR. La valeur par défaut est 10.0.0.0/24.

--subscription

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

--vnet

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

--zone -z

Zone de disponibilité dans laquelle provisionner la ressource.

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

Exemples

Réactivez le serveur d’accès public « testserver » supprimé vers un nouveau serveur « testserverNew » à l’emplacement « newLocation » avec accès public.

az postgres flexible-server revive-dropped --resource-group testGroup --name testserverNew --source-server /subscriptions/{SubId}/resourceGroups/{testGroup}/providers/Microsoft.DBforPostgreSQL/flexibleServers/testserver --location newLocation

Réactivez le serveur d’accès public « testserver » supprimé avec le chiffrement des données activé en tant que nouveau serveur « testserverNouveau » avec chiffrement des données.

az postgres flexible-server revive-dropped -l testLocation --resource-group testGroup --name testserverNew \
  --source-server testserver --key newKeyIdentifier --identity newIdentity

Paramètres obligatoires

--location -l

Lieu. Valeurs provenant de : az account list-locations . Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location> .

--source-server

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

Paramètres facultatifs

--address-prefixes

Préfixe d’adresse IP à utiliser lors de la création d’un réseau virtuel au format CIDR. La valeur par défaut est 10.0.0.0/16.

--backup-identity

Nom ou ID de ressource de l’identité utilisateur de la géo-sauvegarde pour le chiffrement des données. L’identité doit se trouver dans la même région que la région de sauvegarde.

--backup-key

ID de ressource de la clé de coffre de clés de géo-sauvegarde pour le chiffrement des données. La clé doit se trouver dans la même région que la région de sauvegarde.

--geo-redundant-backup

Indique si la sauvegarde géoredondante est activée ou non.

valeurs acceptées: Disabled, Enabled

valeur par défaut: Disabled

--identity

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

--ids

--key

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

--name -n

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

--no-wait

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

valeur par défaut: False

--private-dns-zone

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--subnet

--subnet-prefixes

Préfixe d’adresse IP de sous-réseau à utiliser lors de la création d’un sous-réseau au format CIDR. La valeur par défaut est 10.0.0.0/24.

--subscription

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

--vnet

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

--zone -z

Zone de disponibilité dans laquelle provisionner la ressource.

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

Exemples

Obtenir les détails d’un serveur flexible

az postgres flexible-server show --resource-group testGroup --name testserver

Paramètres facultatifs

--ids

--name -n

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

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--subscription

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

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

az postgres flexible-server show-connection-string [--admin-password]
                                                   [--admin-user]
                                                   [--database-name]
                                                   [--ids]
                                                   [--pg-bouncer]
                                                   [--server-name]
                                                   [--subscription]

Exemples

Afficher les chaînes de connexion pour les langages cmd et de programmation.

az postgres flexible-server show-connection-string -s testserver -u username -p password -d databasename

Afficher les chaînes de connexion pour les langages cmd et de programmation avec PgBouncer activé.

az postgres flexible-server show-connection-string -s testserver -u username -p password -d databasename --pg-bouncer

Paramètres facultatifs

--admin-password -p

valeur par défaut: {password}

--admin-user -u

Nom d’utilisateur administrateur du serveur. Une fois défini, il ne peut pas être modifié.

valeur par défaut: {login}

--database-name -d

Nom de la base de données à créer lors de l’approvisionnement du serveur de base de données.

valeur par défaut: {database}

--ids

--pg-bouncer

Afficher les chaînes de connexion pour PgBouncer.

valeur par défaut: False

--server-name -s

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

valeur par défaut: {server}

--subscription

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

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

Exemples

Démarrez un serveur flexible.

az postgres flexible-server start --resource-group testGroup --name testserver

Paramètres facultatifs

--ids

--name -n

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

--no-wait

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

valeur par défaut: False

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--subscription

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

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

Exemples

Arrêtez un serveur flexible.

az postgres flexible-server stop --resource-group testGroup --name testserver

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--name -n

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

--no-wait

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

valeur par défaut: False

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--subscription

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

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

az postgres flexible-server update [--active-directory-auth {Disabled, Enabled}]
                                   [--add]
                                   [--admin-password]
                                   [--backup-identity]
                                   [--backup-key]
                                   [--backup-retention]
                                   [--force-string]
                                   [--high-availability {Disabled, SameZone, ZoneRedundant}]
                                   [--identity]
                                   [--ids]
                                   [--key]
                                   [--maintenance-window]
                                   [--name]
                                   [--password-auth {Disabled, Enabled}]
                                   [--private-dns-zone]
                                   [--remove]
                                   [--resource-group]
                                   [--set]
                                   [--sku-name]
                                   [--standby-zone]
                                   [--storage-size]
                                   [--subscription]
                                   [--tags]
                                   [--tier]
                                   [--yes]

Exemples

Mettez à jour la référence sku d’un serveur flexible à l’aide du contexte local pour le serveur et le groupe de ressources.

az postgres flexible-server update --sku-name Standard_D4s_v3

Mettre à jour les balises d’un serveur.

az postgres flexible-server update --resource-group testGroup --name testserver --tags "k1=v1" "k2=v2"

Réinitialiser le mot de passe

az postgres flexible-server update --resource-group testGroup --name testserver -p password123

Mettre à jour un serveur flexible pour activer l’authentification Active Directory pour le serveur avec authentification de mot de passe

az postgres flexible-server update --resource-group testGroup --name testserver --active-directory-auth Enabled

Modifier la clé/l’identité pour le chiffrement des données. Le chiffrement des données ne peut pas être activé après la création du serveur. Cela met uniquement à jour la clé/l’identité.

# get key identifier of the existing key
newKeyIdentifier=$(az keyvault key show --vault-name testVault --name testKey \
  --query key.kid -o tsv)
# update server with new key/identity
az postgres flexible-server update --resource-group testGroup --name testserver \
  --key $newKeyIdentifier --identity newIdentity

Mettez à jour un serveur flexible pour mettre à jour la zone DNS privée pour un serveur avec réseau virtuel, à l’aide d’une zone DNS privée dans le même groupe de ressources et le même abonnement. DNS privé zone sera créée DNS privé zone sera liée au réseau virtuel s’il n’est pas déjà lié.

az postgres flexible-server update --resource-group testGroup --name testserver --private-dns-zone testDNS2.postgres.database.azure.com

Mettez à jour un serveur flexible pour mettre à jour la zone DNS privée pour un serveur avec réseau virtuel, à l’aide d’une zone DNS privée dans le groupe de ressources et l’abonnement différents. DNS privé zone sera liée au réseau virtuel s’il n’est pas déjà lié.

az postgres flexible-server update --resource-group testGroup --name testserver --private-dns-zone /subscriptions/{SubId2}/resourceGroups/{testGroup2}/providers/Microsoft.Network/privateDnsZones/testDNS.postgres.database.azure.com

Paramètres facultatifs

--active-directory-auth

Indique si l’authentification Azure Active Directory est activée.

valeurs acceptées: Disabled, Enabled

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires de valeurs de clé. Exemple : --add property.listProperty <key=value, string ou JSON string>.

valeur par défaut: []

--admin-password -p

Mot de passe de l’administrateur. 8 caractères minimum et un maximum de 128 caractères. Le mot de passe doit contenir des caractères de trois des catégories suivantes : Lettres majuscules, lettres minuscules, chiffres et caractères non alphanumériques.

--backup-identity

Nom ou ID de ressource de l’identité utilisateur de la géo-sauvegarde pour le chiffrement des données. L’identité doit se trouver dans la même région que la région de sauvegarde.

--backup-key

ID de ressource de la clé de coffre de clés de géo-sauvegarde pour le chiffrement des données. La clé doit se trouver dans la même région que la région de sauvegarde.

--backup-retention

Nombre de jours de conservation d’une sauvegarde. Plage de 7 à 35 jours. La valeur par défaut est 7 jours.

--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

valeur par défaut: False

--high-availability

Activez (ZoneRedundant ou SameZone) ou désactivez la fonctionnalité de haute disponibilité.

valeurs acceptées: Disabled, SameZone, ZoneRedundant

--identity

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

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--key

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

--maintenance-window

Période de temps (UTC) désignée pour la maintenance. Exemples : « Dim:23:30 » à planifier le dimanche, 23h30 UTC. Pour revenir à la passe par défaut « Désactivé ».

--name -n

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

--password-auth

Indique si l’authentification par mot de passe est activée.

valeurs acceptées: Disabled, Enabled

--private-dns-zone

Ce paramètre s’applique uniquement à un serveur disposant d’un accès privé. Nom ou ID de la zone DNS privée nouvelle ou existante. Vous pouvez utiliser la zone dns privée à partir du même groupe de ressources, d’un groupe de ressources différent ou d’un autre abonnement. Si vous souhaitez utiliser une zone d’un autre groupe de ressources ou abonnement, indiquez l’ID de ressource. L’interface CLI crée une zone DNS privée au sein du même groupe de ressources que le réseau virtuel si elle n’est pas fournie par les utilisateurs.

--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list OU --remove propertyToRemove.

valeur par défaut: []

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--set

Mettez à jour un objet en spécifiant un chemin de propriété et une valeur à définir. Exemple : --set property1.property2=.

valeur par défaut: []

--sku-name

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

--standby-zone

Informations de zone de disponibilité du serveur de secours lorsque la haute disponibilité est activée.

--storage-size

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

--subscription

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

--tags

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

--tier

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

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

Exemples

Mettez à niveau le serveur « testsvr » vers PostgreSQL version majeure 14.

az postgres flexible-server upgrade -g testgroup -n testsvr -v 14

Paramètres obligatoires

--version -v

Version principale du serveur.

valeurs acceptées: 12, 13, 14

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--name -n

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

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--subscription

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

--yes -y

Ne pas demander de confirmation.

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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

--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendez la suppression.

valeur par défaut: False

--exists

Attendez que la ressource existe.

valeur par défaut: False

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30

--name -n

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

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name> .

--subscription

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

--timeout

Attente maximale en secondes.

valeur par défaut: 3600

--updated

Attendez la mise à jour avec provisioningState sur « Succeeded ».

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux 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.

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID .

--verbose

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