クラウドフットプリント分析

クラウドフットプリント分析は 1 社を受け取り、そのクラウドフットプリント全体を返します。総数、主要プロバイダー・国・リージョン、週ごとに現れた新規ホストの数、直近のホスト、そして対応すべき変化を示すフラグです。企業のリストを作るにはクラウドフットプリント検索を使います。そのうち 1 社の全体像を知りたいときは分析を使います。

はじめる前に

企業の domain_search_id が必要です。クラウドフットプリント検索、企業検索、企業ルックアップの各行に含まれています。

cURL

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 を取得します。

リクエスト

cURL

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`	企業が既に使っていたプロバイダー上の、新しいリージョンまたは新しい国。	新しい地域への拡大です。

フラグはリクエストのたびに再確認されます。その後に元に戻った変化は含まれません。

移転したホスト

{
  "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 です。

ツインホスト

{
  "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 件返します。

テストホスト

{
  "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 が含まれることはありません。

新しいプロバイダー

{
  "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 件返します。

新しいリージョン

{
  "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 日間追跡して初めて新規として扱います。そのため、追跡を始めて間もない企業では空のリストが返ります。

レシピ

クラウドから離れる企業
期間を指定して変化を見る
すべてのフラグを数える

cURL

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}'

プロバイダー間の移転だけを残します。同じプロバイダーからの移転が多い場合は、移行が進んでいるサインです。

cURL

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 月分だけになります。総数と上位リストは変わりません。

cURL

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 になります。国内という意味ではなく「不明」です。