Freigeben über


Servers - Update

Aktualisiert einen vorhandenen Server. Der Anforderungstext kann eine oder mehrere der Eigenschaften enthalten, die in der normalen Serverdefinition vorhanden sind.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

serverName
path True

string

minLength: 3
maxLength: 63
pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*

Name des Servers

subscriptionId
path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Typ Beschreibung
identity

UserAssignedIdentity

Beschreibt die Identität der Anwendung.

properties.administratorLoginPassword

string (password)

Passwort, das dem Administrator-Login zugewiesen ist. Solange die Passwortauthentifizierung aktiviert ist, kann dieses Passwort jederzeit geändert werden.

properties.authConfig

AuthConfigForPatch

Authentifizierungskonfigurationseigenschaften eines Servers.

properties.availabilityZone

string

Verfügbarkeitszone eines Servers.

properties.backup

BackupForPatch

Sicherungseigenschaften eines Servers.

properties.cluster

Cluster

Clustereigenschaften eines Servers.

properties.createMode

CreateModeForPatch

Aktualisierungsmodus eines vorhandenen Servers.

properties.dataEncryption

DataEncryption

Datenverschlüsselungseigenschaften eines Servers.

properties.highAvailability

HighAvailabilityForPatch

Eigenschaften mit hoher Verfügbarkeit eines Servers.

properties.maintenanceWindow

MaintenanceWindowForPatch

Wartungsfenstereigenschaften eines Servers.

properties.network

Network

Netzwerkeigenschaften eines Servers. Nur erforderlich, wenn der Server in ein vom Kunden bereitgestelltes virtuelles Netzwerk integriert werden soll.

properties.replica

Replica

Lesen Sie die Replikateigenschaften eines Servers. Nur erforderlich, wenn Sie einen Server heraufstufen möchten.

properties.replicationRole

ReplicationRole

Rolle des Servers in einer Replikationsgruppe.

properties.storage

Storage

Speichereigenschaften eines Servers.

properties.version

PostgresMajorVersion

Hauptversion der PostgreSQL-Datenbank-Engine.

sku

SkuForPatch

Computeebene und -größe eines Servers.

tags

object

Anwendungsspezifische Metadaten in Form von Schlüsselwertpaaren.

Antworten

Name Typ Beschreibung
202 Accepted

Ressourcenvorgang akzeptiert.

Header

  • Azure-AsyncOperation: string
  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

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.

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

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.

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

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.

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

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.

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

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.

Beispielanforderung

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": "17"
  }
}

Beispiel für eine Antwort

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.

Beispielanforderung

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
    }
  }
}

Beispiel für eine Antwort

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.

Beispielanforderung

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"
  }
}

Beispiel für eine Antwort

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.

Beispielanforderung

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"
  }
}

Beispiel für eine Antwort

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.

Beispielanforderung

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"
  }
}

Beispiel für eine Antwort

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.

Beispielanforderung

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"
  }
}

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
AuthConfigForPatch

Authentifizierungskonfigurationseigenschaften eines Servers.

AzureManagedDiskPerformanceTier

Speicherebene eines Servers.

BackupForPatch

Sicherungseigenschaften eines Servers.

Cluster

Clustereigenschaften eines Servers.

CreateModeForPatch

Aktualisierungsmodus eines vorhandenen Servers.

DataEncryption

Datenverschlüsselungseigenschaften eines Servers.

DataEncryptionType

Datenverschlüsselungstyp, der von einem Server verwendet wird.

EncryptionKeyStatus

Status des Schlüssels, der von einem Server verwendet wird, der mit einer Datenverschlüsselung auf der Grundlage eines vom Kunden verwalteten Schlüssels konfiguriert ist, um den primären Speicher zu verschlüsseln, der dem Server zugeordnet ist.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

GeographicallyRedundantBackup

Gibt an, ob der Server so konfiguriert ist, dass geografisch redundante Sicherungen erstellt werden.

HighAvailabilityForPatch

Eigenschaften mit hoher Verfügbarkeit eines Servers.

HighAvailabilityState

Mögliche Zustände des Standbyservers, der erstellt wird, wenn Hochverfügbarkeit auf SameZone oder ZoneRedundant festgelegt ist.

IdentityType

Arten von Identitäten, die einem Server zugeordnet sind.

MaintenanceWindowForPatch

Wartungsfenstereigenschaften eines Servers.

MicrosoftEntraAuth

