> ## 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. # クラウドフットプリント分析 > 1 社のクラウドフットプリント全体と、対応すべき変化を示すフラグを 1 回の呼び出しで取得します。移転したホスト、新しいクラウド、新しいリージョン、テスト環境がわかります。 [クラウドフットプリント分析](/jp/api-reference/endpoint/companies/cloud_footprints_insights) は 1 社を受け取り、そのクラウドフットプリント全体を返します。総数、主要プロバイダー・国・リージョン、週ごとに現れた新規ホストの数、直近のホスト、そして対応すべき変化を示す**フラグ**です。 企業のリストを作るには[クラウドフットプリント検索](/jp/developer-guides/search/cloud-footprint-search)を使います。そのうち 1 社の全体像を知りたいときは分析を使います。 ## はじめる前に 企業の `domain_search_id` が必要です。クラウドフットプリント検索、企業検索、企業ルックアップの各行に含まれています。 ```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 }' ``` 最初の行から `domain_search_id` を取得します。 ## リクエスト ```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" }' ``` | キー | 必須 | 意味 | | - | - | - | | `domain_search_id` | はい | 対象の企業。 | | `date_from` | いいえ | 期間の開始日（`YYYY-MM-DD`）。 | | `date_to` | いいえ | 期間の終了日（`YYYY-MM-DD`）。 | 日付を指定しない場合、期間は直近 90 日間です。プランによって、`date_from` で遡れる範囲が制限されることがあります。 ## 返されるデータ | キー | 内容 | 期間に連動するか | | - | - | - | | `totals` | ホスト、サーバー、プロバイダー、国、クロスボーダーの国、リージョンの数 | `new_hosts` のみ | | `providers` | 上位 8 プロバイダー | いいえ | | `countries` | 上位 8 か国（それぞれ `evidence_url` 付き） | いいえ | | `regions` | 上位 8 クラウドリージョン | いいえ | | `weekly_series` | 週ごとに初めて観測されたホスト数 | はい | | `recent_hosts` | 最新のホスト最大 12 件（1 ホストにつき 1 件） | はい | | `window_days` | 期間の日数（両端を含む） | — | | `flags` | 対応すべき変化 | はい | **ホスト**は、`api.example.com` のように企業が運用する名前付きのアドレスです。**サーバー**は、それらのホストの背後にある一意の IP アドレスです。上位リストはサーバー数、次にホスト数の多い順に並びます。 `weekly_series` の週は、ワークスペースのタイムゾーンで月曜日に始まります。 ## フラグ フラグは、フットプリントを行動につながる情報に変えます。リストは 5 つあります。各リストは最大 8 件で新しい順に並び、各項目には自分で確認できる実在のホストが含まれます。 | フラグ | 意味 | 重要な理由 | | - | - | - | | `moved_hosts` | ホストが別のプロバイダー、国、またはリージョンから応答するようになった。 | 企業が移行または移転を進めています。 | | `twin_hosts` | 同じサービスが 2 つのクラウドで同時に稼働し、そのうち 1 つが最近追加された。 | マルチクラウド展開、または移行の途中です。 | | `test_hosts` | 企業のメインではないクラウド上に、新しい開発・テスト・ステージング・PoC 用のホストがある。 | 企業が新しいクラウドを試しています。最も早いサインです。 | | `new_providers` | 企業がこれまで使っていなかったプロバイダー。 | 新しいベンダーとの取引です。 | | `new_regions` | 企業が既に使っていたプロバイダー上の、新しいリージョンまたは新しい国。 | 新しい地域への拡大です。 | フラグはリクエストのたびに再確認されます。その後に元に戻った変化は含まれません。 ### 移転したホスト ```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 } ``` この本番ホストはオレゴンの AWS を離れ、現在はフェニックスの Oracle Cloud で稼働しています。 * `is_provider_change` は、プロバイダーが変わった場合に `true` です。国またはリージョンだけが変わった場合は `false` です。 * `is_live_confirmed` は、ホストが現在 `to` から応答している場合に `true` です。ホストが `from` を離れたものの、移転先を確認できなかった場合は `false` です。 ### ツインホスト ```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` は、ホストが共有する名前です。 * `providers` は、サービスが稼働しているクラウドを新しい順に並べたものです。`new_provider` はその中で最も新しいクラウドです。 * `hosts` は、クラウドごとに稼働中のホストを 1 件ずつ、最大 3 件返します。 ### テストホスト ```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" } ] } ``` AWS を使う企業が、Google Cloud に新しい開発用ホストを持っている例です。 * `tags` は、ホスト名のうち本番環境でないことを示す語です。 * `is_poc` は、名前が PoC（概念実証）やパイロットを示す場合に `true` です。これらの項目が先頭に並びます。 * `places` は、ホストが現在稼働している場所です。`primary_provider` が含まれることはありません。 ### 新しいプロバイダー ```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` は、企業がこのプロバイダー上に現在持つホスト数です。 * `hosts` は、裏づけとなる稼働中のホストを最大 3 件返します。 ### 新しいリージョン ```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" } ] } ``` このプロバイダーは期間より前から使われていました。新しいのはリージョンだけです。`cloud_region` が `null` の場合、そのプロバイダー上の新しい国を示すフラグです。 ### フラグが空の場合 * **`flags` が `null`。** この企業のフラグはまだ準備できていません。レスポンスの残りの部分は完全です。 * **1 つのリストが `null`。** この呼び出しではそのリストを作成できませんでした。他のリストは有効です。しばらくしてから再度お試しください。 * **`is_spam_flood` が `true`。** 企業のホスト名のノイズが多すぎてフラグを付けられないため、すべてのリストが空になります。 * **リストが `[]`。** 期間内に該当するものがありませんでした。`twin_hosts`、`test_hosts`、`new_providers`、`new_regions` は、Pubrio がその企業を 90 日間追跡して初めて新規として扱います。そのため、追跡を始めて間もない企業では空のリストが返ります。 ## レシピ ```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}' ``` プロバイダー間の移転だけを残します。同じプロバイダーからの移転が多い場合は、移行が進んでいるサインです。 ```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` とすべてのフラグは 8 月分だけになります。総数と上位リストは変わりません。 ```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' ``` 詳細を読む前に、どのフラグに項目があるかをすばやく確認できます。 ## 知っておくべき点 * 2 か国で稼働する企業は両方の国のエントリーに計上されるため、上位リストの合計が `totals` を上回ることがあります。 * 本社所在地が不明な企業では `is_cross_border` は `null` になります。国内という意味ではなく「不明」です。 ## 関連 全リクエストキーとレスポンスフィールド。 プロバイダー、国、リージョン、規模で企業のリストを作成します。 クラウドフットプリントの変化を webhook やメールに送る。