Partilhar via


Microsoft.DBforPostgreSQL flexibleServers

Definição de recursos do bíceps

O tipo de recurso flexibleServers pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DBforPostgreSQL/flexibleServers, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.DBforPostgreSQL/flexibleServers@2025-08-01' = {
  scope: resourceSymbolicName or scope
  identity: {
    principalId: 'string'
    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'
    }
    cluster: {
      clusterSize: int
      defaultDatabaseName: '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'
  }
}

Valores de propriedade

Microsoft.DBforPostgreSQL/flexibleServers

Designação Descrição Valor
identidade Identidades gerenciadas atribuídas ao servidor. UserAssignedIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
Designação O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* (obrigatório)
propriedades Propriedades de um servidor. Propriedades do servidor
âmbito Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
SKU Camada de computação e tamanho de um servidor. Referência
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

AuthConfig

Designação Descrição Valor
activeDirectoryAuth Indica se o servidor suporta a autenticação do Microsoft Entra. 'Desativado'
'Habilitado'
passwordAuth Indica se o servidor suporta autenticação baseada em senha. 'Desativado'
'Habilitado'
inquilinoId Identificador do locatário do recurso delegado. cadeia (de caracteres)

Backup

Designação Descrição Valor
backupRetentionDays Dias de retenção de backup para o servidor. Int
geoRedundantBackup Indica se o servidor está configurado para criar backups geograficamente redundantes. 'Desativado'
'Habilitado'

Aglomeração

Designação Descrição Valor
tamanho do cluster Número de nós atribuídos ao cluster elástico. Int
defaultDatabaseName Nome do banco de dados padrão para o cluster elástico. cadeia (de caracteres)

Encriptação de Dados

Designação Descrição Valor
geoBackupKeyURI Identificador da identidade gerenciada atribuída ao usuário usada para acessar a chave no Cofre de Chaves do Azure para criptografia de dados do armazenamento geograficamente redundante associado a um servidor configurado para dar suporte a backups geograficamente redundantes. cadeia (de caracteres)
geoBackupUserAssignedIdentityId Identificador da identidade gerenciada atribuída ao usuário usada para acessar a chave no Cofre de Chaves do Azure para criptografia de dados do armazenamento geograficamente redundante associado a um servidor configurado para dar suporte a backups geograficamente redundantes. cadeia (de caracteres)
primárioKeyURI URI da chave no Cofre de Chaves do Azure usada para criptografia de dados do armazenamento primário associado a um servidor. cadeia (de caracteres)
primaryUserAssignedIdentityId Identificador da identidade gerenciada atribuída ao usuário usada para acessar a chave no Cofre de Chaves do Azure para criptografia de dados do armazenamento primário associado a um servidor. cadeia (de caracteres)
tipo Tipo de criptografia de dados usado por um servidor. 'AzureKeyVault'
'SystemManaged'

Alta disponibilidade

Designação Descrição Valor
modo Modo de alta disponibilidade para um servidor. 'SameZone'
'ZoneRedundante'
standbyAvailabilityZone Zona de disponibilidade associada ao servidor em espera criado quando a alta disponibilidade é definida como SameZone ou ZoneRedundant. cadeia (de caracteres)

Janela de Manutenção

Designação Descrição Valor
customWindow Indica se a janela personalizada está habilitada ou desabilitada. cadeia (de caracteres)
diadesemana Dia da semana a utilizar para a janela de manutenção. Int
hora de início Hora de início a ser usada para a janela de manutenção. Int
Minuto inicial Minuto inicial a ser usado para a janela de manutenção. Int

Rede

Designação Descrição Valor
delegatedSubnetResourceId Identificador de recurso da sub-rede delegada. Necessário durante a criação de um novo servidor, caso pretenda que o servidor seja integrado na sua própria rede virtual. Para uma operação de atualização, você só precisa fornecer essa propriedade se quiser alterar o valor atribuído para a zona DNS privada. cadeia (de caracteres)
privateDnsZoneArmResourceId Identificador da zona DNS privada. Necessário durante a criação de um novo servidor, caso pretenda que o servidor seja integrado na sua própria rede virtual. Para uma operação de atualização, você só precisa fornecer essa propriedade se quiser alterar o valor atribuído para a zona DNS privada. cadeia (de caracteres)
acesso à rede pública Indica se o acesso à rede pública está habilitado ou não. Isso só é suportado para servidores que não estão integrados em uma rede virtual que é de propriedade e fornecida pelo cliente quando o servidor é implantado. 'Desativado'
'Habilitado'

