Servers - Update

Service:: PostgreSQL

Versione API:: 2026-10-01

Aggiorna un server esistente. Il corpo della richiesta può contenere una o più delle proprietà presenti nella normale definizione del server.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome non distingue tra maiuscole e minuscole.
serverName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*	Il nome del server.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
identity	UserAssignedIdentity	Descrive l'identità dell'applicazione.
properties.administratorLoginPassword	string (password)	Password assegnata all'accesso amministratore. Finché l'autenticazione tramite password è abilitata, questa password può essere modificata in qualsiasi momento.
properties.authConfig	AuthConfigForPatch	Proprietà di configurazione dell'autenticazione di un server.
properties.availabilityZone	string	Zona di disponibilità di un server.
properties.backup	BackupForPatch	Proprietà di backup di un server.
properties.cluster	Cluster	Proprietà del cluster di un server.
properties.createMode	CreateModeForPatch	Modalità di aggiornamento di un server esistente.
properties.dataEncryption	DataEncryption	Proprietà di crittografia dei dati di un server.
properties.fipsMode	FipsMode	Indica se la modalità FIPS (Federal Information Processing Standards) è abilitata sul server. Se non specificato, il valore corrente viene preservato.
properties.highAvailability	HighAvailabilityForPatch	Proprietà a disponibilità elevata di un server.
properties.maintenanceWindow	MaintenanceWindowForPatch	Proprietà della finestra di manutenzione di un server.
properties.network	Network	Proprietà di rete di un server. Necessario solo se si desidera che il server sia integrato in una rete virtuale fornita dal cliente.
properties.replica	Replica	Leggi le proprietà della replica di un server. Obbligatorio solo nel caso in cui si desideri promuovere un server.
properties.replicationRole	ReplicationRole	Ruolo del server in un set di replica.
properties.sourceServerResourceId	string (arm-id)	Identificatore del server da utilizzare come origine del nuovo server.
properties.storage	Storage	Proprietà di archiviazione di un server.
properties.version	string	Versione principale del motore di database PostgreSQL.
sku	SkuForPatch	Livello di calcolo e dimensioni di un server.
tags	object	Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.

Risposte

Nome	Tipo	Descrizione
202 Accepted		Operazione sulle risorse accettata. Intestazioni Azure-AsyncOperation: string Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

202 Accepted

Operazione sulle risorse accettata.

Intestazioni

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

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	impersonare il tuo account utente

Esempio

Enable or disable FIPS mode on 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.

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.

Update the storage performance of a server using Premium SSD v2.

Enable or disable FIPS mode on an existing server.

Esempio di richiesta

HTTP

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

{
  "properties": {
    "fipsMode": "Disabled"
  }
}

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

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.

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

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.

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

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.

Esempio di richiesta

HTTP

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

{
  "properties": {
    "replica": {
      "promoteMode": "Switchover",
      "promoteOption": "Forced"
    },
    "sourceServerResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/examplesourceserver"
  }
}

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

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.

Esempio di richiesta

HTTP

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

{
  "properties": {
    "replica": {
      "promoteMode": "Switchover",
      "promoteOption": "Planned"
    },
    "sourceServerResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/examplesourceserver"
  }
}

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

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

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

Update an existing server with custom maintenance window.

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

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

Esempio di richiesta

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2026-10-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"
  }
}

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

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

Esempio di richiesta

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2026-10-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"
  }
}

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

Update an existing server with Microsoft Entra authentication enabled.

Esempio di richiesta

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver?api-version=2026-10-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"
  }
}

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

Update an existing server.

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

Update the storage performance of a server using Premium SSD v2.

Esempio di richiesta

HTTP

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

{
  "properties": {
    "storage": {
      "type": "PremiumV2_LRS",
      "iops": 6000,
      "throughput": 250
    }
  }
}

Risposta di esempio

Codice di stato:: 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=2026-10-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2026-10-01

Definizioni