Zeigt an, ob der Server Microsoft Entra-Authentifizierung unterstützt.

Network

Netzwerkeigenschaften eines Servers.

PasswordBasedAuth

Gibt an, ob der Server die kennwortbasierte Authentifizierung unterstützt.

PostgresMajorVersion

Hauptversion der PostgreSQL-Datenbank-Engine.

PostgreSqlFlexibleServerHighAvailabilityMode

Modus der hohen Verfügbarkeit wird für diese Berechnung unterstützt.

ReadReplicaPromoteMode

Typ des Vorgangs, der auf das Read Replica angewendet werden soll. Diese Eigenschaft ist schreibgeschützt.

ReadReplicaPromoteOption

Datensynchronisierungsoption, die beim Verarbeiten des in der promoteMode-Eigenschaft angegebenen Vorgangs verwendet werden soll. Diese Eigenschaft ist schreibgeschützt.

Replica

Replikateigenschaften eines Servers.

ReplicationRole

Rolle des Servers in einer Replikationsgruppe.

ReplicationState

Gibt den Replikationsstatus einer Read Replica an. Diese Eigenschaft wird nur zurückgegeben, wenn es sich bei dem Zielserver um ein Lesereplikat handelt.

ServerForPatch

Stellt einen Server dar, der aktualisiert werden soll.

ServerPublicNetworkAccessState

Gibt an, ob der Zugriff auf öffentliche Netzwerke aktiviert ist oder nicht.

SkuForPatch

Berechnen von Informationen eines Servers.

SkuTier

Ebene der Compute, die einem Server zugewiesen ist.

Storage

Speichereigenschaften eines Servers.

StorageAutoGrow

Zeigt an, ob der Server so konfiguriert ist, dass er automatisch die Speichergröße vergrößert, wenn der verfügbare Speicherplatz nahe an null ist und die Bedingungen ein automatisches Wachsen der Speichergröße erlauben.

StorageType

Typ des Speichers, der einem Server zugewiesen ist. Wenn nicht angegeben, wird standardmäßig Premium_LRS verwendet.

UserAssignedIdentity

Identitäten, die einem Server zugeordnet sind.

UserIdentity

Benutzerseitig zugewiesene verwaltete Identität, die einem Server zugeordnet ist.

AuthConfigForPatch

Authentifizierungskonfigurationseigenschaften eines Servers.

Name Typ Beschreibung
activeDirectoryAuth

MicrosoftEntraAuth

Zeigt an, ob der Server Microsoft Entra-Authentifizierung unterstützt.

passwordAuth

PasswordBasedAuth

Gibt an, ob der Server die kennwortbasierte Authentifizierung unterstützt.

tenantId

string

Bezeichner des Mandanten der delegierten Ressource.

AzureManagedDiskPerformanceTier

Speicherebene eines Servers.

Wert Beschreibung
P1

SSD der Einstiegsklasse für minimale IOPS, ideal für leichte Entwicklungs- oder Test-Workloads.

P2

Etwas höhere IOPS für kleine Anwendungen, die eine gleichbleibend niedrige Latenz erfordern.

P3

Ausgewogene Leistung für grundlegende Produktionsworkloads mit moderatem Durchsatz.

P4

Verbesserte IOPS für wachsende Anwendungen mit vorhersehbaren Leistungsanforderungen.

P6

Mid-Tier-SSD für stetige Workloads, die zuverlässigen Durchsatz und Latenz erfordern.

P10

Beliebte Wahl für allgemeine Produktions-Workloads mit skalierbarer Leistung.

P15

Hohe IOPS-Stufe für anspruchsvolle Apps mit häufigen Lese-/Schreibvorgängen.

P20

Einstiegspunkt für Hochleistungs-Solid-State-Disks (SSDs), die sich für kleine I/O-intensive Workloads eignen.

P30

Ausgewogene Ebene für Anwendungen mit moderatem Durchsatz und Latenzempfindlichkeit.

P40

Verbesserte Leistung für wachsende Produktions-Workloads mit konsistenten IOPS-Anforderungen.

P50

Optimiert für Anwendungen der Enterprise-Klasse, die einen dauerhaft hohen Durchsatz erfordern.

P60

Tarif mit hoher Kapazität für große Datenbanken und Analyse-Workloads mit erhöhten IOPS.

P70

Entwickelt für geschäftskritische Systeme, die eine extrem niedrige Latenz und hohe Parallelität erfordern.

