Microsoft.DBforPostgreSQL flexibleServers 2021-06-01

Article
10/24/2024

Bicep resource definition

The flexibleServers resource type can be deployed with operations that target:

Resource groups - See resource group deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.DBforPostgreSQL/flexibleServers resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.DBforPostgreSQL/flexibleServers@2021-06-01' = {
  location: 'string'
  name: 'string'
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    availabilityZone: 'string'
    backup: {
      backupRetentionDays: int
      geoRedundantBackup: 'string'
    }
    createMode: 'string'
    highAvailability: {
      mode: 'string'
      standbyAvailabilityZone: 'string'
    }
    maintenanceWindow: {
      customWindow: 'string'
      dayOfWeek: int
      startHour: int
      startMinute: int
    }
    network: {
      delegatedSubnetResourceId: 'string'
      privateDnsZoneArmResourceId: 'string'
    }
    pointInTimeUTC: 'string'
    sourceServerResourceId: 'string'
    storage: {
      storageSizeGB: int
    }
    version: 'string'
  }
  sku: {
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Property values

Backup

Name	Description	Value
backupRetentionDays	Backup retention days for the server.	int
geoRedundantBackup	A value indicating whether Geo-Redundant backup is enabled on the server.	'Disabled' 'Enabled'

HighAvailability

Name	Description	Value
mode	The HA mode for the server.	'Disabled' 'ZoneRedundant'
standbyAvailabilityZone	availability zone information of the standby.	string

MaintenanceWindow

Name	Description	Value
customWindow	indicates whether custom window is enabled or disabled	string
dayOfWeek	day of week for maintenance window	int
startHour	start hour for maintenance window	int
startMinute	start minute for maintenance window	int

Microsoft.DBforPostgreSQL/flexibleServers

Name	Description	Value
location	The geo-location where the resource lives	string (required)
name	The resource name	string (required)
properties	Properties of the server.	ServerProperties
sku	The SKU (pricing tier) of the server.	Sku
tags	Resource tags	Dictionary of tag names and values. See Tags in templates

Network

Name	Description	Value
delegatedSubnetResourceId	delegated subnet arm resource id.	string
privateDnsZoneArmResourceId	private dns zone arm resource id.	string

ServerProperties

Name	Description	Value
administratorLogin	The administrator's login name of a server. Can only be specified when the server is being created (and is required for creation).	string
administratorLoginPassword	The administrator login password (required for server creation).	string Constraints: Sensitive value. Pass in as a secure parameter.
availabilityZone	availability zone information of the server.	string
backup	Backup properties of a server.	Backup
createMode	The mode to create a new PostgreSQL server.	'Create' 'Default' 'PointInTimeRestore' 'Update'
highAvailability	High availability properties of a server.	HighAvailability
maintenanceWindow	Maintenance window properties of a server.	MaintenanceWindow
network	Network properties of a server.	Network
pointInTimeUTC	Restore point creation time (ISO8601 format), specifying the time to restore from. It's required when 'createMode' is 'PointInTimeRestore'.	string
sourceServerResourceId	The source server resource ID to restore from. It's required when 'createMode' is 'PointInTimeRestore'.	string
storage	Storage properties of a server.	Storage
version	PostgreSQL Server version.	'11' '12' '13' '14'

Sku

Name	Description	Value
name	The name of the sku, typically, tier + family + cores, e.g. Standard_D4s_v3.	string (required)
tier	The tier of the particular SKU, e.g. Burstable.	'Burstable' 'GeneralPurpose' 'MemoryOptimized' (required)

Storage

Name	Description	Value
storageSizeGB	Max storage allowed for a server.	int

TrackedResourceTags

Name	Description	Value

Quickstart samples

The following quickstart samples deploy this resource type.

Bicep File	Description
Create PgFlex server & enable protection via Backup Vault	Template that creates a PostgreSQL Flexible Server and enables protection via Backup Vault
Deploy Azure Database for PostgreSQL (flexible) with AAD	This template provides a way to deploy a Flexible server Azure database for PostgreSQL with AAD integration.
Deploy Azure Database for PostgreSQL (flexible) with VNet	This template provides a way to deploy a Flexible server Azure database for PostgreSQL with VNet integration.
SonarQube on Web App with PostgreSQL and VNet integration	This template provides easy to deploy SonarQube to Web App on Linux with PostgreSQL Flexible Server, VNet integration and private DNS.

ARM template resource definition

The flexibleServers resource type can be deployed with operations that target:

Resource groups - See resource group deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.DBforPostgreSQL/flexibleServers resource, add the following JSON to your template.

{
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "apiVersion": "2021-06-01",
  "name": "string",
  "location": "string",
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "availabilityZone": "string",
    "backup": {
      "backupRetentionDays": "int",
      "geoRedundantBackup": "string"
    },
    "createMode": "string",
    "highAvailability": {
      "mode": "string",
      "standbyAvailabilityZone": "string"
    },
    "maintenanceWindow": {
      "customWindow": "string",
      "dayOfWeek": "int",
      "startHour": "int",
      "startMinute": "int"
    },
    "network": {
      "delegatedSubnetResourceId": "string",
      "privateDnsZoneArmResourceId": "string"
    },
    "pointInTimeUTC": "string",
    "sourceServerResourceId": "string",
    "storage": {
      "storageSizeGB": "int"
    },
    "version": "string"
  },
  "sku": {
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property values

Backup

Name	Description	Value
backupRetentionDays	Backup retention days for the server.	int
geoRedundantBackup	A value indicating whether Geo-Redundant backup is enabled on the server.	'Disabled' 'Enabled'

HighAvailability

Name	Description	Value
mode	The HA mode for the server.	'Disabled' 'ZoneRedundant'
standbyAvailabilityZone	availability zone information of the standby.	string

MaintenanceWindow

Name	Description	Value
customWindow	indicates whether custom window is enabled or disabled	string
dayOfWeek	day of week for maintenance window	int
startHour	start hour for maintenance window	int
startMinute	start minute for maintenance window	int

Microsoft.DBforPostgreSQL/flexibleServers

Name	Description	Value
apiVersion	The api version	'2021-06-01'
location	The geo-location where the resource lives	string (required)
name	The resource name	string (required)
properties	Properties of the server.	ServerProperties
sku	The SKU (pricing tier) of the server.	Sku
tags	Resource tags	Dictionary of tag names and values. See Tags in templates
type	The resource type	'Microsoft.DBforPostgreSQL/flexibleServers'

Network

Name	Description	Value
delegatedSubnetResourceId	delegated subnet arm resource id.	string
privateDnsZoneArmResourceId	private dns zone arm resource id.	string

ServerProperties

Name	Description	Value
administratorLogin	The administrator's login name of a server. Can only be specified when the server is being created (and is required for creation).	string
administratorLoginPassword	The administrator login password (required for server creation).	string Constraints: Sensitive value. Pass in as a secure parameter.
availabilityZone	availability zone information of the server.	string
backup	Backup properties of a server.	Backup
createMode	The mode to create a new PostgreSQL server.	'Create' 'Default' 'PointInTimeRestore' 'Update'
highAvailability	High availability properties of a server.	HighAvailability
maintenanceWindow	Maintenance window properties of a server.	MaintenanceWindow
network	Network properties of a server.	Network
pointInTimeUTC	Restore point creation time (ISO8601 format), specifying the time to restore from. It's required when 'createMode' is 'PointInTimeRestore'.	string
sourceServerResourceId	The source server resource ID to restore from. It's required when 'createMode' is 'PointInTimeRestore'.	string
storage	Storage properties of a server.	Storage
version	PostgreSQL Server version.	'11' '12' '13' '14'

Sku

Name	Description	Value
name	The name of the sku, typically, tier + family + cores, e.g. Standard_D4s_v3.	string (required)
tier	The tier of the particular SKU, e.g. Burstable.	'Burstable' 'GeneralPurpose' 'MemoryOptimized' (required)

Storage

Name	Description	Value
storageSizeGB	Max storage allowed for a server.	int

TrackedResourceTags

Name	Description	Value

Quickstart templates

The following quickstart templates deploy this resource type.

Template	Description
Create PgFlex server & enable protection via Backup Vault	Template that creates a PostgreSQL Flexible Server and enables protection via Backup Vault
Deploy Azure Database for PostgreSQL (flexible) with AAD	This template provides a way to deploy a Flexible server Azure database for PostgreSQL with AAD integration.
Deploy Azure Database for PostgreSQL (flexible) with VNet	This template provides a way to deploy a Flexible server Azure database for PostgreSQL with VNet integration.
SonarQube on Web App with PostgreSQL and VNet integration	This template provides easy to deploy SonarQube to Web App on Linux with PostgreSQL Flexible Server, VNet integration and private DNS.

Terraform (AzAPI provider) resource definition

The flexibleServers resource type can be deployed with operations that target:

Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.DBforPostgreSQL/flexibleServers resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DBforPostgreSQL/flexibleServers@2021-06-01"
  name = "string"
  location = "string"
  body = jsonencode({
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      availabilityZone = "string"
      backup = {
        backupRetentionDays = int
        geoRedundantBackup = "string"
      }
      createMode = "string"
      highAvailability = {
        mode = "string"
        standbyAvailabilityZone = "string"
      }
      maintenanceWindow = {
        customWindow = "string"
        dayOfWeek = int
        startHour = int
        startMinute = int
      }
      network = {
        delegatedSubnetResourceId = "string"
        privateDnsZoneArmResourceId = "string"
      }
      pointInTimeUTC = "string"
      sourceServerResourceId = "string"
      storage = {
        storageSizeGB = int
      }
      version = "string"
    }
  })
  sku = {
    name = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
}

Property values

Backup

Name	Description	Value
backupRetentionDays	Backup retention days for the server.	int
geoRedundantBackup	A value indicating whether Geo-Redundant backup is enabled on the server.	'Disabled' 'Enabled'

HighAvailability

Name	Description	Value
mode	The HA mode for the server.	'Disabled' 'ZoneRedundant'
standbyAvailabilityZone	availability zone information of the standby.	string

MaintenanceWindow

Name	Description	Value
customWindow	indicates whether custom window is enabled or disabled	string
dayOfWeek	day of week for maintenance window	int
startHour	start hour for maintenance window	int
startMinute	start minute for maintenance window	int

Microsoft.DBforPostgreSQL/flexibleServers

Name	Description	Value
location	The geo-location where the resource lives	string (required)
name	The resource name	string (required)
properties	Properties of the server.	ServerProperties
sku	The SKU (pricing tier) of the server.	Sku
tags	Resource tags	Dictionary of tag names and values.
type	The resource type	"Microsoft.DBforPostgreSQL/flexibleServers@2021-06-01"

Network

Name	Description	Value
delegatedSubnetResourceId	delegated subnet arm resource id.	string
privateDnsZoneArmResourceId	private dns zone arm resource id.	string

ServerProperties

Name	Description	Value
administratorLogin	The administrator's login name of a server. Can only be specified when the server is being created (and is required for creation).	string
administratorLoginPassword	The administrator login password (required for server creation).	string Constraints: Sensitive value. Pass in as a secure parameter.
availabilityZone	availability zone information of the server.	string
backup	Backup properties of a server.	Backup
createMode	The mode to create a new PostgreSQL server.	'Create' 'Default' 'PointInTimeRestore' 'Update'
highAvailability	High availability properties of a server.	HighAvailability
maintenanceWindow	Maintenance window properties of a server.	MaintenanceWindow
network	Network properties of a server.	Network
pointInTimeUTC	Restore point creation time (ISO8601 format), specifying the time to restore from. It's required when 'createMode' is 'PointInTimeRestore'.	string
sourceServerResourceId	The source server resource ID to restore from. It's required when 'createMode' is 'PointInTimeRestore'.	string
storage	Storage properties of a server.	Storage
version	PostgreSQL Server version.	'11' '12' '13' '14'

Sku

Name	Description	Value
name	The name of the sku, typically, tier + family + cores, e.g. Standard_D4s_v3.	string (required)
tier	The tier of the particular SKU, e.g. Burstable.	'Burstable' 'GeneralPurpose' 'MemoryOptimized' (required)

Storage

Name	Description	Value
storageSizeGB	Max storage allowed for a server.	int

TrackedResourceTags

Name	Description	Value

Share via

Microsoft.DBforPostgreSQL flexibleServers 2021-06-01

Bicep resource definition

Resource format

Property values

Backup

HighAvailability

MaintenanceWindow

Microsoft.DBforPostgreSQL/flexibleServers

Network

ServerProperties

Sku

Storage

TrackedResourceTags

Quickstart samples

ARM template resource definition

Resource format

Property values

Backup

HighAvailability

MaintenanceWindow

Microsoft.DBforPostgreSQL/flexibleServers

Network

ServerProperties

Sku

Storage

TrackedResourceTags

Quickstart templates

Terraform (AzAPI provider) resource definition

Resource format

Property values

Backup

HighAvailability

MaintenanceWindow

Microsoft.DBforPostgreSQL/flexibleServers

Network

ServerProperties

Sku

Storage

TrackedResourceTags

Feedback

Additional resources