Nome	Descrizione
AuthConfigForPatch	Proprietà di configurazione dell'autenticazione di un server.
AzureManagedDiskPerformanceTier	Livello di archiviazione di un server.
BackupForPatch	Proprietà di backup di un server.
Cluster	Proprietà del cluster di un server.
CreateModeForPatch	Modalità di aggiornamento di un server esistente.
DataEncryption	Proprietà di crittografia dei dati di un server.
DataEncryptionType	Tipo di crittografia dei dati utilizzato da un server.
EncryptionKeyStatus	Stato della chiave utilizzata da un server configurato con la crittografia dei dati basata sulla chiave gestita dal cliente, per crittografare l'archiviazione primaria associata al server.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
FipsMode	Indica se la modalità FIPS (Federal Information Processing Standards) è abilitata sul server.
GeographicallyRedundantBackup	Indica se il server è configurato per la creazione di backup con ridondanza geografica.
HighAvailabilityForPatch	Proprietà a disponibilità elevata di un server.
HighAvailabilityState	Possibili stati del server di standby creati quando la disponibilità elevata è impostata su SameZone o ZoneRedundant.
IdentityType	Tipi di identità associate a un server.
ImmutableBackup	Indica se il server è configurato per creare backup immutabili.
MaintenanceWindowForPatch	Proprietà della finestra di manutenzione di un server.
MicrosoftEntraAuth	Indica se il server supporta l'autenticazione di Microsoft Entra.
Network	Proprietà di rete di un server.
PasswordBasedAuth	Indica se il server supporta l'autenticazione basata su password.
PostgreSqlFlexibleServerHighAvailabilityMode	Modalità di alta disponibilità supportata per questo calcolo.
ReadReplicaPromoteMode	Tipo di operazione da applicare alla replica di lettura. Questa proprietà è di sola scrittura.
ReadReplicaPromoteOption	Opzione di sincronizzazione dei dati da utilizzare durante l'elaborazione dell'operazione specificata nella proprietà promoteMode. Questa proprietà è di sola scrittura.
Replica	Proprietà di replica di un server.
ReplicationRole	Ruolo del server in un set di replica.
ReplicationState	Indica lo stato di replica di una replica di lettura. Questa proprietà viene restituita solo quando il server di destinazione è una replica di lettura.
ServerForPatch	Rappresenta un server da aggiornare.
ServerPublicNetworkAccessState	Indica se l'accesso alla rete pubblica è abilitato o meno.
SkuForPatch	Calcola le informazioni di un server.
SkuTier	Livello di calcolo assegnato a un server.
Storage	Proprietà di archiviazione di un server.
StorageAutoGrow	Indica se il server è configurato per aumentare automaticamente la dimensione di spazio quando lo spazio disponibile si avvicina a zero e le condizioni permettono una crescita automatica della dimensione dello storage.
StorageType	Tipo di archiviazione assegnata a un server. Se non specificato, il valore predefinito è Premium_LRS.
UserAssignedIdentity	Identità associate a un server.
UserIdentity	Identità gestita assegnata dall'utente associata a un server.

AuthConfigForPatch

Oggetto

Proprietà di configurazione dell'autenticazione di un server.

Nome	Tipo	Descrizione
activeDirectoryAuth	MicrosoftEntraAuth	Indica se il server supporta l'autenticazione di Microsoft Entra.
passwordAuth	PasswordBasedAuth	Indica se il server supporta l'autenticazione basata su password.
tenantId	string	Identificatore del tenant della risorsa delegata.

AzureManagedDiskPerformanceTier

Enumerazione

Livello di archiviazione di un server.

Valore	Descrizione
P1	SSD entry-level per IOPS minimi, ideale per carichi di lavoro di sviluppo o test leggeri.
P2	IOPS leggermente superiori per applicazioni su piccola scala che richiedono una bassa latenza costante.
P3	Prestazioni bilanciate per carichi di lavoro di produzione di base con velocità effettiva moderata.
P4	IOPS migliorati per le app in crescita con esigenze di prestazioni prevedibili.
P6	SSD di livello intermedio per carichi di lavoro costanti che richiedono throughput e latenza affidabili.
P10	Scelta popolare per carichi di lavoro di produzione generici con prestazioni scalabili.
P15	Livello di IOPS elevato per app complesse con operazioni di lettura/scrittura frequenti.
P20	Punto di ingresso per dischi a stato solido (SSD) ad alte prestazioni, adatti per carichi di lavoro ad alta intensità di I/O su piccola scala.
P30	Livello bilanciato per velocità effettiva moderata e applicazioni sensibili alla latenza.
P40	Prestazioni migliorate per carichi di lavoro di produzione in crescita con richieste di IOPS coerenti.
P50	Ottimizzato per applicazioni di livello aziendale che richiedono un throughput elevato e sostenuto.
P60	Livello ad alta capacità per database di grandi dimensioni e carichi di lavoro di analisi con operazioni di I/O al secondo elevate.
P70	Progettato per sistemi mission-critical che richiedono latenza estremamente bassa e concorrenza elevata.
P80	SSD di alto livello per il massimo IOPS e throughput, ideale per i carichi di lavoro più impegnativi.

