segment_versions

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

Overview

Name	segment_versions
Type	Resource
Id	aws.pinpoint.segment_versions

Fields

The following fields are returned by SELECT queries:

get_segment_version

Name	Datatype	Description
application_id	string	The unique identifier for the application that the segment is associated with.
arn	string	The Amazon Resource Name (ARN) of the segment.
creation_date	string	The date and time when the segment was created.
dimensions	object	Specifies the dimension settings for a segment.
id	string	The unique identifier for the segment.
import_definition	object	The settings for the import job that's associated with the segment.
last_modified_date	string	The date and time when the segment was last modified.
name	string	The name of the segment.
segment_groups	object	A list of one or more segment groups that apply to the segment. Each segment group consists of zero or more base segments and the dimensions that are applied to those base segments.
segment_type	string	The segment type. Valid values are: DIMENSIONAL - A dynamic segment, which is a segment that uses selection criteria that you specify and is based on endpoint data that's reported by your app. Dynamic segments can change over time. IMPORT - A static segment, which is a segment that uses selection criteria that you specify and is based on endpoint definitions that you import from a file. Imported segments are static; they don't change over time. (DIMENSIONAL, IMPORT)
version	integer	The version number of the segment.
tags	object	A string-to-string map of key-value pairs that identifies the tags that are associated with the segment. Each tag consists of a required tag key and an associated tag value.

get_segment_versions

Name	Datatype	Description
item	array	An array of responses, one for each segment that's associated with the application (Segments resource) or each version of a segment that's associated with the application (Segment Versions resource).
next_token	string	The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_segment_version	select	application-id, segment-id, version, region		Retrieves information about the configuration, dimension, and other settings for a specific version of a segment that's associated with an application.
get_segment_versions	select	application-id, segment-id, region	page-size, token	Retrieves information about the configuration, dimension, and other settings for all the versions of a specific segment that's associated with an application.

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
application-id	string	The unique identifier for the application. This identifier is displayed as the Project ID on the Amazon Pinpoint console.
region	string	AWS region (default: us-east-1)
segment-id	string	The unique identifier for the segment.
version	string	The unique version number (Version property) for the campaign version.
page-size	string	The maximum number of items to include in each page of a paginated response. This parameter is not supported for application, campaign, and journey metrics.
token	string	The NextToken string that specifies which page of results to return in a paginated response.

SELECT examples

get_segment_version

Retrieves information about the configuration, dimension, and other settings for a specific version of a segment that's associated with an application.

SELECT
application_id,
arn,
creation_date,
dimensions,
id,
import_definition,
last_modified_date,
name,
segment_groups,
segment_type,
version,
tags
FROM aws.pinpoint.segment_versions
WHERE `application-id` = '{{ application-id }}' -- required
AND `segment-id` = '{{ segment-id }}' -- required
AND version = '{{ version }}' -- required
AND region = '{{ region }}' -- required
;

get_segment_versions

Retrieves information about the configuration, dimension, and other settings for all the versions of a specific segment that's associated with an application.

SELECT
item,
next_token
FROM aws.pinpoint.segment_versions
WHERE `application-id` = '{{ application-id }}' -- required
AND `segment-id` = '{{ segment-id }}' -- required
AND region = '{{ region }}' -- required
AND `page-size` = '{{ page-size }}'
AND token = '{{ token }}'
;