Servers - Update

Serviço:: PostgreSQL

Versão da API:: 2025-08-01

Atualiza um servidor existente. O corpo da solicitação pode conter uma ou várias das propriedades presentes na definição normal do servidor.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}?api-version=2025-08-01

Parâmetros do URI

Nome	Em	Obrigatório	Tipo	Descrição
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
serverName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*	O nome do servidor.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Nome	Tipo	Descrição
identity	UserAssignedIdentity	Descreve a identidade do aplicativo.
properties.administratorLoginPassword	string (password)	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.
properties.authConfig	AuthConfigForPatch	Propriedades de configuração de autenticação de um servidor.
properties.availabilityZone	string	Zona de disponibilidade de um servidor.
properties.backup	BackupForPatch	Propriedades de backup de um servidor.
properties.cluster	Cluster	Propriedades de cluster de um servidor.
properties.createMode	CreateModeForPatch	Modo de atualização de um servidor existente.
properties.dataEncryption	DataEncryption	Propriedades de criptografia de dados de um servidor.
properties.highAvailability	HighAvailabilityForPatch	Propriedades de alta disponibilidade de um servidor.
properties.maintenanceWindow	MaintenanceWindowForPatch	Propriedades da janela de manutenção de um servidor.
properties.network	Network	Propriedades de rede de um servidor. Apenas necessário se pretender que o seu servidor seja integrado numa rede virtual fornecida pelo cliente.
properties.replica	Replica	Leia as propriedades da réplica de um servidor. Necessário apenas no caso de você querer promover um servidor.
properties.replicationRole	ReplicationRole	Função do servidor em um conjunto de replicação.
properties.storage	Storage	Propriedades de armazenamento de um servidor.
properties.version	PostgresMajorVersion	Versão principal do mecanismo de banco de dados PostgreSQL.
sku	SkuForPatch	Camada de computação e tamanho de um servidor.
tags	object	Metadados específicos do aplicativo na forma de pares chave-valor.

Respostas

Nome	Tipo	Descrição
202 Accepted		Operação de recurso aceita. Cabeçalhos Azure-AsyncOperation: string Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Nome

Tipo

Descrição

202 Accepted

Operação de recurso aceita.

Cabeçalhos

Azure-AsyncOperation: string
Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Nome	Descrição
user_impersonation	personificar a sua conta de utilizador

Exemplos

Promote a read replica to a standalone server with forced data synchronization. Meaning that it doesn't wait for data in the read replica to be synchronized with its source server before it initiates the promotion to a standalone server.

Promote a read replica to a standalone server with planned data synchronization. Meaning that it waits for data in the read replica to be fully synchronized with its source server before it initiates the promotion to a standalone server.

Switch over a read replica to primary server with forced data synchronization. Meaning that it doesn't wait for data in the read replica to be synchronized with its source server before it initiates the switching of roles between the read replica and the primary server.

Switch over a read replica to primary server with planned data synchronization. Meaning that it waits for data in the read replica to be fully synchronized with its source server before it initiates the switching of roles between the read replica and the primary server.

Update an existing server to upgrade the major version of PostgreSQL database engine.

Update an existing server with custom maintenance window.

Update an existing server with data encryption based on customer managed key with automatic key version update.

Update an existing server with data encryption based on customer managed key.

Update an existing server with Microsoft Entra authentication enabled.

Update an existing server.

Promote a read replica to a standalone server with forced data synchronization. Meaning that it doesn't wait for data in the read replica to be synchronized with its source server before it initiates the promotion to a standalone server.

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2025-08-01

{
  "properties": {
    "replica": {
      "promoteMode": "Standalone",
      "promoteOption": "Forced"
    }
  }
}

Resposta da amostra

Código de estado:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/azureAsyncOperation/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa?api-version=2025-06-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2025-06-01-preview

Promote a read replica to a standalone server with planned data synchronization. Meaning that it waits for data in the read replica to be fully synchronized with its source server before it initiates the promotion to a standalone server.

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2025-08-01

{
  "properties": {
    "replica": {
      "promoteMode": "Standalone",
      "promoteOption": "Planned"
    }
  }
}

Resposta da amostra

Código de estado:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/azureAsyncOperation/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa?api-version=2025-06-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2025-06-01-preview

Switch over a read replica to primary server with forced data synchronization. Meaning that it doesn't wait for data in the read replica to be synchronized with its source server before it initiates the switching of roles between the read replica and the primary server.

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2025-08-01

