resources API: cloud бүртгэлүүдийн нөөцийн мэдээллийг хэрхэн авах вэ?

Энэ API нь холбосон cloud бүртгэлүүд дээрх нөөцүүдийн (resources) мэдээллийг буцаана.

Хүсэлт

Формат

GET/cspm/resources/{id}

Параметрүүд

• `id` — String; заавал биш: Тийм; Мэдээллийг нь харах нөөцийн ID.

Хэрэв хүсэлтэд энэ параметрийг заагаагүй бол хариунд таны cloud бүртгэлүүд дээрх бүх нөөцийн мэдээлэл орно.

Жишээ

Cloud бүртгэлүүд дээрх бүх нөөцийн мэдээллийг хүсэх:

GET/cspm/resources

34a3a231-73d1-4945-8376-a41f7b****** нөөцийн мэдээллийг хүсэх:

GET/cspm/resources/34a3a231-73d1-4945-8376-a41f7b******

Хариу

Формат

{
  "data": [
    {
      "id": "string",
      "type": "resource",
      "attributes": {
        "resource_name": "string",
        "resource_region": "string",
        "resource_type": "string"
      },
      "links": {
        "self": "string"
      }
    }
  ],
  "links": {
    "self": "string",
    "next": "string"
  },
  "meta": {
    "total": 0,
    "elapsed": 0
  }
}

Шинж чанарууд

Энэ endpoint нь олон шинж чанар агуулсан объект буцаана:

• `data` — Array; Тодорхой нэг нөөцийн мэдээллийг агуулсан шинж чанаруудын жагсаалт.
• `id` — String; Scan бүлгийн ID.
• `type` — String; Бүлгийн төрөл. Боломжит утга: rule.
• `attributes` — Array; Scan бүлгийн тохиргооны мэдээллийг өгнө.
• `resource_name` — String; Нөөцийн нэр.
• `resource_region` — String; Нөөц байрлах бүс (region).
• `resource_type` — String; Нөөцийн төрөл.
• `links` — Array; Энэ scan бүлэгт хамаарах холбоосуудыг өгнө.
• `self` — String; Энэ scan бүлгийн тохиргооны мэдээлэл рүү шууд заасан холбоос.
• Доорх шинж чанарууд зөвхөн компанийн бүх scan бүлгийн мэдээллийг авах үед (хүсэлтэд id заагаагүй үед) буцна.
• `links` — Array; Хуудсууд хооронд шилжих холбоосуудыг өгнө.
• `self` — String; Энэ нөөцийн мэдээлэл рүү шууд заасан холбоос.
• `next` — String; Дараагийн нөөцийн мэдээлэл рүү шууд заасан холбоос.
• `meta` — Array; Хүсэлтээр буцсан мэдээллийн ерөнхий мэдээллийг өгнө.
• `total` — Integer; Таны хүсэлтээр буцсан үр дүнгийн нийт тоо.
• `elapsed` — Integer; Таны үзсэн, одоо харагдаж буйг оруулсан үр дүнгийн тоо.

Жишээ

Холбосон cloud бүртгэлүүд дээрх бүх нөөцийн мэдээллийг хүссэн:

{
    "data": [
        {
            "id": "0e1f4b58-a373-44d4-8d01-1a7ad3******",
            "type": "resource",
            "attributes": {
                "resource_name": "0e1f4b58-a373-44d4-8d01-1a7ad3******",
                "resource_region": "ap-southeast-1",
                "resource_type": "ACM Certificate"
            },
            "links": {
                "self": "https://api.staging.cs.gravityzone.bitdefender.com/v1/cspm/resources/0e1f4b58-a373-44d4-8d01-1a7ad3******"
            }
        },
        {
            "id": "34a3a231-73d1-4945-8376-a41f7b******",
            "type": "resource",
            "attributes": {
                "resource_name": "34a3a231-73d1-4945-8376-a41f7b******",
                "resource_region": "ap-southeast-1",
                "resource_type": "ACM Certificate"
            },
            "links": {
                "self": "https://api.staging.cs.gravityzone.bitdefender.com/v1/cspm/resources/34a3a231-73d1-4945-8376-a41f7b******"
            }
        },
        {
            "...": "..."
        }
    ],
    "links": {
        "self": "https://api.staging.cs.gravityzone.bitdefender.com/v1/cspm/resources?page_limit=500",
        "next": "https://api.staging.cs.gravityzone.bitdefender.com/v1/cspm/resources?page_limit=500&page_cursor=eyJ0b3RhbCI6IDE3NTcsICJlbGFwc2VkIjogNTAwLCAibm9fbGF0ZXJfdGhhbiI6ICIyMDI0LTAxLTE0VDE3OjAzOjM0Ljc1NDY1OCIsICJuZXh0X2JlZ2luX3VpZCI6ICJzdWJuZXQtZjMwZmNkOTUifQ%3D%3D"
    },
    "meta": {
        "total": 1757,
        "elapsed": 500
    }
}

34a3a231-73d1-4945-8376-a41f7b****** нөөцийн мэдээллийг хүссэн:

{
  "data": {
    "id": "string",
    "type": "resource",
    "attributes": {
      "resource_name": "34a3a231-73d1-4945-8376-a41f7b******",
      "resource_region": "ap-southeast-1",
      "resource_type": "ACM Certificate"
    },
    "links": {
      "self":"https://api.staging.cs.gravityzone.bitdefender.com/v1/cspm/resources/34a3a231-73d1-4945-8376-a41f7b******"
    }
  }
}