Skip to main content

user_hierarchy_structures

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

Overview

Nameuser_hierarchy_structures
TypeResource
Idaws.connect.user_hierarchy_structures

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
level_fiveobjectInformation about level five.
level_fourobjectInformation about level four.
level_oneobjectInformation about level one.
level_threeobjectInformation about level three.
level_twoobjectInformation about level two.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_user_hierarchy_structureselectinstance_id, regionDescribes the hierarchy structure of the specified Connect Customer instance.
update_user_hierarchy_structureupdateinstance_id, region, HierarchyStructureUpdates the user hierarchy structure: add, remove, and rename user hierarchy levels.

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
instance_idstringThe identifier of the Connect Customer instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
regionstringAWS region (default: us-east-1)

SELECT examples

Describes the hierarchy structure of the specified Connect Customer instance.

SELECT
level_five,
level_four,
level_one,
level_three,
level_two
FROM aws.connect.user_hierarchy_structures
WHERE instance_id = '{{ instance_id }}' -- required
AND region = '{{ region }}' -- required
;

UPDATE examples

Updates the user hierarchy structure: add, remove, and rename user hierarchy levels.

UPDATE aws.connect.user_hierarchy_structures
SET
HierarchyStructure = '{{ HierarchyStructure }}'
WHERE
instance_id = '{{ instance_id }}' --required
AND region = '{{ region }}' --required
AND HierarchyStructure = '{{ HierarchyStructure }}' --required;