{
  "properties": {
    "replica": {
      "promoteMode": "Switchover",
      "promoteOption": "Forced"
    }
  }
}

Resposta da amostra

Código de estado:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/azureAsyncOperation/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa?api-version=2025-06-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2025-06-01-preview

Switch over a read replica to primary server with planned data synchronization. Meaning that it waits for data in the read replica to be fully synchronized with its source server before it initiates the switching of roles between the read replica and the primary server.

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2025-08-01

{
  "properties": {
    "replica": {
      "promoteMode": "Switchover",
      "promoteOption": "Planned"
    }
  }
}

Resposta da amostra

Código de estado:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/azureAsyncOperation/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa?api-version=2025-06-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2025-06-01-preview

Update an existing server to upgrade the major version of PostgreSQL database engine.

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2025-08-01

{
  "properties": {
    "createMode": "Update",
    "version": "18"
  }
}

Resposta da amostra

Código de estado:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/azureAsyncOperation/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa?api-version=2025-06-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2025-06-01-preview

Update an existing server with custom maintenance window.

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2025-08-01

{
  "properties": {
    "createMode": "Update",
    "maintenanceWindow": {
      "customWindow": "Enabled",
      "dayOfWeek": 0,
      "startHour": 8,
      "startMinute": 0
    }
  }
}

Resposta da amostra

Código de estado:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/azureAsyncOperation/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa?api-version=2025-06-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2025-06-01-preview

Update an existing server with data encryption based on customer managed key with automatic key version update.

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2025-08-01

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplegeoredundantidentity": {},
      "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/exampleprimaryidentity": {}
    }
  },
  "properties": {
    "administratorLoginPassword": "examplenewpassword",
    "backup": {
      "backupRetentionDays": 20
    },
    "createMode": "Update",
    "dataEncryption": {
      "type": "AzureKeyVault",
      "geoBackupKeyURI": "https://examplegeoredundantkeyvault.vault.azure.net/keys/examplekey",
      "geoBackupUserAssignedIdentityId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplegeoredundantidentity",
      "primaryKeyURI": "https://exampleprimarykeyvault.vault.azure.net/keys/examplekey",
      "primaryUserAssignedIdentityId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/exampleprimaryidentity"
    }
  },
  "sku": {
    "name": "Standard_D8s_v3",
    "tier": "GeneralPurpose"
  }
}

Resposta da amostra

Código de estado:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/azureAsyncOperation/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa?api-version=2025-06-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2025-06-01-preview

Update an existing server with data encryption based on customer managed key.

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2025-08-01

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplegeoredundantidentity": {},
      "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/exampleprimaryidentity": {}
    }
  },
  "properties": {
    "administratorLoginPassword": "examplenewpassword",
    "backup": {
      "backupRetentionDays": 20
    },
    "createMode": "Update",
    "dataEncryption": {
      "type": "AzureKeyVault",
      "geoBackupKeyURI": "https://examplegeoredundantkeyvault.vault.azure.net/keys/examplekey/yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
      "geoBackupUserAssignedIdentityId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplegeoredundantidentity",
      "primaryKeyURI": "https://exampleprimarykeyvault.vault.azure.net/keys/examplekey/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "primaryUserAssignedIdentityId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/exampleprimaryidentity"
    }
  },
  "sku": {
    "name": "Standard_D8s_v3",
    "tier": "GeneralPurpose"
  }
}

Resposta da amostra

Código de estado:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/azureAsyncOperation/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa?api-version=2025-06-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2025-06-01-preview

Update an existing server with Microsoft Entra authentication enabled.

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2025-08-01

{
  "properties": {
    "administratorLoginPassword": "examplenewpassword",
    "authConfig": {
      "activeDirectoryAuth": "Enabled",
      "passwordAuth": "Enabled",
      "tenantId": "tttttt-tttt-tttt-tttt-tttttttttttt"
    },
    "backup": {
      "backupRetentionDays": 20
    },
    "createMode": "Update",
    "storage": {
      "autoGrow": "Disabled",
      "storageSizeGB": 1024,
      "tier": "P30"
    }
  },
  "sku": {
    "name": "Standard_D8s_v3",
    "tier": "GeneralPurpose"
  }
}

Resposta da amostra

Código de estado:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/azureAsyncOperation/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa?api-version=2025-06-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2025-06-01-preview

Update an existing server.

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2025-08-01

