HYPHApar S33D
Documentation › Intégrations

Clouds AWS, Azure, Google Cloud, OVHcloud et Scaleway

Un agent lit l'API du fournisseur avec un compte en lecture seule. Les instances deviennent des ressources dans HYPHA, à côté de vos hôtes.

Principe

AWS

Lecture d'EC2, d'EBS, des alarmes CloudWatch et de l'identité du compte, par une politique IAM en lecture seule :

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Action": ["ec2:DescribeInstances", "ec2:DescribeInstanceStatus", "ec2:DescribeVolumes",
               "cloudwatch:DescribeAlarms", "sts:GetCallerIdentity"],
    "Resource": "*"
  }]
}
integrations:
  aws:
    access_key_id: AKIA…
    secret_access_key: "…"
    regions: [eu-west-3, eu-central-1]
    interval: 5m
    metrics: false

Azure

Un principal de service au rôle Lecteur sur chaque abonnement suivi :

az ad sp create-for-rbac --name hypha-lecture --role Reader --scopes /subscriptions/<id-abonnement>
integrations:
  azure:
    tenant_id: "…"
    client_id: "…"
    client_secret: "…"
    subscriptions: ["<id-abonnement>"]

Google Cloud

Un compte de service au rôle Lecteur de Compute (roles/compute.viewer) et sa clé JSON, dans un fichier à part :

integrations:
  gcp:
    credentials_file: /etc/hypha/gcp-lecture.json   # 600, root
    projects: [mon-projet]

Les instances de toutes les zones du projet : état, type, adresses (gcp.instance.status). Une instance que Google répare (REPAIRING) passe en critique.

OVHcloud

Une application de l'API OVHcloud et une clé « consumer » limitée aux lectures : droits GET sur /dedicated/server*, /ip* et /domain*.

integrations:
  ovhcloud:
    endpoint: https://eu.api.ovh.com/1.0
    application_key: "…"
    application_secret: "…"
    consumer_key: "…"
    interval: 15m

Ce que l'agent d'une machine ne voit pas :

Seuls des GET partent, espacés de 200 ms ; 5 minutes au moins entre deux passages.

Scaleway

La clé d'API d'un membre IAM aux droits InstancesReadOnly et ElasticMetalReadOnly :

integrations:
  scaleway:
    secret_key: "…"
    zones: [fr-par-1, fr-par-2, nl-ams-1]

Par zone : les instances (état, verrouillage, maintenances planifiées) et les serveurs Elastic Metal (état, réponse au ping de Scaleway).

Ce que cela coûte

Mise à jour : 19 novembre 2026