BackupForPatch

Oggetto

Proprietà di backup di un server.

Nome	Tipo	Descrizione
backupRetentionDays	integer (int32)	Giorni di conservazione dei backup per il server.
earliestRestoreDate	string (date-time)	Ora del punto di ripristino meno recente (formato ISO8601) per un server.
geoRedundantBackup	GeographicallyRedundantBackup	Indica se il server è configurato per la creazione di backup con ridondanza geografica.
immutableBackup	ImmutableBackup	Indica se il server è configurato per creare backup immutabili.

Cluster

Oggetto

Proprietà del cluster di un server.

Nome	Tipo	Valore predefinito	Descrizione
clusterSize	integer (int32)	0	Numero di nodi assegnati al cluster elastico.
defaultDatabaseName	string		Nome del database predefinito per il cluster elastico.

CreateModeForPatch

Enumerazione

Modalità di aggiornamento di un server esistente.

Valore	Descrizione
Default	È equivalente a "Aggiorna".
Update	L'operazione aggiorna un server esistente.

DataEncryption

Oggetto

Proprietà di crittografia dei dati di un server.

Nome	Tipo	Descrizione
geoBackupEncryptionKeyStatus	EncryptionKeyStatus	Stato della chiave utilizzata da un server configurato con la crittografia dei dati basata sulla chiave gestita dal cliente, per crittografare lo storage con ridondanza geografica associato al server quando è configurato per supportare backup con ridondanza geografica.
geoBackupFederatedIdentityClientId	string (uuid)	Client ID dell'applicazione Microsoft Entra multi-tenant per quando è configurata per supportare backup geograficamente ridondanti.
geoBackupKeyURI	string	Identificatore dell'identità gestita assegnata all'utente usata per accedere alla chiave in Azure Key Vault per la crittografia dei dati dell'archiviazione con ridondanza geografica associata a un server configurato per supportare backup con ridondanza geografica.
geoBackupUserAssignedIdentityId	string	Identificatore dell'identità gestita assegnata all'utente usata per accedere alla chiave in Azure Key Vault per la crittografia dei dati dell'archiviazione con ridondanza geografica associata a un server configurato per supportare backup con ridondanza geografica.
primaryEncryptionKeyStatus	EncryptionKeyStatus	Stato della chiave utilizzata da un server configurato con la crittografia dei dati basata sulla chiave gestita dal cliente, per crittografare l'archiviazione primaria associata al server.
primaryFederatedIdentityClientId	string (uuid)	ID client dell'applicazione Microsoft Entra multi-tenant.
primaryKeyURI	string	URI della chiave in Azure Key Vault usato per la crittografia dei dati dell'archiviazione primaria associata a un server.
primaryUserAssignedIdentityId	string	Identificatore dell'identità gestita assegnata all'utente usata per accedere alla chiave in Azure Key Vault per la crittografia dei dati dell'archiviazione primaria associata a un server.
type	DataEncryptionType	Tipo di crittografia dei dati utilizzato da un server.

DataEncryptionType

Enumerazione

Tipo di crittografia dei dati utilizzato da un server.

Valore	Descrizione
SystemManaged	Crittografia gestita da Azure utilizzando chiavi gestite dalla piattaforma per semplicità e conformità.
AzureKeyVault	Crittografia utilizzando chiavi gestite dal cliente memorizzate in Azure Key Vault per un controllo e una sicurezza migliori.

EncryptionKeyStatus

Enumerazione

