Lista — interfejs API wzbogacania danych
Uruchom żądanie GET lub POST, aby pobrać listę zakresów adresów IP pasujących do określonych filtrów.
Żądanie systemu HTTP
GET /api/v1/subnet/
POST /api/v1/subnet/
Parametry TREŚĆ żądania
Parametr | Opis |
---|---|
filtry | Filtrowanie obiektów za pomocą wszystkich filtrów wyszukiwania dla żądania, zobacz Filtry zakresu adresów IP, aby uzyskać więcej szczegółów |
Sortdirection | Kierunek sortowania. Możliwe wartości to: asc i desc |
sortField | Pola używane do sortowania zakresów adresów IP. Dopuszczalne wartości: - category: kategoria zakresu adresów IP - tags: tagi zakresu adresów IP - name: nazwa zakresu adresów IP |
skip | Pomija określoną liczbę rekordów |
limit | Maksymalna liczba rekordów zwracanych przez żądanie |
Przykład
Zażądaj
Oto przykład żądania.
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
Zwraca listę zakresów adresów IP w formacie JSON. Aby uzyskać informacje o polach odpowiedzi, zobacz Właściwości.
{
"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
}
]
}
Jeśli napotkasz jakiekolwiek problemy, jesteśmy tutaj, aby pomóc. Aby uzyskać pomoc lub pomoc techniczną dotyczącą problemu z produktem, otwórz bilet pomocy technicznej.