Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . pinpoint ]

delete-segment

Description

Deletes a segment.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  delete-segment
--application-id <value>
--segment-id <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--application-id (string) The unique ID of your Amazon Pinpoint application.

--segment-id (string) The unique ID of the segment.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Output

SegmentResponse -> (structure)

Segment definition.

ApplicationId -> (string)

The ID of the application to which the segment applies.

CreationDate -> (string)

The date the segment was created in ISO 8601 format.

Dimensions -> (structure)

The segment dimensions attributes.

Attributes -> (map)

Custom segment attributes.

key -> (string)

value -> (structure)

Custom attibute dimension

AttributeType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Behavior -> (structure)

The segment behaviors attributes.

Recency -> (structure)

The recency of use.

Duration -> (string)

The length of time during which users have been active or inactive with your app. Valid values: HR_24, DAY_7, DAY_14, DAY_30

RecencyType -> (string)

The recency dimension type: ACTIVE - Users who have used your app within the specified duration are included in the segment. INACTIVE - Users who have not used your app within the specified duration are included in the segment.

Demographic -> (structure)

The segment demographics attributes.

AppVersion -> (structure)

The app version criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Channel -> (structure)

The channel criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

DeviceType -> (structure)

The device type criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Make -> (structure)

The device make criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Model -> (structure)

The device model criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Platform -> (structure)

The device platform criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Location -> (structure)

The segment location attributes.

Country -> (structure)

The country filter according to ISO 3166-1 Alpha-2 codes.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

GPSPoint -> (structure)

The GPS Point dimension.

Coordinates -> (structure)

Coordinate to measure distance from.

Latitude -> (double)

Latitude

Longitude -> (double)

Longitude

RangeInKilometers -> (double)

Range in kilometers from the coordinate.

Metrics -> (map)

Custom segment metrics.

key -> (string)

value -> (structure)

Custom metric dimension

ComparisonOperator -> (string)

GREATER_THAN | LESS_THAN | GREATER_THAN_OR_EQUAL | LESS_THAN_OR_EQUAL | EQUAL

Value -> (double)

Value to be compared.

UserAttributes -> (map)

Custom segment user attributes.

key -> (string)

value -> (structure)

Custom attibute dimension

AttributeType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Id -> (string)

The unique segment ID.

ImportDefinition -> (structure)

The import job settings.

ChannelCounts -> (map)

Channel type counts

key -> (string)

value -> (integer)

ExternalId -> (string)

DEPRECATED. Your AWS account ID, which you assigned to the ExternalID key in an IAM trust policy. Used by Amazon Pinpoint to assume an IAM role. This requirement is removed, and external IDs are not recommended for IAM roles assumed by Amazon Pinpoint.

Format -> (string)

The format of the endpoint files that were imported to create this segment. Valid values: CSV, JSON

RoleArn -> (string)

The Amazon Resource Name (ARN) of an IAM role that grants Amazon Pinpoint access to the endpoints in Amazon S3.

S3Url -> (string)

A URL that points to the Amazon S3 location from which the endpoints for this segment were imported.

Size -> (integer)

The number of endpoints that were successfully imported to create this segment.

LastModifiedDate -> (string)

The date the segment was last updated in ISO 8601 format.

Name -> (string)

The name of segment

SegmentGroups -> (structure)

Segment definition groups. We currently only support one. If specified Dimensions must be empty.

Groups -> (list)

List of dimension groups to evaluate.

(structure)

Segment group definition.

Dimensions -> (list)

List of dimensions to include or exclude.

(structure)

Segment dimensions

Attributes -> (map)

Custom segment attributes.

key -> (string)

value -> (structure)

Custom attibute dimension

AttributeType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Behavior -> (structure)

The segment behaviors attributes.

Recency -> (structure)

The recency of use.

Duration -> (string)

The length of time during which users have been active or inactive with your app. Valid values: HR_24, DAY_7, DAY_14, DAY_30

RecencyType -> (string)

The recency dimension type: ACTIVE - Users who have used your app within the specified duration are included in the segment. INACTIVE - Users who have not used your app within the specified duration are included in the segment.

Demographic -> (structure)

The segment demographics attributes.

AppVersion -> (structure)

The app version criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Channel -> (structure)

The channel criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

DeviceType -> (structure)

The device type criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Make -> (structure)

The device make criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Model -> (structure)

The device model criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Platform -> (structure)

The device platform criteria for the segment.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

Location -> (structure)

The segment location attributes.

Country -> (structure)

The country filter according to ISO 3166-1 Alpha-2 codes.

DimensionType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

GPSPoint -> (structure)

The GPS Point dimension.

Coordinates -> (structure)

Coordinate to measure distance from.

Latitude -> (double)

Latitude

Longitude -> (double)

Longitude

RangeInKilometers -> (double)

Range in kilometers from the coordinate.

Metrics -> (map)

Custom segment metrics.

key -> (string)

value -> (structure)

Custom metric dimension

ComparisonOperator -> (string)

GREATER_THAN | LESS_THAN | GREATER_THAN_OR_EQUAL | LESS_THAN_OR_EQUAL | EQUAL

Value -> (double)

Value to be compared.

UserAttributes -> (map)

Custom segment user attributes.

key -> (string)

value -> (structure)

Custom attibute dimension

AttributeType -> (string)

The type of dimension: INCLUSIVE - Endpoints that match the criteria are included in the segment. EXCLUSIVE - Endpoints that match the criteria are excluded from the segment.

Values -> (list)

The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type.

(string)

SourceSegments -> (list)

Segments that define the source of this segment. Currently a maximum of 1 import segment is supported.

(structure)

Segment reference.

Id -> (string)

Segment Id.

Version -> (integer)

If specified contains a specific version of the segment included.

SourceType -> (string)

Include or exclude the source.

Type -> (string)

How should the dimensions be applied for the result

Include -> (string)

How should the groups be applied for the result

SegmentType -> (string)

The segment type: DIMENSIONAL - A dynamic segment built from selection criteria based on endpoint data reported by your app. You create this type of segment by using the segment builder in the Amazon Pinpoint console or by making a POST request to the segments resource. IMPORT - A static segment built from an imported set of endpoint definitions. You create this type of segment by importing a segment in the Amazon Pinpoint console or by making a POST request to the jobs/import resource.

Version -> (integer)

The segment version number.