P80

Erstklassige SSD für maximale IOPS und Durchsatz, ideal für die anspruchsvollsten Workloads.

BackupForPatch

Sicherungseigenschaften eines Servers.

Name Typ Beschreibung
backupRetentionDays

integer (int32)

Sicherungsaufbewahrungstage für den Server.

earliestRestoreDate

string (date-time)

Frühester Zeitpunkt der Wiederherstellung (ISO8601 Format) für einen Server.

geoRedundantBackup

GeographicallyRedundantBackup

Gibt an, ob der Server so konfiguriert ist, dass geografisch redundante Sicherungen erstellt werden.

Cluster

Clustereigenschaften eines Servers.

Name Typ Standardwert Beschreibung
clusterSize

integer (int32)

0

Anzahl der Knoten, die dem elastischen Cluster zugewiesen sind.

defaultDatabaseName

string

Standarddatenbankname für den elastischen Cluster.

CreateModeForPatch

Aktualisierungsmodus eines vorhandenen Servers.

Wert Beschreibung
Default

Es ist äquivalent zu 'Update'.

Update

Der Vorgang aktualisiert einen vorhandenen Server.

DataEncryption

Datenverschlüsselungseigenschaften eines Servers.

Name Typ Beschreibung
geoBackupEncryptionKeyStatus

EncryptionKeyStatus

Status des Schlüssels, der von einem Server verwendet wird, der mit Datenverschlüsselung basierend auf einem vom Kunden verwalteten Schlüssel konfiguriert ist, um den geografisch redundanten Speicher zu verschlüsseln, der dem Server zugeordnet ist, wenn er für die Unterstützung geografisch redundanter Sicherungen konfiguriert ist.

geoBackupKeyURI

string

Identifikator der vom Benutzer zugewiesenen verwalteten Identität, die verwendet wird, um auf den Schlüssel in Azure Key Vault zuzugreifen, um die Datenverschlüsselung des geografisch redundanten Speichers zu erhalten, der mit einem Server verbunden ist, der für geografisch redundante Backups konfiguriert ist.

geoBackupUserAssignedIdentityId

string

Identifikator der vom Benutzer zugewiesenen verwalteten Identität, die verwendet wird, um auf den Schlüssel in Azure Key Vault zuzugreifen, um die Datenverschlüsselung des geografisch redundanten Speichers zu erhalten, der mit einem Server verbunden ist, der für geografisch redundante Backups konfiguriert ist.

primaryEncryptionKeyStatus

EncryptionKeyStatus

Status des Schlüssels, der von einem Server verwendet wird, der mit einer Datenverschlüsselung auf der Grundlage eines vom Kunden verwalteten Schlüssels konfiguriert ist, um den primären Speicher zu verschlüsseln, der dem Server zugeordnet ist.

primaryKeyURI

string

URI des Schlüssels in Azure Key Vault, der zur Datenverschlüsselung des mit einem Server verbundenen Primärspeichers verwendet wird.

primaryUserAssignedIdentityId

string

Identifikator der vom Benutzer zugewiesenen verwalteten Identität, die zum Zugriff auf den Schlüssel in Azure Key Vault zur Datenverschlüsselung des mit einem Server verbundenen Primärspeichers verwendet wird.

type

DataEncryptionType

Datenverschlüsselungstyp, der von einem Server verwendet wird.

DataEncryptionType

Datenverschlüsselungstyp, der von einem Server verwendet wird.

Wert Beschreibung
SystemManaged

Verschlüsselung wird von Azure mit plattformverwalteten Schlüsseln für Einfachheit und Einhaltung verwaltet.

AzureKeyVault

Verschlüsselung mit kundenverwalteten Schlüsseln, die in Azure Key Vault gespeichert sind, für verbesserte Kontrolle und Sicherheit.

EncryptionKeyStatus

Status des Schlüssels, der von einem Server verwendet wird, der mit einer Datenverschlüsselung auf der Grundlage eines vom Kunden verwalteten Schlüssels konfiguriert ist, um den primären Speicher zu verschlüsseln, der dem Server zugeordnet ist.

Wert Beschreibung
Valid

Der Schlüssel ist gültig und kann zur Verschlüsselung verwendet werden.

Invalid

