Delete Collector
Delete a collector by name and type.
POST https://instance.securid.com/aveksa/command.submit?cmd=deleteCollector
note
Requires a user with System:Manage privilege.
Request
Parameters
| deleteCollector | |
| The friendly name of the collector to delete. | |
The type of the collector. Valid values: Identity Activity Account Entitlement Role Metadata MAEDC |
Headers
Bearer token | |
| Accept | application/json |
| Content-Type | application/json |
Response
On success, the server returns 200 with the following body.
Examples
Request
- Curl
- Python
- Node.js
curl -K -X POST \
"https://instance.securid.com/aveksa/command.submit?cmd=deleteCollector&name=Sample+ADC&type=Account" \
-H "Authorization: Bearer <token>"
import requests
url = "https://instance.securid.com/aveksa/command.submit"
params = {
"cmd": "deleteCollector",
"name": "Sample ADC",
"type": "Account"
}
headers = {
'Authorization': 'Bearer <token>'
}
response = requests.post(url, params=params, headers=headers)
if response.status_code == 200:
print("Collector deleted successfully")
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: "deleteCollector",
name: "Sample ADC",
type: "Account"
};
const headers = {
'Authorization': 'Bearer <token>'
};
axios.post(url, null, { params, headers })
.then(response => {
if (response.status === 200) {
console.log("Collector deleted successfully");
} else {
console.log(`Request failed with status code ${response.status}`);
}
})
.catch(error => {
console.error('Error:', error);
});
Response
- 200
- 401 Invalid Token
- 404 Not Found
- 405 Wrong Method
- 412 Missing name
- 412 Missing type
- 412 Invalid type
{
"data": {
"type": "deleteCollector"
}
}
<html>
<head>
<title>Error</title>
</head>
<body>The token is not valid for the command 'deleteCollector'. Token is invalid or expired</body>
</html>
Returned when no collector matches the specified name and type. The response body contains no error message.
<html>
<head>
<title>Error</title>
</head>
<body>
Query String=cmd=deleteCollector&format=json&name=NonExistentCollector&type=Account</body>
</html>
Returned when the request is sent as GET instead of POST.
<html>
<head>
<title>Error</title>
</head>
<body>The command must be executed using a HTTP POST request
Query String=cmd=deleteCollector&format=json&name=Sample+ADC&type=Account</body>
</html>
<html>
<head>
<title>Error</title>
</head>
<body>The parameter name is required.
Query String=cmd=deleteCollector&format=json&type=Account</body>
</html>
<html>
<head>
<title>Error</title>
</head>
<body>The parameter type is required.
Query String=cmd=deleteCollector&format=json&name=Sample+ADC</body>
</html>
Returned when the type value is not one of the accepted collector types.
<html>
<head>
<title>Error</title>
</head>
<body>Invalid value bogus for the parameter type
Query String=cmd=deleteCollector&format=json&name=Sample+ADC&type=bogus</body>
</html>
Verified with RSA Governance & Lifecycle version 8.0.0.188886 P10_HF01.