CO2-Fußabdruck Ihrer OVHcloud Dienste einsehen

Ziel

Im Rahmen Ihrer beruflichen Tätigkeit oder aus Interesse an dem Thema müssen Sie möglicherweise den CO2-Fußabdruck Ihrer Dienstleistungen berechnen.

Diese Anleitung erklärt, wie Sie monatlich die CO2-Bilanz Ihrer OVHcloud Dienste ermitteln.

Voraussetzungen

• Ihr Kunden-Account ist der "Rechnungskontakt" für die Dienstleistungen, für die Sie den CO2-Fußabdruck erhalten möchten. Weitere Informationen finden Sie in unserer Anleitung zur Kontaktverwaltung.

Zugriff auf das OVHcloud Kundencenter

• Direkter Link: Zu meinem Account
• Navigationspfad: Klicken Sie oben rechts auf Ihren Namen > Zu meinem Account

Die Berechnung des CO2-Fußabdrucks ist für folgende Dienste verfügbar:

• Dedicated Server (Advance, Game, Scale, High Grade, Storage)
• Eco Dedicated Server (Rise, Kimsufi, So you Start)
• VMware on OVHcloud
• Public Cloud

In der praktischen Anwendung

Dabei sind mehrere Punkte zu beachten:

• Für den laufenden Monat kann keine Bilanz erstellt werden.
• Unabhängig davon, ob Sie über die OVHcloud API ein Datum am Anfang, in der Mitte oder am Ende eines Monats eingeben, berücksichtigt die Bilanz stets vollständige Monate.
• Nach Ablauf der letzten 24 Monate kann keine Bilanz erstellt werden.
• Für jeden OVHcloud Dienst kann vor der Bereitstellung der Funktion keine Bilanz erstellt werden (siehe nachstehende Tabelle).

Verfügbarkeit von CO₂-Fußabdruck-Daten:

Abrufen der monatlichen Bilanz des Vormonats über das OVHcloud Kundencenter

1. Auf dem Mein Account gehen Sie in der linken Spalte nach unten zu Nützliche Links, und klicken Sie dann auf den Tab Meine CO2-Bilanz.
2. Klicken Sie auf der neu geöffneten Seite auf Meinen CO2-Fußabdruck von [Monat] [Jahr] herunterladen.

Sie können jeden Monat die CO2-Bilanz des Vormonats für Ihre wählbaren Dienste abrufen.

Wenn Sie den CO2-Fußabdruck für einen Monat vor dem Vormonat oder eine Bilanz über mehrere Monate benötigen, müssen Sie diese über unsere API abrufen.

Eine Bilanz vor dem Vormonat über unsere API abrufen

Standardmäßig wird die OVHcloud API zur Verfügung gestellt, damit Entwickler oder Integratoren Funktionen, die im OVHcloud Kundencenter vorhanden sind oder darüber hinaus direkt in ihren Anwendungen oder Lösungen kombinieren können.

Schritt 1 - Verbindung zur OVHcloud API