Réplica

Designação Descrição Valor
promoverMode Tipo de operação a ser aplicada na réplica de leitura. Esta propriedade é somente gravação. Autônomo significa que a réplica de leitura será promovida para um servidor autônomo e se tornará uma entidade completamente independente do conjunto de replicação. A alternância significa que a réplica de leitura funcionará com o servidor primário. 'Autônomo'
'Transição'
promoverOpção Opção de sincronização de dados a ser usada ao processar a operação especificada na propriedade promoteMode. Esta propriedade é somente gravação. 'Forçado'
'Planejado'
função Função do servidor em um conjunto de replicação. 'AsyncReplica'
'GeoAsyncReplica'
'Nenhuma'
'Primária'

Propriedades do servidor

Designação Descrição Valor
administradorLogin Nome do login designado como o primeiro administrador baseado em senha atribuído à sua instância do PostgreSQL. Deve ser especificado na primeira vez que você habilitar a autenticação baseada em senha em um servidor. Uma vez definido para um determinado valor, ele não pode ser alterado para o resto da vida de um servidor. Se você desabilitar a autenticação baseada em senha em um servidor que a tenha habilitado, essa função baseada em senha não será excluída. cadeia (de caracteres)
administradorLoginPassword Palavra-passe atribuída ao início de sessão do administrador. Desde que a autenticação de senha esteja ativada, essa senha pode ser alterada a qualquer momento. cadeia de caracteres

Restrições:
Valor sensível. Passe como um parâmetro seguro.
authConfig Propriedades de configuração de autenticação de um servidor. AuthConfig
availabilityZone Zona de disponibilidade de um servidor. cadeia (de caracteres)
cópia de segurança Propriedades de backup de um servidor. Cópia de segurança
cluster Propriedades de cluster de um servidor. Aglomeração
createMode Modo de criação de um novo servidor. 'Criar'
'Inadimplência'
'GeoRestauração'
'PointInTimeRestore'
'Réplica'
'ReviveDropped'
'Atualização'
encriptação de dados Propriedades de criptografia de dados de um servidor. Encriptação de Dados
alta disponibilidade Propriedades de alta disponibilidade de um servidor. HighAvailability
manutençãoJanela Propriedades da janela de manutenção de um servidor. Janela de Manutenção
rede Propriedades de rede de um servidor. Apenas necessário se pretender que o seu servidor seja integrado numa rede virtual fornecida pelo cliente. Rede
pointInTimeUTC Tempo de criação (em formato ISO8601) do backup que você deseja restaurar no novo servidor. É necessário quando 'createMode' é 'PointInTimeRestore', 'GeoRestore' ou 'ReviveDropped'. cadeia (de caracteres)
réplica Leia as propriedades da réplica de um servidor. Necessário apenas no caso de você querer promover um servidor. Réplica
replicationRole Função do servidor em um conjunto de replicação. 'AsyncReplica'
'GeoAsyncReplica'
'Nenhuma'
'Primária'
sourceServerResourceId Identificador do servidor a ser usado como a origem do novo servidor. Necessário quando 'createMode' é 'PointInTimeRestore', 'GeoRestore', 'Replica' ou 'ReviveDropped'. Essa propriedade é retornada somente quando o servidor de destino é uma réplica de leitura. cadeia (de caracteres)
armazenamento Propriedades de armazenamento de um servidor. Armazenamento
versão Versão principal do mecanismo de banco de dados PostgreSQL. '11'
'12'
'13'
'14'
'15'
'16'
'17'
'18'

Referência

Designação Descrição Valor
Designação Nome pelo qual é conhecido um determinado tamanho de computação atribuído a um servidor. string (obrigatório)
escalão Camada da computação atribuída a um servidor. 'Estourável'
'Propósito Geral'
'MemoryOptimized' (obrigatório)

