sessions

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

Overview

Name	sessions
Type	Resource
Id	aws.wisdom.sessions

Fields

The following fields are returned by SELECT queries:

get_session

Name	Datatype	Description
name	string	The name of the session. (pattern: <code>^[a-zA-Z0-9\s_.,-]+</code>)
description	string	The description of the session. (pattern: <code>^[a-zA-Z0-9\s_.,-]+</code>)
integration_configuration	object	The configuration information for the session integration.
session_arn	string	The Amazon Resource Name (ARN) of the session. (pattern: <code>^arn:[a-z-]?:wisdom:[a-z0-9-]?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?$</code>)
session_id	string	The identifier of the session. (pattern: <code>^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$</code>)
tags	object	The tags used to organize, track, or control access for this resource.

search_sessions

Name	Datatype	Description
assistant_arn	string	The Amazon Resource Name (ARN) of the Wisdom assistant. (pattern: <code>^arn:[a-z-]?:wisdom:[a-z0-9-]?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?$</code>)
assistant_id	string	The identifier of the Wisdom assistant. (pattern: <code>^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$</code>)
session_arn	string	The Amazon Resource Name (ARN) of the session. (pattern: <code>^arn:[a-z-]?:wisdom:[a-z0-9-]?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?$</code>)
session_id	string	The identifier of the session. (pattern: <code>^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$</code>)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_session	select	assistant_id, session_id, region		Retrieves information for a specified session.
search_sessions	select	assistant_id, region	maxResults, nextToken	Searches for sessions.
create_session	insert	assistant_id, region, name		Creates a session. A session is a contextual container used for generating recommendations. Amazon Connect creates a new Wisdom session for each contact on which Wisdom is enabled.

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
assistant_id	string	The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
region	string	AWS region (default: us-east-1)
session_id	string	The identifier of the session. Can be either the ID or the ARN. URLs cannot contain the ARN.
maxResults	integer	The maximum number of results to return per page.
nextToken	string	The 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

get_session

Retrieves information for a specified session.

SELECT
name,
description,
integration_configuration,
session_arn,
session_id,
tags
FROM aws.wisdom.sessions
WHERE assistant_id = '{{ assistant_id }}' -- required
AND session_id = '{{ session_id }}' -- required
AND region = '{{ region }}' -- required
;

search_sessions

Searches for sessions.

SELECT
assistant_arn,
assistant_id,
session_arn,
session_id
FROM aws.wisdom.sessions
WHERE assistant_id = '{{ assistant_id }}' -- required
AND region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;

INSERT examples

create_session

Creates a session. A session is a contextual container used for generating recommendations. Amazon Connect creates a new Wisdom session for each contact on which Wisdom is enabled.

INSERT INTO aws.wisdom.sessions (
clientToken,
description,
name,
tags,
assistant_id,
region
)
SELECT 
'{{ clientToken }}',
'{{ description }}',
'{{ name }}' /* required */,
'{{ tags }}',
'{{ assistant_id }}',
'{{ region }}'
RETURNING
session
;

Manifest

# Description fields are for documentation purposes
- name: sessions
props:
  - name: assistant_id
    value: "{{ assistant_id }}"
    description: Required parameter for the sessions resource.
  - name: region
    value: "{{ region }}"
    description: Required parameter for the sessions resource.
  - name: clientToken
    value: "{{ clientToken }}"
  - name: description
    value: "{{ description }}"
  - name: name
    value: "{{ name }}"
  - name: tags
    value: "{{ tags }}"