Tenable Security Center API: Bulk

/bulk

The bulk endpoint is very resource intensive. Requests that are too large may fail. It is recommended to minimize the payload size of requests to bulk.

Methods
POST

Performs a bulk action, depending on access and permissions.

NOTE #1: Currently supported bulk actions (with links to their respective documentation):

NOTE #2: If a bulk post fails on one object, the bulk operation will continue to attempt other objects, return a fail response indicating failed objects, and rollback all bulk actions.

NOTE #2:  For a bulk ACR edit, which is bulk action /hosts/acr::PATCH, all bulk operations that are successful will make the change to the object, and the bulk operations that fail will of course not make the change.  But there will be a fail response for the overall bulk request and the returned fail response indicates which operations failed. All operations are attempted even if some fail.

Request Parameters
Expand
1
2
3
4
5
6
7
8
9
10
11
12
{
    "operations" : [
        {
            "api" : <string> "/asset" | "/asset/<id>" | "/dashboard/<id>/component" | "/dashboard/<id>/component/<id>" | "/hosts/acr" | "/query" | "/query/<id>" | "/recastRiskRule",
            "method" : <string> "DELETE" | "GET" | "PATCH" | "POST",
           method "GET"            ------------
            "params" : <valid object parameters:see NOTE #1> DEFAULT {}
 
            method not "GET"            ----------------
            "params" : <valid object parameters:see NOTE #1>      }...
    ]
}
Example Response
Expand
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
{
    "type" : "regular",
    "response" : [
        {
            "type" : "regular",
            "response" : {
                "id" : "38",
                "name" : "testBulk",
                "type" : "dynamic",
                "description" : "",
                "tags" : "",
                "context" : "",
                "status" : "0",
                "createdTime" : "1414436709",
                "modifiedTime" : "1423678805",
                "typeFields" : {
                    "rules" : {
                        "operator" : "any",
                        "children" : [
                            {
                                "filterName" : "ip",
                                "operator" : "eq",
                                "value" : "192.168.0.0\/24",
                                "pluginIDConstraint" : "-1",
                                "type" : "clause"                           }
                        ],
                        "type" : "group"                    }
                },
                "repositories" : [],
                "ipCount" : 0,
                "groups" : [],
                "assetDataFields" : [],
                "canUse" : "true",
                "canManage" : "true",
                "creator" : {
                    "id" : "1",
                    "username" : "head",
                    "firstname" : "Security Manager",
                    "lastname" : ""             },
                "owner" : {
                    "id" : "1",
                    "username" : "head",
                    "firstname" : "Security Manager",
                    "lastname" : ""             },
                "template" : {
                    "id" : -1,
                    "name" : "",
                    "description" : ""              },
                "ownerGroup" : {
                    "id" : "0",
                    "name" : "Full Access",
                    "description" : "Full Access group"             },
                "targetGroup" : {
                    "id" : -1,
                    "name" : "",
                    "description" : ""              }
            },
            "error_code" : 0,
            "error_msg" : "",
            "warnings" : [],
            "timestamp" : 1423678804
        },
        {
            "type" : "regular",
            "response" : {
                "id" : "38",
                "name" : "testBulk2",
                "type" : "dynamic",
                "description" : "",
                "tags" : "",
                "context" : "",
                "status" : "0",
                "createdTime" : "1414436709",
                "modifiedTime" : "1423678805",
                "typeFields" : {
                "rules" : {
                    "operator" : "any",
                    "children" : [
                        {
                            "filterName" : "ip",
                            "operator" : "eq",
                            "value" : "192.168.0.0\/24",
                            "pluginIDConstraint" : "-1",
                            "type" : "clause"                       }
                    ],
                    "type" : "group"                }
                },
                "repositories" : [],
                "ipCount" : 0,
                "groups" : [],
                "assetDataFields" : [],
                "canUse" : "true",
                "canManage" : "true",
                "creator" : {
                    "id" : "1",
                    "username" : "head",
                    "firstname" : "Security Manager",
                    "lastname" : ""             },
                "owner" : {
                    "id" : "1",
                    "username" : "head",
                    "firstname" : "Security Manager",
                    "lastname" : ""             },
                "template" : {
                    "id" : -1,
                    "name" : "",
                    "description" : ""              },
                "ownerGroup" : {
                    "id" : "0",
                    "name" : "Full Access",
                    "description" : "Full Access group"             },
                "targetGroup" : {
                    "id" : -1,
                    "name" : "",
                    "description" : ""              }
            },
            "error_code" : 0,
            "error_msg" : "",
            "warnings" : [],
            "timestamp" : 1423678804
        }
    ],
    "error_code" : 0,
    "error_msg" : "",
    "warnings" : [],
    "timestamp" : 1423678804
}