Armazenamento

Designação Descrição Valor
crescimento automático Sinalizar para ativar ou desativar o crescimento automático do tamanho de armazenamento de um servidor quando o espaço disponível estiver próximo de zero e as condições permitirem aumentar automaticamente o tamanho do armazenamento. 'Desativado'
'Habilitado'
IOPS IOPS máximo suportado para armazenamento. Necessário quando o tipo de armazenamento é PremiumV2_LRS ou UltraSSD_LRS. Int
storageSizeGB Tamanho do armazenamento atribuído a um servidor. Int
débito Taxa de transferência máxima suportada para armazenamento. Necessário quando o tipo de armazenamento é PremiumV2_LRS ou UltraSSD_LRS. Int
escalão Camada de armazenamento de um servidor. «P1»
«P10»
«P15»
«P2»
«P20»
«P3»
«P30»
«P4»
«P40»
«P50»
«P6»
«P60»
«P70»
«P80»
tipo Tipo de armazenamento atribuído a um servidor. Os valores permitidos são Premium_LRS, PremiumV2_LRS ou UltraSSD_LRS. Se não for especificado, o padrão será Premium_LRS. 'PremiumV2_LRS'
'Premium_LRS'
'UltraSSD_LRS'

TrackedResourceTags

Designação Descrição Valor

IdentidadeAtribuídaPeloUtilizador

Designação Descrição Valor
principalId Identificador do objeto da entidade de serviço associada à identidade gerenciada atribuída ao usuário. cadeia (de caracteres)
tipo Tipos de identidades associadas a um servidor. 'Nenhuma'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
identidades atribuídas pelo utilizador Mapa de identidades gerenciadas atribuídas pelo usuário. UserAssignedIdentityMap

UserAssignedIdentityMap

Designação Descrição Valor

Identidade do usuário

Designação Descrição Valor
ID do cliente Identificador do cliente da entidade de serviço associada à identidade gerenciada atribuída ao usuário. cadeia (de caracteres)
principalId Identificador do objeto da entidade de serviço associada à identidade gerenciada atribuída ao usuário. cadeia (de caracteres)

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Módulo Descrição
DB para Postgre SQL Flexible Server AVM Resource Module for DB for Postgre SQL Flexible Server

Exemplos de início rápido do Azure

Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
Criar servidor PgFlex & ativar a proteção através do Backup Vault Modelo que cria um Servidor Flexível PostgreSQL e permite proteção via Backup Vault
Implantar o Banco de Dados do Azure para PostgreSQL (flexível) com o AAD Este modelo fornece uma maneira de implantar um banco de dados flexível do Azure Server para PostgreSQL com integração com AAD.
Implantar o Banco de Dados do Azure para PostgreSQL (flexível) com VNet Este modelo fornece uma maneira de implantar um banco de dados flexível do Azure Server para PostgreSQL com integração VNet.
SonarQube on Web App com integração PostgreSQL e VNet Este modelo fornece fácil de implantar SonarQube para Web App no Linux com PostgreSQL Flexible Server, integração VNet e DNS privado.

Definição de recurso de modelo ARM

O tipo de recurso flexibleServers pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DBforPostgreSQL/flexibleServers, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "apiVersion": "2025-08-01",
  "name": "string",
  "identity": {
    "principalId": "string",
    "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"
    },
    "cluster": {
      "clusterSize": "int",
      "defaultDatabaseName": "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"
  }
}

Valores de propriedade

Microsoft.DBforPostgreSQL/flexibleServers

Designação Descrição Valor
Versão da API A versão api '2025-08-01'
identidade Identidades gerenciadas atribuídas ao servidor. UserAssignedIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
Designação O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* (obrigatório)
propriedades Propriedades de um servidor. Propriedades do servidor
SKU Camada de computação e tamanho de um servidor. Referência
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.DBforPostgreSQL/flexibleServers'

AuthConfig

Designação Descrição Valor
activeDirectoryAuth Indica se o servidor suporta a autenticação do Microsoft Entra. 'Desativado'
'Habilitado'
passwordAuth Indica se o servidor suporta autenticação baseada em senha. 'Desativado'
'Habilitado'
inquilinoId Identificador do locatário do recurso delegado. cadeia (de caracteres)

