removeBulkHardwareAccess

Classes SoftLayer_User_Customer_OpenIdConnect
Tags method sldn user

SoftLayer_User_Customer_OpenIdConnect::removeBulkHardwareAccess

Remove multiple hardware from a portal user’s hardware access list.

Description

Remove multiple hardware from a portal user’s hardware access list. A user’s hardware access list controls which of an account’s hardware objects a user has access to in the SoftLayer customer portal and API. Hardware does not exist in the SoftLayer portal and returns “not found” exceptions in the API if the user doesn’t have access to it. If a user does not has access to the hardware you’re attempting to remove then removeBulkHardwareAccess() returns true.

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

If the user has full hardware access, then it will provide access to “ALL but passed in” hardware ids.

Parameters

Name Type Description
hardwareIds int[] Hardware IDs

Required Headers

Optional Headers

  • None

Return Values

  • boolean

Error Handling

  • Throws the exception “You may not grant or deny Master User device access.” when trying to remove hardware access to a master user.
  • Throws the exception “You may not grant or deny yourself device access.” when trying to remove hardware access to the user making the call to the SoftLayer API.
  • Throws the exception “You may not grant or deny device access to other users.” when trying to remove hardware access the user making the API call is not their account’s master user or does not have the “USER_MANAGE” portal permission.
  • Throws the exception “Please specify a valid hardware id.” if the given hardware id is not a valid hardware id.
  • Throws the exception “Unable to remove user hardware access.” if the API was unable to remove hardware access from the given portal user.

Associated Methods

curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [int]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_User_Customer_OpenIdConnect/{SoftLayer_User_Customer_OpenIdConnectID}/removeBulkHardwareAccess'