1// Code generated by smithy-go-codegen DO NOT EDIT.
2
3package personalize
4
5import (
6	"context"
7	awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
8	"github.com/aws/aws-sdk-go-v2/aws/signer/v4"
9	"github.com/aws/smithy-go/middleware"
10	smithyhttp "github.com/aws/smithy-go/transport/http"
11)
12
13// Creates an event tracker that you use when sending event data to the specified
14// dataset group using the PutEvents
15// (https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API.
16// When Amazon Personalize creates an event tracker, it also creates an
17// event-interactions dataset in the dataset group associated with the event
18// tracker. The event-interactions dataset stores the event data from the PutEvents
19// call. The contents of this dataset are not available to the user. Only one event
20// tracker can be associated with a dataset group. You will get an error if you
21// call CreateEventTracker using the same dataset group as an existing event
22// tracker. When you send event data you include your tracking ID. The tracking ID
23// identifies the customer and authorizes the customer to send the data. The event
24// tracker can be in one of the following states:
25//
26// * CREATE PENDING > CREATE
27// IN_PROGRESS > ACTIVE -or- CREATE FAILED
28//
29// * DELETE PENDING > DELETE
30// IN_PROGRESS
31//
32// To get the status of the event tracker, call DescribeEventTracker.
33// The event tracker must be in the ACTIVE state before using the tracking ID.
34// Related APIs
35//
36// * ListEventTrackers
37//
38// * DescribeEventTracker
39//
40// * DeleteEventTracker
41func (c *Client) CreateEventTracker(ctx context.Context, params *CreateEventTrackerInput, optFns ...func(*Options)) (*CreateEventTrackerOutput, error) {
42	if params == nil {
43		params = &CreateEventTrackerInput{}
44	}
45
46	result, metadata, err := c.invokeOperation(ctx, "CreateEventTracker", params, optFns, addOperationCreateEventTrackerMiddlewares)
47	if err != nil {
48		return nil, err
49	}
50
51	out := result.(*CreateEventTrackerOutput)
52	out.ResultMetadata = metadata
53	return out, nil
54}
55
56type CreateEventTrackerInput struct {
57
58	// The Amazon Resource Name (ARN) of the dataset group that receives the event
59	// data.
60	//
61	// This member is required.
62	DatasetGroupArn *string
63
64	// The name for the event tracker.
65	//
66	// This member is required.
67	Name *string
68}
69
70type CreateEventTrackerOutput struct {
71
72	// The ARN of the event tracker.
73	EventTrackerArn *string
74
75	// The ID of the event tracker. Include this ID in requests to the PutEvents
76	// (https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API.
77	TrackingId *string
78
79	// Metadata pertaining to the operation's result.
80	ResultMetadata middleware.Metadata
81}
82
83func addOperationCreateEventTrackerMiddlewares(stack *middleware.Stack, options Options) (err error) {
84	err = stack.Serialize.Add(&awsAwsjson11_serializeOpCreateEventTracker{}, middleware.After)
85	if err != nil {
86		return err
87	}
88	err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpCreateEventTracker{}, middleware.After)
89	if err != nil {
90		return err
91	}
92	if err = addSetLoggerMiddleware(stack, options); err != nil {
93		return err
94	}
95	if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil {
96		return err
97	}
98	if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil {
99		return err
100	}
101	if err = addResolveEndpointMiddleware(stack, options); err != nil {
102		return err
103	}
104	if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil {
105		return err
106	}
107	if err = addRetryMiddlewares(stack, options); err != nil {
108		return err
109	}
110	if err = addHTTPSignerV4Middleware(stack, options); err != nil {
111		return err
112	}
113	if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil {
114		return err
115	}
116	if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil {
117		return err
118	}
119	if err = addClientUserAgent(stack); err != nil {
120		return err
121	}
122	if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
123		return err
124	}
125	if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
126		return err
127	}
128	if err = addOpCreateEventTrackerValidationMiddleware(stack); err != nil {
129		return err
130	}
131	if err = stack.Initialize.Add(newServiceMetadataMiddleware_opCreateEventTracker(options.Region), middleware.Before); err != nil {
132		return err
133	}
134	if err = addRequestIDRetrieverMiddleware(stack); err != nil {
135		return err
136	}
137	if err = addResponseErrorMiddleware(stack); err != nil {
138		return err
139	}
140	if err = addRequestResponseLogging(stack, options); err != nil {
141		return err
142	}
143	return nil
144}
145
146func newServiceMetadataMiddleware_opCreateEventTracker(region string) *awsmiddleware.RegisterServiceMetadata {
147	return &awsmiddleware.RegisterServiceMetadata{
148		Region:        region,
149		ServiceID:     ServiceID,
150		SigningName:   "personalize",
151		OperationName: "CreateEventTracker",
152	}
153}
154