Backup

Designação Descrição Valor
backupRetentionDays Dias de retenção de backup para o servidor. Int
geoRedundantBackup Indica se o servidor está configurado para criar backups geograficamente redundantes. 'Desativado'
'Habilitado'

Aglomeração

Designação Descrição Valor
tamanho do cluster Número de nós atribuídos ao cluster elástico. Int
defaultDatabaseName Nome do banco de dados padrão para o cluster elástico. cadeia (de caracteres)

Encriptação de Dados

Designação Descrição Valor
geoBackupKeyURI Identificador da identidade gerenciada atribuída ao usuário usada para acessar a chave no Cofre de Chaves do Azure para criptografia de dados do armazenamento geograficamente redundante associado a um servidor configurado para dar suporte a backups geograficamente redundantes. cadeia (de caracteres)
geoBackupUserAssignedIdentityId Identificador da identidade gerenciada atribuída ao usuário usada para acessar a chave no Cofre de Chaves do Azure para criptografia de dados do armazenamento geograficamente redundante associado a um servidor configurado para dar suporte a backups geograficamente redundantes. cadeia (de caracteres)
primárioKeyURI URI da chave no Cofre de Chaves do Azure usada para criptografia de dados do armazenamento primário associado a um servidor. cadeia (de caracteres)
primaryUserAssignedIdentityId Identificador da identidade gerenciada atribuída ao usuário usada para acessar a chave no Cofre de Chaves do Azure para criptografia de dados do armazenamento primário associado a um servidor. cadeia (de caracteres)
tipo Tipo de criptografia de dados usado por um servidor. 'AzureKeyVault'
'SystemManaged'

Alta disponibilidade

Designação Descrição Valor
modo Modo de alta disponibilidade para um servidor. 'SameZone'
'ZoneRedundante'
standbyAvailabilityZone Zona de disponibilidade associada ao servidor em espera criado quando a alta disponibilidade é definida como SameZone ou ZoneRedundant. cadeia (de caracteres)

Janela de Manutenção

Designação Descrição Valor
customWindow Indica se a janela personalizada está habilitada ou desabilitada. cadeia (de caracteres)
diadesemana Dia da semana a utilizar para a janela de manutenção. Int
hora de início Hora de início a ser usada para a janela de manutenção. Int
Minuto inicial Minuto inicial a ser usado para a janela de manutenção. Int

Rede

Designação Descrição Valor
delegatedSubnetResourceId Identificador de recurso da sub-rede delegada. Necessário durante a criação de um novo servidor, caso pretenda que o servidor seja integrado na sua própria rede virtual. Para uma operação de atualização, você só precisa fornecer essa propriedade se quiser alterar o valor atribuído para a zona DNS privada. cadeia (de caracteres)
privateDnsZoneArmResourceId Identificador da zona DNS privada. Necessário durante a criação de um novo servidor, caso pretenda que o servidor seja integrado na sua própria rede virtual. Para uma operação de atualização, você só precisa fornecer essa propriedade se quiser alterar o valor atribuído para a zona DNS privada. cadeia (de caracteres)
acesso à rede pública Indica se o acesso à rede pública está habilitado ou não. Isso só é suportado para servidores que não estão integrados em uma rede virtual que é de propriedade e fornecida pelo cliente quando o servidor é implantado. 'Desativado'
'Habilitado'

Réplica

Designação Descrição Valor
promoverMode Tipo de operação a ser aplicada na réplica de leitura. Esta propriedade é somente gravação. Autônomo significa que a réplica de leitura será promovida para um servidor autônomo e se tornará uma entidade completamente independente do conjunto de replicação. A alternância significa que a réplica de leitura funcionará com o servidor primário. 'Autônomo'
'Transição'
promoverOpção Opção de sincronização de dados a ser usada ao processar a operação especificada na propriedade promoteMode. Esta propriedade é somente gravação. 'Forçado'
'Planejado'
função Função do servidor em um conjunto de replicação. 'AsyncReplica'
'GeoAsyncReplica'
'Nenhuma'
'Primária'