Der Schlüssel ist ungültig und kann nicht für die Verschlüsselung verwendet werden. Mögliche Ursachen sind das Löschen von Schlüsseln, Berechtigungsänderungen, die Deaktivierung des Schlüssels, der nicht unterstützte Schlüsseltyp oder das aktuelle Datum, das außerhalb des mit dem Schlüssel verknüpften Gültigkeitszeitraums liegt.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

GeographicallyRedundantBackup

Gibt an, ob der Server so konfiguriert ist, dass geografisch redundante Sicherungen erstellt werden.

Wert Beschreibung
Enabled

Der Server ist so konfiguriert, dass geografisch redundante Sicherungen erstellt werden.

Disabled

Der Server ist nicht so konfiguriert, dass geografisch redundante Sicherungen erstellt werden.

HighAvailabilityForPatch

Eigenschaften mit hoher Verfügbarkeit eines Servers.

Name Typ Beschreibung
mode

PostgreSqlFlexibleServerHighAvailabilityMode

Hochverfügbarkeitsmodus für einen Server.

standbyAvailabilityZone

string

Verfügbarkeitszone, die dem Standbyserver zugeordnet ist, der erstellt wurde, wenn Hochverfügbarkeit auf SameZone oder ZoneRedundant festgelegt ist.

state

HighAvailabilityState

Mögliche Zustände des Standbyservers, der erstellt wird, wenn Hochverfügbarkeit auf SameZone oder ZoneRedundant festgelegt ist.

HighAvailabilityState

Mögliche Zustände des Standbyservers, der erstellt wird, wenn Hochverfügbarkeit auf SameZone oder ZoneRedundant festgelegt ist.

Wert Beschreibung
NotEnabled

Die Hochverfügbarkeit ist für den Server nicht aktiviert.

CreatingStandby

Der Standby-Server wird erstellt.

ReplicatingData

Die Daten werden auf den Standby-Server repliziert.

FailingOver

Der Failovervorgang zum Standbyserver wird ausgeführt.

Healthy

Der Standbyserver ist fehlerfrei und kann im Falle eines Failovers übernommen werden.

RemovingStandby

Der Standby-Server wird entfernt.

IdentityType

Arten von Identitäten, die einem Server zugeordnet sind.

Wert Beschreibung
None

Dem Server ist keine verwaltete Identität zugewiesen.

UserAssigned

Dem Server werden eine oder mehrere verwaltete Identitäten zugewiesen, die vom Benutzer bereitgestellt werden.

SystemAssigned

Azure erstellt und verwaltet automatisch die Identität, die mit dem Lebenszyklus des Servers verknüpft ist.

SystemAssigned,UserAssigned

Dem Server werden sowohl systemseitig als auch benutzerseitig zugewiesene Identitäten zugewiesen.

MaintenanceWindowForPatch

Wartungsfenstereigenschaften eines Servers.

Name Typ Beschreibung
customWindow

string

Gibt an, ob das benutzerdefinierte Fenster aktiviert oder deaktiviert ist.

dayOfWeek

integer (int32)

Wochentag, der für das Wartungsfenster verwendet werden soll.

startHour

integer (int32)

Startstunde, die für das Wartungsfenster verwendet werden soll.

startMinute

integer (int32)

Startminute, die für das Wartungsfenster verwendet werden soll.

MicrosoftEntraAuth

Zeigt an, ob der Server Microsoft Entra-Authentifizierung unterstützt.

Wert Beschreibung
Enabled

Der Server unterstützt Microsoft Entra-Authentifizierung.

Disabled

Der Server unterstützt keine Microsoft Entra-Authentifizierung.

Network

Netzwerkeigenschaften eines Servers.

Name Typ Beschreibung
delegatedSubnetResourceId

string (arm-id)

Ressourcen-ID des delegierten Subnetzes. Erforderlich bei der Erstellung eines neuen Servers, falls der Server in Ihr eigenes virtuelles Netzwerk integriert werden soll. Für einen Aktualisierungsvorgang müssen Sie diese Eigenschaft nur angeben, wenn Sie den für die private DNS-Zone zugewiesenen Wert ändern möchten.

privateDnsZoneArmResourceId

string (arm-id)

Kennung der privaten DNS-Zone. Erforderlich bei der Erstellung eines neuen Servers, falls der Server in Ihr eigenes virtuelles Netzwerk integriert werden soll. Für einen Aktualisierungsvorgang müssen Sie diese Eigenschaft nur angeben, wenn Sie den für die private DNS-Zone zugewiesenen Wert ändern möchten.

