Create Address Group
Creates a new address group.
Required Permissions
Requires the ADMIN role or higher.
HTTP Request
POST /api/sonar/address-groups
cURL Example
curl -H "Authorization: Bearer <API_KEY>" \
-d name=Exceptions \
-X POST \
https://HOSTNAME/api/sonar/address-groups
Request Parameters
| Key | Required | Type | Description | Note |
|---|---|---|---|---|
| name | O | String | Address group name | Minimum 1 to maximum 50 characters |
| guid | X | String | Address group GUID | 36 characters. The default value is randomly generated. |
| description | X | String | Address group description | Maximum 2,000 characters |
Success Response
{}
Error Responses
Required argument is missing
HTTP status code 400
{
"error_code": "null-argument",
"error_msg": "name should be not null"
}
Invalid argument length
HTTP status code 400
{
"error_code": "invalid-argument",
"error_msg": "'name' must be shorter than or equal to 50 characters."
}
Identifier is not in valid GUID format
HTTP status code 400
{
"error_code": "invalid-param-type",
"error_msg": "guid should be guid type."
}