Propriedades do servidor

Designação Descrição Valor
administradorLogin Nome do login designado como o primeiro administrador baseado em senha atribuído à sua instância do PostgreSQL. Deve ser especificado na primeira vez que você habilitar a autenticação baseada em senha em um servidor. Uma vez definido para um determinado valor, ele não pode ser alterado para o resto da vida de um servidor. Se você desabilitar a autenticação baseada em senha em um servidor que a tenha habilitado, essa função baseada em senha não será excluída. cadeia (de caracteres)
administradorLoginPassword Palavra-passe atribuída ao início de sessão do administrador. Desde que a autenticação de senha esteja ativada, essa senha pode ser alterada a qualquer momento. cadeia de caracteres

Restrições:
Valor sensível. Passe como um parâmetro seguro.
authConfig Propriedades de configuração de autenticação de um servidor. AuthConfig
availabilityZone Zona de disponibilidade de um servidor. cadeia (de caracteres)
cópia de segurança Propriedades de backup de um servidor. Cópia de segurança
cluster Propriedades de cluster de um servidor. Aglomeração
createMode Modo de criação de um novo servidor. 'Criar'
'Inadimplência'
'GeoRestauração'
'PointInTimeRestore'
'Réplica'
'ReviveDropped'
'Atualização'
encriptação de dados Propriedades de criptografia de dados de um servidor. Encriptação de Dados
alta disponibilidade Propriedades de alta disponibilidade de um servidor. HighAvailability
manutençãoJanela Propriedades da janela de manutenção de um servidor. Janela de Manutenção
rede Propriedades de rede de um servidor. Apenas necessário se pretender que o seu servidor seja integrado numa rede virtual fornecida pelo cliente. Rede
pointInTimeUTC Tempo de criação (em formato ISO8601) do backup que você deseja restaurar no novo servidor. É necessário quando 'createMode' é 'PointInTimeRestore', 'GeoRestore' ou 'ReviveDropped'. cadeia (de caracteres)
réplica Leia as propriedades da réplica de um servidor. Necessário apenas no caso de você querer promover um servidor. Réplica
replicationRole Função do servidor em um conjunto de replicação. 'AsyncReplica'
'GeoAsyncReplica'
'Nenhuma'
'Primária'
sourceServerResourceId Identificador do servidor a ser usado como a origem do novo servidor. Necessário quando 'createMode' é 'PointInTimeRestore', 'GeoRestore', 'Replica' ou 'ReviveDropped'. Essa propriedade é retornada somente quando o servidor de destino é uma réplica de leitura. cadeia (de caracteres)
armazenamento Propriedades de armazenamento de um servidor. Armazenamento
versão Versão principal do mecanismo de banco de dados PostgreSQL. '11'
'12'
'13'
'14'
'15'
'16'
'17'
'18'

Referência

Designação Descrição Valor
Designação Nome pelo qual é conhecido um determinado tamanho de computação atribuído a um servidor. string (obrigatório)
escalão Camada da computação atribuída a um servidor. 'Estourável'
'Propósito Geral'
'MemoryOptimized' (obrigatório)

Armazenamento

Designação Descrição Valor
crescimento automático Sinalizar para ativar ou desativar o crescimento automático do tamanho de armazenamento de um servidor quando o espaço disponível estiver próximo de zero e as condições permitirem aumentar automaticamente o tamanho do armazenamento. 'Desativado'
'Habilitado'
IOPS IOPS máximo suportado para armazenamento. Necessário quando o tipo de armazenamento é PremiumV2_LRS ou UltraSSD_LRS. Int
storageSizeGB Tamanho do armazenamento atribuído a um servidor. Int
débito Taxa de transferência máxima suportada para armazenamento. Necessário quando o tipo de armazenamento é PremiumV2_LRS ou UltraSSD_LRS. Int
escalão Camada de armazenamento de um servidor. «P1»
«P10»
«P15»
«P2»
«P20»
«P3»
«P30»
«P4»
«P40»
«P50»
«P6»
«P60»
«P70»
«P80»
tipo Tipo de armazenamento atribuído a um servidor. Os valores permitidos são Premium_LRS, PremiumV2_LRS ou UltraSSD_LRS. Se não for especificado, o padrão será Premium_LRS. 'PremiumV2_LRS'
'Premium_LRS'
'UltraSSD_LRS'

