Quelle verbinden

OVHcloud verbinden

Fügen Sie einen lesenden API-Schlüssel Ihres OVHcloud-Kontos ein, und Costfluent importiert seine Public-Cloud-Kosten nach Projekt und Monat.

Costfluent liest Ihre Ausgaben für OVHcloud Public Cloud aus der API von OVHcloud, mit einem lesenden API-Schlüssel, den Sie dafür anlegen. Eine Verbindung ist ein OVHcloud-Konto, mit den Kosten jedes seiner Public-Cloud-Projekte.

Wie Costfluent verbindet

Ein API-Schlüssel von OVHcloud besteht aus drei Teilen: einem Application Key, einem Application Secret und einem Consumer Key. Costfluent speichert sie verschlüsselt und signiert damit jede Anfrage an OVHcloud. Es liest das Konto, zu dem der Schlüssel gehört und an dem es die Verbindung erkennt, listet bei jeder Synchronisierung die Public-Cloud-Projekte des Kontos auf und liest die Nutzung jedes Projekts. Der Schlüssel wird nur für diese Verbindung verwendet.

Costfluent lehnt einen Consumer Key ab, der mehr als lesen darf: einen, dessen Rechte eine andere Methode als GET enthalten oder der gar nicht auf benannte Routen beschränkt ist.

OVHcloud betreibt drei Plattformen, jede mit eigenen Konten, eigener API und eigener Token-Seite, auf der API-Schlüssel angelegt werden. Sie wählen die Plattform beim Verbinden, und Costfluent ruft die API dieser Plattform auf:

PlattformIn CostfluentAPIToken-Seite
OVHcloud Europeovh-eueu.api.ovh.comapi.eu.ovhcloud.com
OVHcloud North America, für Konten bei ovh.caovh-caca.api.ovh.comca.api.ovh.com
OVHcloud USovh-usapi.us.ovhcloud.comapi.us.ovhcloud.com

Ein Schlüssel funktioniert nur auf der Plattform, auf der er angelegt wurde. Legen Sie ihn daher auf der Plattform Ihres Kontos an und wählen Sie beim Verbinden dieselbe Plattform. Gelesen werden nur Public-Cloud-Projekte, keine Dedicated Server, Domains oder anderen Dienste von OVHcloud.