publicNetworkAccess

ServerPublicNetworkAccessState

Gibt an, ob der Zugriff auf öffentliche Netzwerke aktiviert ist oder nicht. Dies wird nur für Server unterstützt, die nicht in ein virtuelles Netzwerk integriert sind, das sich im Besitz des Kunden befindet und von ihm bereitgestellt wird, wenn der Server bereitgestellt wird.

PasswordBasedAuth

Gibt an, ob der Server die kennwortbasierte Authentifizierung unterstützt.

Wert Beschreibung
Enabled

Der Server unterstützt die kennwortbasierte Authentifizierung.

Disabled

Der Server unterstützt keine passwortbasierte Authentifizierung.

PostgresMajorVersion

Hauptversion der PostgreSQL-Datenbank-Engine.

Wert Beschreibung
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

Modus der hohen Verfügbarkeit wird für diese Berechnung unterstützt.

Wert Beschreibung
Disabled

Die Hochverfügbarkeit ist für den Server deaktiviert.

ZoneRedundant

Hochverfügbarkeit ist für den Server aktiviert, wobei sich der Standbyserver in einer anderen Verfügbarkeitszone als der des primären Server befindet.

SameZone

Hochverfügbarkeit ist für den Server aktiviert, wobei sich der Standbyserver in derselben Verfügbarkeitszone wie der primäre Server befindet.

ReadReplicaPromoteMode

Typ des Vorgangs, der auf das Read Replica angewendet werden soll. Diese Eigenschaft ist schreibgeschützt.

Wert Beschreibung
Standalone

Read Replica wird zu einem unabhängigen Server und zu einer völlig unabhängigen Entität vom Replikationsset.

Switchover

Das Read Replica tauscht die Rollen mit dem primären Server.

ReadReplicaPromoteOption

Datensynchronisierungsoption, die beim Verarbeiten des in der promoteMode-Eigenschaft angegebenen Vorgangs verwendet werden soll. Diese Eigenschaft ist schreibgeschützt.

Wert Beschreibung
Planned

Warten Sie, bis die Daten im Lesereplikat vollständig mit dem Quellserver synchronisiert sind, bevor die Operation gestartet wird.

Forced

Starte die Operation sofort, ohne darauf zu warten, dass die Daten im Lesereplikat mit dem Quellserver synchronisiert sind.

Replica

Replikateigenschaften eines Servers.

Name Typ Beschreibung
capacity

integer (int32)

Maximale Anzahl von Read Replicas, die für einen Server zulässig sind.

promoteMode

ReadReplicaPromoteMode

Typ des Vorgangs, der auf das Read Replica angewendet werden soll. Diese Eigenschaft ist schreibgeschützt. Eigenständig bedeutet, dass das Lesereplikat zu einem eigenständigen Server heraufgestuft wird und zu einer vollständig unabhängigen Entität vom Replikationssatz wird. Switchover bedeutet, dass das Lesereplikat Rollen mit dem primären Server übernimmt.

promoteOption

ReadReplicaPromoteOption

Datensynchronisierungsoption, die beim Verarbeiten des in der promoteMode-Eigenschaft angegebenen Vorgangs verwendet werden soll. Diese Eigenschaft ist schreibgeschützt.

replicationState

ReplicationState

Gibt den Replikationsstatus einer Read Replica an. Diese Eigenschaft wird nur zurückgegeben, wenn es sich bei dem Zielserver um ein Lesereplikat handelt. Mögliche Werte sind "Active", "Broken", "Catchup", "Provisioning", "Reconfiguring" und "Updated".

role

ReplicationRole

Rolle des Servers in einer Replikationsgruppe.

ReplicationRole

Rolle des Servers in einer Replikationsgruppe.

Wert Beschreibung
None

Es ist keine Replikationsrolle zugewiesen. Der Server arbeitet unabhängig.

Primary

Fungiert als Quellserver für die Replikation auf ein oder mehrere Replikate.

AsyncReplica

Empfängt Daten asynchron von einem primären Server in derselben Region.

GeoAsyncReplica

Empfängt Daten asynchron von einem primären Server in einer anderen Region, um geografische Redundanz zu gewährleisten.

ReplicationState

Gibt den Replikationsstatus einer Read Replica an. Diese Eigenschaft wird nur zurückgegeben, wenn es sich bei dem Zielserver um ein Lesereplikat handelt.