TrackedResourceTags

Designação Descrição Valor

IdentidadeAtribuídaPeloUtilizador

Designação Descrição Valor
principalId Identificador do objeto da entidade de serviço associada à identidade gerenciada atribuída ao usuário. cadeia (de caracteres)
tipo Tipos de identidades associadas a um servidor. 'Nenhuma'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
identidades atribuídas pelo utilizador Mapa de identidades gerenciadas atribuídas pelo usuário. UserAssignedIdentityMap

UserAssignedIdentityMap

Designação Descrição Valor

Identidade do usuário

Designação Descrição Valor
ID do cliente Identificador do cliente da entidade de serviço associada à identidade gerenciada atribuída ao usuário. cadeia (de caracteres)
principalId Identificador do objeto da entidade de serviço associada à identidade gerenciada atribuída ao usuário. cadeia (de caracteres)

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

Modelo Descrição
Criar servidor PgFlex & ativar a proteção através do Backup Vault

Implementar no Azure
Modelo que cria um Servidor Flexível PostgreSQL e permite proteção via Backup Vault
Implantar o Banco de Dados do Azure para PostgreSQL (flexível) com o AAD

Implementar no Azure
Este modelo fornece uma maneira de implantar um banco de dados flexível do Azure Server para PostgreSQL com integração com AAD.
Implantar o Banco de Dados do Azure para PostgreSQL (flexível) com VNet

Implementar no Azure
Este modelo fornece uma maneira de implantar um banco de dados flexível do Azure Server para PostgreSQL com integração VNet.
SonarQube on Web App com integração PostgreSQL e VNet

Implementar no Azure
Este modelo fornece fácil de implantar SonarQube para Web App no Linux com PostgreSQL Flexible Server, integração VNet e DNS privado.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso flexibleServers pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DBforPostgreSQL/flexibleServers, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DBforPostgreSQL/flexibleServers@2025-08-01"
  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"
      }
      cluster = {
        clusterSize = int
        defaultDatabaseName = "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"
    }
  }
}

Valores de propriedade

Microsoft.DBforPostgreSQL/flexibleServers

Designação Descrição Valor
identidade Identidades gerenciadas atribuídas ao servidor. UserAssignedIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
Designação O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
propriedades Propriedades de um servidor. Propriedades do servidor
SKU Camada de computação e tamanho de um servidor. Referência
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.DBforPostgreSQL/flexibleServers@2025-08-01"

AuthConfig

Designação Descrição Valor
activeDirectoryAuth Indica se o servidor suporta a autenticação do Microsoft Entra. 'Desativado'
'Habilitado'
passwordAuth Indica se o servidor suporta autenticação baseada em senha. 'Desativado'
'Habilitado'
inquilinoId Identificador do locatário do recurso delegado. cadeia (de caracteres)

Backup

Designação Descrição Valor
backupRetentionDays Dias de retenção de backup para o servidor. Int
geoRedundantBackup Indica se o servidor está configurado para criar backups geograficamente redundantes. 'Desativado'
'Habilitado'

Aglomeração

Designação Descrição Valor
tamanho do cluster Número de nós atribuídos ao cluster elástico. Int
defaultDatabaseName Nome do banco de dados padrão para o cluster elástico. cadeia (de caracteres)

Encriptação de Dados

Designação Descrição Valor
geoBackupKeyURI Identificador da identidade gerenciada atribuída ao usuário usada para acessar a chave no Cofre de Chaves do Azure para criptografia de dados do armazenamento geograficamente redundante associado a um servidor configurado para dar suporte a backups geograficamente redundantes. cadeia (de caracteres)
geoBackupUserAssignedIdentityId Identificador da identidade gerenciada atribuída ao usuário usada para acessar a chave no Cofre de Chaves do Azure para criptografia de dados do armazenamento geograficamente redundante associado a um servidor configurado para dar suporte a backups geograficamente redundantes. cadeia (de caracteres)
primárioKeyURI URI da chave no Cofre de Chaves do Azure usada para criptografia de dados do armazenamento primário associado a um servidor. cadeia (de caracteres)
primaryUserAssignedIdentityId Identificador da identidade gerenciada atribuída ao usuário usada para acessar a chave no Cofre de Chaves do Azure para criptografia de dados do armazenamento primário associado a um servidor. cadeia (de caracteres)
tipo Tipo de criptografia de dados usado por um servidor. 'AzureKeyVault'
'SystemManaged'

