Remove Subnet Groups

Deletes the specified subnet groups.

Required Permissions

Requires the ADMIN role or higher.

HTTP Request

DELETE /api/sonar/subnet-groups
cURL Example
curl -H "Authorization: Bearer <API_KEY>" \
     -X DELETE \
     "https://HOSTNAME/api/sonar/subnet-groups?guids=638cfeb2-e259-46af-961a-1eeb65ea35f0"
Request Parameter
KeyRequiredTypeDescriptionNote
guidsOList (of strings)Subnet group GUID listComma-separated list

Success Response

{
    "failures": []
}

Error Responses

Subnet group is not found

HTTP status code 200

{
    "failures": [
        {
            "id": "c1dfe306-abba-4ed8-862b-0e98e2effcb6",
            "reason": "subnet-group-not-found"
        }
    ]
}
No privileges to delete a subnet group

HTTP status code 500

{
    "error_code": "illegal-state",
    "error_msg": "no-permission"
}