{
  "properties": {
    "administratorLoginPassword": "examplenewpassword",
    "backup": {
      "backupRetentionDays": 20
    },
    "createMode": "Update",
    "storage": {
      "autoGrow": "Enabled",
      "storageSizeGB": 1024,
      "tier": "P30"
    }
  },
  "sku": {
    "name": "Standard_D8s_v3",
    "tier": "GeneralPurpose"
  }
}

Resposta da amostra

Código de estado:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/azureAsyncOperation/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa?api-version=2025-06-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2025-06-01-preview

Definições

Nome	Descrição
AuthConfigForPatch	Propriedades de configuração de autenticação de um servidor.
AzureManagedDiskPerformanceTier	Camada de armazenamento de um servidor.
BackupForPatch	Propriedades de backup de um servidor.
Cluster	Propriedades de cluster de um servidor.
CreateModeForPatch	Modo de atualização de um servidor existente.
DataEncryption	Propriedades de criptografia de dados de um servidor.
DataEncryptionType	Tipo de criptografia de dados usado por um servidor.
EncryptionKeyStatus	Status da chave usada por um servidor configurado com criptografia de dados com base na chave gerenciada pelo cliente, para criptografar o armazenamento primário associado ao servidor.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
GeographicallyRedundantBackup	Indica se o servidor está configurado para criar backups geograficamente redundantes.
HighAvailabilityForPatch	Propriedades de alta disponibilidade de um servidor.
HighAvailabilityState	Possíveis estados do servidor em espera criados quando a alta disponibilidade é definida como SameZone ou ZoneRedundant.
IdentityType	Tipos de identidades associadas a um servidor.
MaintenanceWindowForPatch	Propriedades da janela de manutenção de um servidor.
MicrosoftEntraAuth	Indica se o servidor suporta autenticação Microsoft Entra.
Network	Propriedades de rede de um servidor.
PasswordBasedAuth	Indica se o servidor suporta autenticação baseada em senha.
PostgresMajorVersion	Versão principal do mecanismo de banco de dados PostgreSQL.
PostgreSqlFlexibleServerHighAvailabilityMode	Modo de alta disponibilidade suportado para este cálculo.
ReadReplicaPromoteMode	Tipo de operação a ser aplicada na réplica de leitura. Esta propriedade é somente gravação.
ReadReplicaPromoteOption	Opção de sincronização de dados a ser usada ao processar a operação especificada na propriedade promoteMode. Esta propriedade é somente gravação.
Replica	Propriedades de réplica de um servidor.
ReplicationRole	Função do servidor em um conjunto de replicação.
ReplicationState	Indica o estado de replicação de uma réplica de leitura. Essa propriedade é retornada somente quando o servidor de destino é uma réplica de leitura.
ServerForPatch	Representa um servidor a ser atualizado.
ServerPublicNetworkAccessState	Indica se o acesso à rede pública está habilitado ou não.
SkuForPatch	Computar informações de um servidor.
SkuTier	Camada da computação atribuída a um servidor.
Storage	Propriedades de armazenamento de um servidor.
StorageAutoGrow	Indica se o servidor está configurado para aumentar automaticamente o tamanho do armazenamento quando o espaço disponível se aproxima de zero e as condições permitem o crescimento automático do tamanho do armazenamento.
StorageType	Tipo de armazenamento atribuído a um servidor. Se não for especificado, o padrão será Premium_LRS.
UserAssignedIdentity	Identidades associadas a um servidor.
UserIdentity	Identidade gerenciada atribuída pelo usuário associada a um servidor.

AuthConfigForPatch

Object

Propriedades de configuração de autenticação de um servidor.

Nome	Tipo	Descrição
activeDirectoryAuth	MicrosoftEntraAuth	Indica se o servidor suporta autenticação Microsoft Entra.
passwordAuth	PasswordBasedAuth	Indica se o servidor suporta autenticação baseada em senha.
tenantId	string	Identificador do locatário do recurso delegado.

AzureManagedDiskPerformanceTier

Enumeração

Camada de armazenamento de um servidor.

