Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo fornece as últimas notícias e atualizações sobre as versões de API recomendadas a serem usadas. As versões de API que não estão listadas aqui podem ser suportadas, mas serão desativadas em breve. Localize a documentação da versão preliminar mais recente e da versão da API estável disponível aqui.
Versões da API
Esta seção resume as alterações de recurso em cada versão da API Banco de Dados do Azure para PostgreSQL.
Note
As versões de API geralmente se baseiam em versões anteriores, mas os recursos de visualização podem ser alterados ou removidos. A coluna Notas de Versão lista as alterações para cada versão.
| Versão da API | Estável/Versão prévia | Notas de Lançamento |
|---|---|---|
| 2026-10-01 | Estável (GA) | Inclui todos os recursos de versões de API estáveis anteriores, com as seguintes adições: Gerenciamento de manutenção: Suporte para reagendar a manutenção planejada, aplicar atualizações de manutenção disponíveis sob demanda, exibir a manutenção futura e recuperar o histórico de manutenção. Conectividade de rede: Suporte para migrar servidores da integração de rede virtual (VNet) para acesso público e rede com capacidade de endpoint privado. Conformidade fips: Suporte para criar servidores com FIPS habilitado e habilitando ou desabilitando o FIPS em servidores existentes. Backups imutáveis: Suporte para a criação de servidores com backups imutáveis habilitados. Atualizações de versão principais: Suporte para executar verificações de validação de pré-atualização antes de iniciar uma atualização de versão principal do PostgreSQL. Ajuste autônomo: Adiciona vacuumTable como uma opção de ajuste autônomo com suporte.CMK (chaves gerenciadas pelo cliente entre locatários): Suporte para configurar a criptografia entre locatários usando chaves gerenciadas pelo cliente, com ou sem backups com redundância geográfica habilitados. Flexibilidade de versão do PostgreSQL: Remove a restrição de enumeração de versão do PostgreSQL, permitindo a criação do servidor e atualizações de versão principais para dar suporte a versões recém-lançadas do PostgreSQL sem a necessidade de uma atualização de esquema de API. |
| 2026-07-01-preview | Preview | Inclui todos os recursos das versões anteriores da API, com as seguintes adições: PostgreSQL 19: Adiciona o PostgreSQL versão 19 à enumeração PostgresMajorVersion compatível.Agente de Banco de Dados (DBAgent): Apresenta um novo recurso DBAgent e operações de gerenciamento associadas. Gerenciamento de armazenamento: Adiciona novas propriedades de armazenamento para dar suporte à configuração de crescimento automático de armazenamento e SSD Premium v2. |
| 2026-04-01-preview | Preview | Inclui todos os recursos das versões anteriores da API, com as seguintes adições: Gerenciamento de manutenção: Apresenta a MaintenanceEvent API com operações para recuperar detalhes do evento de manutenção, listar eventos de manutenção por servidor, reagendar a manutenção planejada e aplicar atualizações de manutenção disponíveis sob demanda.Pré-verificações de atualização de versão principal: apresenta a API MajorVersionUpgradePrecheck com operações Obter e Listar por Servidor, junto com uma nova operação MajorVersionUpgradePrecheck na API de Servidores para iniciar verificações de validação de pré-atualização.CMK (chaves gerenciadas pelo cliente entre locatários): Adiciona primaryFederatedIdentityClientId e geoBackupFederatedIdentityClientId propriedades à API de Servidores para dar suporte à criptografia de dados entre locatários usando chaves gerenciadas pelo cliente. |
| 2026-01-01-preview | Preview | Inclui todos os recursos das versões anteriores da API, com a seguinte adição: Conectividade de rede: Suporte para migrar servidores da integração de rede virtual (VNet) para acesso público e rede com capacidade de endpoint privado. |
| 2025-08-01 | Estável (GA) | Recursos de GA anteriores + Suporte para PG 18 Suporte para PG 17 Adiciona suporte para especificar o nome do banco de dados padrão em um Cluster Elástico Adiciona suporte para recomendações de tabela Corrige códigos de resposta HTTP para refletir o que cada API pode retornar Adiciona exemplo de criptografia de dados baseada em CMK com atualização automática da versão da chave Adiciona exemplo de criação de servidor em rede virtual de propriedade da Microsoft Renomeia arquivos para melhor representação de seu sumário Renomeia IDs de operação para melhorar a organização, a clareza e a navegação Melhora metadados das definições locais Aprimora as descrições para torná-las consistentes |
| 2025-06-01-preview | Preview | Renomeia arquivos para melhor representação de seu sumário Renomeia operações para melhorar a organização, a clareza e a navegação Adiciona exemplo de criptografia de dados baseada em CMK com atualização automática da versão da chave Adiciona exemplo de criação de servidor em rede virtual de propriedade da Microsoft Adiciona suporte para recomendações de tabela Adiciona suporte para especificar o nome do banco de dados padrão em um Cluster Elástico Remove o suporte ao recurso de ajuste de parâmetros Melhora descrições Melhora metadados das definições locais Corrige códigos de resposta HTTP para refletir o que cada API pode retornar |
| 2025-01-01-preview | Preview | Adiciona suporte para o recurso de ajuste de parâmetro |
| 2024-11-01-preview | Preview | Ajuste do índice Tipos de origem adicionados para migração Suporte a PG 17 Suporte ao tipo de armazenamento UltraSSD_LRS Clusters elásticos em instâncias de servidor flexíveis |
| 2024-08-01 | Estável (GA) | Recursos de GA anteriores + Geo + CMK - Revive Descartado Aumento automático do armazenamento Escala de IOPS Nova API de funcionalidade de localização Backup de retenção de longo prazo Logs do servidor Migrations Pré-validação de migração Réplicas de leitura – Alternância (troca de site) Réplicas de leitura – Pontos de Extremidade Virtuais Pontos de extremidade privados APIs do Azure Defender/Proteção contra Ameaças Suporte a PG 16 suporte ao tipo de armazenamento PremiumV2_LRS Alterações na funcionalidade de localização do SSDv2 Funções de migração ID do recurso da instância de migração para dar suporte Às Migrações de ponto de extremidade privado Backup sob demanda Identidade gerenciada atribuída ao sistema |
| 2023-06-01-preview | Preview | Recursos de GA anteriores + Pré-validação de Migração Réplicas de leitura – Alternância (troca de site) Réplicas de leitura – Pontos de Extremidade Virtuais Pontos de extremidade privados APIs do Azure Defender\Proteção contra Ameaças Suporte a PG 16 suporte ao tipo de armazenamento PremiumV2_LRS Alterações na funcionalidade de localização do SSDv2 API de Uso de Cota |
| 2023-03-01-preview | Preview | Novos recursos de versão de disponibilidade geral (2022-12-01) + Geo + CMK Aumento automático do armazenamento Escala de IOPS Nova API de capacidade de localização Azure Defender Logs do servidor Migrations |
| 2022-12-01 | Estável (GA) | Recursos de GA anteriores + EntraID CMK Backups Administrators Replicas GeoRestore MVU |
| 2022-05-01-preview | Preview | CheckMigrationNameAvailability Migrations |
| 2021-06-01 | Estável (GA) | Recursos de GA anteriores + Servidor CRUD CheckNameAvailability Configurações (parâmetros) Base de dados Regras de firewall Privada Sufixo da zona DNS PITR Reinicialização do servidor Inicialização do servidor Parada do servidor Período de manutenção Uso da sub-rede da rede virtual |
Lista de operações de API estável
Cada operação de API estável com suporte e seus detalhes são listados na tabela a seguir.
| Recurso/Operação | Detalhes |
|---|---|
| Administrators | Gerenciar administradores de servidor Microsoft Entra ID |
| Proteção Avançada contra Ameaças | Gerenciar configurações avançadas de proteção contra ameaças |
| Backup e restauração | Gerenciar backups automáticos e sob demanda do servidor |
| Funcionalidades | Listar capacidades de servidor disponíveis por local e servidor |
| Configurações | Exibir e gerenciar parâmetros do servidor PostgreSQL |
| Bancos de dados | Criar, ler, atualizar, excluir e listar bancos de dados |
| Criptografia de dados | Configurar CMK (chaves gerenciadas pelo cliente), incluindo criptografia entre tenants |
| Regras de firewall | Criar, ler, atualizar, excluir e listar regras de firewall |
| Retenção de longo prazo | Gerenciar operações de backup de retenção de longo prazo |
| Eventos de manutenção | Listar, recuperar, reagendar e aplicar eventos de manutenção sob demanda |
| Pré-verificações para upgrade de versão principal | Iniciar verificações de validação de pré-atualização e recuperar resultados de validação |
| Migrations | Criar e gerenciar operações de migração de banco de dados |
| Disponibilidade de nomes | Verificar a disponibilidade do servidor e do nome do endpoint virtual |
| Migração do modo de rede | Migrar servidores da integração de VNet para uma configuração de rede compatível com Link Privado |
| Operações | Listar as operações de gerenciamento disponíveis do provedor de recursos |
| Ajuste de desempenho | Recuperar opções de ajuste e recomendações de otimização de banco de dados |
| Sufixo da zona DNS privada | Recuperar o sufixo de zona DNS privado |
| Pontos de extremidade privados | Gerenciar conexões de ponto de extremidade privado |
| Recursos de Links Privados | Listar recursos de link privado |
| Uso da cota | Recuperar informações de cota e uso do servidor regional |
| Réplicas de leitura | Criar e gerenciar réplicas de leitura, incluindo promoção e alternância |
| Servidores | Criar, ler, atualizar, excluir, listar, iniciar, parar e reiniciar servidores |
| Endpoints virtuais | Criar e gerenciar pontos de extremidade virtuais |
| Uso da sub-rede da rede virtual | Recuperar informações de uso de sub-rede de rede virtual |
Lista de operações da API da versão preliminar
A tabela a seguir lista cada operação de API de visualização com suporte e seus detalhes.
| Recurso/Operação | Detalhes |
|---|---|
| Administrators | Criar, recuperar, listar e excluir administradores de servidor Microsoft Entra ID |
| Proteção Avançada contra Ameaças | Recuperar, listar e atualizar configurações avançadas de proteção contra ameaças |
| Backup e restauração | Criar, recuperar, listar e excluir backups sob demanda; listar backups automáticos disponíveis |
| Funcionalidades | Listar capacidades do servidor disponíveis por local e servidor |
| Logs capturados | Listar logs de servidor capturados disponíveis para download |
| Configurações | Recuperar, listar e atualizar parâmetros do servidor PostgreSQL |
| Agentes de banco de dados | Listar, recuperar, habilitar e desabilitar configurações do agente de banco de dados |
| Bancos de dados | Criar, recuperar, listar e excluir bancos de dados |
| Criptografia de dados | Configurar CMK (chaves gerenciadas pelo cliente), incluindo criptografia entre locatários |
| Regras de firewall | Criar, recuperar, atualizar, listar e excluir regras de firewall |
| Retenção de longo prazo | Validar pré-requisitos de backup, iniciar backups de retenção de longo prazo e recuperar resultados da operação de backup |
| Eventos de manutenção | Recuperar e listar eventos de manutenção, filtrar por status futuro ou passado, reagendar a manutenção e aplicar a manutenção imediatamente |
| Pré-verificações de atualização de versão principal | Iniciar verificações de validação de pré-atualização e recuperar ou listar resultados de validação |
| Migrations | Criar, recuperar, listar, atualizar e cancelar migrações de banco de dados; validar a disponibilidade do nome da migração |
| Disponibilidade de nomes | Verificar a disponibilidade de nome do servidor e do endpoint virtual globalmente ou por local |
| Migração do modo de rede | Migrar servidores da integração de VNet para um modelo de rede compatível com Link Privado |
| Operações | Listar as operações de gerenciamento do provedor de recursos disponíveis |
| Ajuste de desempenho | Recuperar opções de ajuste e recomendações de otimização de índice ou tabela |
| Sufixo da zona DNS privada | Obter o sufixo da zona DNS privada |
| Pontos de extremidade privados | Recuperar, listar, aprovar, rejeitar e excluir conexões de endpoint privado |
| Recursos de Links Privados | Recuperar e listar recursos de link privado |
| Uso da cota | Recuperar o uso de cota regional para servidores flexíveis |
| Réplicas de leitura | Criar, listar e gerenciar réplicas de leitura, incluindo promoção e alternância |
| Servidores | Criar, recuperar, atualizar, excluir e listar servidores; iniciar, parar e reiniciar servidores |
| Gerenciamento de Armazenamento | Configurar o SSD Premium v2 e o crescimento automático do armazenamento por meio de propriedades de armazenamento do servidor |
| Endpoints virtuais | Criar, recuperar, atualizar, listar e excluir pontos de extremidade virtuais |
| Uso da sub-rede da rede virtual | Recuperar informações de uso de sub-rede de rede virtual |
Usando versões prévias da API do Terraform
O Terraform é uma ferramenta de software IaC (infraestrutura como código) criada pela HashiCorp. Os usuários definem e fornecem infraestrutura de data center usando uma linguagem de configuração declarativa conhecida como HCL (Linguagem de Configuração HashiCorp) ou, opcionalmente, JSON. O Terraform é uma maneira comum de realizar o gerenciamento de IaC para o Banco de Dados do Azure para PostgreSQL com base na API do Azure RM em GA, além das Modelos do Azure Resource Manager (ARM). A comunidade do Terraform lança atualizações regulares para o provedor Terraform do Azure Resource Manager (AzureRM) com base na versão da API do Azure Resource Manager em Disponibilidade Geral (GA).
Se um recurso específico estiver atualmente em uma API de visualização e ainda não estiver incorporado à API ga e ao provedor terraform do AzureRM, use o provedor Terraform da AzAPI para chamar a API de visualização diretamente do Terraform. O provedor AzAPI é uma camada fina sobre as APIs REST do Azure Resource Manager. O provedor de AzAPI permite que você gerencie qualquer tipo de recurso Azure usando qualquer versão da API. O provedor AzAPI é uma camada fina sobre as APIs REST do Azure ARM. Usando o provedor AzAPI, você pode gerenciar qualquer tipo de recurso Azure usando qualquer versão da API. Esse provedor complementa o provedor do AzureRM habilitando o gerenciamento de novos recursos e propriedades do Azure (incluindo a versão prévia privada).
O provedor AzAPI apresenta os seguintes benefícios:
- Suporte a todos os serviços do Azure:
- Recursos e serviços de versão prévia privada
- Recursos e serviços de visualização pública
- Todas as versões da API
- Fidelidade total do arquivo de estado do Terraform
- Propriedades e valores são salvos no estado
- Nenhuma dependência do Swagger
- Autenticação comum e consistente do Azure
O AzAPI2AzureRM é uma ferramenta de software livre projetada para ajudar a migrar do provedor AzAPI para o provedor do AzureRM.
Contatos
Para qualquer pergunta ou sugestão que tenha sobre o Azure Database para PostgreSQL, envie um email para a equipe do Azure Database para PostgreSQL (@Ask Azure Database para PostgreSQL). Observe que esse endereço de email não é um alias de suporte técnico.
Além disso, considere os seguintes pontos de contato, conforme apropriado:
- Para entrar em contato com o Suporte do Azure, abra um chamado no portal do Azure.
- Para corrigir um problema com sua conta, registre uma solicitação de suporte no portal do Azure.
- Para fornecer comentários ou solicitar novos recursos, crie uma entrada por meio do UserVoice.