HYPHAby S33D
Documentation › Integrations

AWS, Azure, Google Cloud, OVHcloud and Scaleway

An agent reads the provider's API with a read-only account. Instances become resources in HYPHA, next to your hosts.

How it works

AWS

Reads EC2, EBS, CloudWatch alarms and the account identity, through a read-only IAM policy:

{
  "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

A service principal with the Reader role on each monitored subscription:

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

Google Cloud

A service account with the Compute Viewer role (roles/compute.viewer) and its JSON key, in a separate file:

integrations:
  gcp:
    credentials_file: /etc/hypha/gcp-readonly.json   # 600, root
    projects: [my-project]

Instances in every zone of the project: state, type, addresses (gcp.instance.status). An instance being repaired by Google (REPAIRING) turns critical.

OVHcloud

An OVHcloud API application and a "consumer" key limited to reads: GET rights on /dedicated/server*, /ip* and /domain*.

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

What a machine's agent cannot see:

Only GET requests go out, 200 ms apart; 5 minutes at least between two passes.

Scaleway

The API key of an IAM member with InstancesReadOnly and ElasticMetalReadOnly:

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

Per zone: instances (state, lock, scheduled maintenance) and Elastic Metal servers (state, answer to Scaleway's ping).

What it costs

Updated: 19 November 2026