Connect an OVH Public Cloud project

PruneOps needs a read-only OVH API application (application key + secret + consumer key) to inventory instances, volumes and DNS zones in your OVH Public Cloud project. Object Storage uses separate S3-compatible credentials.

How it works

Two independent credential sets, both read-only.

01
Application key/secret

Generated once at eu.api.ovh.com/createApp and saved to the account — no consumer key needed yet at this step.

02
Consumer key

Generated in one click from the account's Credentials tab, scoped to read-only GET on /cloud/project/* and /domain/zone/*. Becomes usable only after you approve it at the OVH link shown.

03
Object Storage

A separate S3-compatible access key / secret key pair, generated per Object Storage endpoint from the OVH control panel, covers bucket inventory.

Classic API credentials

Covers instances, volumes and DNS zones.

  1. Create an application at eu.api.ovh.com/createApp. This gives you an Application Key and Application Secret.
  2. Go to Organization → Integrations → Cloud Accounts → Add Account, pick OVHcloud, and save the Application Key / Application Secret above (leave the Consumer Key field empty for now).
  3. On the account's Credentials tab, click Generate Consumer Key. This requests a key scoped to read-only GET access on /cloud/project/*, /domain/* and /service/* and saves it immediately.
  4. A dialog opens with a link to OVH — open it and approve the requested permissions. The key isn't usable until you do this step.
    Click Generate Consumer Key only once and validate it right away — clicking it again before validating replaces the pending key with a new one, silently invalidating the link you were about to open.

Public Cloud project ID

Required for instance and volume collection.

Once the Consumer Key is validated, find your Public Cloud project ID (service_name) either in the OVH Control Panel under Public Cloud → Project, or by calling the API directly:

GET /cloud/project/

Returns a list with a single project ID for most accounts. Paste it into the Public Cloud Project ID field and save.

Domain renewal pricing

DNS zone hosting is free at OVH — the monthly cost shown for a domain is its yearly registration/renewal price divided by 12, resolved live via the API. This needs the broader /domain/* and /service/* scope above; if you generated your Consumer Key before this scope was added, regenerate it (previous step) to see real domain pricing instead of a flat estimate.

Object Storage credentials (optional)

S3-compatible, generated independently of the classic API keys above.

  1. In the OVH Control Panel, open the Object Storage container you want to inventory and generate an S3 access key / secret key pair.
  2. Add them to the same cloud account under S3 Access Key / S3 Secret Key, along with the endpoint region (e.g. GRA, SBG, RBX).

First sync

Once the account is saved, inventory runs on the next hourly cycle — or trigger it immediately from the account's detail page. Discovered instances, volumes, buckets and DNS zones appear under Audit → OVH.