Valor	Descrição
P1	SSD de nível básico para IOPS mínimas, ideal para cargas de trabalho de desenvolvimento ou teste leves.
P2	IOPS ligeiramente mais alta para aplicativos de pequena escala que precisam de baixa latência consistente.
P3	Desempenho equilibrado para cargas de trabalho básicas de produção com rendimento moderado.
P4	IOPS aprimoradas para aplicativos em crescimento com necessidades de desempenho previsíveis.
P6	SSD de nível intermediário para cargas de trabalho estáveis que exigem taxa de transferência e latência confiáveis.
P10	Escolha popular para cargas de trabalho de produção de uso geral com desempenho escalável.
P15	Camada IOPS alta para aplicativos exigentes com operações frequentes de leitura/gravação.
P20	Ponto de entrada para discos de estado sólido (SSDs) de alto desempenho, adequado para cargas de trabalho intensivas de E/S em pequena escala.
P30	Nível equilibrado para aplicativos sensíveis à latência e taxa de transferência moderada.
P40	Desempenho aprimorado para cargas de trabalho de produção crescentes com demandas de IOPS consistentes.
P50	Otimizado para aplicativos de nível empresarial que precisam de alto rendimento sustentado.
P60	Camada de alta capacidade para grandes bancos de dados e cargas de trabalho de análise com IOPS elevadas.
P70	Projetado para sistemas de missão crítica que exigem latência ultrabaixa e alta simultaneidade.
P80	SSD de nível superior para IOPS e rendimento máximos, ideal para as cargas de trabalho mais exigentes.

BackupForPatch

Object

Propriedades de backup de um servidor.

Nome	Tipo	Descrição
backupRetentionDays	integer (int32)	Dias de retenção de backup para o servidor.
earliestRestoreDate	string (date-time)	Tempo de ponto de restauração mais antigo (formato ISO8601) para um servidor.
geoRedundantBackup	GeographicallyRedundantBackup	Indica se o servidor está configurado para criar backups geograficamente redundantes.

Cluster

Object

Propriedades de cluster de um servidor.

Nome	Tipo	Valor predefinido	Descrição
clusterSize	integer (int32)	0	Número de nós atribuídos ao cluster elástico.
defaultDatabaseName	string		Nome do banco de dados padrão para o cluster elástico.

CreateModeForPatch

Enumeração

Modo de atualização de um servidor existente.

Valor	Descrição
Default	É equivalente a 'Atualizar'.
Update	A operação atualiza um servidor existente.

DataEncryption

Object

Propriedades de criptografia de dados de um servidor.

Nome	Tipo	Descrição
geoBackupEncryptionKeyStatus	EncryptionKeyStatus	Status da chave usada por um servidor configurado com criptografia de dados com base na chave gerenciada pelo cliente, para criptografar o armazenamento geograficamente redundante associado ao servidor quando ele é configurado para suportar backups geograficamente redundantes.
geoBackupKeyURI	string	Identificador da identidade gerida atribuída pelo utilizador usado para aceder à chave no Azure Key Vault para encriptação de dados do armazenamento geograficamente redundante associado a um servidor configurado para suportar backups geograficamente redundantes.
geoBackupUserAssignedIdentityId	string	Identificador da identidade gerida atribuída pelo utilizador usado para aceder à chave no Azure Key Vault para encriptação de dados do armazenamento geograficamente redundante associado a um servidor configurado para suportar backups geograficamente redundantes.
primaryEncryptionKeyStatus	EncryptionKeyStatus	Status da chave usada por um servidor configurado com criptografia de dados com base na chave gerenciada pelo cliente, para criptografar o armazenamento primário associado ao servidor.
primaryKeyURI	string	URI da chave no Azure Key Vault usado para encriptação de dados do armazenamento principal associado a um servidor.
primaryUserAssignedIdentityId	string	Identificador da identidade gerida atribuída pelo utilizador usado para aceder à chave no Azure Key Vault para encriptação de dados do armazenamento principal associado a um servidor.
type	DataEncryptionType	Tipo de criptografia de dados usado por um servidor.

DataEncryptionType

Enumeração

Tipo de criptografia de dados usado por um servidor.

Valor	Descrição
SystemManaged	Encriptação gerida pelo Azure usando chaves geridas por plataforma para simplificação e conformidade.
AzureKeyVault	Encriptação usando chaves geridas pelo cliente armazenadas no Azure Key Vault para maior controlo e segurança.

EncryptionKeyStatus

Enumeração

Status da chave usada por um servidor configurado com criptografia de dados com base na chave gerenciada pelo cliente, para criptografar o armazenamento primário associado ao servidor.

