Veeam API
Connectez OverView à Veeam Backup & Replication via l'API REST pour récupérer le statut des jobs de sauvegarde et les machines protégées
Le connecteur API Veeam Backup & Replication permet à OverView de récupérer directement depuis votre plateforme Veeam l'inventaire des sauvegardes, le statut des jobs et les machines protégées.
Objectif
Le connecteur récupère les informations suivantes :
- Inventaire des sauvegardes et points de restauration
- Statut des jobs de sauvegarde (succès, échecs, avertissements)
- Machines protégées et couverture de sauvegarde
Prérequis
- Veeam Backup & Replication v12 ou supérieur
- Un compte Veeam Backup Administrator — requis par l'API REST Veeam
- Port 9419 ouvert entre OverView et le serveur VBR
Pourquoi un compte administrateur ? Veeam ne propose pas à ce jour de rôle en lecture seule pour son API REST : l'authentification requiert officiellement le rôle Veeam Backup Administrator. Les rôles moins privilégiés comme Backup Viewer ne sont pas supportés pour l'accès API et échouent sur certains endpoints selon les versions. Veeam a annoncé l'extension du contrôle d'accès par rôles (RBAC) à l'API REST dans une future version. En attendant, nous recommandons un compte de service dédié avec un mot de passe robuste (voir ci-dessous).
Informations à fournir dans OverView
Contactez le support OverSOC pour configurer ce connecteur. Vous devrez fournir :
| Champ | Description |
|---|---|
| URL du serveur | URL de l'API REST du serveur VBR (ex. https://vbr-server.example.com:9419) |
| Nom d'utilisateur | Nom d'utilisateur du compte Veeam Backup Administrator |
| Mot de passe | Mot de passe du compte |
Procédure
Préparer un compte de service
L'authentification à l'API REST Veeam utilise un compte utilisateur existant. Nous recommandons de créer un compte de service dédié plutôt que d'utiliser un compte administrateur personnel :
- Ouvrez la console Veeam Backup & Replication.
- Accédez à Users and Roles (menu ☰ > Users and Roles).
- Ajoutez le compte de service et attribuez-lui le rôle Veeam Backup Administrator.
Vérifier l'accès réseau
La plateforme OverView doit pouvoir joindre le port 9419 de votre serveur VBR. Vérifiez que votre pare-feu autorise les connexions entrantes sur ce port depuis les IP OverView — contactez le support OverSOC pour obtenir la plage d'IP actuelle.
Documentation officielle
Alternative : import par fichiers via DropPoint
L'accès API décrit plus haut est la méthode recommandée pour ce connecteur. Lorsqu'il n'est pas disponible (réseau cloisonné, version ou licence sans API, export déjà produit par ailleurs), OverView accepte des exports de fichiers, à déposer dans le bucket dédié à Veeam Backup & Replication.
Bucket : s3://veeam/
Exemple : s3://veeam/export.csv
La procédure est décrite dans le guide OverView DropPoint : génération des credentials, configuration du client, puis envoi des fichiers depuis l'interface web OverView, l'AWS CLI ou un SDK. Les exemples y sont préremplis avec ce bucket lorsque vous suivez ce lien.