Create Subnet Group

Creates a new subnet group.

HTTP Request

POST /api/sonar/subnet-groups
Request using cURL
curl -H "Authorization: Bearer <API_KEY>" \
     -d name="OA" \
     -d description="Office zone" \
     -X POST \
     https://HOSTNAME/api/sonar/subnet-groups
Request Parameters
KeyRequiredTypeDescriptionNote
guidXStringSubnet group GUID36 characters. Randomly generated if not specified.
nameOStringSubnet group nameMinimum 1 to maximum 50 characters
descriptionXStringSubnet descriptionMaximum 50 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 less than or equal to 50 characters."
}
Duplicate group name

HTTP status code 500

{
    "error_code": "illegal-state",
    "error_msg": "duplicated subnet group name: OA"
}
No privilege to create a subnet group

HTTP status code 500

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