Vérifier et effectuer une mise à jour mineure PostgreSQL

Vous pouvez vérifier si une mise à jour mineure est disponible pour votre cluster PostgreSQL, puis l'appliquer si souhaité.

info

Une mise à jour mineure correspond à une évolution au sein de la même version majeure de PostgreSQL (par exemple, de 17.2 vers 17.5). Elle inclut des corrections de bugs et des améliorations de stabilité, sans modification de la structure ou de la compatibilité des données.

Permissions

info

Cette action nécessite les permissions IAM (Identity and Access Management) suivantes :

postgresql.cluster.get (pour vérifier la disponibilité)
postgresql.cluster.update (pour effectuer la mise à jour)

Vérifier la disponibilité d'une mise à jour mineure

La requête GET /postgresql/spaces/{spaceId}/clusters/{clusterId}/upgrade/minor permet de vérifier si une mise à jour mineure est disponible pour un cluster PostgreSQL.

Paramètres

Paramètre	Type	Requis	Description
`spaceId`	UUID	Oui	Identifiant de l'espace
`clusterId`	UUID	Oui	Identifiant unique du cluster

Exemple de réponse

{
  "currentVersion": "17.2",
  "targetVersion": "17.5",
  "available": true
}

Champ	Type	Description
`currentVersion`	string	Version mineure actuelle du cluster
`targetVersion`	string	Version mineure cible disponible (`null` si aucune mise à jour n'est disponible)
`available`	boolean	`true` si une mise à jour mineure est disponible, `false` sinon

Effectuer une mise à jour mineure

La requête PUT /postgresql/spaces/{spaceId}/clusters/{clusterId}/upgrade/minor permet de mettre à jour le cluster vers la dernière version mineure disponible pour sa version majeure actuelle.

Paramètres

Paramètre	Type	Requis	Description
`spaceId`	UUID	Oui	Identifiant de l'espace
`clusterId`	UUID	Oui	Identifiant unique du cluster

Exemple de réponse

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "name": "mon-cluster-postgresql",
  "databaseName": "appdb",
  "user": "admin",
  "majorVersion": "17",
  "fullVersion": "17.5",
  "status": {
    "state": "UPGRADING",
    "message": "Cluster is being upgraded"
  },
  "nodeConfiguration": {
    "vcpuCount": 2,
    "memorySizeGiB": 8
  },
  "volume": {
    "type": "GP2",
    "sizeGiB": 100
  },
  "visibility": "EXTERNAL",
  "replicaCount": 1,
  "host": "mon-cluster-postgresql.postgres.eu-west-2.numspot.com",
  "port": 5432,
  "createdOn": "2026-04-05T10:30:00Z"
}

avertissement

La mise à jour mineure déclenche un redémarrage progressif (rolling restart) du cluster. Si vous disposez d'au moins un réplica, la disponibilité du service est préservée.
Assurez-vous que vos applications gèrent correctement les déconnexions temporaires pendant la mise à jour.

Voir la spécification complète

Permissions​

Permissions