Servers - Update
Actualiza un servidor existente. El cuerpo de la solicitud puede contener una o varias de las propiedades presentes en la definición de servidor normal.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}?api-version=2026-10-01
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre no distingue entre mayúsculas y minúsculas. |
|
server
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* |
El nombre del servidor. |
|
subscription
|
path | True |
string (uuid) |
Identificador de la suscripción de destino. El valor debe ser un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versión de la API que se va a usar para esta operación. |
Cuerpo de la solicitud
| Nombre | Tipo | Description |
|---|---|---|
| identity |
Describe la identidad de la aplicación. |
|
| properties.administratorLoginPassword |
string (password) |
Contraseña asignada al inicio de sesión del administrador. Siempre que la autenticación con contraseña esté habilitada, esta contraseña se puede cambiar en cualquier momento. |
| properties.authConfig |
Propiedades de configuración de autenticación de un servidor. |
|
| properties.availabilityZone |
string |
Zona de disponibilidad de un servidor. |
| properties.backup |
Propiedades de copia de seguridad de un servidor. |
|
| properties.cluster |
Propiedades de clúster de un servidor. |
|
| properties.createMode |
Modo de actualización de un servidor existente. |
|
| properties.dataEncryption |
Propiedades de cifrado de datos de un servidor. |
|
| properties.fipsMode |
Indica si el modo FIPS (Normas Federales de Procesamiento de Información) está activado en el servidor. Si no se especifica, se conserva el valor actual. |
|
| properties.highAvailability |
Propiedades de alta disponibilidad de un servidor. |
|
| properties.maintenanceWindow |
Propiedades de la ventana de mantenimiento de un servidor. |
|
| properties.network |
Propiedades de red de un servidor. Solo es necesario si desea que su servidor se integre en una red virtual proporcionada por el cliente. |
|
| properties.replica |
Leer las propiedades de réplica de un servidor. Requerido solo en caso de que desee promocionar un servidor. |
|
| properties.replicationRole |
Rol del servidor en un conjunto de replicación. |
|
| properties.sourceServerResourceId |
string (arm-id) |
Identificador del servidor que se utilizará como origen del nuevo servidor. |
| properties.storage |
Propiedades de almacenamiento de un servidor. |
|
| properties.version |
string |
Versión principal del motor de base de datos PostgreSQL. |
| sku |
Nivel de proceso y tamaño de un servidor. |
|
| tags |
object |
Metadatos específicos de la aplicación en forma de pares clave-valor. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 202 Accepted |
Operación de recursos aceptada. Encabezados
|
|
| Other Status Codes |
Una respuesta de error inesperada. |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
| Nombre | Description |
|---|---|
| user_impersonation | suplantar su cuenta de usuario |
Ejemplos
Enable or disable FIPS mode on an existing server.
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
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.
Solicitud de ejemplo
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"
}
}
}
Respuesta de muestra
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.
Solicitud de ejemplo
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"
}
}
}
Respuesta de muestra
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.
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
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.
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
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.
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
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.
Solicitud de ejemplo
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
}
}
}
Respuesta de muestra
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.
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
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.
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
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.
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
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.
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
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.
Solicitud de ejemplo
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
}
}
}
Respuesta de muestra
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
Definiciones
| Nombre | Description |
|---|---|
|
Auth |
Propiedades de configuración de autenticación de un servidor. |
|
Azure |
Nivel de almacenamiento de un servidor. |
|
Backup |
Propiedades de copia de seguridad de un servidor. |
| Cluster |
Propiedades de clúster de un servidor. |
|
Create |
Modo de actualización de un servidor existente. |
|
Data |
Propiedades de cifrado de datos de un servidor. |
|
Data |
Tipo de cifrado de datos utilizado por un servidor. |
|
Encryption |
Estado de la clave utilizada por un servidor configurado con cifrado de datos basado en la clave administrada por el cliente, para cifrar el almacenamiento principal asociado al servidor. |
|
Error |
Información adicional sobre el error de administración de recursos. |
|
Error |
Detalle del error. |
|
Error |
Respuesta de error |
|
Fips |
Indica si el modo FIPS (Normas Federales de Procesamiento de Información) está activado en el servidor. |
|
Geographically |
Indica si el servidor está configurado para crear copias de seguridad con redundancia geográfica. |
|
High |
Propiedades de alta disponibilidad de un servidor. |
|
High |
Posibles estados del servidor en espera creado cuando la alta disponibilidad se establece en SameZone o ZoneRedundant. |
|
Identity |
Tipos de identidades asociadas a un servidor. |
|
Immutable |
Indica si el servidor está configurado para crear copias de seguridad inmutables. |
|
Maintenance |
Propiedades de la ventana de mantenimiento de un servidor. |
|
Microsoft |
Indica si el servidor admite la autenticación de Microsoft Entra. |
| Network |
Propiedades de red de un servidor. |
|
Password |
Indica si el servidor admite la autenticación basada en contraseña. |
|
Postgre |
Modo de alta disponibilidad soportado para este cálculo. |
|
Read |
Tipo de operación que se va a aplicar en la réplica de lectura. Esta propiedad es de solo escritura. |
|
Read |
Opción de sincronización de datos que se usará al procesar la operación especificada en la propiedad promoteMode. Esta propiedad es de solo escritura. |
| Replica |
Propiedades de réplica de un servidor. |
|
Replication |
Rol del servidor en un conjunto de replicación. |
|
Replication |
Indica el estado de replicación de una réplica de lectura. Esta propiedad solo se devuelve cuando el servidor de destino es una réplica de lectura. |
|
Server |
Representa un servidor que se va a actualizar. |
|
Server |
Indica si el acceso a la red pública está habilitado o no. |
|
Sku |
Información informática de un servidor. |
|
Sku |
Nivel del proceso asignado a un servidor. |
| Storage |
Propiedades de almacenamiento de un servidor. |
|
Storage |
Indica si el servidor está configurado para aumentar automáticamente el tamaño del almacenamiento cuando el espacio disponible está cerca de cero y las condiciones permiten un crecimiento automático del tamaño del almacenamiento. |
|
Storage |
Tipo de almacenamiento asignado a un servidor. Si no se especifica, el valor predeterminado es Premium_LRS. |
|
User |
Identidades asociadas a un servidor. |
|
User |
Identidad administrada asignada por el usuario asociada a un servidor. |
AuthConfigForPatch
Propiedades de configuración de autenticación de un servidor.
| Nombre | Tipo | Description |
|---|---|---|
| activeDirectoryAuth |
Indica si el servidor admite la autenticación de Microsoft Entra. |
|
| passwordAuth |
Indica si el servidor admite la autenticación basada en contraseña. |
|
| tenantId |
string |
Identificador del inquilino del recurso delegado. |
AzureManagedDiskPerformanceTier
Nivel de almacenamiento de un servidor.
| Valor | Description |
|---|---|
| P1 |
SSD de nivel básico para IOPS mínimas, ideal para cargas de trabajo ligeras de desarrollo o pruebas. |
| P2 |
IOPS ligeramente más altas para aplicaciones a pequeña escala que necesitan una baja latencia constante. |
| P3 |
Rendimiento equilibrado para cargas de trabajo de producción básicas con un rendimiento moderado. |
| P4 |
IOPS mejoradas para aplicaciones en crecimiento con necesidades de rendimiento predecibles. |
| P6 |
SSD de nivel medio para cargas de trabajo estables que requieren un rendimiento y una latencia fiables. |
| P10 |
Opción popular para cargas de trabajo de producción de uso general con rendimiento escalable. |
| P15 |
Nivel de IOPS alto para aplicaciones exigentes con operaciones de lectura y escritura frecuentes. |
| P20 |
Punto de entrada para discos de estado sólido (SSD) de alto rendimiento, adecuado para cargas de trabajo intensivas de E/S a pequeña escala. |
| P30 |
Nivel equilibrado para aplicaciones sensibles a la latencia y rendimiento moderado. |
| P40 |
Rendimiento mejorado para cargas de trabajo de producción crecientes con demandas de IOPS consistentes. |
| P50 |
Optimizado para aplicaciones de nivel empresarial que necesitan un alto rendimiento sostenido. |
| P60 |
Nivel de alta capacidad para grandes bases de datos y cargas de trabajo de análisis con IOPS elevadas. |
| P70 |
Diseñado para sistemas de misión crítica que requieren una latencia ultrabaja y una alta simultaneidad. |
| P80 |
SSD de primer nivel para obtener el máximo rendimiento e IOPS, ideal para las cargas de trabajo más exigentes. |
BackupForPatch
Propiedades de copia de seguridad de un servidor.
| Nombre | Tipo | Description |
|---|---|---|
| backupRetentionDays |
integer (int32) |
Días de retención de copia de seguridad para el servidor. |
| earliestRestoreDate |
string (date-time) |
Hora de punto de restauración más temprana (formato ISO8601) para un servidor. |
| geoRedundantBackup |
Indica si el servidor está configurado para crear copias de seguridad con redundancia geográfica. |
|
| immutableBackup |
Indica si el servidor está configurado para crear copias de seguridad inmutables. |
Cluster
Propiedades de clúster de un servidor.
| Nombre | Tipo | Valor predeterminado | Description |
|---|---|---|---|
| clusterSize |
integer (int32) |
0 |
Número de nodos asignados al clúster elástico. |
| defaultDatabaseName |
string |
Nombre de base de datos predeterminado para el clúster elástico. |
CreateModeForPatch
Modo de actualización de un servidor existente.
| Valor | Description |
|---|---|
| Default |
Es equivalente a 'Actualizar'. |
| Update |
La operación actualiza un servidor existente. |
DataEncryption
Propiedades de cifrado de datos de un servidor.
| Nombre | Tipo | Description |
|---|---|---|
| geoBackupEncryptionKeyStatus |
Estado de la clave utilizada por un servidor configurado con cifrado de datos basado en la clave administrada por el cliente, para cifrar el almacenamiento geográficamente redundante asociado al servidor cuando está configurado para admitir copias de seguridad geográficamente redundantes. |
|
| geoBackupFederatedIdentityClientId |
string (uuid) |
ID de cliente de la aplicación Microsoft Entra multi-inquilino para cuando está configurada para soportar copias de seguridad geográficamente redundantes. |
| geoBackupKeyURI |
string |
Identificador de la identidad administrada asignada por el usuario que se usa para acceder a la clave en Azure Key Vault para el cifrado de datos del almacenamiento con redundancia geográfica asociado a un servidor configurado para admitir copias de seguridad con redundancia geográfica. |
| geoBackupUserAssignedIdentityId |
string |
Identificador de la identidad administrada asignada por el usuario que se usa para acceder a la clave en Azure Key Vault para el cifrado de datos del almacenamiento con redundancia geográfica asociado a un servidor configurado para admitir copias de seguridad con redundancia geográfica. |
| primaryEncryptionKeyStatus |
Estado de la clave utilizada por un servidor configurado con cifrado de datos basado en la clave administrada por el cliente, para cifrar el almacenamiento principal asociado al servidor. |
|
| primaryFederatedIdentityClientId |
string (uuid) |
ID de cliente de la aplicación Microsoft Entra multi-inquilino. |
| primaryKeyURI |
string |
URI de la clave de Azure Key Vault que se usa para el cifrado de datos del almacenamiento principal asociado a un servidor. |
| primaryUserAssignedIdentityId |
string |
Identificador de la identidad administrada asignada por el usuario que se usa para acceder a la clave en Azure Key Vault para el cifrado de datos del almacenamiento principal asociado a un servidor. |
| type |
Tipo de cifrado de datos utilizado por un servidor. |
DataEncryptionType
Tipo de cifrado de datos utilizado por un servidor.
| Valor | Description |
|---|---|
| SystemManaged |
Cifrado gestionado por Azure usando claves gestionadas por plataforma para mayor simplicidad y cumplimiento. |
| AzureKeyVault |
Cifrado usando claves gestionadas por el cliente almacenadas en Azure Key Vault para un mayor control y seguridad. |
EncryptionKeyStatus
Estado de la clave utilizada por un servidor configurado con cifrado de datos basado en la clave administrada por el cliente, para cifrar el almacenamiento principal asociado al servidor.
| Valor | Description |
|---|---|
| Valid |
La clave es válida y se puede utilizar para el cifrado. |
| Invalid |
La clave no es válida y no se puede utilizar para el cifrado. Las posibles causas incluyen la eliminación de claves, cambios de permisos, clave deshabilitada, tipo de clave no admitido o fecha actual fuera del período de validez asociado a la clave. |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
| Nombre | Tipo | Description |
|---|---|---|
| info |
object |
Información adicional. |
| type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
| Nombre | Tipo | Description |
|---|---|---|
| additionalInfo |
Información adicional del error. |
|
| code |
string |
Código de error. |
| details |
Detalles del error. |
|
| message |
string |
El mensaje de error. |
| target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
| Nombre | Tipo | Description |
|---|---|---|
| error |
Objeto de error. |
FipsMode
Indica si el modo FIPS (Normas Federales de Procesamiento de Información) está activado en el servidor.
| Valor | Description |
|---|---|
| Enabled |
El modo FIPS está activado en el servidor. |
| Disabled |
El modo FIPS está deshabilitado en el servidor. |
GeographicallyRedundantBackup
Indica si el servidor está configurado para crear copias de seguridad con redundancia geográfica.
| Valor | Description |
|---|---|
| Enabled |
El servidor está configurado para crear copias de seguridad con redundancia geográfica. |
| Disabled |
El servidor no está configurado para crear copias de seguridad con redundancia geográfica. |
HighAvailabilityForPatch
Propiedades de alta disponibilidad de un servidor.
| Nombre | Tipo | Description |
|---|---|---|
| mode |
Modo de alta disponibilidad para un servidor. |
|
| standbyAvailabilityZone |
string |
Zona de disponibilidad asociada al servidor en espera creada cuando la alta disponibilidad se establece en SameZone o ZoneRedundant. |
| state |
Posibles estados del servidor en espera creado cuando la alta disponibilidad se establece en SameZone o ZoneRedundant. |
HighAvailabilityState
Posibles estados del servidor en espera creado cuando la alta disponibilidad se establece en SameZone o ZoneRedundant.
| Valor | Description |
|---|---|
| NotEnabled |
La alta disponibilidad no está habilitada para el servidor. |
| CreatingStandby |
Se está creando un servidor en espera. |
| ReplicatingData |
Los datos se replican en el servidor en espera. |
| FailingOver |
La operación de conmutación por error al servidor en espera está en curso. |
| Healthy |
El servidor en espera está en buen estado y listo para tomar el control en caso de una conmutación por error. |
| RemovingStandby |
Se está quitando el servidor en espera. |
| RecreatingStandby |
El servidor de espera está siendo recreado. |
| ComputeUpdatingByFailover |
Compute se está actualizando debido a un conmutamiento por error. |
IdentityType
Tipos de identidades asociadas a un servidor.
| Valor | Description |
|---|---|
| None |
No se asigna ninguna identidad administrada al servidor. |
| UserAssigned |
Una o varias identidades administradas proporcionadas por el usuario se asignan al servidor. |
| SystemAssigned |
Azure crea y gestiona automáticamente la identidad asociada al ciclo de vida del servidor. |
| SystemAssigned,UserAssigned |
Tanto las identidades asignadas por el sistema como las asignadas por el usuario se asignan al servidor. |
ImmutableBackup
Indica si el servidor está configurado para crear copias de seguridad inmutables.
| Valor | Description |
|---|---|
| Enabled |
El servidor está configurado para crear copias de seguridad inmutables. |
| Disabled |
El servidor no está configurado para crear copias de seguridad inmutables. |
MaintenanceWindowForPatch
Propiedades de la ventana de mantenimiento de un servidor.
| Nombre | Tipo | Description |
|---|---|---|
| customWindow |
string |
Indica si la ventana personalizada está habilitada o deshabilitada. |
| dayOfWeek |
integer (int32) |
Día de la semana que se utilizará para la ventana de mantenimiento. |
| startHour |
integer (int32) |
Hora de inicio que se utilizará para la ventana de mantenimiento. |
| startMinute |
integer (int32) |
Minuto de inicio que se utilizará para la ventana de mantenimiento. |
MicrosoftEntraAuth
Indica si el servidor admite la autenticación de Microsoft Entra.
| Valor | Description |
|---|---|
| Enabled |
El servidor soporta autenticación Microsoft Entra. |
| Disabled |
El servidor no soporta autenticación Microsoft Entra. |
Network
Propiedades de red de un servidor.
| Nombre | Tipo | Description |
|---|---|---|
| delegatedSubnetResourceId |
string (arm-id) |
Identificador de recursos de la subred delegada. Necesario durante la creación de un nuevo servidor, en caso de que desee que el servidor se integre en su propia red virtual. Para una operación de actualización, solo tiene que proporcionar esta propiedad si desea cambiar el valor asignado para la zona DNS privada. |
| privateDnsZoneArmResourceId |
string (arm-id) |
Identificador de la zona DNS privada. Necesario durante la creación de un nuevo servidor, en caso de que desee que el servidor se integre en su propia red virtual. Para una operación de actualización, solo tiene que proporcionar esta propiedad si desea cambiar el valor asignado para la zona DNS privada. |
| publicNetworkAccess |
Indica si el acceso a la red pública está habilitado o no. Esto solo se admite para servidores que no están integrados en una red virtual que es propiedad del cliente y proporcionada por el cliente cuando se implementa el servidor. |
PasswordBasedAuth
Indica si el servidor admite la autenticación basada en contraseña.
| Valor | Description |
|---|---|
| Enabled |
El servidor admite la autenticación basada en contraseña. |
| Disabled |
El servidor no soporta autenticación basada en contraseña. |
PostgreSqlFlexibleServerHighAvailabilityMode
Modo de alta disponibilidad soportado para este cálculo.
| Valor | Description |
|---|---|
| Disabled |
La alta disponibilidad está deshabilitada para el servidor. |
| ZoneRedundant |
La alta disponibilidad está habilitada para el servidor, con el servidor en espera en una zona de disponibilidad diferente a la del principal. |
| SameZone |
La alta disponibilidad está habilitada para el servidor, con el servidor en espera en la misma zona de disponibilidad que el principal. |
ReadReplicaPromoteMode
Tipo de operación que se va a aplicar en la réplica de lectura. Esta propiedad es de solo escritura.
| Valor | Description |
|---|---|
| Standalone |
La réplica de lectura se convertirá en un servidor independiente y en una entidad completamente independiente del conjunto de replicación. |
| Switchover |
La réplica de lectura intercambiará roles con el servidor principal. |
ReadReplicaPromoteOption
Opción de sincronización de datos que se usará al procesar la operación especificada en la propiedad promoteMode. Esta propiedad es de solo escritura.
| Valor | Description |
|---|---|
| Planned |
Espera a que los datos en la réplica de lectura estén completamente sincronizados con su servidor de origen antes de iniciar la operación. |
| Forced |
Inicia la operación inmediatamente, sin esperar a que los datos en la réplica de lectura se sincronicen con su servidor de origen. |
Replica
Propiedades de réplica de un servidor.
| Nombre | Tipo | Description |
|---|---|---|
| capacity |
integer (int32) |
Número máximo de réplicas de lectura permitidas para un servidor. |
| promoteMode |
Tipo de operación que se va a aplicar en la réplica de lectura. Esta propiedad es de solo escritura. Independiente significa que la réplica de lectura se promoverá a un servidor independiente y se convertirá en una entidad completamente independiente del conjunto de replicación. El cambio significa que la réplica de lectura tendrá roles con el servidor principal. |
|
| promoteOption |
Opción de sincronización de datos que se usará al procesar la operación especificada en la propiedad promoteMode. Esta propiedad es de solo escritura. |
|
| replicationState |
Indica el estado de replicación de una réplica de lectura. Esta propiedad solo se devuelve cuando el servidor de destino es una réplica de lectura. Los valores posibles son Activo, Roto, Puesta al día, Aprovisionamiento, Reconfiguración y Actualización |
|
| role |
Rol del servidor en un conjunto de replicación. |
ReplicationRole
Rol del servidor en un conjunto de replicación.
| Valor | Description |
|---|---|
| None |
No se ha asignado ningún rol de replicación; El servidor funciona de forma independiente. |
| Primary |
Actúa como servidor de origen para la replicación en una o varias réplicas. |
| AsyncReplica |
Recibe datos de forma asincrónica de un servidor principal dentro de la misma región. |
| GeoAsyncReplica |
Recibe datos de forma asincrónica de un servidor principal en una región diferente para la redundancia geográfica. |
ReplicationState
Indica el estado de replicación de una réplica de lectura. Esta propiedad solo se devuelve cuando el servidor de destino es una réplica de lectura.
| Valor | Description |
|---|---|
| Active |
El servidor réplica de lectura está completamente sincronizado y replica activamente los datos del servidor principal. |
| Catchup |
El servidor réplica de lectura está detrás del servidor principal y actualmente está poniéndose al día con los cambios pendientes. |
| Provisioning |
Se está creando un servidor de réplica de lectura y está en proceso de inicialización. |
| Updating |
El servidor réplica de lectura está experimentando algunos cambios, puede estar cambiando el tamaño de cálculo o promoviéndolo al servidor principal. |
| Broken |
La replicación ha fallado o se ha interrumpido. |
| Reconfiguring |
El servidor réplica de lectura está siendo reconfigurado, posiblemente debido a cambios en la fuente o en la configuración. |
ServerForPatch
Representa un servidor que se va a actualizar.
| Nombre | Tipo | Description |
|---|---|---|
| identity |
Describe la identidad de la aplicación. |
|
| properties.administratorLogin |
string |
Nombre del inicio de sesión designado como el primer administrador basado en contraseña asignado a su instancia de PostgreSQL. Debe especificarse la primera vez que habilite la autenticación basada en contraseña en un servidor. Una vez establecido en un valor dado, no se puede cambiar durante el resto de la vida útil de un servidor. Si deshabilita la autenticación basada en contraseña en un servidor que la tenía habilitada, este rol basado en contraseña no se elimina. |
| properties.administratorLoginPassword |
string (password) |
Contraseña asignada al inicio de sesión del administrador. Siempre que la autenticación con contraseña esté habilitada, esta contraseña se puede cambiar en cualquier momento. |
| properties.authConfig |
Propiedades de configuración de autenticación de un servidor. |
|
| properties.availabilityZone |
string |
Zona de disponibilidad de un servidor. |
| properties.backup |
Propiedades de copia de seguridad de un servidor. |
|
| properties.cluster |
Propiedades de clúster de un servidor. |
|
| properties.createMode |
Modo de actualización de un servidor existente. |
|
| properties.dataEncryption |
Propiedades de cifrado de datos de un servidor. |
|
| properties.fipsMode |
Indica si el modo FIPS (Normas Federales de Procesamiento de Información) está activado en el servidor. Si no se especifica, se conserva el valor actual. |
|
| properties.highAvailability |
Propiedades de alta disponibilidad de un servidor. |
|
| properties.maintenanceWindow |
Propiedades de la ventana de mantenimiento de un servidor. |
|
| properties.network |
Propiedades de red de un servidor. Solo es necesario si desea que su servidor se integre en una red virtual proporcionada por el cliente. |
|
| properties.replica |
Leer las propiedades de réplica de un servidor. Requerido solo en caso de que desee promocionar un servidor. |
|
| properties.replicationRole |
Rol del servidor en un conjunto de replicación. |
|
| properties.sourceServerResourceId |
string (arm-id) |
Identificador del servidor que se utilizará como origen del nuevo servidor. |
| properties.storage |
Propiedades de almacenamiento de un servidor. |
|
| properties.version |
string |
Versión principal del motor de base de datos PostgreSQL. |
| sku |
Nivel de proceso y tamaño de un servidor. |
|
| tags |
object |
Metadatos específicos de la aplicación en forma de pares clave-valor. |
ServerPublicNetworkAccessState
Indica si el acceso a la red pública está habilitado o no.
| Valor | Description |
|---|---|
| Enabled |
El acceso a la red pública está habilitado. Esto permite acceder al servidor desde la Internet pública, siempre que se implemente la regla de firewall necesaria que permita el tráfico entrante que se origina en el cliente que se conecta. Esto es compatible con el uso de puntos de conexión privados para conectarse a este servidor. |
| Disabled |
El acceso de red pública está deshabilitado. Esto significa que no se puede acceder al servidor desde la Internet pública, sino solo a través de puntos finales privados. |
SkuForPatch
Información informática de un servidor.
| Nombre | Tipo | Description |
|---|---|---|
| name |
string |
Nombre por el que se conoce un tamaño de proceso determinado asignado a un servidor. |
| tier |
Nivel del proceso asignado a un servidor. |
SkuTier
Nivel del proceso asignado a un servidor.
| Valor | Description |
|---|---|
| Burstable |
Nivel rentable para un uso poco frecuente de la CPU, ideal para cargas de trabajo de desarrollo y prueba con bajos requisitos de rendimiento. |
| GeneralPurpose |
Computación y memoria equilibradas para la mayoría de las cargas de trabajo, lo que ofrece un rendimiento escalable y un rendimiento de E/S. |
| MemoryOptimized |
Alta relación memoria-núcleo para cargas de trabajo exigentes que necesitan un procesamiento rápido en memoria y una alta simultaneidad. |
Storage
Propiedades de almacenamiento de un servidor.
| Nombre | Tipo | Description |
|---|---|---|
| autoGrow |
Marque para habilitar o deshabilitar el crecimiento automático del tamaño de almacenamiento de un servidor cuando el espacio disponible se acerca a cero y las condiciones permiten aumentar automáticamente el tamaño de almacenamiento. |
|
| autoGrowIncrementPercent |
integer (int32) minimum: 1maximum: 100 |
El crecimiento automático del almacenamiento incrementa como porcentaje del tamaño de almacenamiento asignado actualmente. Este valor no es un incremento absoluto de tamaño ni un umbral de utilización. |
| autoGrowMaxThresholdMb |
integer (int32) minimum: 1maximum: 67108864 |
Tamaño máximo de almacenamiento asignado al que puede crecer el autocrecimiento, en MB. Este valor no es un umbral de disparo de utilización de disco y debe ser al menos la corriente efectiva o el tamaño de almacenamiento solicitado. La conversión de almacenamiento utiliza 1 GB = 1.024 MB. |
| iops |
integer (int32) |
Número máximo de IOPS admitidas para el almacenamiento. Obligatorio cuando el tipo de almacenamiento es PremiumV2_LRS o UltraSSD_LRS. |
| storageSizeGB |
integer (int32) |
Tamaño del almacenamiento asignado a un servidor. |
| throughput |
integer (int32) |
Rendimiento máximo admitido para el almacenamiento. Obligatorio cuando el tipo de almacenamiento es PremiumV2_LRS o UltraSSD_LRS. |
| tier |
Nivel de almacenamiento de un servidor. |
|
| type |
Tipo de almacenamiento asignado a un servidor. Los valores permitidos son Premium_LRS, PremiumV2_LRS o UltraSSD_LRS. Si no se especifica, el valor predeterminado es Premium_LRS. |
StorageAutoGrow
Indica si el servidor está configurado para aumentar automáticamente el tamaño del almacenamiento cuando el espacio disponible está cerca de cero y las condiciones permiten un crecimiento automático del tamaño del almacenamiento.
| Valor | Description |
|---|---|
| Enabled |
El servidor debe aumentar automáticamente el tamaño de almacenamiento cuando el espacio disponible se acerca a cero y las condiciones permiten aumentar automáticamente el tamaño de almacenamiento. |
| Disabled |
El servidor no debe aumentar automáticamente el tamaño de almacenamiento cuando el espacio disponible se acerca a cero. |
StorageType
Tipo de almacenamiento asignado a un servidor. Si no se especifica, el valor predeterminado es Premium_LRS.
| Valor | Description |
|---|---|
| Premium_LRS |
Almacenamiento con respaldo de disco de estado sólido (SSD) estándar que ofrece un rendimiento constante para cargas de trabajo de uso general. |
| PremiumV2_LRS |
Almacenamiento en disco de estado sólido (SSD) de próxima generación con escalabilidad y rendimiento mejorados para cargas de trabajo empresariales exigentes. |
| UltraSSD_LRS |
Almacenamiento en disco de estado sólido (SSD) de gama alta diseñado para IOPS extremas y aplicaciones sensibles a la latencia. |
UserAssignedIdentity
Identidades asociadas a un servidor.
| Nombre | Tipo | Description |
|---|---|---|
| principalId |
string |
Identificador del objeto de la entidad de servicio asociada a la identidad administrada asignada por el usuario. |
| tenantId |
string |
Identificador del inquilino de un servidor. |
| type |
Tipos de identidades asociadas a un servidor. |
|
| userAssignedIdentities |
<string,
User |
Mapa de identidades administradas asignadas por el usuario. |
UserIdentity
Identidad administrada asignada por el usuario asociada a un servidor.
| Nombre | Tipo | Description |
|---|---|---|
| clientId |
string |
Identificador del cliente de la entidad de servicio asociada a la identidad administrada asignada por el usuario. |
| principalId |
string |
Identificador del objeto de la entidad de servicio asociada a la identidad administrada asignada por el usuario. |