Wert Beschreibung
Active

Der Read Replica-Server ist vollständig synchronisiert und repliziert aktiv Daten vom Primärserver.

Catchup

Der Read-Replica-Server liegt hinter dem Hauptserver und holt derzeit mit ausstehenden Änderungen auf.

Provisioning

Der Read-Replica-Server wird gerade erstellt und wird gerade initialisiert.

Updating

Der Read-Replica-Server durchläuft einige Änderungen, es kann sein, dass sich die Rechengröße ändert oder er auf den Primärserver befördert wird.

Broken

Die Replikation ist fehlgeschlagen oder wurde unterbrochen.

Reconfiguring

Der Read-Replica-Server wird neu konfiguriert, möglicherweise aufgrund von Quell- oder Einstellungsänderungen.

ServerForPatch

Stellt einen Server dar, der aktualisiert werden soll.

Name Typ Beschreibung
identity

UserAssignedIdentity

Beschreibt die Identität der Anwendung.

properties.administratorLogin

string

Name des Anmeldenamens, der als erster kennwortbasierter Administrator festgelegt ist, der Ihrer PostgreSQL-Instanz zugewiesen ist. Muss angegeben werden, wenn Sie die kennwortbasierte Authentifizierung zum ersten Mal auf einem Server aktivieren. Sobald er auf einen bestimmten Wert festgelegt ist, kann er für den Rest der Lebensdauer eines Servers nicht mehr geändert werden. Wenn Sie die kennwortbasierte Authentifizierung auf einem Server deaktivieren, auf dem sie aktiviert war, wird diese kennwortbasierte Rolle nicht gelöscht.

properties.administratorLoginPassword

string (password)

Passwort, das dem Administrator-Login zugewiesen ist. Solange die Passwortauthentifizierung aktiviert ist, kann dieses Passwort jederzeit geändert werden.

properties.authConfig

AuthConfigForPatch

Authentifizierungskonfigurationseigenschaften eines Servers.

properties.availabilityZone

string

Verfügbarkeitszone eines Servers.

properties.backup

BackupForPatch

Sicherungseigenschaften eines Servers.

properties.cluster

Cluster

Clustereigenschaften eines Servers.

properties.createMode

CreateModeForPatch

Aktualisierungsmodus eines vorhandenen Servers.

properties.dataEncryption

DataEncryption

Datenverschlüsselungseigenschaften eines Servers.

properties.highAvailability

HighAvailabilityForPatch

Eigenschaften mit hoher Verfügbarkeit eines Servers.

properties.maintenanceWindow

MaintenanceWindowForPatch

Wartungsfenstereigenschaften eines Servers.

properties.network

Network

Netzwerkeigenschaften eines Servers. Nur erforderlich, wenn der Server in ein vom Kunden bereitgestelltes virtuelles Netzwerk integriert werden soll.

properties.replica

Replica

Lesen Sie die Replikateigenschaften eines Servers. Nur erforderlich, wenn Sie einen Server heraufstufen möchten.

properties.replicationRole

ReplicationRole

Rolle des Servers in einer Replikationsgruppe.

properties.storage

Storage

Speichereigenschaften eines Servers.

properties.version

PostgresMajorVersion

Hauptversion der PostgreSQL-Datenbank-Engine.

sku

SkuForPatch

Computeebene und -größe eines Servers.

tags

object

Anwendungsspezifische Metadaten in Form von Schlüsselwertpaaren.

ServerPublicNetworkAccessState

Gibt an, ob der Zugriff auf öffentliche Netzwerke aktiviert ist oder nicht.

Wert Beschreibung
Enabled

Der Zugriff auf das öffentliche Netzwerk ist aktiviert. Auf diese Weise kann über das öffentliche Internet auf den Server zugegriffen werden, vorausgesetzt, die erforderliche Firewallregel ist vorhanden, die eingehenden Datenverkehr vom verbindenden Client zulässt. Dies ist kompatibel mit der Verwendung privater Endpunkte zum Herstellen einer Verbindung mit diesem Server.

Disabled

Öffentlicher Netzwerkzugriff ist deaktiviert. Das bedeutet, dass der Server nicht aus dem öffentlichen Internet erreichbar ist, sondern nur über private Endpunkte.

SkuForPatch

Berechnen von Informationen eines Servers.

Name Typ Beschreibung
name

string

