Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se proporcionan las noticias y actualizaciones más recientes sobre las versiones de API recomendadas que se van a usar. Es posible que se admitan las versiones de API que no aparecen aquí, pero se retirarán pronto. La documentación de la versión preliminar más reciente y de la versión estable de la API está disponible aquí.
Versiones de la API
En esta sección se resumen los cambios de características en cada versión de api de Azure Database for PostgreSQL.
Nota
Las versiones de API generalmente se basan en versiones anteriores, pero las características en versión preliminar pueden cambiar o quitarse. En la columna Notas de la versión se enumeran los cambios de cada versión.
| Versión de API | Estable / Versión preliminar | Notas de lanzamiento |
|---|---|---|
| 2026-10-01 | Estable (GA) | Incluye todas las funcionalidades de las versiones de API estables anteriores, con las siguientes adiciones: Administración de mantenimiento: Compatibilidad con la reprogramación del mantenimiento planeado, la aplicación de actualizaciones de mantenimiento disponibles a petición, la visualización del próximo mantenimiento y la recuperación del historial de mantenimiento. Redes: Compatibilidad con la migración de servidores desde la integración de la red virtual (VNet) al acceso público y a redes con compatibilidad para puntos de conexión privados. Cumplimiento de FIPS: Compatibilidad con la creación de servidores con FIPS habilitado y habilitación o deshabilitación de FIPS en servidores existentes. Copias de seguridad inmutables: Compatibilidad con la creación de servidores con copias de seguridad inmutables habilitadas. Actualizaciones de la versión principal: Permite ejecutar comprobaciones de validación previas a la actualización antes de iniciar una actualización de la versión principal de PostgreSQL. Ajuste autónomo: Agrega vacuumTable como opción de ajuste autónomo compatible.Claves administradas por el cliente entre inquilinos (CMK): Compatibilidad con la configuración del cifrado entre inquilinos mediante claves administradas por el cliente, con o sin copias de seguridad con redundancia geográfica habilitadas. Flexibilidad de la versión de PostgreSQL: Quita la restricción de enumeración de versiones de PostgreSQL, lo que permite la creación del servidor y las actualizaciones de versiones principales para admitir versiones de PostgreSQL recién publicadas sin necesidad de actualizar un esquema de API. |
| 2026-07-01-preview | Preview | Incluye todas las funcionalidades de las versiones anteriores de la API, con las siguientes adiciones: PostgreSQL 19: Agrega la versión 19 de PostgreSQL a la enumeración admitida PostgresMajorVersion .Agente de base de datos (DBAgent): Presenta un nuevo recurso DBAgent y las operaciones de administración asociadas. Administración del almacenamiento: Agrega nuevas propiedades de almacenamiento para admitir Premium SSD v2 y la configuración de crecimiento automático del almacenamiento. |
| 2026-04-01-preview | Preview | Incluye todas las funcionalidades de las versiones anteriores de la API, con las siguientes adiciones: Administración de mantenimiento: Presenta la MaintenanceEvent API con operaciones para recuperar detalles de eventos de mantenimiento, enumerar eventos de mantenimiento por servidor, reprogramar el mantenimiento planeado y aplicar actualizaciones de mantenimiento disponibles a petición.Comprobaciones previas de actualización de la versión principal: presenta la API de MajorVersionUpgradePrecheck con las operaciones Get y List by Server, junto con una nueva operación MajorVersionUpgradePrecheck en la API de servidores para iniciar comprobaciones de validación previas a la actualización.Claves administradas por el cliente entre inquilinos (CMK): agrega las propiedades primaryFederatedIdentityClientId y geoBackupFederatedIdentityClientId a la API de servidores para admitir el cifrado de datos entre inquilinos mediante claves administradas por el cliente. |
| 2026-01-01-vista previa | Preview | Incluye todas las funcionalidades de las versiones anteriores de la API, con la siguiente adición: Redes: Compatibilidad con la migración de servidores desde la integración de la red virtual (VNet) al acceso público y a la conectividad compatible con punto de conexión privado. |
| 2025-08-01 | Estable (GA) | Características de disponibilidad general anteriores + Compatibilidad con PG 18 Compatibilidad con PG 17 Agrega compatibilidad para especificar el nombre de base de datos predeterminado en un clúster elástico. Agrega compatibilidad con las recomendaciones de tabla. Corrige los códigos de respuesta HTTP para reflejar lo que puede devolver cada API. Agrega un ejemplo para el cifrado de datos basado en CMK con la actualización automática de la versión de la clave Se agrega un ejemplo para la creación de un servidor en la red virtual propiedad de Microsoft. Cambia el nombre de los archivos para una mejor representación de su contenido Cambia el nombre de los identificadores de operación para mejorar la organización, la claridad y la navegación. Mejora los metadatos de las definiciones locales Mejora las descripciones para lograr coherencia |
| 2025-06-01-preview | Preview | Cambia el nombre de los archivos para una mejor representación de su contenido Cambia el nombre de las operaciones para mejorar la organización, la claridad y la navegación. Agrega un ejemplo para el cifrado de datos basado en CMK con la actualización automática de la versión de la clave Se agrega un ejemplo para la creación de un servidor en la red virtual propiedad de Microsoft. Agrega compatibilidad con las recomendaciones de tabla. Agrega compatibilidad para especificar el nombre de base de datos predeterminado en un clúster elástico. Quita la compatibilidad con la característica de ajuste de parámetros. Mejora las descripciones Mejora los metadatos de las definiciones locales Corrige los códigos de respuesta HTTP para reflejar lo que puede devolver cada API. |
| 2025-01-01-preview | Preview | Agrega compatibilidad con la característica de optimización de parámetros. |
| 2024-11-01-preview | Preview | Ajuste del índice Se han agregado tipos de origen para la migración Compatibilidad con PG 17 Compatibilidad con tipo de almacenamiento UltraSSD_LRS Clústeres elásticos en instancias de servidor flexibles |
| 2024-08-01 | Estable (GA) | Características de disponibilidad general anteriores + Geo + CMK - Revive Dropped Crecimiento automático del almacenamiento Escalado de IOPS Nueva API de funcionalidad de ubicación Copia de seguridad de retención a largo plazo Registros del servidor Migrations Validación previa de la migración Réplicas de lectura: conmutación (intercambio de sitio) Réplicas de lectura: puntos de conexión virtuales Puntos de conexión privados APIs de Azure Defender / Protección contra Amenazas Compatibilidad con PG 16 Compatibilidad con tipos de almacenamiento de PremiumV2_LRS Cambios en la funcionalidad de ubicación para SSDv2 Roles de migración Identificador de recurso de instancia de migración para admitir migraciones de puntos de conexión privados Copia de seguridad a petición Identidad administrada asignada por el sistema |
| 2023-06-01-preview | Preview | Características de disponibilidad general anteriores + Validación previa de la migración Réplicas de lectura: conmutación (intercambio de sitio) Réplicas de lectura: puntos de conexión virtuales Puntos de conexión privados API de Azure Defender\Threat Protection Compatibilidad con PG 16 Compatibilidad con tipos de almacenamiento de PremiumV2_LRS Cambios en la funcionalidad de ubicación para SSDv2 API de uso de cuota |
| 2023-03-01-preview | Preview | Nuevas características de la versión GA (2022-12-01) Geo + CMK Crecimiento automático del almacenamiento Escalado de IOPS Nueva API de funcionalidad de ubicación Azure Defender Registros del servidor Migrations |
| 2022-12-01 | Estable (GA) | Características de disponibilidad general anteriores + EntraID CMK Backups Administrators Replicas GeoRestore MVU |
| 2022-05-01-preview | Preview | CheckMigrationNameAvailability Migrations |
| 2021-06-01 | Estable (GA) | Características de disponibilidad general anteriores + Servidor CRUD CheckNameAvailability Configuraciones (parámetros) Database Reglas de firewall Privada Sufijo de zona DNS Restauración a un momento dado Reinicio del servidor Iniciar el servidor Detención del servidor Ventana de mantenimiento Uso de subredes de red virtual |
Lista de operaciones estables de la API
Cada operación de API estable admitida y sus detalles se enumeran en la tabla siguiente.
| Característica/operación | Detalles |
|---|---|
| Administrators | Administración de administradores de servidores Microsoft Entra ID |
| Protección contra amenazas avanzada | Administrar la configuración de protección avanzada contra amenazas |
| Copia de seguridad y restauración | Administrar copias de seguridad automáticas y a petición del servidor |
| Capabilities | Enumerar las funcionalidades de servidor disponibles por ubicación y servidor |
| Configurations | Ver y administrar los parámetros del servidor PostgreSQL |
| Databases | Crear, leer, actualizar, eliminar y enumerar bases de datos |
| Cifrado de datos | Configuración de claves administradas por el cliente entre inquilinos incluido el cifrado entre inquilinos |
| Reglas de firewall | Creación, lectura, actualización, eliminación y enumeración de reglas de firewall |
| Retención a largo plazo | Administración de operaciones de copia de seguridad de retención a largo plazo |
| Eventos de mantenimiento | Listar, obtener, volver a programar y aplicar eventos de mantenimiento bajo demanda |
| Comprobaciones previas a la actualización de la versión principal | Iniciar comprobaciones de validación previas a la actualización y recuperar los resultados de validación |
| Migrations | Creación y administración de operaciones de migración de bases de datos |
| Disponibilidad del nombre | Comprobación de la disponibilidad del nombre del servidor y del punto de conexión virtual |
| Migración del modo de red | Migración de servidores de Integración con red virtual a una configuración de red compatible con vínculo privado |
| Operations | Enumerar las operaciones de administración del proveedor de recursos disponibles |
| Ajuste del rendimiento | Recuperar opciones de ajuste y recomendaciones de optimización de bases de datos |
| Sufijo de zona de DNS privado | Recuperar el sufijo de zona DNS privada |
| Puntos de conexión privados | Administrar conexiones de puntos de conexión privados |
| Recursos de Enlace Privado | Enumerar recursos de vínculos privados |
| Uso de la cuota | Recuperación de información de uso y cuota del servidor regional |
| Réplicas de lectura | Crear y administrar réplicas de lectura, incluida la promoción y el cambio de rol |
| Servers | Crear, leer, actualizar, eliminar, enumerar, iniciar, detener y reiniciar servidores |
| Puntos de conexión virtuales | Crear y administrar puntos de conexión virtuales |
| Uso de subred de la red virtual | Recuperar la información de uso de subredes de red virtual |
Vista previa de la lista de operaciones de API
En la tabla siguiente se enumera cada operación de API de versión preliminar admitida y sus detalles.
| Característica/operación | Detalles |
|---|---|
| Administrators | Crear, recuperar, enumerar y eliminar administradores de servidor de Microsoft Entra ID |
| Protección contra amenazas avanzada | Recuperar, enumerar y actualizar la configuración avanzada de protección contra amenazas |
| Copia de seguridad y restauración | Crear, recuperar, enumerar y eliminar copias de seguridad a petición; listar las copias de seguridad automáticas disponibles |
| Capabilities | Enumerar las funcionalidades de servidor disponibles por ubicación y servidor |
| Registros capturados | Enumerar los registros de servidor capturados disponibles para su descarga |
| Configurations | Recuperar, enumerar y actualizar parámetros de servidor de PostgreSQL |
| Agentes de base de datos | Enumerar, recuperar, habilitar y deshabilitar configuraciones del agente de base de datos |
| Databases | Crear, recuperar, enumerar y eliminar bases de datos |
| Cifrado de datos | Configuración de claves administradas por el cliente entre inquilinos incluido el cifrado entre inquilinos |
| Reglas de firewall | Crear, recuperar, actualizar, enumerar y eliminar reglas de firewall |
| Retención a largo plazo | Validar los requisitos previos de copia de seguridad, iniciar copias de seguridad de retención a largo plazo y recuperar los resultados de la operación de copia de seguridad |
| Eventos de mantenimiento | Recuperar y enumerar eventos de mantenimiento, filtrar por estado futuro o pasado, volver a programar el mantenimiento y aplicar el mantenimiento inmediatamente |
| Comprobaciones previas a la actualización de la versión mayor | Iniciar comprobaciones de validación previas a la actualización y recuperar o enumerar los resultados de validación |
| Migrations | Crear, recuperar, enumerar, actualizar y cancelar migraciones de bases de datos; validar la disponibilidad del nombre de migración |
| Disponibilidad del nombre | Comprobar la disponibilidad del nombre del servidor y del punto de conexión virtual globalmente o por ubicación |
| Migración del modo de red | Migración de servidores de Integración con red virtual a un modelo de red compatible con vínculo privado |
| Operations | Enumerar las operaciones de administración del proveedor de recursos disponibles |
| Ajuste del rendimiento | Recuperar opciones de ajuste y recomendaciones de optimización de índices o tablas |
| Sufijo de zona de DNS privado | Recuperación del sufijo de zona DNS privada |
| Puntos de conexión privados | Recuperar, enumerar, aprobar, rechazar y eliminar conexiones de endpoint privado |
| Recursos de Enlace Privado | Recuperación y lista de recursos de vínculo privado |
| Uso de la cuota | Recuperar el uso de la cuota regional para servidores flexibles |
| Réplicas de lectura | Crear, listar y administrar réplicas de lectura, incluida la promoción y la conmutación |
| Servers | Crear, recuperar, actualizar, eliminar y enumerar servidores; iniciar, detener y reiniciar servidores |
| Administración del almacenamiento | Configuración de SSD Prémium v2 y el crecimiento automático del almacenamiento a través de propiedades de almacenamiento del servidor |
| Puntos de conexión virtuales | Crear, recuperar, actualizar, enumerar y eliminar puntos de conexión virtuales |
| Uso de la subred de Red virtual | Recuperar información de uso de la subred de la red virtual |
Uso de versiones preliminares de la API de Terraform
Terraform es una herramienta de software de infraestructura como código (IaC) creada por HashiCorp. Los usuarios definen y proporcionan infraestructura del centro de datos mediante un lenguaje de configuración declarativo conocido como HashiCorp Configuration Language (HCL) u, opcionalmente, JSON. Terraform es una manera común de realizar la administración de IaC para Azure Database for PostgreSQL basada en la API de Azure RM de disponibilidad general. Además de las plantillas de Azure Resource Manager (ARM), la comunidad de Terraform publica actualizaciones periódicas para el proveedor de Terraform de Azure Resource Manager (AzureRM) en función de la versión de API de Azure Resource Manager en disponibilidad general (GA).
Si una característica determinada está actualmente en una API en versión preliminar y aún no se incorpora a la API de disponibilidad general y al proveedor de Terraform de AzureRM, use el proveedor de Terraform AzAPI para llamar a la API de versión preliminar directamente desde Terraform. El proveedor de AzAPI es una fina capa sobre las API de REST de Azure Resource Manager. El proveedor AzAPI le permite administrar cualquier tipo de recurso Azure mediante cualquier versión de API. El proveedor de AzAPI es una fina capa sobre las API de REST de Azure ARM. Mediante el proveedor AzAPI, puede administrar cualquier tipo de recurso Azure mediante cualquier versión de API. Este proveedor complementa al proveedor de AzureRM habilitando la administración de nuevos recursos y propiedades de Azure (incluyendo la versión preliminar privada).
El proveedor de AzAPI presenta las siguientes ventajas:
- Admite todos los servicios de Azure:
- Características y servicios de versión preliminar privada
- Características y servicios de versión preliminar pública
- Todas las versiones de API
- Fidelidad completa del archivo de estado de Terraform
- Las propiedades y los valores se guardan en el estado
- Sin dependencia de Swagger
- Autenticación común y coherente de Azure
AzAPI2AzureRM es una herramienta de código abierto diseñada para ayudar a migrar del proveedor AzAPI al proveedor de AzureRM.
Contactos
Para cualquier pregunta o sugerencia que pueda tener en Azure Database for PostgreSQL, envíe un correo electrónico al equipo de Azure Database for PostgreSQL (@Ask Azure Database for PostgreSQL). Tenga en cuenta que esta dirección de correo electrónico no es un alias de soporte técnico.
Además, tenga en cuenta los siguientes puntos de contacto según corresponda:
- Para ponerse en contacto con el servicio de soporte técnico de Azure, presente una incidencia de soporte técnico en Azure Portal.
- Para corregir un problema con la cuenta, envíe una solicitud de soporte técnico en Azure Portal.
- Para proporcionar comentarios o solicitar nuevas características, cree una entrada a través de UserVoice.