Skip to main content

user_proficiencies

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

Overview

Nameuser_proficiencies
TypeResource
Idaws.connect.user_proficiencies

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
attribute_namestringThe name of user's proficiency. You must use name of predefined attribute present in the Connect Customer instance.
attribute_valuestringThe value of user's proficiency. You must use value of predefined attribute present in the Connect Customer instance.
levelnumber (float)The level of the proficiency. The valid values are 1, 2, 3, 4 and 5.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_user_proficienciesselectinstance_id, user_id, regionnextToken, maxResultsLists proficiencies associated with a user.
associate_user_proficienciesupdateinstance_id, user_id, region, UserProficienciesAssociates a set of proficiencies with a user.
disassociate_user_proficienciesexecinstance_id, user_id, region, UserProficienciesDisassociates a set of proficiencies from a user.
update_user_proficienciesexecinstance_id, user_id, region, UserProficienciesUpdates the properties associated with the proficiencies of a user.

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)
user_idstringThe identifier of the user account.
maxResultsintegerThe maximum number of results to return per page.
nextTokenstringThe token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

SELECT examples

Lists proficiencies associated with a user.

SELECT
attribute_name,
attribute_value,
level
FROM aws.connect.user_proficiencies
WHERE instance_id = '{{ instance_id }}' -- required
AND user_id = '{{ user_id }}' -- required
AND region = '{{ region }}' -- required
AND nextToken = '{{ nextToken }}'
AND maxResults = '{{ maxResults }}'
;

UPDATE examples

Associates a set of proficiencies with a user.

UPDATE aws.connect.user_proficiencies
SET
UserProficiencies = '{{ UserProficiencies }}'
WHERE
instance_id = '{{ instance_id }}' --required
AND user_id = '{{ user_id }}' --required
AND region = '{{ region }}' --required
AND UserProficiencies = '{{ UserProficiencies }}' --required;

Lifecycle Methods

Disassociates a set of proficiencies from a user.

EXEC aws.connect.user_proficiencies.disassociate_user_proficiencies
@instance_id='{{ instance_id }}' --required,
@user_id='{{ user_id }}' --required,
@region='{{ region }}' --required
@@json=
'{
"UserProficiencies": "{{ UserProficiencies }}"
}'
;