Valor	Descrição
Valid	A chave é válida e pode ser usada para criptografia.
Invalid	A chave é inválida e não pode ser usada para criptografia. As causas possíveis incluem exclusão de chave, alterações de permissão, chave sendo desabilitada, tipo de chave não suportado ou data atual fora do período de validade associado à chave.

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Nome	Tipo	Descrição
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Nome	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Object

Resposta de erro

Nome	Tipo	Descrição
error	ErrorDetail	O objeto de erro.

GeographicallyRedundantBackup

Enumeração

Indica se o servidor está configurado para criar backups geograficamente redundantes.

Valor	Descrição
Enabled	O servidor está configurado para criar backups geograficamente redundantes.
Disabled	O servidor não está configurado para criar backups geograficamente redundantes.

HighAvailabilityForPatch

Object

Propriedades de alta disponibilidade de um servidor.

Nome	Tipo	Descrição
mode	PostgreSqlFlexibleServerHighAvailabilityMode	Modo de alta disponibilidade para um servidor.
standbyAvailabilityZone	string	Zona de disponibilidade associada ao servidor em espera criado quando a alta disponibilidade é definida como SameZone ou ZoneRedundant.
state	HighAvailabilityState	Possíveis estados do servidor em espera criados quando a alta disponibilidade é definida como SameZone ou ZoneRedundant.

HighAvailabilityState

Enumeração

Possíveis estados do servidor em espera criados quando a alta disponibilidade é definida como SameZone ou ZoneRedundant.

Valor	Descrição
NotEnabled	A alta disponibilidade não está habilitada para o servidor.
CreatingStandby	O servidor em espera está sendo criado.
ReplicatingData	Os dados estão sendo replicados para o servidor em espera.
FailingOver	A operação de failover para o servidor em espera está em andamento.
Healthy	O servidor em espera está íntegro e pronto para assumir o controle em caso de failover.
RemovingStandby	O servidor em espera está sendo removido.
RecreatingStandby	O servidor de espera está a ser recriado.
ComputeUpdatingByFailover	O Compute está a ser atualizado devido a um failover.

IdentityType

Enumeração

Tipos de identidades associadas a um servidor.

Valor	Descrição
None	Nenhuma identidade gerenciada é atribuída ao servidor.
UserAssigned	Uma ou mais identidades gerenciadas fornecidas pelo usuário são atribuídas ao servidor.
SystemAssigned	O Azure cria e gere automaticamente a identidade associada ao ciclo de vida do servidor.
SystemAssigned,UserAssigned	As identidades atribuídas pelo sistema e pelo usuário são atribuídas ao servidor.

MaintenanceWindowForPatch

Object

Propriedades da janela de manutenção de um servidor.

Nome	Tipo	Descrição
customWindow	string	Indica se a janela personalizada está habilitada ou desabilitada.
dayOfWeek	integer (int32)	Dia da semana a utilizar para a janela de manutenção.
startHour	integer (int32)	Hora de início a ser usada para a janela de manutenção.
startMinute	integer (int32)	Minuto inicial a ser usado para a janela de manutenção.

MicrosoftEntraAuth

Enumeração

Indica se o servidor suporta autenticação Microsoft Entra.

Valor	Descrição
Enabled	O servidor suporta autenticação Microsoft Entra.
Disabled	O servidor não suporta autenticação Microsoft Entra.

Network

Object

Propriedades de rede de um servidor.

Nome	Tipo	Descrição
delegatedSubnetResourceId	string (arm-id)	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.
privateDnsZoneArmResourceId	string (arm-id)	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.
publicNetworkAccess	ServerPublicNetworkAccessState	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.

PasswordBasedAuth

Enumeração

Indica se o servidor suporta autenticação baseada em senha.

Valor	Descrição
Enabled	O servidor suporta autenticação baseada em senha.
Disabled	O servidor não suporta autenticação baseada em palavra-passe.

PostgresMajorVersion

Enumeração

Versão principal do mecanismo de banco de dados PostgreSQL.

Valor	Descrição
18	PostgreSQL 18.
17	PostgreSQL 17.
16	PostgreSQL 16.
15	PostgreSQL 15.
14	PostgreSQL 14.
13	PostgreSQL 13.
12	PostgreSQL 12.
11	PostgreSQL 11.

PostgreSqlFlexibleServerHighAvailabilityMode

Enumeração

Modo de alta disponibilidade suportado para este cálculo.

