你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Servers - Update

更新现有服务器。 请求正文可以包含常规服务器定义中存在的一个或多个属性。

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

URI 参数

名称 必需 类型 说明
resourceGroupName
path True

string

minLength: 1
maxLength: 90

资源组的名称。 此名称不区分大小写。

serverName
path True

string

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

服务器的名称。

subscriptionId
path True

string (uuid)

目标订阅的 ID。 该值必须是 UUID。

api-version
query True

string

minLength: 1

用于此操作的 API 版本。

请求正文

名称 类型 说明
parameters

ServerForUpdate

更新灵活服务器所需的参数。

响应

名称 类型 说明
200 OK

Server

好的

202 Accepted

已接受

标头

Location: string

Other Status Codes

ErrorResponse

描述作失败的原因的错误响应。

安全性

azure_auth

Microsoft Entra OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

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 flexible server to upgrade the major version of PostgreSQL database engine.
Update an existing flexible server with custom maintenance window.
Update an existing flexible server with data encryption based on customer managed key.
Update an existing flexible server with Microsoft Entra authentication enabled.
Update an existing flexible 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.

示例请求

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

{
  "properties": {
    "replica": {
      "promoteMode": "standalone",
      "promoteOption": "forced"
    }
  }
}

示例响应

{
  "sku": {
    "name": "Standard_D8s_v3",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "fullyQualifiedDomainName": "exampleserver.postgres.database.azure.com",
    "version": "16",
    "minorVersion": "8",
    "administratorLogin": "administratorlogin",
    "state": "Ready",
    "availabilityZone": "1",
    "dataEncryption": {
      "type": "SystemManaged"
    },
    "authConfig": {
      "activeDirectoryAuth": "Disabled",
      "passwordAuth": "Enabled"
    },
    "storage": {
      "storageSizeGB": 1024,
      "autoGrow": "Enabled",
      "tier": "P30",
      "iops": 5000
    },
    "backup": {
      "backupRetentionDays": 20,
      "geoRedundantBackup": "Disabled",
      "earliestRestoreDate": "2024-08-01T18:35:22.123456Z"
    },
    "network": {
      "publicNetworkAccess": "Disabled",
      "delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/virtualNetworks/examplevirtualnetwork/subnets/examplesubnet",
      "privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/privateDnsZones/exampleprivatednszone.postgres.database.azure.com"
    },
    "highAvailability": {
      "mode": "ZoneRedundant",
      "state": "Healthy",
      "standbyAvailabilityZone": "2"
    },
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    },
    "replica": {
      "role": "None",
      "capacity": 0
    }
  },
  "___location": "westus",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver",
  "name": "exampleserver",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-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.

示例请求

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

{
  "properties": {
    "replica": {
      "promoteMode": "standalone",
      "promoteOption": "planned"
    }
  }
}

示例响应

{
  "sku": {
    "name": "Standard_D8s_v3",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "fullyQualifiedDomainName": "exampleserver.postgres.database.azure.com",
    "version": "16",
    "minorVersion": "8",
    "administratorLogin": "administratorlogin",
    "state": "Ready",
    "availabilityZone": "1",
    "dataEncryption": {
      "type": "SystemManaged"
    },
    "authConfig": {
      "activeDirectoryAuth": "Disabled",
      "passwordAuth": "Enabled"
    },
    "storage": {
      "storageSizeGB": 1024,
      "autoGrow": "Enabled",
      "tier": "P30",
      "iops": 5000
    },
    "backup": {
      "backupRetentionDays": 20,
      "geoRedundantBackup": "Disabled",
      "earliestRestoreDate": "2025-02-26T01:16:58.3723361+00:00"
    },
    "network": {
      "publicNetworkAccess": "Disabled",
      "delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/virtualNetworks/examplevirtualnetwork/subnets/examplesubnet",
      "privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/privateDnsZones/exampleprivatednszone.postgres.database.azure.com"
    },
    "highAvailability": {
      "mode": "ZoneRedundant",
      "state": "Healthy",
      "standbyAvailabilityZone": "2"
    },
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    },
    "replica": {
      "role": "None",
      "capacity": 0
    }
  },
  "___location": "westus",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver",
  "name": "exampleserver",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-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.

示例请求

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

{
  "properties": {
    "replica": {
      "promoteMode": "switchover",
      "promoteOption": "forced"
    }
  }
}

示例响应

