Lister les backups d'un cluster PostgreSQL

Vous pouvez lister l'ensemble des backups disponibles pour un cluster PostgreSQL.

Types de backups

Il existe deux types de backups :

Type	Description
ON_DEMAND	Backup manuel déclenché par l'utilisateur
AUTO	Backup automatique généré par le système

Permissions

info

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

• postgresql.cluster.get

API

La requête GET /postgresql/spaces/{spaceId}/clusters/{clusterId}/backups permet de lister tous les backups d'un cluster PostgreSQL.

Paramètres

Paramètre	Type	Requis	Description
spaceId	UUID (Universally Unique Identifier)	Oui	Identifiant de l'espace
clusterId	UUID	Oui	Identifiant unique du cluster

Exemple de réponse

{
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "clusterId": "e592a4f6-2e49-46e7-b6d0-248a7711197a",
      "clusterName": "mon-cluster-postgresql",
      "name": "mon-backup",
      "type": "ON_DEMAND",
      "target": "PREFER_STANDBY",
      "status": {
        "state": "SUCCEEDED",
        "message": "Backup completed successfully"
      },
      "startedAt": "2026-04-08T10:00:00Z",
      "completedAt": "2026-04-08T10:30:00Z"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "clusterId": "e592a4f6-2e49-46e7-b6d0-248a7711197a",
      "clusterName": "mon-cluster-postgresql",
      "name": "auto-backup-20260407",
      "type": "AUTO",
      "target": "PREFER_STANDBY",
      "status": {
        "state": "ACTIVE",
        "message": "Backup schedule is active and running"
      },
      "startedAt": "2026-04-07T02:00:00Z",
      "completedAt": "2026-04-07T02:15:00Z"
    }
  ]
}

Champs de réponse

Champ	Type	Description
id	UUID	Identifiant unique du backup
clusterId	UUID	Identifiant du cluster source
clusterName	string	Nom du cluster source
name	string	Nom du backup
type	string	Type de backup (ON_DEMAND ou AUTO)
target	string	Nœud cible pour l'exécution du backup (PREFER_STANDBY, STANDBY ou PRIMARY)
status	object	État actuel du backup
startedAt	string (date-time)	Date de début du backup
completedAt	string (date-time)	Date de fin du backup (null si en cours)

États des backups

État	Description	Applicable à
CREATING	Demande de backup soumise, pas encore démarré	ON_DEMAND, AUTO
RUNNING	Backup en cours (backups on-demand)	ON_DEMAND
ACTIVE	Planning de backup actif et en cours d'exécution (backups automatiques)	AUTO
SUCCEEDED	Backup terminé avec succès (backups on-demand)	ON_DEMAND
FAILED	Échec du backup	ON_DEMAND, AUTO
DELETING	Backup en cours de suppression	ON_DEMAND

Voir la spécification complète