Comment obtenir l'empreinte carbone de vos services OVHcloud

Objectif

Dans le cadre de vos activités professionnelles ou par intérêt sur le sujet, vous pouvez être amené à devoir calculer l'empreinte carbone de vos services.

Découvrez comment récupérer mensuellement l'empreinte carbone de vos services OVHcloud.

Prérequis

• Être contact « Facturation » des services pour lesquels vous souhaitez obtenir l'empreinte carbone. Pour plus d'informations, consultez notre guide sur la gestion des contacts.

Accès à l'espace client OVHcloud

• Lien direct : Mon compte
• Pour accéder à vos services : Cliquez sur votre nom en haut à droite > Mon compte

Le calcul de l'empreinte carbone est disponible pour les services suivants :

• Serveur Dédié (Advance, Game, Scale, High Grade, Storage)
• Serveur Dédié Eco (Rise, Kimsufi, So you Start)
• VMware on OVHcloud
• Public Cloud

En pratique

Plusieurs points sont à prendre en compte :

• Vous ne pouvez pas générer de bilan pour le mois en cours.
• Quelles que soient les dates saisies via l'API OVHcloud (début, milieu ou fin de mois), le bilan prend toujours en compte des mois complets.
• Aucun bilan ne peut être généré au-delà des 24 derniers mois.
• Aucun bilan ne peut être généré pour la période précédant la date de mise en place de la fonctionnalité pour chaque service OVHcloud (voir le tableau ci-dessous).

Disponibilité des données d'empreinte carbone :

Récupérer le bilan mensuel du mois précédent via l'espace client OVHcloud

1. Sur le Mon compte, dans la colonne de gauche, descendez jusqu'à la section contenant les Liens utiles, puis cliquez sur l'onglet Mon bilan carbone.
2. Sur la nouvelle page qui apparaît, cliquez sur Télécharger mon empreinte de [Mois] [Année].

Vous pourrez récupérer chaque mois l'empreinte carbone du mois précédent pour vos services éligibles.

Si vous avez besoin de l'empreinte carbone pour un mois antérieur au mois précédant le mois en cours, ou d'un bilan couvrant plusieurs mois, vous devrez obligatoirement passer par nos API pour le récupérer.

Récupérer un bilan antérieur au mois précédent via nos API

Par défaut, les API OVHcloud sont mises à disposition pour permettre aux développeurs ou aux intégrateurs d'associer, par exemple, des fonctionnalités présentes ou non dans l'espace client OVHcloud directement dans leurs applications ou solutions.

Étape 1 - Se connecter à l'API OVHcloud