Valor	Descrição
Disabled	A alta disponibilidade está desativada para o servidor.
ZoneRedundant	A alta disponibilidade está habilitada para o servidor, com o servidor em espera em uma zona de disponibilidade diferente da principal.
SameZone	A alta disponibilidade está habilitada para o servidor, com o servidor em espera na mesma zona de disponibilidade do principal.

ReadReplicaPromoteMode

Enumeração

Tipo de operação a ser aplicada na réplica de leitura. Esta propriedade é somente gravação.

Valor	Descrição
Standalone	A réplica de leitura tornar-se-á um servidor independente e uma entidade completamente independente do conjunto de replicação.
Switchover	A réplica de leitura trocará funções com o servidor primário.

ReadReplicaPromoteOption

Enumeraçã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.

Valor	Descrição
Planned	Espere que os dados na réplica de leitura estejam totalmente sincronizados com o seu servidor de origem antes de iniciar a operação.
Forced	Iniciar a operação imediatamente, sem esperar que os dados na réplica de leitura sejam sincronizados com o seu servidor de origem.

Replica

Object

Propriedades de réplica de um servidor.

Nome	Tipo	Descrição
capacity	integer (int32)	Número máximo de réplicas de leitura permitido para um servidor.
promoteMode	ReadReplicaPromoteMode	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.
promoteOption	ReadReplicaPromoteOption	Opção de sincronização de dados a ser usada ao processar a operação especificada na propriedade promoteMode. Esta propriedade é somente gravação.
replicationState	ReplicationState	Indica o estado de replicação de uma réplica de leitura. Essa propriedade é retornada somente quando o servidor de destino é uma réplica de leitura. Os valores possíveis são Ativo, Quebrado, Catchup, Provisionamento, Reconfiguração e Atualização
role	ReplicationRole	Função do servidor em um conjunto de replicação.

ReplicationRole

Enumeração

Função do servidor em um conjunto de replicação.

Valor	Descrição
None	Nenhuma função de replicação atribuída; O servidor opera de forma independente.
Primary	Atua como o servidor de origem para replicação para uma ou mais réplicas.
AsyncReplica	Recebe dados de forma assíncrona de um servidor primário dentro da mesma região.
GeoAsyncReplica	Recebe dados de forma assíncrona de um servidor primário em uma região diferente para redundância geográfica.

ReplicationState

Enumeração

Indica o estado de replicação de uma réplica de leitura. Essa propriedade é retornada somente quando o servidor de destino é uma réplica de leitura.

Valor	Descrição
Active	O servidor de réplica de leitura está totalmente sincronizado e está a replicar ativamente os dados do servidor principal.
Catchup	O servidor réplica de leitura está atrás do servidor principal e está atualmente a recuperar alterações pendentes.
Provisioning	O servidor réplica de leitura está a ser criado e está em processo de inicialização.
Updating	O servidor réplica de leitura está a passar por algumas alterações, pode estar a alterar o tamanho de computação ou promovê-lo ao servidor principal.
Broken	A replicação falhou ou foi interrompida.
Reconfiguring	O servidor réplica de leitura está a ser reconfigurado, possivelmente devido a alterações na origem ou nas definições.

ServerForPatch

Object

Representa um servidor a ser atualizado.

Nome	Tipo	Descrição
identity	UserAssignedIdentity	Descreve a identidade do aplicativo.
properties.administratorLogin	string	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.
properties.administratorLoginPassword	string (password)	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.
properties.authConfig	AuthConfigForPatch	Propriedades de configuração de autenticação de um servidor.
properties.availabilityZone	string	Zona de disponibilidade de um servidor.
properties.backup	BackupForPatch	Propriedades de backup de um servidor.
properties.cluster	Cluster	Propriedades de cluster de um servidor.
properties.createMode	CreateModeForPatch	Modo de atualização de um servidor existente.
properties.dataEncryption	DataEncryption	Propriedades de criptografia de dados de um servidor.
properties.highAvailability	HighAvailabilityForPatch	Propriedades de alta disponibilidade de um servidor.
properties.maintenanceWindow	MaintenanceWindowForPatch	Propriedades da janela de manutenção de um servidor.
properties.network	Network	Propriedades de rede de um servidor. Apenas necessário se pretender que o seu servidor seja integrado numa rede virtual fornecida pelo cliente.
properties.replica	Replica	Leia as propriedades da réplica de um servidor. Necessário apenas no caso de você querer promover um servidor.
properties.replicationRole	ReplicationRole	Função do servidor em um conjunto de replicação.
properties.storage	Storage	Propriedades de armazenamento de um servidor.
properties.version	PostgresMajorVersion	Versão principal do mecanismo de banco de dados PostgreSQL.
sku	SkuForPatch	Camada de computação e tamanho de um servidor.
tags	object	Metadados específicos do aplicativo na forma de pares chave-valor.

