> ## 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.

# تحليلات البصمة السحابية

> اطّلع على البصمة السحابية الكاملة لشركة واحدة في طلب واحد، مع علامات للتغيّرات الجديرة بالتحرّك: المضيفات المنقولة، والسحابات الجديدة، والمناطق الجديدة، وبيئات الاختبار.

[تحليلات البصمة السحابية](/ar/api-reference/endpoint/companies/cloud_footprints_insights) تأخذ شركة واحدة وتعيد بصمتها السحابية كاملة: الإجماليات، وأبرز مزوّديها ودولها ومناطقها، وعدد المضيفات الجديدة التي ظهرت كل أسبوع، وأحدث المضيفات، و**العلامات** — التغيّرات الجديرة بالتحرّك.

استخدم [البحث في البصمة السحابية](/ar/developer-guides/search/cloud-footprint-search) لبناء قائمة شركات. واستخدم التحليلات عندما تريد القصة الكاملة لإحداها.

## قبل أن تبدأ

تحتاج إلى `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 من أحدث المضيفات، بإدخال واحد لكل مضيف | نعم |
| `window_days` | أيام النافذة، مع احتساب الطرفين | — |
| `flags` | التغيّرات الجديرة بالتحرّك | نعم |

**المضيف** عنوان مُسمّى تشغّله الشركة، مثل `api.example.com`. و**الخادم** عنوان IP مميز خلف هذه المضيفات. تُرتَّب القوائم الأبرز حسب الخوادم ثم المضيفات.

تبدأ أسابيع `weekly_series` يوم الاثنين بالمنطقة الزمنية لمساحة عملك.

## العلامات

تحوّل العلامات البصمة إلى أمور يمكنك التحرّك بناءً عليها. هناك خمس قوائم. تضم كل قائمة حتى 8 عناصر، الأحدث أولًا، وكل عنصر يسمّي مضيفات حقيقية يمكنك التحقق منها بنفسك.

| العلامة | ما تعنيه | لماذا تهم |
| - | - | - |
| `moved_hosts` | مضيف يستجيب الآن من مزوّد أو دولة أو منطقة مختلفة. | الشركة تُجري ترحيلًا أو تنقل موقعها. |
| `twin_hosts` | الخدمة نفسها تعمل على سحابتين في الوقت نفسه، وأُضيفت إحداهما مؤخرًا. | نشر متعدد السحابات أو ترحيل قيد التنفيذ. |
| `test_hosts` | مضيف جديد للتطوير أو الاختبار أو ما قبل الإنتاج أو إثبات المفهوم على سحابة ليست السحابة الرئيسية للشركة. | الشركة تجرّب سحابة جديدة. وهذا أبكر مؤشر. |
| `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` بقيمة `true` عندما يستجيب المضيف من `to` الآن. وتكون `false` عندما يغادر المضيف `from` دون التمكّن من تأكيد مكانه الجديد.

### المضيفات التوأم

```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` يعطي مضيفًا واحدًا نشطًا لكل سحابة، حتى 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` بقيمة `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`.** العلامات غير جاهزة لهذه الشركة بعد. وبقية الاستجابة كاملة.
* **قائمة واحدة بقيمة `null`.** تعذّر بناء تلك القائمة في هذا الطلب. والقوائم الأخرى صالحة. أعد المحاولة لاحقًا.
* **`is_spam_flood` بقيمة `true`.** أسماء مضيفات الشركة مشوّشة بدرجة لا تسمح بوضع علامات، لذا كل القوائم فارغة.
* **قائمة بقيمة `[]`.** لم يطابق شيء في النافذة. لا تعدّ `twin_hosts` و`test_hosts` و`new_providers` و`new_regions` شيئًا جديدًا إلا بعد أن تتابع Pubrio الشركة لمدة 90 يومًا، لذا تعيد الشركة المتابَعة حديثًا قوائم فارغة.

## وصفات

<Tabs>
  <Tab title="من يغادر سحابة">
    ```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}'
    ```

    يُبقي على التنقلات بين المزوّدين فقط. وكثرة التنقلات من المزوّد نفسه تشير إلى ترحيل.
  </Tab>

  <Tab title="التغيّرات في نافذة محددة">
    ```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` وكل العلامات الآن شهر أغسطس فقط. أما الإجماليات والقوائم الأبرز فلا تتغيّر.
  </Tab>

  <Tab title="عدّ كل العلامات">
    ```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'
    ```

    فحص سريع لمعرفة العلامات التي تحتوي على شيء قبل أن تقرأ التفاصيل.
  </Tab>
</Tabs>

## أمور تستحق المعرفة

* الشركة العاملة في دولتين تُحتسب في مدخلَي الدولتين، لذا قد يتجاوز مجموع القوائم الأبرز `totals`.
* تكون `is_cross_border` بقيمة `null` عندما لا يُعرف مقر الشركة. أي غير معروف، لا محلي.

## ذات صلة

<CardGroup cols={2}>
  <Card title="مرجع تحليلات البصمة السحابية" icon="code" href="/ar/api-reference/endpoint/companies/cloud_footprints_insights">
    كل مفاتيح الطلب وحقول الاستجابة.
  </Card>

  <Card title="البحث في البصمة السحابية" icon="cloud" href="/ar/developer-guides/search/cloud-footprint-search">
    ابنِ قائمة شركات حسب المزوّد والدولة والمنطقة والحجم.
  </Card>

  <Card title="إعداد webhooks" icon="webhook" href="/ar/developer-guides/setting-up-webhooks">
    ادفع تغيّرات البصمة السحابية إلى webhook أو بريد.
  </Card>
</CardGroup>