> ## 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. # Cloud-Footprint-Insights > Lesen Sie den gesamten Cloud-Footprint eines Unternehmens mit einem Aufruf, dazu Flags für Änderungen, auf die es sich zu reagieren lohnt: verschobene Hosts, neue Clouds, neue Regionen und Testumgebungen. [Cloud-Footprint-Insights](/de/api-reference/endpoint/companies/cloud_footprints_insights) nimmt ein Unternehmen und liefert seinen gesamten Cloud-Footprint: Summen, die führenden Anbieter, Länder und Regionen, wie viele neue Hosts pro Woche auftauchten, die neuesten Hosts und **Flags** — die Änderungen, auf die es sich zu reagieren lohnt. Mit der [Cloud-Footprint-Suche](/de/developer-guides/search/cloud-footprint-search) bauen Sie eine Liste von Unternehmen auf. Insights nutzen Sie, wenn Sie das Gesamtbild zu einem davon brauchen. ## Bevor Sie beginnen Sie brauchen die `domain_search_id` des Unternehmens. Jede Zeile aus Cloud-Footprint-Suche, Unternehmenssuche und Unternehmens-Lookup enthält sie. ```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 }' ``` Übernehmen Sie `domain_search_id` aus der ersten Zeile. ## Anfrage ```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" }' ``` | Schlüssel | Erforderlich | Bedeutung | | - | - | - | | `domain_search_id` | Ja | Das Unternehmen. | | `date_from` | Nein | Beginn des Datumsfensters, `YYYY-MM-DD`. | | `date_to` | Nein | Ende des Datumsfensters, `YYYY-MM-DD`. | Ohne Datumsangaben umfasst das Fenster die letzten 90 Tage. Ihr Plan kann begrenzen, wie weit `date_from` zurückreichen darf. ## Was zurückkommt | Schlüssel | Inhalt | Folgt dem Datumsfenster? | | - | - | - | | `totals` | Hosts, Server, Anbieter, Länder, grenzüberschreitende Länder und Regionen | Nur `new_hosts` | | `providers` | Die 8 führenden Anbieter | Nein | | `countries` | Die 8 führenden Länder, jeweils mit `evidence_url` | Nein | | `regions` | Die 8 führenden Cloud-Regionen | Nein | | `weekly_series` | Pro Woche erstmals gesehene Hosts | Ja | | `recent_hosts` | Bis zu 12 der neuesten Hosts, ein Eintrag je Host | Ja | | `window_days` | Tage im Fenster, beide Enden eingeschlossen | — | | `flags` | Änderungen, auf die es sich zu reagieren lohnt | Ja | Ein **Host** ist eine benannte Adresse, die das Unternehmen betreibt, etwa `api.example.com`. Ein **Server** ist eine eindeutige IP-Adresse hinter diesen Hosts. Die Top-Listen sind nach Servern sortiert, dann nach Hosts. Die Wochen in `weekly_series` beginnen am Montag in der Zeitzone Ihres Workspace. ## Flags Flags machen aus dem Footprint etwas, worauf Sie reagieren können. Es gibt fünf Listen. Jede enthält bis zu 8 Einträge, neueste zuerst. Jeder Eintrag nennt echte Hosts, die Sie selbst prüfen können. | Flag | Bedeutung | Warum es wichtig ist | | - | - | - | | `moved_hosts` | Ein Host antwortet jetzt von einem anderen Anbieter, aus einem anderen Land oder einer anderen Region. | Das Unternehmen migriert oder zieht um. | | `twin_hosts` | Derselbe Dienst läuft gleichzeitig auf zwei Clouds, und eine davon kam kürzlich hinzu. | Ein Multi-Cloud-Rollout oder eine laufende Migration. | | `test_hosts` | Ein neuer Dev-, Test-, Staging- oder Proof-of-Concept-Host auf einer Cloud, die nicht die Haupt-Cloud des Unternehmens ist. | Das Unternehmen testet eine neue Cloud. Das ist das früheste Anzeichen. | | `new_providers` | Ein Anbieter, den das Unternehmen bisher nicht genutzt hat. | Eine neue Lieferantenbeziehung. | | `new_regions` | Eine neue Region oder ein neues Land bei einem Anbieter, den das Unternehmen bereits nutzte. | Wachstum in einen neuen geografischen Raum. | Jedes Flag wird bei jeder Abfrage erneut geprüft. Eine inzwischen rückgängig gemachte Änderung fällt heraus. ### Verschobene Hosts ```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 } ``` Dieser Produktions-Host hat AWS in Oregon verlassen und läuft jetzt auf Oracle Cloud in Phoenix. * `is_provider_change` ist `true`, wenn sich der Anbieter geändert hat. Es ist `false`, wenn sich nur Land oder Region geändert hat. * `is_live_confirmed` ist `true`, wenn der Host gerade von `to` antwortet. Es ist `false`, wenn der Host `from` verlassen hat, sein neuer Ort aber nicht bestätigt werden konnte. ### Zwillings-Hosts ```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` ist der Name, den die Hosts teilen. * `providers` listet die Clouds, auf denen der Dienst live ist, neueste zuerst. `new_provider` ist die neueste. * `hosts` liefert einen Live-Host je Cloud, bis zu 3. ### Test-Hosts ```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" } ] } ``` Ein AWS-Unternehmen mit einem neuen Entwicklungs-Host auf Google Cloud. * `tags` sind die Wörter im Hostnamen, die ihn als Nicht-Produktion kennzeichnen. * `is_poc` ist `true`, wenn der Name einen Proof of Concept oder ein Pilotprojekt kennzeichnet. Diese Einträge stehen zuerst. * `places` gibt an, wo der Host jetzt live ist. Es enthält nie `primary_provider`. ### Neue Anbieter ```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` gibt an, wie viele Hosts das Unternehmen jetzt bei diesem Anbieter hat. * `hosts` liefert bis zu 3 Live-Hosts als Beleg. ### Neue Regionen ```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" } ] } ``` Der Anbieter war schon vor dem Fenster im Einsatz. Nur die Region ist neu. Ist `cloud_region` `null`, ist das Flag ein neues Land bei diesem Anbieter. ### Wenn Flags leer sind * **`flags` ist `null`.** Die Flags für dieses Unternehmen stehen noch nicht bereit. Der Rest der Antwort ist trotzdem vollständig. * **Eine Liste ist `null`.** Diese Liste konnte bei diesem Aufruf nicht erstellt werden. Die anderen Listen sind weiterhin gültig. Versuchen Sie es später erneut. * **`is_spam_flood` ist `true`.** Die Hostnamen des Unternehmens sind für Flags zu verrauscht, daher ist jede Liste leer. * **Eine Liste ist `[]`.** Im Fenster passte nichts. `twin_hosts`, `test_hosts`, `new_providers` und `new_regions` werten etwas erst als neu, wenn Pubrio das Unternehmen seit 90 Tagen verfolgt. Ein erst kürzlich verfolgtes Unternehmen liefert daher leere Listen. ## Rezepte ```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}' ``` Behält nur Wechsel zwischen Anbietern. Viele Wechsel weg vom selben Anbieter deuten auf eine Migration hin. ```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` und alle Flags decken jetzt nur den August ab. Summen und Top-Listen ändern sich nicht. ```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' ``` Eine schnelle Prüfung, welche Flags Einträge haben, bevor Sie die Details lesen. ## Wissenswertes * Ein Unternehmen, das in zwei Ländern betreibt, zählt in beiden Ländereinträgen. Die Top-Listen können daher zusammen mehr ergeben als `totals`. * `is_cross_border` ist `null`, wenn kein Unternehmenssitz bekannt ist. Das heißt unbekannt, nicht inländisch. ## Verwandt Alle Anfrageschlüssel und Antwortfelder. Bauen Sie eine Liste von Unternehmen nach Anbieter, Land, Region und Größe auf. Cloud-Footprint-Änderungen an einen Webhook oder per E-Mail senden.