Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
- Últimas
- 2025-08-01
- 2025-06-01-preview
- 2025-01-01-visualização
- 2024-11-01-pré-visualização
- 2024-08-01
- 2024-03-01-visualização
- 2023-12-01-pré-visualização
- 2023-06-01-visualização
- 2023-03-01-visualização
- 2022-12-01
- 2022-03-08-pré-visualização
- 2022-01-20-pré-visualização
- 2021-06-01
- 2021-06-01-pré-visualização
- 2020-02-14-pré-visualização
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 |
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 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 |