Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Définition de ressource Bicep
Le type de ressource flexibleServers peut être déployé avec des opérations qui ciblent :
- groupes de ressources - Consultez commandes de déploiement de groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format de ressource
Pour créer une ressource Microsoft.DBforPostgreSQL/flexibleServers, ajoutez le bicep suivant à votre modèle.
resource symbolicname 'Microsoft.DBforPostgreSQL/flexibleServers@2023-06-01-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {
clientId: 'string'
principalId: 'string'
}
}
}
location: 'string'
name: 'string'
properties: {
administratorLogin: 'string'
administratorLoginPassword: 'string'
authConfig: {
activeDirectoryAuth: 'string'
passwordAuth: 'string'
tenantId: 'string'
}
availabilityZone: 'string'
backup: {
backupRetentionDays: int
geoRedundantBackup: 'string'
}
createMode: 'string'
dataEncryption: {
geoBackupKeyURI: 'string'
geoBackupUserAssignedIdentityId: 'string'
primaryKeyURI: 'string'
primaryUserAssignedIdentityId: 'string'
type: 'string'
}
highAvailability: {
mode: 'string'
standbyAvailabilityZone: 'string'
}
maintenanceWindow: {
customWindow: 'string'
dayOfWeek: int
startHour: int
startMinute: int
}
network: {
delegatedSubnetResourceId: 'string'
privateDnsZoneArmResourceId: 'string'
publicNetworkAccess: 'string'
}
pointInTimeUTC: 'string'
replica: {
promoteMode: 'string'
promoteOption: 'string'
role: 'string'
}
replicationRole: 'string'
sourceServerResourceId: 'string'
storage: {
autoGrow: 'string'
iops: int
storageSizeGB: int
throughput: int
tier: 'string'
type: 'string'
}
version: 'string'
}
sku: {
name: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
Valeurs de la propriété
Microsoft.DBforPostgreSQL/flexibleServers
| Nom | Descriptif | Valeur |
|---|---|---|
| identité | Décrit l’identité de l’application. | UserAssignedIdentity |
| emplacement | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
| nom | Nom de la ressource | corde Contraintes: Longueur minimale = 3 Longueur maximale = 63 Modèle = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* (obligatoire) |
| Propriétés | Propriétés du serveur. | Propriétés du serveur |
| Sku | Référence SKU (niveau tarifaire) du serveur. | référence SKU |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
AuthConfig
| Nom | Descriptif | Valeur |
|---|---|---|
| activeDirectoryAuth | Si cette option est activée, l’authentification Azure Active Directory est activée. | 'Désactivé' 'Activé' |
| passwordAuth | Si cette option est activée, l’authentification par mot de passe est activée. | 'Désactivé' 'Activé' |
| ID de locataire | ID de locataire du serveur. | corde |
Sauvegarde
| Nom | Descriptif | Valeur |
|---|---|---|
| backupRetentionDays | Jours de rétention de sauvegarde pour le serveur. | Int |
| geoRedundantBackup | Valeur indiquant si Geo-Redundant sauvegarde est activée sur le serveur. | 'Désactivé' 'Activé' |
Cryptage des données
| Nom | Descriptif | Valeur |
|---|---|---|
| geoBackupKeyURI | URI de la clé dans keyvault pour le chiffrement des données pour la géo-sauvegarde du serveur. | corde |
| geoBackupUserAssignedIdentityId | ID de ressource de l’identité affectée par l’utilisateur à utiliser pour le chiffrement des données pour la géo-sauvegarde du serveur. | corde |
| primaryKeyURI | URI de la clé dans keyvault pour le chiffrement des données du serveur principal. | corde |
| primaryUserAssignedIdentityId | ID de ressource de l’identité affectée par l’utilisateur à utiliser pour le chiffrement des données du serveur principal. | corde |
| type | Type de chiffrement de données à représenter s’il s’agit d’un coffre de clés Géré par le système et Azure Key Vault. | « AzureKeyVault » 'Géré par le système' |
Haute disponibilité
| Nom | Descriptif | Valeur |
|---|---|---|
| mode | Mode haute disponibilité du serveur. | 'Désactivé' 'SameZone' 'Zone redondante' |
| standbyAvailabilityZone | informations sur la zone de disponibilité du serveur de secours. | corde |
MaintenanceWindow
| Nom | Descriptif | Valeur |
|---|---|---|
| personnaliséFenêtre | indique si la fenêtre personnalisée est activée ou désactivée | corde |
| jourDeLaSemaine | jour de semaine pour la fenêtre de maintenance | Int |
| startHour | heure de début de la fenêtre de maintenance | Int |
| startMinute | minute de démarrage de la fenêtre de maintenance | Int |
Réseau
| Nom | Descriptif | Valeur |
|---|---|---|
| delegatedSubnetResourceId | ID de ressource du sous-réseau délégué. Cette opération doit être transmise pendant la création, au cas où nous voulons que le serveur soit injecté au réseau virtuel, c’est-à-dire un serveur d’accès privé. Pendant la mise à jour, transmettez-la uniquement si nous voulons mettre à jour la valeur de la zone DNS privée. | corde |
| privateDnsZoneArmResourceId | ID de ressource arm de zone DNS privée. Cette opération doit être transmise pendant la création, au cas où nous voulons que le serveur soit injecté au réseau virtuel, c’est-à-dire un serveur d’accès privé. Pendant la mise à jour, transmettez-la uniquement si nous voulons mettre à jour la valeur de la zone DNS privée. | corde |
| publicNetworkAccess | l’accès au réseau public est activé ou non | 'Désactivé' 'Activé' |
Réplique
| Nom | Descriptif | Valeur |
|---|---|---|
| promouvoirMode | Définit le mode de promotion d’un serveur réplica. Il s’agit d’une propriété en écriture seule. | 'autonome' « Basculement » |
| promouvoirOption | Définit les options de promotion d’un serveur réplica. Il s’agit d’une propriété en écriture seule. | 'forcé' 'planifié' |
| rôle | Utilisé pour indiquer le rôle du serveur dans le jeu de réplication. | 'AsyncReplica' 'GeoAsyncReplica' « Aucun » « Primaire » |
Propriétés du serveur
| Nom | Descriptif | Valeur |
|---|---|---|
| administratorLogin | Nom de connexion de l’administrateur d’un serveur. Ne peut être spécifié que lorsque le serveur est en cours de création (et est requis pour la création). | corde |
| administratorLoginMot de passe | Mot de passe de connexion administrateur (requis pour la création du serveur). | corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé. |
| authConfig | Propriétés AuthConfig d’un serveur. | AuthConfig |
| disponibilitéZone | informations sur la zone de disponibilité du serveur. | corde |
| sauvegarde | Propriétés de sauvegarde d’un serveur. | de sauvegarde |
| createMode | Mode de création d’un serveur PostgreSQL. | 'Créer' Valeur par défaut 'GeoRestore' 'PointInTimeRestore' 'Réplique' 'ReviveDropped' 'Mise à jour' |
| dataCryptage | Propriétés de chiffrement des données d’un serveur. | dataEncryption |
| highAvailability | Propriétés de haute disponibilité d’un serveur. | HighAvailability |
| maintenanceFenêtre | Propriétés de la fenêtre de maintenance d’un serveur. | MaintenanceWindow |
| réseau | Propriétés réseau d’un serveur. Cette propriété réseau doit être transmise uniquement si vous souhaitez que le serveur soit un serveur d’accès privé. | Réseau |
| pointInTimeUTC | Heure de création du point de restauration (format ISO8601), en spécifiant l’heure de restauration à partir de laquelle effectuer la restauration. Il est nécessaire lorsque « createMode » est « PointInTimeRestore » ou « GeoRestore » ou « ReviveDropped ». | corde |
| réplique | Propriétés du réplica d’un serveur. Ces propriétés de réplica doivent être transmises uniquement si vous souhaitez promouvoir un serveur. | de réplica |
| réplicationRôle | Rôle de réplication du serveur | 'AsyncReplica' 'GeoAsyncReplica' « Aucun » « Primaire » |
| sourceServerResourceId | ID de ressource du serveur source à partir duquel effectuer la restauration. Il est nécessaire lorsque « createMode » est « PointInTimeRestore » ou « GeoRestore » ou « Replica » ou « ReviveDropped ». Cette propriété est retournée uniquement pour le serveur réplica | corde |
| stockage | Propriétés de stockage d’un serveur. | Stockage |
| Version | Version du serveur PostgreSQL. | '11' '12' '13' '14' '15' '16' |
Sku
| Nom | Descriptif | Valeur |
|---|---|---|
| nom | Nom de la référence SKU, généralement, niveau + famille + cœurs, par exemple Standard_D4s_v3. | chaîne (obligatoire) |
| niveau | Niveau de la référence SKU particulière, par exemple Burstable. | « Burstable » 'Usage général' 'MemoryOptimized' (obligatoire) |
Stockage
| Nom | Descriptif | Valeur |
|---|---|---|
| croissance automatique | Indicateur permettant d’activer/désactiver la croissance automatique du stockage pour un serveur flexible. | 'Désactivé' 'Activé' |
| IOPS | Quantité d’IOPS du niveau de stockage. Cette propriété doit être définie pour le type de stockage PremiumV2_LRS | Int |
| storageSizeGB | Stockage maximal autorisé pour un serveur. | Int |
| débit | Débit de stockage pour le serveur. Cela doit être défini pour le type de stockage PremiumV2_LRS | Int |
| niveau | Nom du niveau de stockage pour les IOPS. | 'P1' 'P10' 'P15' 'P2' 'P20' 'P3' 'P30' 'P4' 'P40' 'P50' 'P6' 'P60' 'P70' 'P80' |
| type | Type de stockage pour le serveur. Les valeurs autorisées sont Premium_LRS et PremiumV2_LRS, et la valeur par défaut est Premium_LRS si elle n’est pas spécifiée | 'PremiumV2_LRS' 'Premium_LRS' |
TrackedResourceTags
| Nom | Descriptif | Valeur |
|---|
userAssignedIdentity
| Nom | Descriptif | Valeur |
|---|---|---|
| type | les types d’identités associés à cette ressource ; actuellement limité à « None and UserAssigned » | « Aucun » 'UserAssigned' (obligatoire) |
| Identités attribuées par l'utilisateur | représente la carte des identités affectées par l’utilisateur. | UserAssignedIdentityMap |
UserAssignedIdentityMap
| Nom | Descriptif | Valeur |
|---|
IdentitéUtilisateur
| Nom | Descriptif | Valeur |
|---|---|---|
| clientId | identificateur client du principal de service que cette identité représente. | corde |
| principalId | identificateur d’objet du principal de service que cette identité représente. | corde |
Exemples d’utilisation
Exemples Bicep
Exemple de base de déploiement de PostgreSQL Flexible Server.
param resourceName string = 'acctest0001'
param location string = 'eastus'
@description('The administrator login name for the PostgreSQL flexible server')
param administratorLogin string
@secure()
@description('The administrator login password for the PostgreSQL flexible server')
param administratorLoginPassword string
resource flexibleServer 'Microsoft.DBforPostgreSQL/flexibleServers@2023-06-01-preview' = {
name: resourceName
location: location
identity: {
type: 'None'
userAssignedIdentities: null
}
properties: {
administratorLogin: null
administratorLoginPassword: null
availabilityZone: '2'
backup: {
geoRedundantBackup: 'Disabled'
}
highAvailability: {
mode: 'Disabled'
}
network: {}
storage: {
storageSizeGB: 32
}
version: '12'
}
sku: {
name: 'Standard_D2s_v3'
tier: 'GeneralPurpose'
}
}
Modules vérifiés Azure
Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.
| Module | Descriptif |
|---|---|
| base de données pour Postgre SQL Flexible Server | Module de ressources AVM pour la base de données pour le serveur flexible Postgre SQL |
Exemples de démarrage rapide Azure
Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.
| Fichier Bicep | Descriptif |
|---|---|
| Créer un serveur PgFlex & activer la protection via le coffre de sauvegarde | Modèle qui crée un serveur flexible PostgreSQL et active la protection via le coffre de sauvegarde |
| déployer Azure Database pour PostgreSQL (flexible) avec AAD | Ce modèle permet de déployer une base de données Azure serveur flexible pour PostgreSQL avec l’intégration AAD. |
| déployer Azure Database pour PostgreSQL (flexible) avec de réseau virtuel | Ce modèle permet de déployer une base de données Azure serveur flexible pour PostgreSQL avec l’intégration au réseau virtuel. |
| SonarQube sur Web App avec PostgreSQL et l’intégration au réseau virtuel | Ce modèle permet de déployer facilement SonarQube sur Web App sur Linux avec le serveur flexible PostgreSQL, l’intégration au réseau virtuel et le DNS privé. |
Définition de ressource de modèle ARM
Le type de ressource flexibleServers peut être déployé avec des opérations qui ciblent :
- groupes de ressources - Consultez commandes de déploiement de groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format de ressource
Pour créer une ressource Microsoft.DBforPostgreSQL/flexibleServers, ajoutez le code JSON suivant à votre modèle.
{
"type": "Microsoft.DBforPostgreSQL/flexibleServers",
"apiVersion": "2023-06-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
"clientId": "string",
"principalId": "string"
}
}
},
"location": "string",
"properties": {
"administratorLogin": "string",
"administratorLoginPassword": "string",
"authConfig": {
"activeDirectoryAuth": "string",
"passwordAuth": "string",
"tenantId": "string"
},
"availabilityZone": "string",
"backup": {
"backupRetentionDays": "int",
"geoRedundantBackup": "string"
},
"createMode": "string",
"dataEncryption": {
"geoBackupKeyURI": "string",
"geoBackupUserAssignedIdentityId": "string",
"primaryKeyURI": "string",
"primaryUserAssignedIdentityId": "string",
"type": "string"
},
"highAvailability": {
"mode": "string",
"standbyAvailabilityZone": "string"
},
"maintenanceWindow": {
"customWindow": "string",
"dayOfWeek": "int",
"startHour": "int",
"startMinute": "int"
},
"network": {
"delegatedSubnetResourceId": "string",
"privateDnsZoneArmResourceId": "string",
"publicNetworkAccess": "string"
},
"pointInTimeUTC": "string",
"replica": {
"promoteMode": "string",
"promoteOption": "string",
"role": "string"
},
"replicationRole": "string",
"sourceServerResourceId": "string",
"storage": {
"autoGrow": "string",
"iops": "int",
"storageSizeGB": "int",
"throughput": "int",
"tier": "string",
"type": "string"
},
"version": "string"
},
"sku": {
"name": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
Valeurs de la propriété
Microsoft.DBforPostgreSQL/flexibleServers
| Nom | Descriptif | Valeur |
|---|---|---|
| apiVersion | Version de l’API | '2023-06-01-preview' |
| identité | Décrit l’identité de l’application. | UserAssignedIdentity |
| emplacement | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
| nom | Nom de la ressource | corde Contraintes: Longueur minimale = 3 Longueur maximale = 63 Modèle = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* (obligatoire) |
| Propriétés | Propriétés du serveur. | Propriétés du serveur |
| Sku | Référence SKU (niveau tarifaire) du serveur. | référence SKU |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
| type | Type de ressource | 'Microsoft.DBforPostgreSQL/flexibleServers' |
AuthConfig
| Nom | Descriptif | Valeur |
|---|---|---|
| activeDirectoryAuth | Si cette option est activée, l’authentification Azure Active Directory est activée. | 'Désactivé' 'Activé' |
| passwordAuth | Si cette option est activée, l’authentification par mot de passe est activée. | 'Désactivé' 'Activé' |
| ID de locataire | ID de locataire du serveur. | corde |
Sauvegarde
| Nom | Descriptif | Valeur |
|---|---|---|
| backupRetentionDays | Jours de rétention de sauvegarde pour le serveur. | Int |
| geoRedundantBackup | Valeur indiquant si Geo-Redundant sauvegarde est activée sur le serveur. | 'Désactivé' 'Activé' |
Cryptage des données
| Nom | Descriptif | Valeur |
|---|---|---|
| geoBackupKeyURI | URI de la clé dans keyvault pour le chiffrement des données pour la géo-sauvegarde du serveur. | corde |
| geoBackupUserAssignedIdentityId | ID de ressource de l’identité affectée par l’utilisateur à utiliser pour le chiffrement des données pour la géo-sauvegarde du serveur. | corde |
| primaryKeyURI | URI de la clé dans keyvault pour le chiffrement des données du serveur principal. | corde |
| primaryUserAssignedIdentityId | ID de ressource de l’identité affectée par l’utilisateur à utiliser pour le chiffrement des données du serveur principal. | corde |
| type | Type de chiffrement de données à représenter s’il s’agit d’un coffre de clés Géré par le système et Azure Key Vault. | « AzureKeyVault » 'Géré par le système' |
Haute disponibilité
| Nom | Descriptif | Valeur |
|---|---|---|
| mode | Mode haute disponibilité du serveur. | 'Désactivé' 'SameZone' 'Zone redondante' |
| standbyAvailabilityZone | informations sur la zone de disponibilité du serveur de secours. | corde |
MaintenanceWindow
| Nom | Descriptif | Valeur |
|---|---|---|
| personnaliséFenêtre | indique si la fenêtre personnalisée est activée ou désactivée | corde |
| jourDeLaSemaine | jour de semaine pour la fenêtre de maintenance | Int |
| startHour | heure de début de la fenêtre de maintenance | Int |
| startMinute | minute de démarrage de la fenêtre de maintenance | Int |
Réseau
| Nom | Descriptif | Valeur |
|---|---|---|
| delegatedSubnetResourceId | ID de ressource du sous-réseau délégué. Cette opération doit être transmise pendant la création, au cas où nous voulons que le serveur soit injecté au réseau virtuel, c’est-à-dire un serveur d’accès privé. Pendant la mise à jour, transmettez-la uniquement si nous voulons mettre à jour la valeur de la zone DNS privée. | corde |
| privateDnsZoneArmResourceId | ID de ressource arm de zone DNS privée. Cette opération doit être transmise pendant la création, au cas où nous voulons que le serveur soit injecté au réseau virtuel, c’est-à-dire un serveur d’accès privé. Pendant la mise à jour, transmettez-la uniquement si nous voulons mettre à jour la valeur de la zone DNS privée. | corde |
| publicNetworkAccess | l’accès au réseau public est activé ou non | 'Désactivé' 'Activé' |
Réplique
| Nom | Descriptif | Valeur |
|---|---|---|
| promouvoirMode | Définit le mode de promotion d’un serveur réplica. Il s’agit d’une propriété en écriture seule. | 'autonome' « Basculement » |
| promouvoirOption | Définit les options de promotion d’un serveur réplica. Il s’agit d’une propriété en écriture seule. | 'forcé' 'planifié' |
| rôle | Utilisé pour indiquer le rôle du serveur dans le jeu de réplication. | 'AsyncReplica' 'GeoAsyncReplica' « Aucun » « Primaire » |
Propriétés du serveur
| Nom | Descriptif | Valeur |
|---|---|---|
| administratorLogin | Nom de connexion de l’administrateur d’un serveur. Ne peut être spécifié que lorsque le serveur est en cours de création (et est requis pour la création). | corde |
| administratorLoginMot de passe | Mot de passe de connexion administrateur (requis pour la création du serveur). | corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé. |
| authConfig | Propriétés AuthConfig d’un serveur. | AuthConfig |
| disponibilitéZone | informations sur la zone de disponibilité du serveur. | corde |
| sauvegarde | Propriétés de sauvegarde d’un serveur. | de sauvegarde |
| createMode | Mode de création d’un serveur PostgreSQL. | 'Créer' Valeur par défaut 'GeoRestore' 'PointInTimeRestore' 'Réplique' 'ReviveDropped' 'Mise à jour' |
| dataCryptage | Propriétés de chiffrement des données d’un serveur. | dataEncryption |
| highAvailability | Propriétés de haute disponibilité d’un serveur. | HighAvailability |
| maintenanceFenêtre | Propriétés de la fenêtre de maintenance d’un serveur. | MaintenanceWindow |
| réseau | Propriétés réseau d’un serveur. Cette propriété réseau doit être transmise uniquement si vous souhaitez que le serveur soit un serveur d’accès privé. | Réseau |
| pointInTimeUTC | Heure de création du point de restauration (format ISO8601), en spécifiant l’heure de restauration à partir de laquelle effectuer la restauration. Il est nécessaire lorsque « createMode » est « PointInTimeRestore » ou « GeoRestore » ou « ReviveDropped ». | corde |
| réplique | Propriétés du réplica d’un serveur. Ces propriétés de réplica doivent être transmises uniquement si vous souhaitez promouvoir un serveur. | de réplica |
| réplicationRôle | Rôle de réplication du serveur | 'AsyncReplica' 'GeoAsyncReplica' « Aucun » « Primaire » |
| sourceServerResourceId | ID de ressource du serveur source à partir duquel effectuer la restauration. Il est nécessaire lorsque « createMode » est « PointInTimeRestore » ou « GeoRestore » ou « Replica » ou « ReviveDropped ». Cette propriété est retournée uniquement pour le serveur réplica | corde |
| stockage | Propriétés de stockage d’un serveur. | Stockage |
| Version | Version du serveur PostgreSQL. | '11' '12' '13' '14' '15' '16' |
Sku
| Nom | Descriptif | Valeur |
|---|---|---|
| nom | Nom de la référence SKU, généralement, niveau + famille + cœurs, par exemple Standard_D4s_v3. | chaîne (obligatoire) |
| niveau | Niveau de la référence SKU particulière, par exemple Burstable. | « Burstable » 'Usage général' 'MemoryOptimized' (obligatoire) |
Stockage
| Nom | Descriptif | Valeur |
|---|---|---|
| croissance automatique | Indicateur permettant d’activer/désactiver la croissance automatique du stockage pour un serveur flexible. | 'Désactivé' 'Activé' |
| IOPS | Quantité d’IOPS du niveau de stockage. Cette propriété doit être définie pour le type de stockage PremiumV2_LRS | Int |
| storageSizeGB | Stockage maximal autorisé pour un serveur. | Int |
| débit | Débit de stockage pour le serveur. Cela doit être défini pour le type de stockage PremiumV2_LRS | Int |
| niveau | Nom du niveau de stockage pour les IOPS. | 'P1' 'P10' 'P15' 'P2' 'P20' 'P3' 'P30' 'P4' 'P40' 'P50' 'P6' 'P60' 'P70' 'P80' |
| type | Type de stockage pour le serveur. Les valeurs autorisées sont Premium_LRS et PremiumV2_LRS, et la valeur par défaut est Premium_LRS si elle n’est pas spécifiée | 'PremiumV2_LRS' 'Premium_LRS' |
TrackedResourceTags
| Nom | Descriptif | Valeur |
|---|
userAssignedIdentity
| Nom | Descriptif | Valeur |
|---|---|---|
| type | les types d’identités associés à cette ressource ; actuellement limité à « None and UserAssigned » | « Aucun » 'UserAssigned' (obligatoire) |
| Identités attribuées par l'utilisateur | représente la carte des identités affectées par l’utilisateur. | UserAssignedIdentityMap |
UserAssignedIdentityMap
| Nom | Descriptif | Valeur |
|---|
IdentitéUtilisateur
| Nom | Descriptif | Valeur |
|---|---|---|
| clientId | identificateur client du principal de service que cette identité représente. | corde |
| principalId | identificateur d’objet du principal de service que cette identité représente. | corde |
Exemples d’utilisation
Modèles de démarrage rapide Microsoft Azure
Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.
| Modèle | Descriptif |
|---|---|
|
Créer un serveur PgFlex & activer la protection via le coffre de sauvegarde |
Modèle qui crée un serveur flexible PostgreSQL et active la protection via le coffre de sauvegarde |
|
déployer Azure Database pour PostgreSQL (flexible) avec AAD |
Ce modèle permet de déployer une base de données Azure serveur flexible pour PostgreSQL avec l’intégration AAD. |
|
déployer Azure Database pour PostgreSQL (flexible) avec de réseau virtuel |
Ce modèle permet de déployer une base de données Azure serveur flexible pour PostgreSQL avec l’intégration au réseau virtuel. |
|
SonarQube sur Web App avec PostgreSQL et l’intégration au réseau virtuel |
Ce modèle permet de déployer facilement SonarQube sur Web App sur Linux avec le serveur flexible PostgreSQL, l’intégration au réseau virtuel et le DNS privé. |
Définition de ressource Terraform (fournisseur AzAPI)
Le type de ressource flexibleServers peut être déployé avec des opérations qui ciblent :
- Groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format de ressource
Pour créer une ressource Microsoft.DBforPostgreSQL/flexibleServers, ajoutez le terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DBforPostgreSQL/flexibleServers@2023-06-01-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
administratorLogin = "string"
administratorLoginPassword = "string"
authConfig = {
activeDirectoryAuth = "string"
passwordAuth = "string"
tenantId = "string"
}
availabilityZone = "string"
backup = {
backupRetentionDays = int
geoRedundantBackup = "string"
}
createMode = "string"
dataEncryption = {
geoBackupKeyURI = "string"
geoBackupUserAssignedIdentityId = "string"
primaryKeyURI = "string"
primaryUserAssignedIdentityId = "string"
type = "string"
}
highAvailability = {
mode = "string"
standbyAvailabilityZone = "string"
}
maintenanceWindow = {
customWindow = "string"
dayOfWeek = int
startHour = int
startMinute = int
}
network = {
delegatedSubnetResourceId = "string"
privateDnsZoneArmResourceId = "string"
publicNetworkAccess = "string"
}
pointInTimeUTC = "string"
replica = {
promoteMode = "string"
promoteOption = "string"
role = "string"
}
replicationRole = "string"
sourceServerResourceId = "string"
storage = {
autoGrow = "string"
iops = int
storageSizeGB = int
throughput = int
tier = "string"
type = "string"
}
version = "string"
}
sku = {
name = "string"
tier = "string"
}
}
}
Valeurs de la propriété
Microsoft.DBforPostgreSQL/flexibleServers
| Nom | Descriptif | Valeur |
|---|---|---|
| identité | Décrit l’identité de l’application. | UserAssignedIdentity |
| emplacement | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
| nom | Nom de la ressource | corde Contraintes: Longueur minimale = 3 Longueur maximale = 63 Modèle = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* (obligatoire) |
| Propriétés | Propriétés du serveur. | Propriétés du serveur |
| Sku | Référence SKU (niveau tarifaire) du serveur. | référence SKU |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. |
| type | Type de ressource | « Microsoft.DBforPostgreSQL/flexibleServers@2023-06-01-preview » |
AuthConfig
| Nom | Descriptif | Valeur |
|---|---|---|
| activeDirectoryAuth | Si cette option est activée, l’authentification Azure Active Directory est activée. | 'Désactivé' 'Activé' |
| passwordAuth | Si cette option est activée, l’authentification par mot de passe est activée. | 'Désactivé' 'Activé' |
| ID de locataire | ID de locataire du serveur. | corde |
Sauvegarde
| Nom | Descriptif | Valeur |
|---|---|---|
| backupRetentionDays | Jours de rétention de sauvegarde pour le serveur. | Int |
| geoRedundantBackup | Valeur indiquant si Geo-Redundant sauvegarde est activée sur le serveur. | 'Désactivé' 'Activé' |
Cryptage des données
| Nom | Descriptif | Valeur |
|---|---|---|
| geoBackupKeyURI | URI de la clé dans keyvault pour le chiffrement des données pour la géo-sauvegarde du serveur. | corde |
| geoBackupUserAssignedIdentityId | ID de ressource de l’identité affectée par l’utilisateur à utiliser pour le chiffrement des données pour la géo-sauvegarde du serveur. | corde |
| primaryKeyURI | URI de la clé dans keyvault pour le chiffrement des données du serveur principal. | corde |
| primaryUserAssignedIdentityId | ID de ressource de l’identité affectée par l’utilisateur à utiliser pour le chiffrement des données du serveur principal. | corde |
| type | Type de chiffrement de données à représenter s’il s’agit d’un coffre de clés Géré par le système et Azure Key Vault. | « AzureKeyVault » 'Géré par le système' |
Haute disponibilité
| Nom | Descriptif | Valeur |
|---|---|---|
| mode | Mode haute disponibilité du serveur. | 'Désactivé' 'SameZone' 'Zone redondante' |
| standbyAvailabilityZone | informations sur la zone de disponibilité du serveur de secours. | corde |
MaintenanceWindow
| Nom | Descriptif | Valeur |
|---|---|---|
| personnaliséFenêtre | indique si la fenêtre personnalisée est activée ou désactivée | corde |
| jourDeLaSemaine | jour de semaine pour la fenêtre de maintenance | Int |
| startHour | heure de début de la fenêtre de maintenance | Int |
| startMinute | minute de démarrage de la fenêtre de maintenance | Int |
Réseau
| Nom | Descriptif | Valeur |
|---|---|---|
| delegatedSubnetResourceId | ID de ressource du sous-réseau délégué. Cette opération doit être transmise pendant la création, au cas où nous voulons que le serveur soit injecté au réseau virtuel, c’est-à-dire un serveur d’accès privé. Pendant la mise à jour, transmettez-la uniquement si nous voulons mettre à jour la valeur de la zone DNS privée. | corde |
| privateDnsZoneArmResourceId | ID de ressource arm de zone DNS privée. Cette opération doit être transmise pendant la création, au cas où nous voulons que le serveur soit injecté au réseau virtuel, c’est-à-dire un serveur d’accès privé. Pendant la mise à jour, transmettez-la uniquement si nous voulons mettre à jour la valeur de la zone DNS privée. | corde |
| publicNetworkAccess | l’accès au réseau public est activé ou non | 'Désactivé' 'Activé' |
Réplique
| Nom | Descriptif | Valeur |
|---|---|---|
| promouvoirMode | Définit le mode de promotion d’un serveur réplica. Il s’agit d’une propriété en écriture seule. | 'autonome' « Basculement » |
| promouvoirOption | Définit les options de promotion d’un serveur réplica. Il s’agit d’une propriété en écriture seule. | 'forcé' 'planifié' |
| rôle | Utilisé pour indiquer le rôle du serveur dans le jeu de réplication. | 'AsyncReplica' 'GeoAsyncReplica' « Aucun » « Primaire » |
Propriétés du serveur
| Nom | Descriptif | Valeur |
|---|---|---|
| administratorLogin | Nom de connexion de l’administrateur d’un serveur. Ne peut être spécifié que lorsque le serveur est en cours de création (et est requis pour la création). | corde |
| administratorLoginMot de passe | Mot de passe de connexion administrateur (requis pour la création du serveur). | corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé. |
| authConfig | Propriétés AuthConfig d’un serveur. | AuthConfig |
| disponibilitéZone | informations sur la zone de disponibilité du serveur. | corde |
| sauvegarde | Propriétés de sauvegarde d’un serveur. | de sauvegarde |
| createMode | Mode de création d’un serveur PostgreSQL. | 'Créer' Valeur par défaut 'GeoRestore' 'PointInTimeRestore' 'Réplique' 'ReviveDropped' 'Mise à jour' |
| dataCryptage | Propriétés de chiffrement des données d’un serveur. | dataEncryption |
| highAvailability | Propriétés de haute disponibilité d’un serveur. | HighAvailability |
| maintenanceFenêtre | Propriétés de la fenêtre de maintenance d’un serveur. | MaintenanceWindow |
| réseau | Propriétés réseau d’un serveur. Cette propriété réseau doit être transmise uniquement si vous souhaitez que le serveur soit un serveur d’accès privé. | Réseau |
| pointInTimeUTC | Heure de création du point de restauration (format ISO8601), en spécifiant l’heure de restauration à partir de laquelle effectuer la restauration. Il est nécessaire lorsque « createMode » est « PointInTimeRestore » ou « GeoRestore » ou « ReviveDropped ». | corde |
| réplique | Propriétés du réplica d’un serveur. Ces propriétés de réplica doivent être transmises uniquement si vous souhaitez promouvoir un serveur. | de réplica |
| réplicationRôle | Rôle de réplication du serveur | 'AsyncReplica' 'GeoAsyncReplica' « Aucun » « Primaire » |
| sourceServerResourceId | ID de ressource du serveur source à partir duquel effectuer la restauration. Il est nécessaire lorsque « createMode » est « PointInTimeRestore » ou « GeoRestore » ou « Replica » ou « ReviveDropped ». Cette propriété est retournée uniquement pour le serveur réplica | corde |
| stockage | Propriétés de stockage d’un serveur. | Stockage |
| Version | Version du serveur PostgreSQL. | '11' '12' '13' '14' '15' '16' |
Sku
| Nom | Descriptif | Valeur |
|---|---|---|
| nom | Nom de la référence SKU, généralement, niveau + famille + cœurs, par exemple Standard_D4s_v3. | chaîne (obligatoire) |
| niveau | Niveau de la référence SKU particulière, par exemple Burstable. | « Burstable » 'Usage général' 'MemoryOptimized' (obligatoire) |
Stockage
| Nom | Descriptif | Valeur |
|---|---|---|
| croissance automatique | Indicateur permettant d’activer/désactiver la croissance automatique du stockage pour un serveur flexible. | 'Désactivé' 'Activé' |
| IOPS | Quantité d’IOPS du niveau de stockage. Cette propriété doit être définie pour le type de stockage PremiumV2_LRS | Int |
| storageSizeGB | Stockage maximal autorisé pour un serveur. | Int |
| débit | Débit de stockage pour le serveur. Cela doit être défini pour le type de stockage PremiumV2_LRS | Int |
| niveau | Nom du niveau de stockage pour les IOPS. | 'P1' 'P10' 'P15' 'P2' 'P20' 'P3' 'P30' 'P4' 'P40' 'P50' 'P6' 'P60' 'P70' 'P80' |
| type | Type de stockage pour le serveur. Les valeurs autorisées sont Premium_LRS et PremiumV2_LRS, et la valeur par défaut est Premium_LRS si elle n’est pas spécifiée | 'PremiumV2_LRS' 'Premium_LRS' |
TrackedResourceTags
| Nom | Descriptif | Valeur |
|---|
userAssignedIdentity
| Nom | Descriptif | Valeur |
|---|---|---|
| type | les types d’identités associés à cette ressource ; actuellement limité à « None and UserAssigned » | « Aucun » 'UserAssigned' (obligatoire) |
| Identités attribuées par l'utilisateur | représente la carte des identités affectées par l’utilisateur. | UserAssignedIdentityMap |
UserAssignedIdentityMap
| Nom | Descriptif | Valeur |
|---|
IdentitéUtilisateur
| Nom | Descriptif | Valeur |
|---|---|---|
| clientId | identificateur client du principal de service que cette identité représente. | corde |
| principalId | identificateur d’objet du principal de service que cette identité représente. | corde |
Exemples d’utilisation
Échantillons Terraform
Exemple de base de déploiement de PostgreSQL Flexible Server.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
azurerm = {
source = "hashicorp/azurerm"
}
}
}
provider "azurerm" {
features {
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "eastus"
}
variable "administrator_login" {
type = string
description = "The administrator login name for the PostgreSQL flexible server"
}
variable "administrator_login_password" {
type = string
description = "The administrator login password for the PostgreSQL flexible server"
sensitive = true
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "flexibleServer" {
type = "Microsoft.DBforPostgreSQL/flexibleServers@2023-06-01-preview"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
identity = {
type = "None",
userAssignedIdentities = null
},
properties = {
administratorLogin = var.administrator_login
administratorLoginPassword = var.administrator_login_password
availabilityZone = "2"
backup = {
geoRedundantBackup = "Disabled"
}
highAvailability = {
mode = "Disabled"
}
network = {
}
storage = {
storageSizeGB = 32
}
version = "12"
}
sku = {
name = "Standard_D2s_v3"
tier = "GeneralPurpose"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
Modules vérifiés Azure
Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.
| Module | Descriptif |
|---|---|
| base de données pour Postgre SQL Flexible Server | Module de ressources AVM pour la base de données pour le serveur flexible Postgre SQL |