Collect Accounts
Run one or more account collectors. All collectors run when no name or businessSource is specified.
GET https://instance.securid.com/aveksa/command.submit?cmd=collectAccounts
note
Requires a user with System:Manage privilege.
Request
Parameters
| collectAccounts | |
| format | properties - (Default) Returns the response as key=value pairs. When multiple collectors run, run-id is a CSV of all run IDs.json - Returns the response as JSON. |
| name | The friendly name of the collector to run. If omitted, all account collectors are processed. |
| businessSource | The friendly name of the business source. If omitted, all business sources are processed. |
| force | Set to true to ignore circuit breaker thresholds and force collection regardless of prior run state. |
Headers
Bearer token | |
| Accept | application/json |
| Content-Type | application/json |
Response
Parameters
run-id | The ID assigned to the collection run. When multiple collectors run, this is a CSV of all run IDs. |
run-source-xx | The name of the collector for run ID xx. One key appears per collector that ran. |
Examples
Request
- Curl
- Python
- Node.js
curl -K -X GET \
"https://instance.securid.com/aveksa/command.submit?cmd=collectAccounts&format=json&name=Sample+ADC" \
-H "Authorization: Bearer <token>"
import requests
url = "https://instance.securid.com/aveksa/command.submit"
params = {
"cmd": "collectAccounts",
"format": "json",
"name": "Sample ADC"
}
headers = {
'Authorization': 'Bearer <token>'
}
response = requests.get(url, params=params, headers=headers)
if response.status_code == 200:
data = response.json()
print(data)
else:
print(f"Request failed with status code {response.status_code}")
const axios = require('axios');
const url = "https://instance.securid.com/aveksa/command.submit";
const params = {
cmd: "collectAccounts",
format: "json",
name: "Sample ADC"
};
const headers = {
'Authorization': 'Bearer <token>'
};
axios.get(url, { params, headers })
.then(response => {
if (response.status === 200) {
console.log(response.data);
} else {
console.log(`Request failed with status code ${response.status}`);
}
})
.catch(error => {
console.error('Error:', error);
});
Response
- 200 (Properties)
- 200 (JSON)
- 200 Multiple
- 401 Invalid Token
- 403 Insufficient Privileges
- 404 Invalid name
- 404 Invalid businessSource
Default format when format is omitted.
run-id=1001
run-source-1001=Sample ADC
{
"data": {
"type": "collectAccounts",
"run-id": "1001",
"run-source-1001": "Sample ADC"
}
}
Returned when no name or businessSource is specified and all collectors run. run-id is a CSV of all run IDs.
{
"data": {
"type": "collectAccounts",
"run-id": "1001,1002,1003",
"run-source-1001": "Sample ADC 1",
"run-source-1002": "Sample ADC 2",
"run-source-1003": "Sample ADC 3"
}
}
<html>
<head>
<title>Error</title>
</head>
<body>The token is not valid for the command 'collectAccounts'. Token is invalid or expired</body>
</html>
Returned when the token does not have System:Manage privilege.
<html>
<head>
<title>Error</title>
</head>
<body>Unauthorized request for collectAccounts from client address /192.0.2.1</body>
</html>
Returned when the name value does not match any account collector.
<html>
<head>
<title>Error</title>
</head>
<body>Error running a collection for the account collectors InvalidName
Query String=cmd=collectAccounts&format=json&name=InvalidName</body>
</html>
Returned when the businessSource value does not match any business source.
<html>
<head>
<title>Error</title>
</head>
<body>Error running a collection for the application InvalidSource
Query String=cmd=collectAccounts&format=json&businessSource=InvalidSource</body>
</html>
Verified with RSA Governance & Lifecycle version 8.0.0.188886 P10_HF01.