Alta disponibilidade

Designação Descrição Valor
modo Modo de alta disponibilidade para um servidor. 'SameZone'
'ZoneRedundante'
standbyAvailabilityZone Zona de disponibilidade associada ao servidor em espera criado quando a alta disponibilidade é definida como SameZone ou ZoneRedundant. cadeia (de caracteres)

Janela de Manutenção

Designação Descrição Valor
customWindow Indica se a janela personalizada está habilitada ou desabilitada. cadeia (de caracteres)
diadesemana Dia da semana a utilizar para a janela de manutenção. Int
hora de início Hora de início a ser usada para a janela de manutenção. Int
Minuto inicial Minuto inicial a ser usado para a janela de manutenção. Int

Rede

Designação Descrição Valor
delegatedSubnetResourceId Identificador de recurso da sub-rede delegada. Necessário durante a criação de um novo servidor, caso pretenda que o servidor seja integrado na sua própria rede virtual. Para uma operação de atualização, você só precisa fornecer essa propriedade se quiser alterar o valor atribuído para a zona DNS privada. cadeia (de caracteres)
privateDnsZoneArmResourceId Identificador da zona DNS privada. Necessário durante a criação de um novo servidor, caso pretenda que o servidor seja integrado na sua própria rede virtual. Para uma operação de atualização, você só precisa fornecer essa propriedade se quiser alterar o valor atribuído para a zona DNS privada. cadeia (de caracteres)
acesso à rede pública Indica se o acesso à rede pública está habilitado ou não. Isso só é suportado para servidores que não estão integrados em uma rede virtual que é de propriedade e fornecida pelo cliente quando o servidor é implantado. 'Desativado'
'Habilitado'

Réplica

Designação Descrição Valor
promoverMode Tipo de operação a ser aplicada na réplica de leitura. Esta propriedade é somente gravação. Autônomo significa que a réplica de leitura será promovida para um servidor autônomo e se tornará uma entidade completamente independente do conjunto de replicação. A alternância significa que a réplica de leitura funcionará com o servidor primário. 'Autônomo'
'Transição'
promoverOpção Opção de sincronização de dados a ser usada ao processar a operação especificada na propriedade promoteMode. Esta propriedade é somente gravação. 'Forçado'
'Planejado'
função Função do servidor em um conjunto de replicação. 'AsyncReplica'
'GeoAsyncReplica'
'Nenhuma'
'Primária'

Propriedades do servidor

Designação Descrição Valor
administradorLogin Nome do login designado como o primeiro administrador baseado em senha atribuído à sua instância do PostgreSQL. Deve ser especificado na primeira vez que você habilitar a autenticação baseada em senha em um servidor. Uma vez definido para um determinado valor, ele não pode ser alterado para o resto da vida de um servidor. Se você desabilitar a autenticação baseada em senha em um servidor que a tenha habilitado, essa função baseada em senha não será excluída. cadeia (de caracteres)
administradorLoginPassword Palavra-passe atribuída ao início de sessão do administrador. Desde que a autenticação de senha esteja ativada, essa senha pode ser alterada a qualquer momento. cadeia de caracteres