Name, unter dem eine bestimmte Computegröße bekannt ist, die einem Server zugewiesen ist.

tier

SkuTier

Ebene der Compute, die einem Server zugewiesen ist.

SkuTier

Ebene der Compute, die einem Server zugewiesen ist.

Wert Beschreibung
Burstable

Kostengünstiger Tarif für seltene CPU-Auslastung, ideal für Entwicklungs- und Test-Workloads mit geringen Leistungsanforderungen.

GeneralPurpose

Ausgewogene Rechenleistung und ausgewogener Arbeitsspeicher für die meisten Workloads mit skalierbarer Leistung und E/A-Durchsatz.

MemoryOptimized

Hohes Memory-to-Core-Verhältnis für anspruchsvolle Workloads, die eine schnelle In-Memory-Verarbeitung und hohe Parallelität erfordern.

Storage

Speichereigenschaften eines Servers.

Name Typ Beschreibung
autoGrow

StorageAutoGrow

Flag zum Aktivieren oder Deaktivieren des automatischen Vergrößerns der Speichergröße eines Servers, wenn der verfügbare Speicherplatz nahe Null liegt und die Bedingungen das automatische Vergrößern der Speichergröße zulassen.

iops

integer (int32)

Maximale IOPS-Unterstützung, die für den Speicher unterstützt wird. Erforderlich, wenn der Speichertyp PremiumV2_LRS oder UltraSSD_LRS ist.

storageSizeGB

integer (int32)

Größe des Speichers, der einem Server zugewiesen ist.

throughput

integer (int32)

Maximaler Durchsatz wird für den Speicher unterstützt. Erforderlich, wenn der Speichertyp PremiumV2_LRS oder UltraSSD_LRS ist.

tier

AzureManagedDiskPerformanceTier

Speicherebene eines Servers.

type

StorageType

Typ des Speichers, der einem Server zugewiesen ist. Zulässige Werte sind Premium_LRS, PremiumV2_LRS oder UltraSSD_LRS. Wenn nicht angegeben, wird standardmäßig Premium_LRS verwendet.

StorageAutoGrow

Zeigt an, ob der Server so konfiguriert ist, dass er automatisch die Speichergröße vergrößert, wenn der verfügbare Speicherplatz nahe an null ist und die Bedingungen ein automatisches Wachsen der Speichergröße erlauben.

Wert Beschreibung
Enabled

Der Server sollte die Speichergröße automatisch vergrößern, wenn der verfügbare Speicherplatz nahe Null liegt und die Bedingungen eine automatische Erhöhung der Speichergröße zulassen.

Disabled

Der Server sollte die Speichergröße nicht automatisch erhöhen, wenn der verfügbare Speicherplatz nahe Null liegt.

StorageType

Typ des Speichers, der einem Server zugewiesen ist. Wenn nicht angegeben, wird standardmäßig Premium_LRS verwendet.

Wert Beschreibung
Premium_LRS

Standardmäßiger SSD-gestützter Speicher (Solid State Disk) mit gleichbleibender Leistung für allgemeine Workloads.

PremiumV2_LRS

Solid State Disk (SSD)-Speicher der nächsten Generation mit verbesserter Skalierbarkeit und Leistung für anspruchsvolle Unternehmens-Workloads.

UltraSSD_LRS

High-End-Solid-State-Disk-Speicher (SSD), der für extreme IOPS und latenzempfindliche Anwendungen entwickelt wurde.

UserAssignedIdentity

Identitäten, die einem Server zugeordnet sind.

Name Typ Beschreibung
principalId

string

Bezeichner des Objekts des Dienstprinzipals, das der vom Benutzer zugewiesenen verwalteten Identität zugeordnet ist.

tenantId

string

Kennung des Mandanten eines Servers.

type

IdentityType

Arten von Identitäten, die einem Server zugeordnet sind.

userAssignedIdentities

<string,  UserIdentity>

Zuordnung der benutzerseitig zugewiesenen verwalteten Identitäten.

UserIdentity

Benutzerseitig zugewiesene verwaltete Identität, die einem Server zugeordnet ist.

Name Typ Beschreibung
clientId

string

Bezeichner des Clients des Dienstprinzipals, der der benutzerseitig zugewiesenen verwalteten Identität zugeordnet ist.

principalId

string

Bezeichner des Objekts des Dienstprinzipals, das der vom Benutzer zugewiesenen verwalteten Identität zugeordnet ist.