Skip to main content

role_permissions

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

Overview

Namerole_permissions
TypeResource
Iddatadog.organization.role_permissions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringID of the permission.
attributesobjectAttributes of a permission.
typestringPermissions resource type. (default: permissions, example: permissions)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_role_permissionsselectrole_id, regionReturns a list of all permissions for a single role.
add_permission_to_roleinsertrole_id, regionAdds a permission to a role.
remove_permission_from_roledeleterole_id, regionRemoves a permission from a role.
remove_user_from_roledeleterole_id, regionRemoves a user from a role.

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
regionstring(default: datadoghq.com)
role_idstringThe unique identifier of the role.

SELECT examples

Returns a list of all permissions for a single role.

SELECT
id,
attributes,
type
FROM datadog.organization.role_permissions
WHERE role_id = '{{ role_id }}' -- required
AND region = '{{ region }}' -- required
;

INSERT examples

Adds a permission to a role.

INSERT INTO datadog.organization.role_permissions (
data__data,
role_id,
region
)
SELECT
'{{ data }}',
'{{ role_id }}',
'{{ region }}'
RETURNING
data
;

DELETE examples

Removes a permission from a role.

DELETE FROM datadog.organization.role_permissions
WHERE role_id = '{{ role_id }}' --required
AND region = '{{ region }}' --required
;