> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Analyse d'empreinte cloud
> Lisez toute l'empreinte cloud d'une entreprise en un seul appel, avec des indicateurs pour les changements à exploiter : hôtes déplacés, nouveaux clouds, nouvelles régions et environnements de test.
[Analyse d'empreinte cloud](/fr/api-reference/endpoint/companies/cloud_footprints_insights) prend une entreprise et renvoie toute son empreinte cloud : totaux, principaux fournisseurs, pays et régions, nombre de nouveaux hôtes apparus chaque semaine, derniers hôtes, et des **indicateurs** — les changements à exploiter.
Utilisez la [Recherche d'empreinte cloud](/fr/developer-guides/search/cloud-footprint-search) pour constituer une liste d'entreprises. Utilisez l'Analyse lorsque vous voulez le tableau complet pour l'une d'elles.
## Avant de commencer
Il vous faut le `domain_search_id` de l'entreprise. Chaque ligne renvoyée par la Recherche d'empreinte cloud, la Recherche d'entreprises et la Consultation d'entreprise en contient un.
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domains": ["platform9.com"], "per_page": 1 }'
```
Prenez le `domain_search_id` de la première ligne.
## Requête
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/insights \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain_search_id": "a8064391-03c6-4ed2-91b0-217a9f89d418" }'
```
| Clé | Obligatoire | Signification |
| - | - | - |
| `domain_search_id` | Oui | L'entreprise. |
| `date_from` | Non | Début de la fenêtre de dates, `YYYY-MM-DD`. |
| `date_to` | Non | Fin de la fenêtre de dates, `YYYY-MM-DD`. |
Sans dates, la fenêtre couvre les 90 derniers jours. Votre forfait peut limiter jusqu'où `date_from` peut remonter.
## Contenu de la réponse
| Clé | Contenu | Suit la fenêtre de dates ? |
| - | - | - |
| `totals` | Hôtes, serveurs, fournisseurs, pays, pays hors du marché d'origine et régions | Seulement `new_hosts` |
| `providers` | Les 8 premiers fournisseurs | Non |
| `countries` | Les 8 premiers pays, chacun avec un `evidence_url` | Non |
| `regions` | Les 8 premières régions cloud | Non |
| `weekly_series` | Hôtes vus pour la première fois chaque semaine | Oui |
| `recent_hosts` | Jusqu'à 12 hôtes les plus récents, une entrée par hôte | Oui |
| `window_days` | Nombre de jours de la fenêtre, bornes incluses | — |
| `flags` | Changements à exploiter | Oui |
Un **hôte** est une adresse nommée exploitée par l'entreprise, comme `api.example.com`. Un **serveur** est une adresse IP distincte derrière ces hôtes. Les classements sont triés par serveurs, puis par hôtes.
Les semaines de `weekly_series` commencent le lundi, dans le fuseau horaire de votre espace de travail.
## Indicateurs
Les indicateurs transforment l'empreinte en actions concrètes. Il existe cinq listes. Chacune contient jusqu'à 8 éléments, les plus récents d'abord, et chaque élément cite de vrais hôtes que vous pouvez vérifier vous-même.
| Indicateur | Signification | Pourquoi c'est important |
| - | - | - |
| `moved_hosts` | Un hôte répond désormais depuis un autre fournisseur, pays ou région. | L'entreprise migre ou déménage. |
| `twin_hosts` | Le même service tourne sur deux clouds à la fois, et l'un d'eux a été ajouté récemment. | Un déploiement multicloud ou une migration en cours. |
| `test_hosts` | Un nouvel hôte de développement, de test, de staging ou de preuve de concept sur un cloud qui n'est pas le cloud principal de l'entreprise. | L'entreprise essaie un nouveau cloud. C'est le signe le plus précoce. |
| `new_providers` | Un fournisseur que l'entreprise n'avait jamais utilisé. | Une nouvelle relation fournisseur. |
| `new_regions` | Une nouvelle région, ou un nouveau pays, chez un fournisseur que l'entreprise utilisait déjà. | Une expansion vers une nouvelle zone géographique. |
Chaque indicateur est revérifié à chaque demande. Un changement annulé depuis disparaît de la liste.
### Hôtes déplacés
```json theme={null}
{
"host": "onemindservices-new-jersey-prod.app.pcd.platform9.com",
"is_provider_change": true,
"from": { "provider": "AWS", "country_code": "US", "cloud_region": "us-west-2", "city": "Portland", "region_name": "Oregon", "first_seen_at": "2026-07-22T12:07:12.918787", "last_seen_at": "2026-07-22T12:19:41.499986" },
"to": { "provider": "OCI", "country_code": "US", "cloud_region": "us-phoenix-1", "city": "Phoenix", "region_name": "Phoenix", "first_seen_at": "2026-09-13T16:07:26.248556", "last_seen_at": "2026-09-14T09:41:19.500363" },
"is_live_confirmed": true
}
```
Cet hôte de production a quitté AWS en Oregon et tourne désormais sur Oracle Cloud à Phoenix.
* `is_provider_change` vaut `true` quand le fournisseur a changé. Il vaut `false` quand seul le pays ou la région a changé.
* `is_live_confirmed` vaut `true` quand l'hôte répond depuis `to` en ce moment. Il vaut `false` quand l'hôte a quitté `from` mais que son nouvel emplacement n'a pas pu être confirmé.
### Hôtes jumeaux
```json theme={null}
{
"service": "du.testbed.only.app.pcd",
"providers": ["AWS", "OCI"],
"new_provider": "AWS",
"first_seen_at": "2026-07-21T11:59:25.286744",
"new_provider_first_seen_at": "2026-09-10T09:23:35.767165",
"hosts": [
{ "host": "test-du-testbed-only-5113915.app.qa-pcd.platform9.com", "provider": "AWS", "country_code": "US", "cloud_region": "us-west-2", "city": "Portland", "region_name": "Oregon", "first_seen_at": "2026-09-10T09:23:35.767165" },
{ "host": "test-du-testbed-only-5114083.app.qa-pcd.platform9.com", "provider": "OCI", "country_code": "US", "cloud_region": "us-phoenix-1", "city": "Phoenix", "region_name": "Phoenix", "first_seen_at": "2026-09-10T11:53:10.757998" }
]
}
```
* `service` est le nom commun aux hôtes.
* `providers` liste les clouds sur lesquels le service est actif, les plus récents d'abord. `new_provider` est le plus récent.
* `hosts` donne un hôte actif par cloud, jusqu'à 3.
### Hôtes de test
```json theme={null}
{
"host": "iam-dev.platform.ea.com",
"tags": ["dev"],
"is_poc": false,
"primary_provider": "AWS",
"first_seen_at": "2026-09-06T08:13:54.048967",
"places": [
{ "provider": "GCP", "country_code": "US", "cloud_region": "us-central1", "city": "Council Bluffs", "region_name": "Iowa" }
]
}
```
Une entreprise sur AWS avec un nouvel hôte de développement sur Google Cloud.
* `tags` contient les mots du nom d'hôte qui le désignent comme hors production.
* `is_poc` vaut `true` quand le nom désigne une preuve de concept ou un pilote. Ces éléments viennent en premier.
* `places` indique où l'hôte est actif maintenant. Il n'inclut jamais `primary_provider`.
### Nouveaux fournisseurs
```json theme={null}
{
"provider": "Equinix Metal",
"first_seen_at": "2026-09-14T02:08:27.707494",
"host_count": 1,
"hosts": [
{ "host": "hnjobs.cncf.io", "provider": "Equinix Metal", "country_code": "US", "cloud_region": null, "city": "Parsippany", "region_name": null, "first_seen_at": "2026-09-14T02:08:27.707494" }
]
}
```
* `host_count` est le nombre d'hôtes que l'entreprise a actuellement chez ce fournisseur.
* `hosts` donne jusqu'à 3 hôtes actifs comme preuve.
### Nouvelles régions
```json theme={null}
{
"provider": "AWS",
"country_code": "US",
"cloud_region": "us-west-1",
"city": "San Jose",
"region_name": "N. California",
"first_seen_at": "2026-09-09T22:44:04.868704",
"host_count": 1,
"hosts": [
{ "host": "mx.experience.zoom.us", "provider": "AWS", "country_code": "US", "cloud_region": "us-west-1", "city": "San Jose", "region_name": "N. California", "first_seen_at": "2026-09-09T22:44:04.868704" }
]
}
```
Le fournisseur était déjà utilisé avant la fenêtre. Seule la région est nouvelle. Quand `cloud_region` vaut `null`, l'indicateur correspond à un nouveau pays chez ce fournisseur.
### Quand les indicateurs sont vides
* **`flags` vaut `null`.** Les indicateurs ne sont pas encore prêts pour cette entreprise. Le reste de la réponse est tout de même complet.
* **Une liste vaut `null`.** Cette liste n'a pas pu être construite lors de cet appel. Les autres listes restent valides. Réessayez plus tard.
* **`is_spam_flood` vaut `true`.** Les noms d'hôtes de l'entreprise sont trop bruités pour produire des indicateurs : toutes les listes sont donc vides.
* **Une liste vaut `[]`.** Rien ne correspond dans la fenêtre. `twin_hosts`, `test_hosts`, `new_providers` et `new_regions` ne considèrent un élément comme nouveau qu'une fois que Pubrio suit l'entreprise depuis 90 jours. Une entreprise suivie depuis peu renvoie donc des listes vides.
## Recettes
```bash cURL theme={null}
curl -s -X POST https://api.pubrio.com/companies/cloud_footprints/insights \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain_search_id": "a8064391-03c6-4ed2-91b0-217a9f89d418" }' \
| jq '.data.flags.moved_hosts[] | select(.is_provider_change) | {host, from: .from.provider, to: .to.provider}'
```
Ne garde que les déplacements entre fournisseurs. De nombreux départs d'un même fournisseur signalent une migration.
```bash cURL theme={null}
curl -s -X POST https://api.pubrio.com/companies/cloud_footprints/insights \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"domain_search_id": "a8064391-03c6-4ed2-91b0-217a9f89d418",
"date_from": "2026-08-01",
"date_to": "2026-08-31"
}'
```
`new_hosts`, `weekly_series`, `recent_hosts` et tous les indicateurs ne couvrent plus que le mois d'août. Les totaux et les classements ne changent pas.
```bash cURL theme={null}
curl -s -X POST https://api.pubrio.com/companies/cloud_footprints/insights \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain_search_id": "a8064391-03c6-4ed2-91b0-217a9f89d418" }' \
| jq '.data.flags | if . == null then "not ready" else with_entries(select(.value | type == "array") | .value |= length) end'
```
Une vérification rapide pour voir quels indicateurs contiennent quelque chose avant d'en lire le détail.
## Bon à savoir
* Une entreprise présente dans deux pays compte dans les deux entrées pays : la somme des classements peut donc dépasser `totals`.
* `is_cross_border` vaut `null` quand le siège de l'entreprise est inconnu. Cela signifie inconnu, pas national.
## Voir aussi
Toutes les clés de requête et tous les champs de réponse.
Constituer une liste d'entreprises par fournisseur, pays, région et taille.
Pousser les changements d'empreinte cloud vers un webhook ou un e-mail.