role_resource_sets

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

Overview

Name	role_resource_sets
Type	Resource
Id	okta.iam.role_resource_sets

Fields

The following fields are returned by SELECT queries:

get_resource_set

Name	Datatype	Description
id	string	Unique ID for the resource set object
_links	object	Specifies link relations (see Web Linking) available using the JSON Hypertext Application Language specification. This object is used for dynamic discovery of related resources and lifecycle operations.
created	string (date-time)	Timestamp when the role was created
description	string	Description of the resource set
label	string	Unique label for the resource set
lastUpdated	string (date-time)	Timestamp when the role was last updated

list_resource_sets

Name	Datatype	Description
_links	object	Specifies link relations (see Web Linking) available for the current status of an application using the JSON Hypertext Application Language specification. Use the LinksNext object for dynamic discovery of related resources and lifecycle operations.
resource-sets	array

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_resource_set	select	resourceSetIdOrLabel, subdomain		Retrieves a resource set by resourceSetIdOrLabel
list_resource_sets	select	subdomain	after	Lists all resource sets with pagination support
create_resource_set	insert	subdomain, description, label, resources		Creates a new resource set. See Supported resources. > Note: The maximum number of resources allowed in a resource set object is 1000. Resources are identified by either an Okta Resource Name (ORN) or by a REST URL format. See Okta Resource Name.
replace_resource_set	replace	resourceSetIdOrLabel, subdomain		Replaces the label and description of a resource set. See Supported resources.
delete_resource_set	delete	resourceSetIdOrLabel, subdomain		Deletes a resource set by resourceSetIdOrLabel

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.

Name	Datatype	Description
resourceSetIdOrLabel	string	id or label of the resource set
subdomain	string	(default: my-org)
after	string	The cursor to use for pagination. It is an opaque string that specifies your current location in the list and is obtained from the Link response header. See Pagination and Link header.

SELECT examples

get_resource_set

Retrieves a resource set by resourceSetIdOrLabel

SELECT
id,
_links,
created,
description,
label,
lastUpdated
FROM okta.iam.role_resource_sets
WHERE resourceSetIdOrLabel = '{{ resourceSetIdOrLabel }}' -- required
AND subdomain = '{{ subdomain }}' -- required
;

list_resource_sets

Lists all resource sets with pagination support

SELECT
_links,
resource-sets
FROM okta.iam.role_resource_sets
WHERE subdomain = '{{ subdomain }}' -- required
AND after = '{{ after }}'
;

INSERT examples

create_resource_set

Creates a new resource set. See Supported resources.

> Note: The maximum number of resources allowed in a resource set object is 1000. Resources are identified by either an Okta Resource Name (ORN) or by a REST URL format. See Okta Resource Name.

INSERT INTO okta.iam.role_resource_sets (
description,
label,
resources,
subdomain
)
SELECT 
'{{ description }}' /* required */,
'{{ label }}' /* required */,
'{{ resources }}' /* required */,
'{{ subdomain }}'
RETURNING
id,
_links,
created,
description,
label,
lastUpdated
;

Manifest

# Description fields are for documentation purposes
- name: role_resource_sets
props:
  - name: subdomain
    value: "{{ subdomain }}"
    description: Required parameter for the role_resource_sets resource.
  - name: description
    value: "{{ description }}"
    description: |
      Description of the resource set
  - name: label
    value: "{{ label }}"
    description: |
      Unique name for the resource set
  - name: resources
    value:
      - "{{ resources }}"
    description: |
      The endpoint (URL) that references all resource objects included in the resource set. Resources are identified by either an Okta Resource Name (ORN) or by a REST URL format. See [Okta Resource Name](https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn).

REPLACE examples

replace_resource_set

Replaces the label and description of a resource set. See Supported resources.

REPLACE okta.iam.role_resource_sets
SET 
description = '{{ description }}',
label = '{{ label }}'
WHERE 
resourceSetIdOrLabel = '{{ resourceSetIdOrLabel }}' --required
AND subdomain = '{{ subdomain }}' --required
RETURNING
id,
_links,
created,
description,
label,
lastUpdated;

DELETE examples

delete_resource_set

Deletes a resource set by resourceSetIdOrLabel

DELETE FROM okta.iam.role_resource_sets
WHERE resourceSetIdOrLabel = '{{ resourceSetIdOrLabel }}' --required
AND subdomain = '{{ subdomain }}' --required
;