• Rendez-vous sur notre site API OVHcloud (vérifiez bien que vous êtes sur https://api.eu.ovhcloud.com si vos services sont hébergés en Europe et sur https://api.ca.ovhcloud.com s'ils sont hébergés en dehors de l'Europe).
• Sur la page qui s'affiche, cliquez sur Explore the OVHcloud API.
• Sur la nouvelle page qui apparaît et dans la partie gauche de la page, positionnez-vous sur le formulaire situé à droite du champ v1, puis sélectionnez/saisissez le choix /me.
• Parmi la liste d'appels API qui apparaît en dessous, recherchez et cliquez sur l'appel API correspondant au format souhaité : POST /me/carbonCalculator/pdf pour un bilan au format PDF, ou POST /me/carbonCalculator/csv pour un bilan au format CSV. Vous pouvez aussi cliquer directement sur l'un des appels API ci-dessous pour y accéder :

• Sur la partie droite de la page s'affiche alors l'API avec son encadré à compléter.
• Cliquez sur le bouton situé en haut à droite intitulé Authenticate, puis sur le bouton Login with OVHcloud SSO.
• La page de connexion de l'espace client OVHcloud s'ouvre.
• Connectez-vous avec votre identifiant client, puis cliquez sur Authorize pour utiliser les API OVHcloud avec vos services.
• Vous êtes ensuite automatiquement redirigé vers la page précédente de l'appel API choisi.

Étape 2 - Demander la génération du bilan et récupérer l'ID de la tâche demandée

Deux appels API sont disponibles, selon le format de bilan souhaité. Le taskID obtenu à cette étape produira un PDF ou un CSV selon l'appel choisi à l'étape 1. Sélectionnez l'onglet correspondant.

Format PDF

Format CSV

L'appel API POST /me/carbonCalculator/pdf génère un bilan portant sur un seul mois.

Remplacez la date du jour qui apparaît dans l'encadré de l'API par une date du mois pour lequel vous souhaitez obtenir le bilan. Veuillez respecter le format de date suivant :

{
  "month": "YYYY-MM-DD"
}

Le jour saisi n'a pas d'importance : quel qu'il soit, le bilan prend en compte le mois complet. Le mois demandé ne peut pas être le mois en cours, ni remonter au-delà des 24 derniers mois.

Une fois la date choisie et correctement saisie, cliquez sur le bouton bleu EXECUTE situé en bas à droite de la section préalablement remplie.

L'appel API POST /me/carbonCalculator/csv génère un bilan portant sur une plage de mois.

Remplacez les deux dates qui apparaissent dans l'encadré de l'API par le mois de début et le mois de fin du calcul. Veuillez respecter le format de date suivant :

{
  "endMonth": "YYYY-MM-DD",
  "startMonth": "YYYY-MM-DD"
}

Le jour saisi n'a pas d'importance : quel qu'il soit, le bilan prend en compte des mois complets, avec un mois au minimum. La date de fin (endMonth) doit être postérieure à la date de début (startMonth), et la date de début ne peut pas remonter au-delà des 24 derniers mois.

Une fois les deux dates correctement saisies, cliquez sur le bouton bleu EXECUTE situé en bas à droite de la section préalablement remplie.

Quel que soit l'appel utilisé, si tout a été effectué correctement, un taskID apparaît dans la fenêtre RESPONSE lorsque vous descendez sur la page, en dessous du bouton EXECUTE.

Par exemple, si votre identifiant client OVHcloud est aa00000-ovh et que vous avez demandé un bilan au format PDF pour le mois de janvier 2025, alors vous obtiendrez le résultat suivant :

{
  "taskID": "aa00000-ovh_202501"
}

Copiez uniquement la valeur obtenue de votre côté et équivalente à la valeur de notre exemple aa00000-ovh_202501 (sans copier les deux " situés aux extrémités).

Étape 3 - Récupérer le fichier contenant le bilan carbone de vos services au format PDF ou CSV

Grâce à la valeur du taskID précédemment récupérée (via l'appel PDF ou via l'appel CSV), vous pourrez récupérer le bilan carbone de vos services.

Restez sur notre site API OVHcloud et effectuez les actions suivantes :

• Dans la partie gauche de la page, positionnez-vous sur le formulaire situé à droite du formulaire v1, puis sélectionnez/saisissez le choix /me.
• Parmi la liste d'appels API qui apparaît en dessous, recherchez et cliquez sur l'appel API suivant : GET /me/carbonCalculator/task/{taskID}. Vous pouvez aussi cliquer directement sur l'appel API ci-dessous pour y accéder :

• Sur la partie droite de la page s'affiche alors l'appel API avec un formulaire à remplir.

Remplissez le formulaire de la partie PATH PARAMETERS ainsi :

• taskID : copiez ici la valeur du taskID récupérée lors de l'étape 2, quel que soit le format demandé.

Une fois la valeur de votre taskID correctement saisie, cliquez sur le bouton bleu EXECUTE.

Le résultat suivant apparaît dans la fenêtre RESPONSE lorsque vous descendez sur la page, en dessous du bouton EXECUTE :

{
  "link": "Find here the complete URL to download the carbon footprint",
  "status": "SUCCESS",
  "taskID": "aa00000-ovh_202501"
}

Dans ce résultat, copiez l'intégralité de l'URL en HTTPS (sans les guillemets) présente à droite de la mention "link":, puis collez-la dans la barre d'adresse de votre navigateur Internet pour initier le téléchargement du bilan carbone au format demandé.

Votre navigateur Internet télécharge automatiquement le fichier et peut l'afficher directement dans le cas d'un bilan au format PDF.

Une fois le fichier ouvert, vous y trouverez notamment les éléments suivants.

Dans le bilan au format PDF :

• Un tableau récapitulatif des émissions de CO2 par catégorie pour le mois demandé.
• Un tableau récapitulatif des émissions de CO2 par catégorie entre le début de l'année civile et le mois demandé.
• Un tableau détaillant les valeurs par type de produit souscrit.
• Un graphique présentant les émissions de CO2 par catégorie.

Dans le bilan au format CSV :

• Le récapitulatif des émissions de CO2 par serveur physique, ou par gamme de serveurs (PCI), pour le ou les mois demandés.

Aller plus loin

Premiers pas avec les API OVHcloud

Pour des prestations spécialisées (référencement, développement, etc.), contactez les partenaires OVHcloud.

Si vous souhaitez bénéficier d'une assistance à l'usage et à la configuration de vos solutions OVHcloud, nous vous proposons de consulter nos différentes offres de support.

Échangez avec notre communauté d'utilisateurs.