# OVHcloud verbinden

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:

| Plattform | In Costfluent | API | Token-Seite |
|---|---|---|---|
| OVHcloud Europe | `ovh-eu` | `eu.api.ovh.com` | `api.eu.ovhcloud.com` |
| OVHcloud North America, für Konten bei ovh.ca | `ovh-ca` | `ca.api.ovh.com` | `ca.api.ovh.com` |
| OVHcloud US | `ovh-us` | `api.us.ovhcloud.com` | `api.us.ovhcloud.com` |

:::caution
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

<Stepper>

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.

</Stepper>

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.

:::note
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](/de/connect/manage-connections#wie-es-sich-verhält)),
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](/de/currency)). 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](/de/connect/manage-connections#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.
