Análisis de huella cloud

Análisis de huella cloud recibe una empresa y devuelve toda su huella cloud: totales, sus principales proveedores, países y regiones, cuántos hosts nuevos aparecieron cada semana, los hosts más recientes y alertas: los cambios que merece la pena atender. Usa Búsqueda de huella cloud para construir una lista de empresas. Usa Análisis cuando quieras la historia completa de una de ellas.

Antes de empezar

Necesitas el domain_search_id de la empresa. Todas las filas de Búsqueda de huella cloud, Búsqueda de empresas y Consulta de empresas lo incluyen.

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

Toma el domain_search_id de la primera fila.

Solicitud

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

Clave	Obligatoria	Significado
`domain_search_id`	Sí	La empresa.
`date_from`	No	Inicio de la ventana de fechas, `YYYY-MM-DD`.
`date_to`	No	Fin de la ventana de fechas, `YYYY-MM-DD`.

Sin fechas, la ventana son los últimos 90 días. Tu plan puede limitar hasta cuándo puede retroceder date_from.

Qué devuelve

Clave	Qué es	¿Sigue la ventana de fechas?
`totals`	Hosts, servidores, proveedores, países, países transfronterizos y regiones	Solo `new_hosts`
`providers`	Los 8 proveedores principales	No
`countries`	Los 8 países principales, cada uno con un `evidence_url`	No
`regions`	Las 8 regiones cloud principales	No
`weekly_series`	Hosts vistos por primera vez cada semana	Sí
`recent_hosts`	Hasta 12 hosts más recientes, una entrada por host	Sí
`window_days`	Días de la ventana, contando ambos extremos	—
`flags`	Cambios que merece la pena atender	Sí

Un host es una dirección con nombre que la empresa gestiona, como api.example.com. Un servidor es una dirección IP distinta detrás de esos hosts. Las listas principales se ordenan por servidores y luego por hosts. Las semanas de weekly_series empiezan el lunes en la zona horaria de tu espacio de trabajo.

Alertas

Las alertas convierten la huella en acciones concretas. Hay cinco listas. Cada una contiene hasta 8 elementos, los más recientes primero, y cada elemento nombra hosts reales que puedes comprobar tú mismo.

Alerta	Qué significa	Por qué importa
`moved_hosts`	Un host responde ahora desde otro proveedor, país o región.	La empresa está migrando o reubicándose.
`twin_hosts`	El mismo servicio corre en dos clouds a la vez, y uno de ellos se añadió hace poco.	Un despliegue multicloud o una migración en curso.
`test_hosts`	Un host nuevo de desarrollo, pruebas, staging o prueba de concepto en un cloud que no es el principal de la empresa.	La empresa está probando un cloud nuevo. Es la señal más temprana.
`new_providers`	Un proveedor que la empresa no había usado antes.	Una nueva relación con un proveedor.
`new_regions`	Una región nueva, o un país nuevo, en un proveedor que la empresa ya usaba.	Crecimiento hacia una nueva zona geográfica.

Cada alerta se vuelve a comprobar cuando la pides. Un cambio que se ha revertido desaparece.

Hosts movidos

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

Este host de producción dejó AWS en Oregón y ahora corre en Oracle Cloud en Phoenix.

is_provider_change es true cuando cambió el proveedor. Es false cuando solo cambió el país o la región.
is_live_confirmed es true cuando el host responde desde to en este momento. Es false cuando el host ha dejado from pero no se pudo confirmar su nueva ubicación.

Hosts gemelos

{
  "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 es el nombre que comparten los hosts.
providers lista los clouds en los que el servicio está activo, los más recientes primero. new_provider es el más reciente.
hosts da un host activo por cloud, hasta 3.

Hosts de prueba

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

Una empresa de AWS con un host de desarrollo nuevo en Google Cloud.

tags son las palabras del nombre del host que lo marcan como no productivo.
is_poc es true cuando el nombre indica una prueba de concepto o un piloto. Estos elementos aparecen primero.
places es dónde está activo el host ahora. Nunca incluye primary_provider.

Proveedores nuevos

{
  "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 es cuántos hosts tiene ahora la empresa en este proveedor.
hosts da hasta 3 hosts activos como prueba.

Regiones nuevas

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

El proveedor ya se usaba antes de la ventana. Solo la región es nueva. Cuando cloud_region es null, la alerta es un país nuevo en ese proveedor.

Cuando las alertas están vacías

flags es null. Las alertas aún no están listas para esta empresa. El resto de la respuesta sigue completo.
Una lista es null. Esa lista no se pudo generar en esta llamada. Las demás listas siguen siendo válidas. Vuelve a intentarlo más tarde.
is_spam_flood es true. Los nombres de host de la empresa tienen demasiado ruido para generar alertas, así que todas las listas están vacías.
Una lista es []. Nada coincidió en la ventana. twin_hosts, test_hosts, new_providers y new_regions solo consideran algo nuevo cuando Pubrio lleva 90 días siguiendo a la empresa, así que una empresa seguida desde hace poco devuelve listas vacías.

Recetas

Quién está dejando un cloud
Cambios en una ventana concreta
Contar todas las alertas

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

Conserva solo los movimientos entre proveedores. Muchos movimientos desde el mismo proveedor apuntan a una migración.

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 y todas las alertas cubren ahora solo agosto. Los totales y las listas principales no cambian.

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'

Una comprobación rápida para ver qué alertas tienen contenido antes de leer los detalles.

Conviene saber

Una empresa que opera en dos países cuenta en ambas entradas de país, así que las listas principales pueden sumar más que totals.
is_cross_border es null cuando no se conoce la sede de la empresa. Significa desconocido, no nacional.

Relacionado

Referencia de Análisis de huella cloud

Todas las claves de la solicitud y los campos de la respuesta.

Búsqueda de huella cloud

Construye una lista de empresas por proveedor, país, región y tamaño.

Configurar webhooks

Envía los cambios de huella cloud a un webhook o email.

Monitor

Búsqueda

Filtros

Personas

Expansión

Antes de empezar

Solicitud

Qué devuelve

Alertas

Hosts movidos

Hosts gemelos

Hosts de prueba

Proveedores nuevos

Regiones nuevas

Cuando las alertas están vacías

Recetas

Conviene saber

Relacionado

Referencia de Análisis de huella cloud

Búsqueda de huella cloud

Configurar webhooks

​Antes de empezar

​Solicitud

​Qué devuelve

​Alertas

​Hosts movidos

​Hosts gemelos

​Hosts de prueba

​Proveedores nuevos

​Regiones nuevas

​Cuando las alertas están vacías

​Recetas

​Conviene saber

​Relacionado

Referencia de Análisis de huella cloud

Búsqueda de huella cloud

Configurar webhooks

Antes de empezar

Solicitud

Qué devuelve

Alertas

Hosts movidos

Hosts gemelos

Hosts de prueba

Proveedores nuevos

Regiones nuevas

Cuando las alertas están vacías

Recetas

Conviene saber

Relacionado