addBulkPortalPermission

Classes SoftLayer_User_Customer
Tags method sldn user

SoftLayer_User_Customer::addBulkPortalPermission

Add multiple permissions to a portal user’s permission set.

Description

Add multiple permissions to a portal user’s permission set. SoftLayer_User_Customer_CustomerPermission_Permission control which features in the SoftLayer customer portal and API a user may use. addBulkPortalPermission() does not attempt to add permissions already assigned to the user.

Users can assign permissions to their child users, but not to themselves. An account’s master has all portal permissions and can set permissions for any of the other users on their account.

Use the SoftLayer_User_Customer_CustomerPermission_Permission::getAllObjects method to retrieve a list of all permissions available in the SoftLayer customer portal and API. Permissions are removed based on the keyName property of the permission objects within the permissions parameter.

Parameters

Name Type Description
permissions SoftLayer_User_Customer_CustomerPermission_Permission[] A collection of permissions to assign to this user.

Required Headers

Optional Headers

  • None

Return Values

  • boolean

Error Handling

  • Throws the exception “You may not add permissions to your account.” when trying to add permissions to the user making calling the SoftLayer API.
  • Throws the exception “Please specify a permission key name.” if the keyName property of the permission parameter is empty.
  • Throws the exception “Unable to locate a permission with the key name {key name}.” when trying to assign an unknown permission to a user.
  • Throws the exception “Unable to add user permission {key name}.” if the API was unable to assign the given permission to the given portal user.

Associated Methods

curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [SoftLayer_User_Customer_CustomerPermission_Permission]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_User_Customer/{SoftLayer_User_CustomerID}/addBulkPortalPermission'