List — API обогащения данных

Статья
01/23/2024

Выполните запрос GET или POST, чтобы получить список диапазонов IP-адресов, соответствующих указанным фильтрам.

HTTP-запрос

GET /api/v1/subnet/

POST /api/v1/subnet/

Запрос параметров BODY

Параметр	Описание
фильтры	Фильтрация объектов со всеми фильтрами поиска для запроса см. в разделе "Фильтры диапазонов IP-адресов" для получения дополнительных сведений
sortDirection	Направление сортировки. Возможные значения: `ascdesc`
sortField	Поля, используемые для сортировки диапазонов IP-адресов. Возможны следующие значения: - категория: категория диапазона IP-адресов - теги: теги диапазона IP-адресов - имя: имя диапазона IP-адресов
skip	Пропускает указанное количество записей
limit	Максимальное количество записей, возвращаемых запросом

Пример

Запросить

Ниже приведен пример запроса.

curl -XPOST -H "Authorization:Token <your_token_key>" -H "Content-Type: application/json" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/v1/subnet/" -d '{
  "filters": {
    // some filters
  },
  "skip": 5,
  "limit": 10
  // ...
}'

Response

Возвращает список диапазонов IP-адресов в формате JSON. Сведения о полях ответа см. в разделе "Свойства".

{
  "total": 1 // total number of records
  "hasNext": false // whether there is more data to show or not.
  "data": [
    {
      // returned records
      "_id": "5fd767259cd24bb563567d7c",
      "name": "range name",
      "subnets": [
        {
          "mask": 112,
          "address": "0000:0000:0000:0000:0000:ffff:c5c6:0000",
          "originalString": "197.198.192.20/16"
        }
      ],
      "location": {
        "name": "United States",
        "latitude": 39.5035514831543,
        "longitude": -99.01830291748047,
        "countryCode": "US",
        "countryName": "United States"
      },
      "organization": "isp name",
      "tags": [
        {
          "_id": "5ce2aaf42207ad108c76fa3a",
          "id": "000000290000000000000000",
          "target": 1,
          "type": 2,
          "name": "Contoso",
          "nameTemplate": {
            "template": "SAGE_BUILTIN_TAG_CONTOSO_NAME"
          },
          "description": "IP addresses used by Contoso",
          "descriptionTemplate": {
            "template": "SAGE_BUILTIN_TAG_CONTOSO_DESCRIPTION"
          },
          "visibility": 0,
          "status": 0,
          "_tid": 113348336
        }
      ],
      "category": 5,
      "lastModified": 1607952165309.8032,
      "_tid": 113348336
    }
  ]
}

Если у вас возникли проблемы, мы здесь, чтобы помочь. Чтобы получить помощь или поддержку проблемы с продуктом, откройте запрос в службу поддержки.

Поделиться через