ServerPublicNetworkAccessState

Enumeração

Indica se o acesso à rede pública está habilitado ou não.

Valor	Descrição
Enabled	O acesso à rede pública está habilitado. Isso permite que o servidor seja acessado a partir da Internet pública, desde que a regra de firewall necessária que permite o tráfego de entrada originado do cliente de conexão esteja em vigor. Isso é compatível com o uso de pontos de extremidade privados para se conectar a este servidor.
Disabled	O acesso à rede pública está desativado. Isto significa que o servidor não pode ser acedido a partir da Internet pública, mas apenas através de terminais privados.

SkuForPatch

Object

Computar informações de um servidor.

Nome	Tipo	Descrição
name	string	Nome pelo qual é conhecido um determinado tamanho de computação atribuído a um servidor.
tier	SkuTier	Camada da computação atribuída a um servidor.

SkuTier

Enumeração

Camada da computação atribuída a um servidor.

Valor	Descrição
Burstable	Nível econômico para uso pouco frequente da CPU, ideal para cargas de trabalho de desenvolvimento e teste com baixos requisitos de desempenho.
GeneralPurpose	Computação e memória equilibradas para a maioria das cargas de trabalho, oferecendo desempenho escalável e taxa de transferência de E/S.
MemoryOptimized	Alta relação memória/núcleo para cargas de trabalho exigentes que precisam de processamento rápido na memória e alta simultaneidade.

Storage

Object

Propriedades de armazenamento de um servidor.

Nome	Tipo	Descrição
autoGrow	StorageAutoGrow	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.
iops	integer (int32)	IOPS máximo suportado para armazenamento. Necessário quando o tipo de armazenamento é PremiumV2_LRS ou UltraSSD_LRS.
storageSizeGB	integer (int32)	Tamanho do armazenamento atribuído a um servidor.
throughput	integer (int32)	Taxa de transferência máxima suportada para armazenamento. Necessário quando o tipo de armazenamento é PremiumV2_LRS ou UltraSSD_LRS.
tier	AzureManagedDiskPerformanceTier	Camada de armazenamento de um servidor.
type	StorageType	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.

StorageAutoGrow

Enumeração

Indica se o servidor está configurado para aumentar automaticamente o tamanho do armazenamento quando o espaço disponível se aproxima de zero e as condições permitem o crescimento automático do tamanho do armazenamento.

Valor	Descrição
Enabled	O servidor deve aumentar automaticamente o tamanho do armazenamento quando o espaço disponível estiver próximo de zero e as condições permitirem aumentar automaticamente o tamanho do armazenamento.
Disabled	O servidor não deve aumentar automaticamente o tamanho do armazenamento quando o espaço disponível estiver próximo de zero.

StorageType

Enumeração

Tipo de armazenamento atribuído a um servidor. Se não for especificado, o padrão será Premium_LRS.

Valor	Descrição
Premium_LRS	O armazenamento padrão suportado por SSD (Solid State Disk) oferece desempenho consistente para cargas de trabalho de uso geral.
PremiumV2_LRS	Armazenamento SSD (Solid State Disk) de última geração com escalabilidade e desempenho melhorados para cargas de trabalho empresariais exigentes.
UltraSSD_LRS	Armazenamento de disco de estado sólido (SSD) high-end projetado para IOPS extremas e aplicativos sensíveis à latência.

UserAssignedIdentity

Object

Identidades associadas a um servidor.

Nome	Tipo	Descrição
principalId	string	Identificador do objeto da entidade de serviço associada à identidade gerenciada atribuída ao usuário.
tenantId	string	Identificador do locatário de um servidor.
type	IdentityType	Tipos de identidades associadas a um servidor.
userAssignedIdentities	<string, UserIdentity>	Mapa de identidades gerenciadas atribuídas pelo usuário.

UserIdentity

Object

Identidade gerenciada atribuída pelo usuário associada a um servidor.

Nome	Tipo	Descrição
clientId	string	Identificador do cliente da entidade de serviço associada à identidade gerenciada atribuída ao usuário.
principalId	string	Identificador do objeto da entidade de serviço associada à identidade gerenciada atribuída ao usuário.