• Besuchen Sie unsere Website OVHcloud API (überprüfen Sie, ob Sie sich auf https://api.eu.ovhcloud.com befinden, wenn Ihre Dienste in Europa gehostet werden, und auf https://api.ca.ovhcloud.com, wenn sie außerhalb Europas gehostet werden).
• Klicken Sie auf der angezeigten Seite auf Explore the OVHcloud API.
• Gehen Sie auf der neu angezeigten Seite und links auf der Seite auf das Formular rechts neben dem Feld v1 und wählen Sie die Option /me aus.
• Suchen Sie in der unten angezeigten Liste der API-Aufrufe nach dem Aufruf, der dem gewünschten Format entspricht, und klicken Sie auf diesen: POST /me/carbonCalculator/pdf für eine Bilanz im PDF-Format oder POST /me/carbonCalculator/csv für eine Bilanz im CSV-Format. Sie können auch direkt auf einen der unten stehenden API-Aufrufe klicken, um darauf zuzugreifen:

• Auf der rechten Seite wird dann der Aufruf mit den zu vervollständigenden Daten angezeigt.
• Klicken Sie oben rechts auf Authenticate und dann auf Login with OVHcloud SSO.
• Das Login-Interface für Ihr OVHcloud Kundencenter wird geöffnet.
• Loggen Sie sich mit Ihrer Kundenkennung ein und klicken Sie auf Authorize, um die OVHcloud API mit Ihren Diensten zu verwenden.
• Sie werden dann automatisch auf die vorherige Seite des gewählten API-Aufrufs weitergeleitet.

Schritt 2 - Bilanzgenerierung anfordern und die ID des angeforderten Tasks abrufen

Je nach gewünschtem Format stehen zwei API-Aufrufe zur Verfügung. Die in diesem Schritt erhaltene taskID liefert eine PDF- oder eine CSV-Datei, je nach dem in Schritt 1 gewählten Aufruf. Wählen Sie den entsprechenden Tab aus.

PDF-Format

CSV-Format

Der API-Aufruf POST /me/carbonCalculator/pdf generiert eine Bilanz für einen einzelnen Monat.

Ersetzen Sie das aktuelle Datum in der Konsole durch ein Datum des Monats, für den Sie die Bilanz erhalten möchten. Beachten Sie das folgende Datumsformat:

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

Der eingegebene Tag ist unerheblich: Unabhängig davon berücksichtigt die Bilanz den gesamten Monat. Der angeforderte Monat darf weder der laufende Monat sein noch mehr als 24 Monate zurückliegen.

Wenn Sie das Datum richtig eingegeben haben, klicken Sie unten rechts im zuvor ausgefüllten Abschnitt auf die blaue Schaltfläche EXECUTE.

Der API-Aufruf POST /me/carbonCalculator/csv generiert eine Bilanz für einen Zeitraum von mehreren Monaten.

Ersetzen Sie die beiden Daten in der Konsole durch den Monat, in dem die Berechnung beginnt, und den Monat, in dem sie endet. Beachten Sie das folgende Datumsformat:

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

Der eingegebene Tag ist unerheblich: Unabhängig davon berücksichtigt die Bilanz vollständige Monate, mindestens jedoch einen Monat. Das Enddatum (endMonth) muss nach dem Startdatum (startMonth) liegen, und das Startdatum darf nicht mehr als 24 Monate zurückliegen.

Wenn Sie beide Daten richtig eingegeben haben, klicken Sie unten rechts im zuvor ausgefüllten Abschnitt auf die blaue Schaltfläche EXECUTE.

Unabhängig vom verwendeten Aufruf erscheint, wenn alles korrekt ausgeführt wurde, im Fenster RESPONSE unten auf der Seite unter der Schaltfläche EXECUTE eine taskID.

Wenn Ihre OVHcloud Kundenkennung beispielsweise aa00000-ovh lautet und Sie eine Bilanz im PDF-Format für den Monat Januar 2025 angefordert haben, erhalten Sie folgendes Ergebnis:

{
  "taskID": "aa00000-ovh_202501"
}

Kopieren Sie nur den Wert der dem Wert unseres Beispiels aa00000-ovh_202501 entspricht (ohne die beiden (") an den Enden zu kopieren).

Schritt 3 - Datei mit der Kohlenstoffbilanz Ihrer Dienstleistungen im PDF- oder CSV-Format abrufen

Dank des zuvor abgerufenen Wertes der taskID (aus dem PDF-Aufruf oder aus dem CSV-Aufruf) können Sie die CO2-Bilanz Ihrer Dienstleistungen abrufen.

In unserer API-Konsole OVHcloud API führen Sie folgende Aktionen aus:

• Gehen Sie auf der linken Seite auf das Formular rechts neben dem Formular v1 und wählen Sie/geben Sie die Option /me ein.
• Suchen Sie in der unten angezeigten Liste der API-Aufrufe nach dem folgenden API-Aufruf, und klicken Sie auf diesen: GET /me/carbonCalculator/task/{taskID}. Sie können auch direkt auf den unten stehenden API-Aufruf klicken, um darauf zuzugreifen:

• Auf der rechten Seite wird dann der API-Aufruf mit einem auszufüllenden Formular angezeigt.

Füllen Sie das Formular im Teil PATH PARAMETERS aus:

• taskID: Kopieren Sie den in Schritt 2 abgerufenen Wert der taskID hier, unabhängig vom angeforderten Format.

Wenn Sie den Wert Ihrer taskID korrekt eingegeben haben, klicken Sie auf den blauen Button EXECUTE.

Das folgende Ergebnis wird im Fenster RESPONSE angezeigt, wenn Sie nach unten auf die Seite unterhalb der Schaltfläche EXECUTE gehen:

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

Kopieren Sie in diesem Ergebnis die gesamte URL inklusive HTTPS rechts neben dem Vermerk "link": und fügen Sie sie in die Adressleiste Ihres Browsers ein, um das Herunterladen der CO2-Bilanz im angeforderten Format zu starten.

Die Datei wird in Ihrem Browser automatisch heruntergeladen und kann bei einer Bilanz im PDF-Format direkt angezeigt werden.

Nach dem Öffnen der Datei enthält sie u.a. folgende Elemente.

In der Bilanz im PDF-Format:

• Eine Tabelle mit einer Übersicht über die CO2-Emissionen nach Kategorien für den beantragten Monat
• Eine Übersicht über die CO2-Emissionen nach Kategorien vom Beginn des Kalenderjahres bis zum beantragten Monat
• Eine Tabelle, in der die Werte nach der Art des abonnierten Produkts aufgeführt sind
• Eine Grafik mit den CO2-Emissionen nach Kategorie

In der Bilanz im CSV-Format:

• Eine Übersicht über die CO2-Emissionen pro physischem Server bzw. pro Serverreihe (PCI) für den bzw. die beantragten Monate

Weiterführende Informationen

Erste Schritte mit der OVHcloud API

Kontaktieren Sie für spezialisierte Dienstleistungen (SEO, Web-Entwicklung etc.) die OVHcloud Partner.

Wenn Sie Hilfe bei der Nutzung und Konfiguration Ihrer OVHcloud Lösungen benötigen, beachten Sie unsere Support-Angebote.

Treten Sie unserer User Community bei.