Voraussetzungen

  1. Die Organisationsrolle Eigentümer oder Integrationsverantwortliche Person in Costfluent.
  2. Ein OVHcloud-Konto bei OVHcloud Europe, OVHcloud North America oder OVHcloud US. Ein Konto ohne Public-Cloud-Projekt lässt sich verbinden; seine Kosten kommen an, sobald es eines hat.
  3. Ein auf Lesen beschränkter API-Schlüssel, angelegt auf der Token-Seite der Plattform Ihres Kontos (die Tabelle oben), während Sie im Konto angemeldet sind, mit genau drei Rechten: GET /auth/details, GET /cloud/project und GET /cloud/project/*/usage/*. Wählen Sie eine unbegrenzte Gültigkeit: Ein Schlüssel, der abläuft, beendet die Verbindung. Die Seite zeigt danach Application Key, Application Secret und Consumer Key an. Die OVHcloud-Anleitung in der Konsole verlinkt die Token-Seite jeder Plattform mit den drei Rechten schon eingetragen.

Verbinden

  1. Öffnen Sie Einstellungen, dann Integrationen, wählen Sie OVHcloud und öffnen Sie den Tab Verbinden.
  2. Übernehmen Sie unter Anzeigename den vorgeschlagenen Namen oder geben Sie einen eigenen ein, und wählen Sie unter Plattform die Plattform, auf der Sie den Schlüssel angelegt haben: Europa (ovh-eu), Nordamerika (ovh-ca) oder USA (ovh-us). Das Formular öffnet mit Europa.
  3. Fügen Sie Application Key, Application Secret und Consumer Key in ihre Felder ein.
  4. Wählen Sie Verbindung testen, um jede Prüfung zu sehen, oder Verbinden, um zu speichern.

Costfluent liest das Konto des Schlüssels, seine Rechte und die Nutzung eines Projekts im laufenden Monat, bevor es etwas speichert. Eine Verbindung, die sich speichern lässt, kann also Ihre Kosten lesen. Eine Verbindung mit demselben Konto wie eine bestehende wird abgelehnt.

Daten und Aktualität

Die API von OVHcloud bepreist die Public-Cloud-Nutzung pro Kalendermonat, nicht pro Tag. Costfluent zeigt die Kosten eines Projekts für einen Monat daher am ersten Tag dieses Monats. Ansichten nach Monat und länger sind genau; ein Tagesdiagramm zeigt den ganzen Monat an seinem ersten Tag, und tägliche Kosten gibt es für OVHcloud nicht.

Der laufende Monat ist der bisherige Monatsstand von OVHcloud. Jede Synchronisierung ersetzt ihn, so dass seine Kosten im Lauf des Monats wachsen, bis OVHcloud den Monat abschließt.

Beim Verbinden werden Kosten so weit zurück importiert, wie der rückwirkende Import Ihres Plans reicht, höchstens sechs Monate (Verbindungen verwalten), soweit OVHcloud so weit zurück Nutzung meldet. Kosten kommen in der eigenen Währung des Kontos an, etwa EUR, CAD oder USD, und Berichte rechnen sie um wie alle anderen Kosten (Währung). Weicht die Summe von OVHcloud für den Monat eines Projekts von der Summe seiner einzelnen Positionen ab, kommt die Differenz als eine Ausgleichsposition an, so dass jeder Projektmonat der Summe von OVHcloud entspricht.

Berichtsdimensionen

  • Unterkonto ist die ID des Public-Cloud-Projekts.
  • Dienst ist das Public-Cloud-Produkt, etwa Compute Instances, Block Storage, Object Storage oder Managed Kubernetes Service. Der Dienst der Ausgleichsposition ist Public Cloud.
  • SKU ist, was abgerechnet wurde: die Instanzgröße (Flavor), etwa d2-2, der Volume- oder Speichertyp oder ein Ressourcentyp mit seiner Komponente. Die SKU der Ausgleichsposition ist remainder.
  • Region ist die Region, die OVHcloud für die Position angibt.
  • Nutzungseinheit ist die Einheit von OVHcloud, etwa Hours oder GiB-Hours.
  • Ressource ist die ID, die OVHcloud der Instanz, dem Volume, dem Kubernetes-Cluster oder der anderen Ressource gibt, die eine Position abrechnet, bei Object Storage der Name des Buckets; eine Position, die keine nennt, etwa Bandbreite oder ein Snapshot, hat keine Ressource.
  • Das Rechnungskonto ist das OVHcloud-Konto, und der Abrechnungszeitraum ist der Kalendermonat.

Aktualisieren oder trennen

Nach dem Verbinden

Der Tab Verwalten listet die Verbindung unter ihrem Anzeigenamen, mit ihrem OVHcloud-Konto. Über das Zahnrad daneben sehen Sie, ob die Kosten noch lesbar sind, welche Workspaces die Verbindung speist und welche Monate importiert wurden. Prüfungen ausführen führt die Prüfungen auf Anfrage erneut aus.

Zugriff rotieren oder entfernen

Wählen Sie auf der Verbindungsseite Zugangsdaten aktualisieren und fügen Sie einen neuen lesenden Schlüssel desselben Kontos ein, angelegt auf derselben Plattform: Plattform öffnet mit der Plattform der Verbindung. Widerrufen Sie danach den alten Schlüssel bei OVHcloud. Ein Schlüssel eines anderen Kontos wird abgelehnt.

Um die Verbindung aufzugeben, entfernen Sie sie in Costfluent und widerrufen Sie ihren Schlüssel bei OVHcloud. Das Entfernen löscht die von ihr importierten Kosten (Verbindung entfernen).

Fehlerbehebung

  • This consumer key may change your OVHcloud account. Die Meldung erscheint auch in der deutschen Oberfläche auf Englisch. Die Rechte des Consumer Keys umfassen mehr als GET oder sind nicht auf benannte Routen beschränkt. Legen Sie einen Schlüssel mit den Rechten unter Voraussetzungen an.
  • This consumer key's access rules do not allow reading its account. Dem Schlüssel fehlt GET /auth/details. Legen Sie einen Schlüssel mit den Rechten unter Voraussetzungen an.
  • This consumer key may not read Public Cloud usage. Dem Schlüssel fehlt GET /cloud/project oder GET /cloud/project/*/usage/*. Legen Sie einen Schlüssel mit den Rechten unter Voraussetzungen an.
  • OVHcloud refused this key. Einer der drei Werte ist falsch, die gewählte Plattform ist nicht die, auf der der Schlüssel angelegt wurde, der Consumer Key wurde auf der Token-Seite von OVHcloud nie bestätigt, oder er wurde widerrufen oder ist abgelaufen.
  • This key belongs to another organization. Erscheint beim Aktualisieren der Zugangsdaten: Der Schlüssel gehört zu einem anderen OVHcloud-Konto. Verbinden Sie dieses Konto als neue Verbindung.