{
  "sku": {
    "name": "Standard_D8s_v3",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "fullyQualifiedDomainName": "exampleserver.postgres.database.azure.com",
    "version": "16",
    "minorVersion": "8",
    "administratorLogin": "administratorlogin",
    "state": "Ready",
    "availabilityZone": "1",
    "dataEncryption": {
      "type": "SystemManaged"
    },
    "authConfig": {
      "activeDirectoryAuth": "Disabled",
      "passwordAuth": "Enabled"
    },
    "storage": {
      "storageSizeGB": 1024,
      "autoGrow": "Enabled",
      "tier": "P30",
      "iops": 5000
    },
    "backup": {
      "backupRetentionDays": 20,
      "geoRedundantBackup": "Disabled",
      "earliestRestoreDate": "2024-08-01T18:35:22.123456Z"
    },
    "network": {
      "publicNetworkAccess": "Disabled",
      "delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/virtualNetworks/examplevirtualnetwork/subnets/examplesubnet",
      "privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/privateDnsZones/exampleprivatednszone.postgres.database.azure.com"
    },
    "highAvailability": {
      "mode": "ZoneRedundant",
      "state": "Healthy",
      "standbyAvailabilityZone": "2"
    },
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    },
    "replica": {
      "role": "Primary",
      "capacity": 5
    }
  },
  "___location": "westus",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver",
  "name": "exampleserver",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-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.

示例请求

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

{
  "properties": {
    "replica": {
      "promoteMode": "switchover",
      "promoteOption": "planned"
    }
  }
}

示例响应

{
  "sku": {
    "name": "Standard_D8s_v3",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "fullyQualifiedDomainName": "exampleserver.postgres.database.azure.com",
    "version": "16",
    "minorVersion": "8",
    "administratorLogin": "administratorlogin",
    "state": "Ready",
    "availabilityZone": "1",
    "dataEncryption": {
      "type": "SystemManaged"
    },
    "authConfig": {
      "activeDirectoryAuth": "Disabled",
      "passwordAuth": "Enabled"
    },
    "storage": {
      "storageSizeGB": 1024,
      "autoGrow": "Enabled",
      "tier": "P30",
      "iops": 5000
    },
    "backup": {
      "backupRetentionDays": 20,
      "geoRedundantBackup": "Disabled",
      "earliestRestoreDate": "2024-08-01T18:35:22.123456Z"
    },
    "network": {
      "publicNetworkAccess": "Disabled",
      "delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/virtualNetworks/examplevirtualnetwork/subnets/examplesubnet",
      "privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/privateDnsZones/exampleprivatednszone.postgres.database.azure.com"
    },
    "highAvailability": {
      "mode": "ZoneRedundant",
      "state": "Healthy",
      "standbyAvailabilityZone": "2"
    },
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    },
    "replica": {
      "role": "Primary",
      "capacity": 5
    }
  },
  "___location": "westus",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver",
  "name": "exampleserver",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01

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

示例请求

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

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

示例响应

{
  "sku": {
    "name": "Standard_D4ds_v5",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "fullyQualifiedDomainName": "exampleserver.exampleprivatednszone.postgres.database.azure.com",
    "version": "16",
    "minorVersion": "8",
    "administratorLogin": "administratorlogin",
    "state": "Ready",
    "availabilityZone": "1",
    "storage": {
      "storageSizeGB": 512,
      "autoGrow": "Enabled",
      "tier": "P20",
      "iops": 2300
    },
    "dataEncryption": {
      "type": "SystemManaged"
    },
    "authConfig": {
      "activeDirectoryAuth": "Disabled",
      "passwordAuth": "Enabled"
    },
    "backup": {
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Disabled",
      "earliestRestoreDate": "2024-08-01T18:35:22.123456Z"
    },
    "network": {
      "publicNetworkAccess": "Disabled",
      "delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/virtualNetworks/examplevirtualnetwork/subnets/examplesubnet",
      "privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/privateDnsZones/exampleprivatednszone.postgres.database.azure.com"
    },
    "highAvailability": {
      "mode": "ZoneRedundant",
      "state": "Healthy",
      "standbyAvailabilityZone": "2"
    },
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    }
  },
  "___location": "westus",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver",
  "name": "exampleserver",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01

Update an existing flexible server with custom maintenance window.

示例请求

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

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

示例响应