Restrições:
Valor sensível. Passe como um parâmetro seguro.
authConfig Propriedades de configuração de autenticação de um servidor. AuthConfig
availabilityZone Zona de disponibilidade de um servidor. cadeia (de caracteres)
cópia de segurança Propriedades de backup de um servidor. Cópia de segurança
cluster Propriedades de cluster de um servidor. Aglomeração
createMode Modo de criação de um novo servidor. 'Criar'
'Inadimplência'
'GeoRestauração'
'PointInTimeRestore'
'Réplica'
'ReviveDropped'
'Atualização'
encriptação de dados Propriedades de criptografia de dados de um servidor. Encriptação de Dados
alta disponibilidade Propriedades de alta disponibilidade de um servidor. HighAvailability
manutençãoJanela Propriedades da janela de manutenção de um servidor. Janela de Manutenção
rede Propriedades de rede de um servidor. Apenas necessário se pretender que o seu servidor seja integrado numa rede virtual fornecida pelo cliente. Rede
pointInTimeUTC Tempo de criação (em formato ISO8601) do backup que você deseja restaurar no novo servidor. É necessário quando 'createMode' é 'PointInTimeRestore', 'GeoRestore' ou 'ReviveDropped'. cadeia (de caracteres)
réplica Leia as propriedades da réplica de um servidor. Necessário apenas no caso de você querer promover um servidor. Réplica
replicationRole Função do servidor em um conjunto de replicação. 'AsyncReplica'
'GeoAsyncReplica'
'Nenhuma'
'Primária'
sourceServerResourceId Identificador do servidor a ser usado como a origem do novo servidor. Necessário quando 'createMode' é 'PointInTimeRestore', 'GeoRestore', 'Replica' ou 'ReviveDropped'. Essa propriedade é retornada somente quando o servidor de destino é uma réplica de leitura. cadeia (de caracteres)
armazenamento Propriedades de armazenamento de um servidor. Armazenamento
versão Versão principal do mecanismo de banco de dados PostgreSQL. '11'
'12'
'13'
'14'
'15'
'16'
'17'
'18'

Referência

Designação Descrição Valor
Designação Nome pelo qual é conhecido um determinado tamanho de computação atribuído a um servidor. string (obrigatório)
escalão Camada da computação atribuída a um servidor. 'Estourável'
'Propósito Geral'
'MemoryOptimized' (obrigatório)

Armazenamento

Designação Descrição Valor
crescimento automático Sinalizar para ativar ou desativar o crescimento automático do tamanho de armazenamento de um servidor quando o espaço disponível estiver próximo de zero e as condições permitirem aumentar automaticamente o tamanho do armazenamento. 'Desativado'
'Habilitado'
IOPS IOPS máximo suportado para armazenamento. Necessário quando o tipo de armazenamento é PremiumV2_LRS ou UltraSSD_LRS. Int
storageSizeGB Tamanho do armazenamento atribuído a um servidor. Int
débito Taxa de transferência máxima suportada para armazenamento. Necessário quando o tipo de armazenamento é PremiumV2_LRS ou UltraSSD_LRS. Int
escalão Camada de armazenamento de um servidor. «P1»
«P10»
«P15»
«P2»
«P20»
«P3»
«P30»
«P4»
«P40»
«P50»
«P6»
«P60»
«P70»
«P80»
tipo Tipo de armazenamento atribuído a um servidor. Os valores permitidos são Premium_LRS, PremiumV2_LRS ou UltraSSD_LRS. Se não for especificado, o padrão será Premium_LRS. 'PremiumV2_LRS'
'Premium_LRS'
'UltraSSD_LRS'

TrackedResourceTags

Designação Descrição Valor

IdentidadeAtribuídaPeloUtilizador

Designação Descrição Valor
principalId Identificador do objeto da entidade de serviço associada à identidade gerenciada atribuída ao usuário. cadeia (de caracteres)
tipo Tipos de identidades associadas a um servidor. 'Nenhuma'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
identidades atribuídas pelo utilizador Mapa de identidades gerenciadas atribuídas pelo usuário. UserAssignedIdentityMap

UserAssignedIdentityMap

Designação Descrição Valor

Identidade do usuário

Designação Descrição Valor
ID do cliente Identificador do cliente da entidade de serviço associada à identidade gerenciada atribuída ao usuário. cadeia (de caracteres)
principalId Identificador do objeto da entidade de serviço associada à identidade gerenciada atribuída ao usuário. cadeia (de caracteres)

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação do 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    = ["*"]
}

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Módulo Descrição
DB para Postgre SQL Flexible Server AVM Resource Module for DB for Postgre SQL Flexible Server