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