Cisco AMP for Endpoints API

GET /v1/file_lists/application_blocking

Description

Returns a list of application blocking file lists. You can filter this list by name.

Query Parameters

Name Type Example Values Description
name[] String Sample Application Blocking List
limit Integer 10, 3
offset Integer 2

Show Response Fields

Name Type Description
version String
metadata.links.self String
metadata.links.prev String
metadata.links.next String
metadata.results.total Integer
metadata.results.current_item_count Integer
metadata.results.index Integer
metadata.results.items_per_page Integer
data Array
data[].name String
data[].guid GUID
data[].type String
data[].links.file_list String
Write
Preview
Auto Generate

Examples

Fetch list of application_blocking file_lists
Fetch list of application_blocking file_lists filtered by name

Fetch list of application_blocking file_lists

Request

Requires Authorization 
GET /v1/file_lists/application_blocking?limit=3&offset=2
Headers
accept: application/json
content-type: application/json
authorization: Basic FILTERED

cURL Edit, then copy and paste on your terminal

curl -X GET \
-H 'accept: application/json' \
-H 'content-type: application/json' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-u YOUR_API_CLIENT_ID \
'https://api.amp.cisco.com/v1/file_lists/application_blocking?limit=3&offset=2'

Response

Shortened for readability 

x-ratelimit-limit: 3000
x-ratelimit-reset: 3315
x-ratelimit-remaining: 2864
x-frame-options: SAMEORIGIN
x-ratelimit-resetdate: 2017-08-18T03:52:38Z
strict-transport-security: max-age=31536000
status: 200 OK
transfer-encoding: chunked
content-type: application/json; charset=utf-8

{
  "version": "v1.2.0",
  "metadata": {
    "links": {
      "self": "https://api.amp.cisco.com/v1/file_lists/application_blocking?limit=3&offset=2",
      "prev": "https://api.amp.cisco.com/v1/file_lists/application_blocking?limit=3&offset=0",
      "next": "https://api.amp.cisco.com/v1/file_lists/application_blocking?limit=3&offset=5"
    },
    "results": {
      "total": 6,
      "current_item_count": 3,
      "index": 2,
      "items_per_page": 3
    }
  },
  "data": [
    {
      "name": "Sample Application Blocking List 2",
      "guid": "e4984c9b-651a-499e-a6fe-9ee938dab661",
      "type": "application_blocking",
      "links": {
        "file_list": "https://api.amp.cisco.com/v1/file_lists/e4984c9b-651a-499e-a6fe-9ee938dab661"
      }
    },
    {
      "name": "Sample Application Blocking List 3",
      "guid": "0fda9022-9491-4982-9066-adc4f65007bc",
      "type": "application_blocking",
      "links": {
        "file_list": "https://api.amp.cisco.com/v1/file_lists/0fda9022-9491-4982-9066-adc4f65007bc"
      }
    }
  ]
}

Fetch list of application_blocking file_lists filtered by name

Request

Requires Authorization 
GET /v1/file_lists/application_blocking?name[]=Sample%20Application%20Blocking%20List&limit=10
Headers
accept: application/json
content-type: application/json
authorization: Basic FILTERED

cURL Edit, then copy and paste on your terminal

curl -X GET \
-H 'accept: application/json' \
-H 'content-type: application/json' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-u YOUR_API_CLIENT_ID \
'https://api.amp.cisco.com/v1/file_lists/application_blocking?name[]=Sample%20Application%20Blocking%20List&limit=10'

Response

Shortened for readability 

x-ratelimit-limit: 3000
x-ratelimit-reset: 3314
x-ratelimit-remaining: 2863
x-frame-options: SAMEORIGIN
x-ratelimit-resetdate: 2017-08-18T03:52:38Z
strict-transport-security: max-age=31536000
status: 200 OK
transfer-encoding: chunked
content-type: application/json; charset=utf-8

{
  "version": "v1.2.0",
  "metadata": {
    "links": {
      "self": "https://api.amp.cisco.com/v1/file_lists/application_blocking?name[]=Sample%20Application%20Blocking%20List&limit=10"
    },
    "results": {
      "total": 6,
      "current_item_count": 6,
      "index": 0,
      "items_per_page": 10
    }
  },
  "data": [
    {
      "name": "Sample Application Blocking List",
      "guid": "e773a9eb-296c-40df-98d8-bed46322589d",
      "type": "application_blocking",
      "links": {
        "file_list": "https://api.amp.cisco.com/v1/file_lists/e773a9eb-296c-40df-98d8-bed46322589d"
      }
    },
    {
      "name": "Sample Application Blocking List 1",
      "guid": "c37aeaa4-0010-486a-961f-d0b34390bcd0",
      "type": "application_blocking",
      "links": {
        "file_list": "https://api.amp.cisco.com/v1/file_lists/c37aeaa4-0010-486a-961f-d0b34390bcd0"
      }
    }
  ]
}