Stato della chiave utilizzata da un server configurato con la crittografia dei dati basata sulla chiave gestita dal cliente, per crittografare l'archiviazione primaria associata al server.

Valore	Descrizione
Valid	La chiave è valida e può essere utilizzata per la crittografia.
Invalid	La chiave non è valida e non può essere utilizzata per la crittografia. Le possibili cause includono l'eliminazione della chiave, la modifica delle autorizzazioni, la disabilitazione della chiave, il tipo di chiave non supportato o la data corrente al di fuori del periodo di validità associato alla chiave.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	La destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

FipsMode

Enumerazione

Indica se la modalità FIPS (Federal Information Processing Standards) è abilitata sul server.

Valore	Descrizione
Enabled	La modalità FIPS è abilitata sul server.
Disabled	La modalità FIPS è disabilitata sul server.

GeographicallyRedundantBackup

Enumerazione

Indica se il server è configurato per la creazione di backup con ridondanza geografica.

Valore	Descrizione
Enabled	Il server è configurato per creare backup geograficamente ridondanti.
Disabled	Il server non è configurato per creare backup geograficamente ridondanti.

HighAvailabilityForPatch

Oggetto

Proprietà a disponibilità elevata di un server.

Nome	Tipo	Descrizione
mode	PostgreSqlFlexibleServerHighAvailabilityMode	Modalità a disponibilità elevata per un server.
standbyAvailabilityZone	string	Zona di disponibilità associata al server di standby creata quando la disponibilità elevata è impostata su SameZone o ZoneRedundant.
state	HighAvailabilityState	Possibili stati del server di standby creati quando la disponibilità elevata è impostata su SameZone o ZoneRedundant.

HighAvailabilityState

Enumerazione

Possibili stati del server di standby creati quando la disponibilità elevata è impostata su SameZone o ZoneRedundant.

Valore	Descrizione
NotEnabled	La disponibilità elevata non è abilitata per il server.
CreatingStandby	È in corso la creazione del server di standby.
ReplicatingData	I dati vengono replicati sul server di standby.
FailingOver	L'operazione di failover sul server di standby è in corso.
Healthy	Il server di standby è integro e pronto a subentrare in caso di failover.
RemovingStandby	Il server di standby è in fase di rimozione.
RecreatingStandby	Il server di standby viene ricreato.
ComputeUpdatingByFailover	Il calcolo viene aggiornato a causa di un failover.

IdentityType

Enumerazione

Tipi di identità associate a un server.

Valore	Descrizione
None	Al server non è assegnata alcuna identità gestita.
UserAssigned	Al server vengono assegnate una o più identità gestite fornite dall'utente.
SystemAssigned	Azure crea e gestisce automaticamente l'identità associata al ciclo di vita del server.
SystemAssigned,UserAssigned	Al server vengono assegnate sia le identità assegnate dal sistema che quelle assegnate dall'utente.

ImmutableBackup

Enumerazione

Indica se il server è configurato per creare backup immutabili.

Valore	Descrizione
Enabled	Il server è configurato per creare backup immutabili.
Disabled	Il server non è configurato per creare backup immutabili.

MaintenanceWindowForPatch

Oggetto

Proprietà della finestra di manutenzione di un server.

Nome	Tipo	Descrizione
customWindow	string	Indica se la finestra personalizzata è abilitata o disabilitata.
dayOfWeek	integer (int32)	Giorno della settimana da utilizzare per la finestra di manutenzione.
startHour	integer (int32)	Ora di inizio da utilizzare per la finestra di manutenzione.
startMinute	integer (int32)	Minuto di inizio da utilizzare per la finestra di manutenzione.

MicrosoftEntraAuth

Enumerazione

Indica se il server supporta l'autenticazione di Microsoft Entra.

Valore	Descrizione
Enabled	Il server supporta l'autenticazione Microsoft Entra.
Disabled	Server non supporta l'autenticazione Microsoft Entra.

Network

Oggetto

Proprietà di rete di un server.

