Skip to main content

grants

Creates, updates, deletes, gets or lists a grants resource.

Overview

Namegrants
TypeResource
Idlinode.profile.grants

Fields

The following fields are returned by SELECT queries:

GrantsResponse.

NameDatatypeDescription
databasearrayThe grants this user has for individual Managed Databases on this account.
domainarrayThe grants this user has for individual domains on this account.
firewallarrayThe grants this user has for individual firewalls on this account.
globalobjectThe grants the user has to all resources on your account.
imagearrayThe grants this user has for individual images on this account.
linodearrayThe grants this user has for individual Linodes on this account.
longviewarrayThe grants this user has for individual Longview Clients on this account.
nodebalancerarrayThe grants this user has for individual NodeBalancers on this account.
stackscriptarrayThe grants this User has for individual StackScripts on this account.
volumearrayThe grants this user has individual Block Storage Volumes on this account.
vpcarrayThe grants this user has individual Virtual Private Clouds (VPCs) on this account.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_profile_grantsselectThis returns a GrantsResponse describing what the acting User has been granted access to. For unrestricted users, this will return a 204 and no body because unrestricted users have access to everything without grants. This will not return information about entities you do not have access to. This operation is useful when writing third-party OAuth applications to see what options you should present to the acting User.

For example, if they do not have global.add_linodes, you might not display a button to deploy a new Linode.

Any client may run this operation; no OAuth scopes are required.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription

SELECT examples

This returns a GrantsResponse describing what the acting User has been granted access to. For unrestricted users, this will return a 204 and no body because unrestricted users have access to everything without grants. This will not return information about entities you do not have access to. This operation is useful when writing third-party OAuth applications to see what options you should present to the acting User.

For example, if they do not have global.add_linodes, you might not display a button to deploy a new Linode.

Any client may run this operation; no OAuth scopes are required.

SELECT
database,
domain,
firewall,
global,
image,
linode,
longview,
nodebalancer,
stackscript,
volume,
vpc
FROM linode.profile.grants;