{
  "sku": {
    "name": "Standard_D4ds_v5",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "fullyQualifiedDomainName": "exampleserver.exampleprivatednszone.postgres.database.azure.com",
    "version": "16",
    "minorVersion": "8",
    "administratorLogin": "administratorlogin",
    "state": "Ready",
    "availabilityZone": "1",
    "storage": {
      "storageSizeGB": 512,
      "autoGrow": "Disabled",
      "tier": "P20",
      "iops": 2300
    },
    "dataEncryption": {
      "type": "SystemManaged"
    },
    "authConfig": {
      "activeDirectoryAuth": "Disabled",
      "passwordAuth": "Enabled"
    },
    "backup": {
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Disabled",
      "earliestRestoreDate": "2024-08-01T18:35:22.123456Z"
    },
    "network": {
      "publicNetworkAccess": "Disabled",
      "delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/virtualNetworks/examplevirtualnetwork/subnets/examplesubnet",
      "privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/privateDnsZones/exampleprivatednszone.postgres.database.azure.com"
    },
    "highAvailability": {
      "mode": "ZoneRedundant",
      "state": "Healthy",
      "standbyAvailabilityZone": "2"
    },
    "maintenanceWindow": {
      "customWindow": "Enabled",
      "dayOfWeek": 0,
      "startHour": 8,
      "startMinute": 0
    }
  },
  "___location": "westus",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver",
  "name": "exampleserver",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01

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

示例请求

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

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

示例响应

{
  "sku": {
    "name": "Standard_D8s_v3",
    "tier": "GeneralPurpose"
  },
  "identity": {
    "userAssignedIdentities": {
      "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/exampleprimaryidentity": {
        "principalId": "pppppppp-pppp-pppp-pppp-pppppppppppp",
        "clientId": "cccccccc-cccc-cccc-cccc-cccccccccccc"
      },
      "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/exampleprimaryidentity-1": {
        "principalId": "90008082-e024-4cc3-8fcf-63bcdb9cf6b6",
        "clientId": "cccccccc-cccc-cccc-cccc-cccccccccccc"
      },
      "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplegeoredundantidentity": {
        "principalId": "pppppppp-pppp-pppp-pppp-pppppppppppp",
        "clientId": "cccccccc-cccc-cccc-cccc-cccccccccccc"
      }
    },
    "type": "UserAssigned",
    "tenantId": "cccccccc-cccc-cccc-cccc-cccccccccccc"
  },
  "properties": {
    "fullyQualifiedDomainName": "exampleserver.exampleprivatednszone.postgres.database.azure.com",
    "version": "16",
    "minorVersion": "8",
    "administratorLogin": "administratorlogin",
    "state": "Ready",
    "availabilityZone": "1",
    "authConfig": {
      "activeDirectoryAuth": "Disabled",
      "passwordAuth": "Enabled"
    },
    "dataEncryption": {
      "type": "AzureKeyVault",
      "primaryKeyURI": "https://exampleprimarykeyvault.vault.azure.net/keys/examplekey/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "primaryUserAssignedIdentityId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/exampleprimaryidentity",
      "geoBackupKeyURI": "https://examplegeoredundantkeyvault.vault.azure.net/keys/examplekey/yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
      "geoBackupUserAssignedIdentityId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/examplegeoredundantidentity",
      "primaryEncryptionKeyStatus": "Valid",
      "geoBackupEncryptionKeyStatus": "Valid"
    },
    "storage": {
      "storageSizeGB": 1024,
      "autoGrow": "Disabled",
      "tier": "P30",
      "iops": 5000
    },
    "backup": {
      "backupRetentionDays": 20,
      "geoRedundantBackup": "Enabled",
      "earliestRestoreDate": "2024-08-01T18:35:22.123456Z"
    },
    "network": {
      "publicNetworkAccess": "Disabled",
      "delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/virtualNetworks/examplevirtualnetwork/subnets/examplesubnet",
      "privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/privateDnsZones/exampleprivatednszone.postgres.database.azure.com"
    },
    "highAvailability": {
      "mode": "ZoneRedundant",
      "state": "Healthy",
      "standbyAvailabilityZone": "2"
    },
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    }
  },
  "___location": "westus",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver",
  "name": "exampleserver",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01

Update an existing flexible server with Microsoft Entra authentication enabled.

示例请求

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

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

示例响应

{
  "sku": {
    "name": "Standard_D8s_v3",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "fullyQualifiedDomainName": "exampleserver.exampleprivatednszone.postgres.database.azure.com",
    "version": "16",
    "minorVersion": "8",
    "administratorLogin": "administratorlogin",
    "state": "Ready",
    "availabilityZone": "1",
    "dataEncryption": {
      "type": "SystemManaged"
    },
    "authConfig": {
      "activeDirectoryAuth": "Enabled",
      "passwordAuth": "Enabled",
      "tenantId": "tttttt-tttt-tttt-tttt-tttttttttttt"
    },
    "storage": {
      "storageSizeGB": 1024,
      "autoGrow": "Disabled",
      "tier": "P30",
      "iops": 5000
    },
    "backup": {
      "backupRetentionDays": 20,
      "geoRedundantBackup": "Disabled",
      "earliestRestoreDate": "2024-08-01T18:35:22.123456Z"
    },
    "network": {
      "publicNetworkAccess": "Disabled",
      "delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/virtualNetworks/examplevirtualnetwork/subnets/examplesubnet",
      "privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/privateDnsZones/exampleprivatednszone.postgres.database.azure.com"
    },
    "highAvailability": {
      "mode": "ZoneRedundant",
      "state": "Healthy",
      "standbyAvailabilityZone": "2"
    },
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    }
  },
  "___location": "westus",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver",
  "name": "exampleserver",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01

Update an existing flexible server.

示例请求

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

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

示例响应

{
  "sku": {
    "name": "Standard_D8s_v3",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "fullyQualifiedDomainName": "exampleserver.exampleprivatednszone.postgres.database.azure.com",
    "version": "16",
    "minorVersion": "8",
    "administratorLogin": "administratorlogin",
    "state": "Ready",
    "availabilityZone": "1",
    "dataEncryption": {
      "type": "SystemManaged"
    },
    "authConfig": {
      "activeDirectoryAuth": "Disabled",
      "passwordAuth": "Enabled"
    },
    "storage": {
      "storageSizeGB": 1024,
      "autoGrow": "Enabled",
      "tier": "P30",
      "iops": 5000
    },
    "backup": {
      "backupRetentionDays": 20,
      "geoRedundantBackup": "Disabled",
      "earliestRestoreDate": "2024-08-01T18:30:22.123456Z"
    },
    "network": {
      "publicNetworkAccess": "Disabled",
      "delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/virtualNetworks/examplevirtualnetwork/subnets/examplesubnet",
      "privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/privateDnsZones/exampleprivatednszone.postgres.database.azure.com"
    },
    "highAvailability": {
      "mode": "ZoneRedundant",
      "state": "Healthy",
      "standbyAvailabilityZone": "2"
    },
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    }
  },
  "___location": "westus",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver",
  "name": "exampleserver",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-08-01

定义

名称 说明
activeDirectoryAuthEnum

指示服务器是否支持 Microsoft Entra 身份验证。

ArmServerKeyType

灵活服务器使用的数据加密类型。

AuthConfig

灵活服务器的身份验证配置属性。

AzureManagedDiskPerformanceTiers

灵活服务器的存储层。

Backup

灵活服务器的备份属性。

createdByType

创建资源的标识的类型。

CreateMode

新灵活服务器的创建模式。

CreateModeForUpdate

现有灵活服务器的更新模式。

DataEncryption

灵活服务器的数据加密属性。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

GeoRedundantBackupEnum

指示是否将 服务器配置为创建地理位置冗余的备份。

HighAvailability

灵活服务器的高可用性属性。

HighAvailabilityMode

灵活服务器的高可用性模式。

IdentityType

与灵活服务器关联的身份类型。

keyStatusEnum

配置了基于客户管理的密钥的数据加密的灵活服务器使用的密钥状态,用于加密与服务器关联的主存储。

MaintenanceWindow

灵活服务器的维护时段属性。

Network

灵活服务器的网络属性。 仅当您希望将服务器集成到客户提供的虚拟网络中时,才需要。

passwordAuthEnum

指示服务器是否支持基于密码的身份验证。

PrivateEndpoint

专用终结点资源。

PrivateEndpointConnection

与指定灵活服务器关联的专用终结点连接列表。

PrivateEndpointConnectionProvisioningState

专用终结点连接资源的预配状态。

PrivateEndpointServiceConnectionStatus

指示连接是否已被服务的所有者批准/拒绝/删除。

PrivateLinkServiceConnectionState

有关服务使用者与提供程序之间的连接状态的信息集合。

ReadReplicaPromoteMode

要应用于只读副本的作类型。 此属性是 write only。 Standalone 意味着只读副本将被提升为独立服务器,并将成为完全独立于复制集的实体。 切换意味着只读副本将与主服务器一起扮演角色。

Replica

灵活服务器的只读副本属性。 仅在您想要升级服务器时才需要。

ReplicationPromoteOption

处理 promoteMode 属性中指定的作时使用的数据同步选项 此属性为“只写”。 Planned 表示作将等待只读副本中的数据与其源服务器完全同步,然后再启动作。 Forced 表示作在启动作之前不会等待只读副本中的数据与其源服务器同步。

ReplicationRole

服务器在复制集中的角色。

ReplicationState

指示只读副本的复制状态。 仅当目标灵活服务器是只读副本时,才会返回此属性。 可能的值包括 Active、Broken、Catchup、Provisioning、Reconfiguring 和 Updating

Server

灵活服务器。

ServerForUpdate

更新灵活服务器所需的参数。

ServerHAState

当高可用性设置为 SameZone 或 ZoneRedundant 时创建的备用服务器的可能状态。

ServerPublicNetworkAccessState

指示是否启用公共网络访问。

ServerState

灵活服务器的可能状态。

ServerVersion

PostgreSQL 数据库引擎的主要版本。

Sku

灵活服务器的计算层和大小。

SkuTier

分配给灵活服务器的计算层。

Storage

灵活服务器的存储属性。

StorageAutoGrow

当可用空间接近零且条件允许自动增加存储大小时,启用或禁用灵活服务器的存储大小的自动增长的标志。

StorageType

分配给灵活服务器的存储类型。 允许的值为 Premium_LRS 或 PremiumV2_LRS。 如果未指定,则默认为 Premium_LRS。

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

UserAssignedIdentity

用户分配的托管标识分配给灵活服务器。

UserIdentity

用户分配的与灵活服务器关联的托管标识。

activeDirectoryAuthEnum

指示服务器是否支持 Microsoft Entra 身份验证。

说明
Disabled
Enabled

ArmServerKeyType

灵活服务器使用的数据加密类型。

说明
AzureKeyVault
SystemManaged

AuthConfig

灵活服务器的身份验证配置属性。

名称 类型 默认值 说明
activeDirectoryAuth

activeDirectoryAuthEnum

指示服务器是否支持 Microsoft Entra 身份验证。

passwordAuth

passwordAuthEnum

Enabled

指示服务器是否支持基于密码的身份验证。

tenantId

string

委托资源的租户的标识符。

AzureManagedDiskPerformanceTiers

灵活服务器的存储层。

说明
P1
P10
P15
P2
P20
P3
P30
P4
P40
P50
P6
P60
P70
P80

Backup

灵活服务器的备份属性。

名称 类型 默认值 说明
backupRetentionDays

integer (int32)

7

灵活服务器的备份保留天数。

earliestRestoreDate

string (date-time)

灵活服务器的最早还原点时间 (ISO8601 格式)。

geoRedundantBackup

GeoRedundantBackupEnum

Disabled

指示是否将 服务器配置为创建地理位置冗余的备份。

createdByType

创建资源的标识的类型。

说明
Application
Key
ManagedIdentity
User

CreateMode

新灵活服务器的创建模式。

说明
Create
Default
GeoRestore
PointInTimeRestore
Replica
ReviveDropped
Update

CreateModeForUpdate

现有灵活服务器的更新模式。

说明
Default
Update

DataEncryption

灵活服务器的数据加密属性。

名称 类型 说明
geoBackupEncryptionKeyStatus

keyStatusEnum

配置了基于客户管理的密钥的数据加密的灵活服务器使用的密钥状态,用于在服务器配置为支持地理冗余备份时加密与服务器关联的地理冗余存储。

geoBackupKeyURI

string

用户分配的托管标识的标识符,用于访问 Azure Key Vault 中的密钥,以便对与配置为支持地理冗余备份的灵活服务器关联的地理冗余存储进行数据加密。

geoBackupUserAssignedIdentityId

string

用户分配的托管标识的标识符,用于访问 Azure Key Vault 中的密钥,以便对与配置为支持地理冗余备份的灵活服务器关联的地理冗余存储进行数据加密。

primaryEncryptionKeyStatus

keyStatusEnum

配置了基于客户管理的密钥的数据加密的灵活服务器使用的密钥状态,用于加密与服务器关联的主存储。

primaryKeyURI

string

Azure Key Vault 中密钥的 URI,用于对与灵活服务器关联的主存储进行数据加密。

primaryUserAssignedIdentityId

string

用户分配的托管标识的标识符,用于访问 Azure Key Vault 中的密钥,以便对与灵活服务器关联的主存储进行数据加密。

type

ArmServerKeyType

灵活服务器使用的数据加密类型。

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

GeoRedundantBackupEnum

指示是否将 服务器配置为创建地理位置冗余的备份。

说明
Disabled
Enabled

HighAvailability

灵活服务器的高可用性属性。

名称 类型 默认值 说明
mode

HighAvailabilityMode

Disabled

灵活服务器的高可用性模式。

standbyAvailabilityZone

string

与高可用性设置为 SameZone 或 ZoneRedundant 时创建的备用服务器关联的可用区。

state

ServerHAState

当高可用性设置为 SameZone 或 ZoneRedundant 时创建的备用服务器的可能状态。

HighAvailabilityMode

灵活服务器的高可用性模式。

说明
Disabled
SameZone
ZoneRedundant

IdentityType

与灵活服务器关联的身份类型。

说明
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

keyStatusEnum

配置了基于客户管理的密钥的数据加密的灵活服务器使用的密钥状态,用于加密与服务器关联的主存储。

说明
Invalid
Valid

MaintenanceWindow

灵活服务器的维护时段属性。

名称 类型 默认值 说明
customWindow

string

Disabled

指示自定义窗口是启用还是禁用。

dayOfWeek

integer (int32)

0

用于维护时段的星期几。

startHour

integer (int32)

0

用于维护时段的开始时间。

startMinute

integer (int32)

0

用于维护时段的开始分钟。

Network

灵活服务器的网络属性。 仅当您希望将服务器集成到客户提供的虚拟网络中时,才需要。

名称 类型 说明
delegatedSubnetResourceId

string

委托子网的资源标识符。 在创建新服务器期间是必需的,以防您希望将服务器集成到您自己的虚拟网络中。 对于更新作,如果要更改为私有 DNS 区域分配的值,则只需提供此属性。

privateDnsZoneArmResourceId

string

私有 DNS 区域的标识符。 在创建新服务器期间是必需的,以防您希望将服务器集成到您自己的虚拟网络中。 对于更新作,如果要更改为私有 DNS 区域分配的值,则只需提供此属性。

publicNetworkAccess

ServerPublicNetworkAccessState

指示是否启用公共网络访问。

passwordAuthEnum

指示服务器是否支持基于密码的身份验证。

说明
Disabled
Enabled

PrivateEndpoint

专用终结点资源。

名称 类型 说明
id

string

专用终结点的 ARM 标识符。

PrivateEndpointConnection

与指定灵活服务器关联的专用终结点连接列表。

名称 类型 说明
id

string (arm-id)

资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

name

string

资源的名称

properties.groupIds

string[]

专用终结点资源的组 ID。

properties.privateEndpoint

PrivateEndpoint

专用终结点资源。

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

有关服务使用者与提供程序之间的连接状态的信息集合。

properties.provisioningState

PrivateEndpointConnectionProvisioningState

专用终结点连接资源的预配状态。

systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

PrivateEndpointConnectionProvisioningState

专用终结点连接资源的预配状态。

说明
Creating
Deleting
Failed
Succeeded

PrivateEndpointServiceConnectionStatus

指示连接是否已被服务的所有者批准/拒绝/删除。

说明
Approved
Pending
Rejected

PrivateLinkServiceConnectionState

有关服务使用者与提供程序之间的连接状态的信息集合。

名称 类型 说明
actionsRequired

string

一条消息,指示服务提供商上的更改是否需要对使用者进行任何更新。

description

string

批准/拒绝连接的原因。

status

PrivateEndpointServiceConnectionStatus

指示连接是否已被服务的所有者批准/拒绝/删除。

ReadReplicaPromoteMode

要应用于只读副本的作类型。 此属性是 write only。 Standalone 意味着只读副本将被提升为独立服务器,并将成为完全独立于复制集的实体。 切换意味着只读副本将与主服务器一起扮演角色。

说明
standalone
switchover

Replica

灵活服务器的只读副本属性。 仅在您想要升级服务器时才需要。

名称 类型 说明
capacity

integer (int32)

灵活服务器允许的最大只读副本数。

promoteMode

ReadReplicaPromoteMode

要应用于只读副本的作类型。 此属性是 write only。 Standalone 意味着只读副本将被提升为独立服务器,并将成为完全独立于复制集的实体。 切换意味着只读副本将与主服务器一起扮演角色。

promoteOption

ReplicationPromoteOption

处理 promoteMode 属性中指定的作时使用的数据同步选项 此属性为“只写”。 Planned 表示作将等待只读副本中的数据与其源服务器完全同步,然后再启动作。 Forced 表示作在启动作之前不会等待只读副本中的数据与其源服务器同步。

replicationState

ReplicationState

指示只读副本的复制状态。 仅当目标灵活服务器是只读副本时,才会返回此属性。 可能的值包括 Active、Broken、Catchup、Provisioning、Reconfiguring 和 Updating

role

ReplicationRole

服务器在复制集中的角色。

ReplicationPromoteOption

处理 promoteMode 属性中指定的作时使用的数据同步选项 此属性为“只写”。 Planned 表示作将等待只读副本中的数据与其源服务器完全同步,然后再启动作。 Forced 表示作在启动作之前不会等待只读副本中的数据与其源服务器同步。

说明
forced
planned

ReplicationRole

服务器在复制集中的角色。

说明
AsyncReplica
GeoAsyncReplica
None
Primary

ReplicationState

指示只读副本的复制状态。 仅当目标灵活服务器是只读副本时,才会返回此属性。 可能的值包括 Active、Broken、Catchup、Provisioning、Reconfiguring 和 Updating

说明
Active
Broken
Catchup
Provisioning
Reconfiguring
Updating

Server

灵活服务器。

名称 类型 说明
id

string (arm-id)

资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

identity

UserAssignedIdentity

用户分配的托管标识分配给灵活服务器。

___location

string

资源所在的地理位置

name

string

资源的名称

properties.administratorLogin

string

指定为分配给 PostgreSQL 实例的第一个基于密码的管理员的登录名。 首次在服务器上启用基于密码的身份验证时,必须指定此参数。 一旦设置为给定值,则在服务器的其余生命周期内无法更改。 如果在启用了基于密码的身份验证的服务器上禁用基于密码的身份验证,则不会删除此基于密码的角色。

properties.administratorLoginPassword

string (password)

分配给管理员登录名的密码。 只要启用了密码身份验证,就可以随时更改此密码。

properties.authConfig

AuthConfig

灵活服务器的身份验证配置属性。

properties.availabilityZone

string

灵活服务器的可用性区域。

properties.backup

Backup

灵活服务器的备份属性。

properties.createMode

CreateMode

新灵活服务器的创建模式。

properties.dataEncryption

DataEncryption

灵活服务器的数据加密属性。

properties.fullyQualifiedDomainName

string

灵活服务器的完全限定域名。

properties.highAvailability

HighAvailability

灵活服务器的高可用性属性。

properties.maintenanceWindow

MaintenanceWindow

灵活服务器的维护时段属性。

properties.minorVersion

string

PostgreSQL 数据库引擎的次要版本。

properties.network

Network

灵活服务器的网络属性。 仅当您希望将服务器集成到客户提供的虚拟网络中时,才需要。

properties.pointInTimeUTC

string (date-time)

要在新灵活服务器中还原的备份的创建时间(ISO8601格式)。 当 'createMode' 为 'PointInTimeRestore'、'GeoRestore' 或 'ReviveDropped' 时,它是必需的。

properties.privateEndpointConnections

PrivateEndpointConnection[]

与指定灵活服务器关联的专用终结点连接列表。

properties.replica

Replica

灵活服务器的只读副本属性。 仅在您想要升级服务器时才需要。

properties.replicaCapacity

integer (int32)

灵活服务器允许的最大只读副本数。

properties.replicationRole

ReplicationRole

服务器在复制集中的角色。

properties.sourceServerResourceId

string

要用作新灵活服务器源的灵活服务器的标识符。 当 'createMode' 为 'PointInTimeRestore'、'GeoRestore'、'Replica' 或 'ReviveDropped' 时是必需的。 仅当目标灵活服务器是只读副本时,才会返回此属性。

properties.state

ServerState

灵活服务器的可能状态。

properties.storage

Storage

灵活服务器的存储属性。

properties.version

ServerVersion

PostgreSQL 数据库引擎的主要版本。

sku

Sku

灵活服务器的计算层和大小。

systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

tags

object

资源标记。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

ServerForUpdate

更新灵活服务器所需的参数。

名称 类型 说明
identity

UserAssignedIdentity

描述应用程序的标识。

properties.administratorLogin

string

指定为分配给 PostgreSQL 实例的第一个基于密码的管理员的登录名。 首次在服务器上启用基于密码的身份验证时,必须指定此参数。 一旦设置为给定值,则在服务器的其余生命周期内无法更改。 如果在启用了基于密码的身份验证的服务器上禁用基于密码的身份验证,则不会删除此基于密码的角色。

properties.administratorLoginPassword

string (password)

分配给管理员登录名的密码。 只要启用了密码身份验证,就可以随时更改此密码。

properties.authConfig

AuthConfig

灵活服务器的身份验证配置属性。

properties.backup

Backup

灵活服务器的备份属性。

properties.createMode

CreateModeForUpdate

现有灵活服务器的更新模式。

properties.dataEncryption

DataEncryption

灵活服务器的数据加密属性。

properties.highAvailability

HighAvailability

灵活服务器的高可用性属性。

properties.maintenanceWindow

MaintenanceWindow

灵活服务器的维护时段属性。

properties.network

Network

灵活服务器的网络属性。 仅当您希望将服务器集成到客户提供的虚拟网络中时,才需要。

properties.replica

Replica

灵活服务器的只读副本属性。 仅在您想要升级服务器时才需要。

properties.replicationRole

ReplicationRole

服务器在复制集中的角色。

properties.storage

Storage

灵活服务器的存储属性。

properties.version

ServerVersion

PostgreSQL 数据库引擎的主要版本。

sku

Sku

灵活服务器的计算层和大小。

tags

object

键值对形式的特定于应用程序的元数据。

ServerHAState

当高可用性设置为 SameZone 或 ZoneRedundant 时创建的备用服务器的可能状态。

说明
CreatingStandby
FailingOver
Healthy
NotEnabled
RemovingStandby
ReplicatingData

ServerPublicNetworkAccessState

指示是否启用公共网络访问。

说明
Disabled
Enabled

ServerState

灵活服务器的可能状态。

说明
Disabled
Dropping
Ready
Starting
Stopped
Stopping
Updating

ServerVersion

PostgreSQL 数据库引擎的主要版本。

说明
11
12
13
14
15
16

Sku

灵活服务器的计算层和大小。

名称 类型 说明
name

string

名称 ,用于已知分配给灵活服务器的给定计算大小。

tier

SkuTier

分配给灵活服务器的计算层。

SkuTier

分配给灵活服务器的计算层。

说明
Burstable
GeneralPurpose
MemoryOptimized

Storage

灵活服务器的存储属性。

名称 类型 说明
autoGrow

StorageAutoGrow

当可用空间接近零且条件允许自动增加存储大小时,启用或禁用灵活服务器的存储大小的自动增长的标志。

iops

integer (int32)

存储支持的最大 IOPS。 当存储类型为 PremiumV2_LRS 时是必需的。

storageSizeGB

integer (int32)

分配给灵活服务器的存储大小。

throughput

integer (int32)

存储支持的最大吞吐量。 当存储类型为 PremiumV2_LRS 时是必需的。

tier

AzureManagedDiskPerformanceTiers

灵活服务器的存储层。

type

StorageType

分配给灵活服务器的存储类型。 允许的值为 Premium_LRS 或 PremiumV2_LRS。 如果未指定,则默认为 Premium_LRS。

StorageAutoGrow

当可用空间接近零且条件允许自动增加存储大小时,启用或禁用灵活服务器的存储大小的自动增长的标志。

说明
Disabled
Enabled

StorageType

分配给灵活服务器的存储类型。 允许的值为 Premium_LRS 或 PremiumV2_LRS。 如果未指定,则默认为 Premium_LRS。

说明
PremiumV2_LRS
Premium_LRS

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

名称 类型 说明
createdAt

string (date-time)

资源创建时间戳(UTC)。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识的类型。

lastModifiedAt

string (date-time)

上次修改的资源时间戳(UTC)

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识的类型。

UserAssignedIdentity

用户分配的托管标识分配给灵活服务器。

名称 类型 说明
principalId

string

与用户分配的托管标识关联的服务主体的对象的标识符。

tenantId

string

灵活服务器租户的标识符。

type

IdentityType

与灵活服务器关联的身份类型。

userAssignedIdentities

<string,  UserIdentity>

用户分配的托管标识的映射。

UserIdentity

用户分配的与灵活服务器关联的托管标识。

名称 类型 说明
clientId

string

与用户分配的托管标识关联的服务主体的客户端的标识符。

principalId

string

与用户分配的托管标识关联的服务主体的对象的标识符。