createObject


SoftLayer_User_Permission_Group::createObject

Create a new customer permission group

Description

Customer created permission groups must be of type NORMAL. The SYSTEM type is reserved for internal use. The account id supplied in the template permission group must match account id of the user who is creating the permission group. The user who is creating the permission group must have the permission to manage users.

Parameters

Name Type Description
templateObject SoftLayer_User_Permission_Group The SoftLayer_User_Permission_Group object that you wish to create.

Required Headers

Optional Headers

Return Values

Error Handling

  • Throws the exception “You cannot create group: Permission Denied.” if a customer user attempts to create a permission group without the proper permission.
  • Throws the exception “You cannot create system group” if a customer user attempts to create a SYSTEM permission group.
  • Throws the exception “You cannot create Groups on other accounts.” if a customer user attempts to create a permission group on an account other than their own.
curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [SoftLayer_User_Permission_Group]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_User_Permission_Group/createObject'