Nome	Tipo	Descrizione
delegatedSubnetResourceId	string (arm-id)	Identificatore della risorsa della subnet delegata. Necessario durante la creazione di un nuovo server, nel caso in cui si desideri che il server sia integrato nella propria rete virtuale. Per un'operazione di aggiornamento, è sufficiente fornire questa proprietà se si desidera modificare il valore assegnato per la zona DNS privata.
privateDnsZoneArmResourceId	string (arm-id)	Identificatore della zona DNS privata. Necessario durante la creazione di un nuovo server, nel caso in cui si desideri che il server sia integrato nella propria rete virtuale. Per un'operazione di aggiornamento, è sufficiente fornire questa proprietà se si desidera modificare il valore assegnato per la zona DNS privata.
publicNetworkAccess	ServerPublicNetworkAccessState	Indica se l'accesso alla rete pubblica è abilitato o meno. Questa opzione è supportata solo per i server che non sono integrati in una rete virtuale di proprietà e fornita dal cliente al momento della distribuzione del server.

PasswordBasedAuth

Enumerazione

Indica se il server supporta l'autenticazione basata su password.

Valore	Descrizione
Enabled	Il server supporta l'autenticazione basata su password.
Disabled	Il server non supporta l'autenticazione basata su password.

PostgreSqlFlexibleServerHighAvailabilityMode

Enumerazione

Modalità di alta disponibilità supportata per questo calcolo.

Valore	Descrizione
Disabled	La disponibilità elevata è disabilitata per il server.
ZoneRedundant	La disponibilità elevata è abilitata per il server, con il server di standby in una zona di disponibilità diversa da quella del server primario.
SameZone	La disponibilità elevata è abilitata per il server, con il server di standby nella stessa zona di disponibilità del server primario.

ReadReplicaPromoteMode

Enumerazione

Tipo di operazione da applicare alla replica di lettura. Questa proprietà è di sola scrittura.

Valore	Descrizione
Standalone	La replica di lettura diventerà un server indipendente e un'entità completamente indipendente dal set di replicazione.
Switchover	La replica di lettura scambierà i ruoli con il server primario.

ReadReplicaPromoteOption

Enumerazione

Opzione di sincronizzazione dei dati da utilizzare durante l'elaborazione dell'operazione specificata nella proprietà promoteMode. Questa proprietà è di sola scrittura.

Valore	Descrizione
Planned	Aspettare che i dati nella replica di lettura siano completamente sincronizzati con il server sorgente prima che inizi l'operazione.
Forced	Avviare immediatamente l'operazione, senza attendere che i dati nella replica di lettura vengano sincronizzati con il suo server sorgente.

Replica

Oggetto

Proprietà di replica di un server.

Nome	Tipo	Descrizione
capacity	integer (int32)	Numero massimo di repliche di lettura consentite per un server.
promoteMode	ReadReplicaPromoteMode	Tipo di operazione da applicare alla replica di lettura. Questa proprietà è di sola scrittura. Standalone significa che la replica di lettura verrà promossa a server standalone e diventerà un'entità completamente indipendente dal set di replica. Lo switchover significa che la replica di lettura avrà un ruolo con il server primario.
promoteOption	ReadReplicaPromoteOption	Opzione di sincronizzazione dei dati da utilizzare durante l'elaborazione dell'operazione specificata nella proprietà promoteMode. Questa proprietà è di sola scrittura.
replicationState	ReplicationState	Indica lo stato di replica di una replica di lettura. Questa proprietà viene restituita solo quando il server di destinazione è una replica di lettura. I valori possibili sono Attivo, Interrotto, Recupero, Provisioning, Riconfigurazione e Aggiornamento
role	ReplicationRole	Ruolo del server in un set di replica.

ReplicationRole

Enumerazione

Ruolo del server in un set di replica.

Valore	Descrizione
None	Nessun ruolo di replica assegnato; Il server funziona in modo indipendente.
Primary	Funge da server di origine per la replica in una o più repliche.
AsyncReplica	Riceve i dati in modo asincrono da un server primario all'interno della stessa area.
GeoAsyncReplica	Riceve i dati in modo asincrono da un server primario in un'area diversa per la ridondanza geografica.

ReplicationState

Enumerazione

Indica lo stato di replica di una replica di lettura. Questa proprietà viene restituita solo quando il server di destinazione è una replica di lettura.

