Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo apresenta as últimas notícias e atualizações sobre as versões da API recomendadas para utilizar. As versões da API que não estão aqui listadas podem ser suportadas, mas serão retiradas em breve. A documentação para a versão de pré-visualização mais recente e para a versão estável da API está disponível aqui.
Versões da API
Esta secção resume as alterações de funcionalidades em cada versão da API do Base de Dados do Azure para PostgreSQL.
Note
As versões da API geralmente baseiam-se em versões anteriores, mas as funcionalidades de pré-visualização podem ser alteradas ou removidas. A coluna Notas de Lançamento lista as alterações para cada versão.
| Versão da API | Estável/Pré-visualização | Notas de lançamento |
|---|---|---|
| 2026-10-01 | Estável (GA) | Inclui todas as funcionalidades das versões anteriores da API estável, com as seguintes adições: Gestão de manutenção: Apoio para reagendamento da manutenção planeada, aplicação de atualizações de manutenção disponíveis a pedido, visualização da manutenção futura e recuperação do histórico de manutenção. Rede: Suporte para a migração de servidores da integração com redes virtuais (VNet) para acesso público e rede com suporte para ponto final privado. Conformidade com FIPS: Suporte para criar servidores com FIPS ativado e ativar ou desativar FIPS em servidores existentes. Backups imutáveis: Suporte para criar servidores com backups imutáveis ativados. Atualizações principais de versão: Suporte para execução de verificações de validação pré-atualização antes de iniciar uma atualização maior de versão do PostgreSQL. Afinação autónoma: Adiciona vacuumTable como opção de afinação autónoma suportada.Chaves geridas pelo cliente entre tenants (CMK): Suporte para configuração de encriptação entre tenants usando chaves geridas pelo cliente, com ou sem backups geo-redundantes ativados. Flexibilidade das versões do PostgreSQL: Remove a restrição de enumeração das versões do PostgreSQL, permitindo a criação de servidores e atualizações de versões principais para suportar versões recém-lançadas do PostgreSQL sem necessidade de atualização do esquema da API. |
| 2026-07-01-preview | Preview | Inclui todas as capacidades das versões anteriores da API, com as seguintes adições: PostgreSQL 19: Adiciona o PostgreSQL versão 19 à enumeração suportada PostgresMajorVersion .Agente de Base de Dados (DBAgent): Introduz um novo recurso DBAgent e operações de gestão associadas. Gestão de armazenamento: Adiciona novas propriedades de armazenamento para suportar o SSD Premium v2 e a configuração de crescimento automático de armazenamento. |
| 2026-04-01-preview | Preview | Inclui todas as capacidades das versões anteriores da API, com as seguintes adições: Gestão de manutenção: Introduz a MaintenanceEvent API com operações para recuperar detalhes dos eventos de manutenção, listar eventos de manutenção por servidor, reagendar a manutenção planeada e aplicar atualizações de manutenção disponíveis a pedido.Pré-verificações de atualização de versão principal: Introduz a MajorVersionUpgradePrecheck API com operações Get e List by Server, juntamente com uma nova MajorVersionUpgradePrecheck operação na API de Servidores para iniciar verificações de validação pré-atualização.Chaves geridas pelo cliente entre locatários (CMK): Adiciona as propriedades primaryFederatedIdentityClientId e geoBackupFederatedIdentityClientId à API dos Servidores para suportar a encriptação de dados entre locatários usando chaves geridas pelo cliente. |
| 2026-01-01-preview | Preview | Inclui todas as capacidades das versões anteriores da API, com a seguinte adição: Redes: Suporte para migração de servidores da integração com redes virtuais (VNet) para acesso público e rede compatível com pontos finais privados. |
| 2025-08-01 | Estável (GA) | Funcionalidades anteriores do GA + Apoio ao PG 18 Apoio ao 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 para a criação de servidor na rede virtual de propriedade da Microsoft Renomeia arquivos para melhor representação de seu conteúdo Renomeia IDs de operações para melhorar a organização, clareza e navegação Melhora os metadados das definições locais Melhora as descrições para consistência |
| 2025-06-01-preview | Preview | Renomeia arquivos para melhor representação de seu conteúdo Renomeia operações para melhorar a organização, clareza e navegação Adiciona exemplo de criptografia de dados baseada em CMK com atualização automática da versão da chave Adiciona exemplo para a criação de servidor na 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 suporte para a funcionalidade de afinação de parâmetros Melhora as descrições Melhora os 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 a funcionalidade de ajuste de parâmetros |
| 2024-11-01-preview | Preview | Ajuste de índices Tipos de origem adicionados para migração Suporte para PG 17 Suporte do tipo de armazenamento UltraSSD_LRS Clusters elásticos em instâncias de servidor flexíveis |
| 2024-08-01 | Estável (GA) | Funcionalidades anteriores do GA + Geo + CMK - Revive descontinuado Crescimento automático do armazenamento Dimensionamento IOPS Nova api de capacidade de localização Backup de retenção a longo prazo Registos do Servidor Migrations Pré-validação da migração Réplicas de leitura - Comutação (troca entre sites) Réplicas de leitura - Pontos finais virtuais Pontos finais privados Azure Defender / APIs de proteção contra ameaças Suporte para PG 16 Suporte do tipo de armazenamento PremiumV2_LRS Alterações na capacidade de localização do SSDv2 Funções de migração ID do recurso da instância de migração para suportar migrações de ponto final privado Backup sob demanda Identidade gerenciada atribuída ao sistema |
| 2023-06-01-preview | Preview | Funcionalidades anteriores do GA + Pré-validação da migração Réplicas de leitura - Comutação (troca entre sites) Réplicas de leitura - Pontos finais virtuais Pontos finais privados Azure Defender\APIs de Proteção contra Ameaças Suporte para PG 16 Suporte do tipo de armazenamento PremiumV2_LRS Alterações na capacidade de localização do SSDv2 API de utilização da quota |
| 2023-03-01-preview | Preview | Novos recursos da versão GA (2022-12-01) + Geo + CMK Crescimento automático do armazenamento Dimensionamento IOPS Nova API de capacidade de localização Azure Defender Registos do Servidor Migrations |
| 2022-12-01 | Estável (GA) | Funcionalidades anteriores do GA + EntraID CMK Backups Administrators Replicas GeoRestore MVU |
| 2022-05-01-preview | Preview | VerificarDisponibilidadeDoNomeDaMigração Migrations |
| 2021-06-01 | Estável (GA) | Funcionalidades anteriores do GA + Servidor CRUD CheckNameAvailability Configurações (Parâmetros) Database Regras de firewall Privado Sufixo de zona DNS PITR Reinicialização do servidor Início do servidor Parada do servidor Janela de manutenção Uso da sub-rede de rede virtual |
Lista estável de operações da API
Cada operação de API estável suportada e os seus detalhes estão listados na tabela seguinte.
| Funcionalidade/Operação | Detalhes |
|---|---|
| Administrators | Gerir administradores de servidores Microsoft Entra ID |
| Advanced Threat Protection | Gerir definições avançadas de proteção contra ameaças |
| Backup e Restauro | Gerir backups automáticos e a pedido de servidores |
| Capabilities | Liste as capacidades disponíveis dos servidores por localização e servidor |
| Configurações | Visualizar e gerir os parâmetros do servidor PostgreSQL |
| Databases | Criar, ler, atualizar, eliminar e listar bases de dados |
| Encriptação de Dados | Configurar chaves geridas pelo cliente (CMK), incluindo encriptação entre locatários |
| Regras de firewall | Criar, ler, atualizar, eliminar e listar regras de firewall |
| Retenção a Longo Prazo | Gerir operações de backup de retenção a longo prazo |
| Eventos de Manutenção | Liste, recupere, reagende e aplique eventos de manutenção sob demanda |
| Pré-verificações da atualização de versão principal | Iniciar verificações de validação pré-atualização e recuperar os resultados da validação |
| Migrations | Criar e gerir operações de migração de bases de dados |
| Disponibilidade do nome | Verifique a disponibilidade dos nomes dos servidores e dos endpoints virtuais |
| Migração do Modo de Rede | Migrar servidores da integração com VNet para uma configuração de rede compatível com Private Link |
| Operations | Listar as operações de gestão de fornecedores de recursos disponíveis |
| Otimização do Desempenho | Obter opções de ajuste e recomendações de otimização de bases de dados |
| Sufixo da zona de DNS privado | Recuperar o sufixo da zona DNS privada |
| Pontos finais privados | Gerir conexões de pontos finais privados |
| Recursos do Private Link | Listar recursos de ligação privada |
| Utilização de quotas | Obter a quota e as informações de utilização regionais dos servidores |
| Réplicas de Leitura | Criar e gerir réplicas de leitura, incluindo promoção e comutação |
| Servers | Criar, ler, atualizar, apagar, listar, iniciar, parar e reiniciar servidores |
| Pontos terminais virtuais | Criar e gerir endpoints virtuais |
| Utilização da sub-rede da rede virtual | Recuperar informação de utilização de sub-redes de rede virtual |
Lista de operações da API Preview
A tabela seguinte lista cada operação de API de pré-visualização suportada e os seus detalhes.
| Funcionalidade/Operação | Detalhes |
|---|---|
| Administrators | Criar, recuperar, listar e eliminar administradores de servidores do Microsoft Entra ID |
| Advanced Threat Protection | Recuperar, listar e atualizar definições avançadas de proteção contra ameaças |
| Backup e Restauro | Criar, recuperar, listar e eliminar backups a pedido; listar backups automáticos disponíveis |
| Capabilities | Liste as capacidades disponíveis dos servidores por localização e servidor |
| Registos capturados | Liste os registos capturados do servidor disponíveis para download |
| Configurações | Recuperar, listar e atualizar parâmetros do servidor PostgreSQL |
| Agentes de Base de Dados | Listar, obter, ativar e desativar configurações de agentes de base de dados |
| Databases | Criar, recuperar, listar e eliminar bases de dados |
| Encriptação de Dados | Configurar chaves geridas pelo cliente (CMK), incluindo encriptação entre locatários |
| Regras de firewall | Criar, recuperar, atualizar, listar e eliminar regras de firewall |
| Retenção a Longo Prazo | Validar pré-requisitos de backup, iniciar backups de retenção a longo prazo e recuperar os resultados das operações de backup |
| Eventos de Manutenção | Obter e listar eventos de manutenção, filtrar por estado agendado ou passado, reagendar a manutenção e aplicar manutenção imediatamente |
| Pré-verificações da atualização da versão principal | Iniciar verificações de validação pré-atualização e recuperar ou listar os resultados da validação |
| Migrations | Criar, recuperar, listar, atualizar e cancelar migrações de bases de dados; validar a disponibilidade do nome da migração |
| Disponibilidade do nome | Verifique a disponibilidade dos nomes dos servidores e dos endpoints virtuais globalmente ou por localização |
| Migração do Modo de Rede | Migrar servidores da integração com VNet para um modelo de rede compatível com Private Link |
| Operations | Listar as operações de gestão de provedores de recursos disponíveis |
| Otimização do Desempenho | Recuperar opções de ajuste e recomendações de otimização de índices ou tabelas |
| Sufixo da zona DNS Privado | Recuperar o sufixo da zona DNS privada |
| Pontos finais privados | Recuperar, listar, aprovar, rejeitar e eliminar ligações de ponto final privado |
| Recursos do Private Link | Recuperar e listar recursos de links privados |
| Utilização de quotas | Recuperar a utilização de quotas regionais para servidores flexíveis |
| Réplicas de Leitura | Criar, listar e gerir réplicas de leitura, incluindo promoção e comutação |
| Servers | Criar, recuperar, atualizar, eliminar e listar servidores; iniciar, parar e reiniciar servidores |
| Gestão de Armazenamento | Configure o SSD Premium v2 e o crescimento automático do armazenamento através das propriedades de armazenamento do servidor |
| Pontos terminais virtuais | Criar, recuperar, atualizar, listar e eliminar endpoints virtuais |
| Utilização da sub-rede de rede virtual | Recuperar informação de utilização da sub-rede da rede virtual |
Usando versões de visualização da API do Terraform
Terraform é uma ferramenta de software de infraestrutura como código (IaC) criada pela HashiCorp. Os usuários definem e fornecem infraestrutura de data center usando uma linguagem de configuração declarativa conhecida como HashiCorp Configuration Language (HCL) ou, opcionalmente, JSON. O Terraform é uma maneira comum de executar o gerenciamento de IaC para o Banco de Dados do Azure para PostgreSQL com base na API do Azure RM em Disponibilidade Geral (GA), além dos Modelos do Azure Resource Manager (ARM). A comunidade Terraform lança atualizações regulares para o provedor do Azure Resource Manager Terraform (AzureRM), com base na versão da API do Azure Resource Manager em Disponibilidade Geral (GA).
Se uma funcionalidade específica estiver atualmente numa API de pré-visualização e ainda não estiver incorporada na GA API e no fornecedor AzureRM Terraform, use o fornecedor AzAPI Terraform para chamar a API de pré-visualização diretamente a partir do Terraform. O provedor AzAPI é uma camada fina sobre as APIs REST do Azure Resource Manager. O fornecedor AzAPI permite-lhe gerir qualquer tipo de recurso Azure utilizando qualquer versão da API. O provedor AzAPI é uma camada fina sobre as APIs REST do Azure ARM. Ao usar o fornecedor AzAPI, pode gerir qualquer tipo de recurso Azure usando qualquer versão da API. Este provedor complementa o provedor AzureRM habilitando o gerenciamento de novos recursos e propriedades do Azure (incluindo visualização privada).
O provedor AzAPI apresenta os seguintes benefícios:
- Suporta todos os serviços do Azure:
- Serviços e funcionalidades de pré-visualização privada
- Serviços e funcionalidades de pré-visualização pública
- Todas as versões da API
- Fidelidade total do ficheiro de estado do Terraform
- As propriedades e os valores são guardados no estado
- Sem dependência do Swagger
- Autenticação comum e consistente do Azure
O AzAPI2AzureRM é uma ferramenta open source concebida para ajudar a migrar do fornecedor AzAPI para o fornecedor AzureRM.
Contacts
Para quaisquer perguntas ou sugestões que possa ter na Base de Dados do Azure para PostgreSQL, envie um e-mail para a Equipa da Base de Dados do Azure para PostgreSQL (@Ask Base de Dados do Azure para PostgreSQL). Observe que esse endereço de e-mail não é um alias de suporte técnico.
Além disso, considere os seguintes pontos de contacto, conforme adequado:
- Para contactar o Suporte do Azure, crie um pedido no portal do Azure.
- Para corrigir um problema na sua conta, crie um pedido de suporte no portal do Azure.
- Para enviar comentários ou pedir novas funcionalidades, crie uma entrada através do UserVoice.