Valore	Descrizione
Active	Il server replica di lettura è completamente sincronizzato e replica attivamente i dati dal server principale.
Catchup	Il server replica di lettura è indietro rispetto al server primario e sta attualmente recuperando le modifiche in corso.
Provisioning	Un server replica di lettura è in fase di creazione ed è in fase di inizializzazione.
Updating	Il server replica Read sta subendo alcune modifiche, può essere che stia modificando la dimensione di calcolo o la sua promozione al server principale.
Broken	La replica non è riuscita o è stata interrotta.
Reconfiguring	Il server replica di lettura è in fase di riconfigurazione, forse a causa di cambiamenti nella sorgente o nelle impostazioni.

ServerForPatch

Oggetto

Rappresenta un server da aggiornare.

Nome	Tipo	Descrizione
identity	UserAssignedIdentity	Descrive l'identità dell'applicazione.
properties.administratorLogin	string	Nome dell'account di accesso designato come primo amministratore basato su password assegnato all'istanza di PostgreSQL. Deve essere specificato la prima volta che si abilita l'autenticazione basata su password in un server. Una volta impostato su un determinato valore, non può essere modificato per il resto della vita di un server. Se si disabilita l'autenticazione basata su password in un server in cui è abilitata, questo ruolo basato su password non viene eliminato.
properties.administratorLoginPassword	string (password)	Password assegnata all'accesso amministratore. Finché l'autenticazione tramite password è abilitata, questa password può essere modificata in qualsiasi momento.
properties.authConfig	AuthConfigForPatch	Proprietà di configurazione dell'autenticazione di un server.
properties.availabilityZone	string	Zona di disponibilità di un server.
properties.backup	BackupForPatch	Proprietà di backup di un server.
properties.cluster	Cluster	Proprietà del cluster di un server.
properties.createMode	CreateModeForPatch	Modalità di aggiornamento di un server esistente.
properties.dataEncryption	DataEncryption	Proprietà di crittografia dei dati di un server.
properties.fipsMode	FipsMode	Indica se la modalità FIPS (Federal Information Processing Standards) è abilitata sul server. Se non specificato, il valore corrente viene preservato.
properties.highAvailability	HighAvailabilityForPatch	Proprietà a disponibilità elevata di un server.
properties.maintenanceWindow	MaintenanceWindowForPatch	Proprietà della finestra di manutenzione di un server.
properties.network	Network	Proprietà di rete di un server. Necessario solo se si desidera che il server sia integrato in una rete virtuale fornita dal cliente.
properties.replica	Replica	Leggi le proprietà della replica di un server. Obbligatorio solo nel caso in cui si desideri promuovere un server.
properties.replicationRole	ReplicationRole	Ruolo del server in un set di replica.
properties.sourceServerResourceId	string (arm-id)	Identificatore del server da utilizzare come origine del nuovo server.
properties.storage	Storage	Proprietà di archiviazione di un server.
properties.version	string	Versione principale del motore di database PostgreSQL.
sku	SkuForPatch	Livello di calcolo e dimensioni di un server.
tags	object	Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.

ServerPublicNetworkAccessState

Enumerazione

Indica se l'accesso alla rete pubblica è abilitato o meno.

Valore	Descrizione
Enabled	L'accesso alla rete pubblica è abilitato. In questo modo è possibile accedere al server dalla rete Internet pubblica, a condizione che sia presente la regola del firewall necessaria che consente il traffico in ingresso proveniente dal client di connessione. Ciò è compatibile con l'uso di endpoint privati per connettersi a questo server.
Disabled	L'accesso alla rete pubblica è disabilitato. Ciò significa che non è possibile accedere al server dalla rete Internet pubblica, ma solo tramite endpoint privati.

SkuForPatch

Oggetto

Calcola le informazioni di un server.

Nome	Tipo	Descrizione
name	string	Nome con cui è nota una data dimensione di calcolo assegnata a un server.
tier	SkuTier	Livello di calcolo assegnato a un server.

SkuTier

Enumerazione

Livello di calcolo assegnato a un server.

Valore	Descrizione
Burstable	Livello conveniente per l'utilizzo poco frequente della CPU, ideale per carichi di lavoro di sviluppo e test con bassi requisiti di prestazioni.
GeneralPurpose	Calcolo e memoria bilanciati per la maggior parte dei carichi di lavoro, che offrono prestazioni scalabili e throughput di I/O.
MemoryOptimized	Elevato rapporto memoria/core per carichi di lavoro impegnativi che richiedono un'elaborazione in-memory rapida e un'elevata concorrenza.

Storage

Oggetto

Proprietà di archiviazione di un server.

Nome	Tipo	Descrizione
autoGrow	StorageAutoGrow	Contrassegnare per abilitare o disabilitare l'aumento automatico delle dimensioni di archiviazione di un server quando lo spazio disponibile si avvicina allo zero e le condizioni consentono l'aumento automatico delle dimensioni di archiviazione.
autoGrowIncrementPercent	integer (int32) minimum: 1 maximum: 100	L'incremento di auto-crescita dello storage come percentuale della dimensione di archiviazione attualmente allocata. Questo valore non è un incremento assoluto di dimensione né una soglia di utilizzo.
autoGrowMaxThresholdMb	integer (int32) minimum: 1 maximum: 67108864	Dimensione massima di archiviazione allocata a cui può crescere l'autogrow di storage, in MB. Questo valore non è una soglia di trigger per l'utilizzo del disco e deve essere almeno la dimensione effettiva di memoria attuale o richiesta. La conversione di storage utilizza 1 GB = 1.024 MB.
iops	integer (int32)	Numero massimo di operazioni di I/O al secondo supportate per l'archiviazione. Obbligatorio quando il tipo di archiviazione è PremiumV2_LRS o UltraSSD_LRS.
storageSizeGB	integer (int32)	Dimensione dello spazio di archiviazione assegnato a un server.
throughput	integer (int32)	Velocità effettiva massima supportata per l'archiviazione. Obbligatorio quando il tipo di archiviazione è PremiumV2_LRS o UltraSSD_LRS.
tier	AzureManagedDiskPerformanceTier	Livello di archiviazione di un server.
type	StorageType	Tipo di archiviazione assegnata a un server. I valori consentiti sono Premium_LRS, PremiumV2_LRS o UltraSSD_LRS. Se non specificato, il valore predefinito è Premium_LRS.

StorageAutoGrow

Enumerazione

Indica se il server è configurato per aumentare automaticamente la dimensione di spazio quando lo spazio disponibile si avvicina a zero e le condizioni permettono una crescita automatica della dimensione dello storage.

Valore	Descrizione
Enabled	Il server dovrebbe aumentare automaticamente le dimensioni di archiviazione quando lo spazio disponibile si avvicina allo zero e le condizioni consentono di aumentare automaticamente le dimensioni di archiviazione.
Disabled	Il server non deve aumentare automaticamente le dimensioni di archiviazione quando lo spazio disponibile è vicino allo zero.

StorageType

Enumerazione

Tipo di archiviazione assegnata a un server. Se non specificato, il valore predefinito è Premium_LRS.

Valore	Descrizione
Premium_LRS	Storage standard supportato da dischi a stato solido (SSD) che offre prestazioni costanti per carichi di lavoro generici.
PremiumV2_LRS	Storage SSD (Solid State Disk) di nuova generazione con scalabilità e prestazioni migliorate per carichi di lavoro aziendali impegnativi.
UltraSSD_LRS	Storage SSD (Solid State Disk) di fascia alta progettato per operazioni di I/O al secondo estreme e applicazioni sensibili alla latenza.

UserAssignedIdentity

Oggetto

Identità associate a un server.

Nome	Tipo	Descrizione
principalId	string	Identificatore dell'oggetto dell'entità servizio associata all'identità gestita assegnata dall'utente.
tenantId	string	Identificatore del tenant di un server.
type	IdentityType	Tipi di identità associate a un server.
userAssignedIdentities	<string, UserIdentity>	Mappa delle identità gestite assegnate dall'utente.

UserIdentity

Oggetto

Identità gestita assegnata dall'utente associata a un server.

Nome	Tipo	Descrizione
clientId	string	Identificatore del client dell'entità servizio associata all'identità gestita assegnata dall'utente.
principalId	string	Identificatore dell'oggetto dell'entità servizio associata all'identità gestita assegnata dall'utente.