String name
The name of the algorithm.
String algorithmArn
The Amazon Resource Name (ARN) of the algorithm.
AlgorithmImage algorithmImage
The URI of the Docker container for the algorithm image.
Map<K,V> defaultHyperParameters
Specifies the default hyperparameters.
DefaultHyperParameterRanges defaultHyperParameterRanges
Specifies the default hyperparameters, their ranges, and whether they are tunable. A tunable hyperparameter can have its value determined during hyperparameter optimization (HPO).
Map<K,V> defaultResourceConfig
Specifies the default maximum number of training jobs and parallel training jobs.
String trainingInputMode
The training input mode.
String roleArn
The Amazon Resource Name (ARN) of the role.
Date creationDateTime
The date and time (in Unix time) that the algorithm was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the algorithm was last updated.
String bestRecipeArn
The Amazon Resource Name (ARN) of the best recipe.
String jobName
The name of the batch inference job.
String batchInferenceJobArn
The Amazon Resource Name (ARN) of the batch inference job.
String failureReason
If the batch inference job failed, the reason for the failure.
String solutionVersionArn
The Amazon Resource Name (ARN) of the solution version from which the batch inference job was created.
Integer numResults
The number of recommendations generated by the batch inference job. This number includes the error messages generated for failed input records.
BatchInferenceJobInput jobInput
The Amazon S3 path that leads to the input data used to generate the batch inference job.
BatchInferenceJobOutput jobOutput
The Amazon S3 bucket that contains the output data generated by the batch inference job.
String roleArn
The ARN of the Amazon Identity and Access Management (IAM) role that requested the batch inference job.
String status
The status of the batch inference job. The status is one of the following values:
PENDING
IN PROGRESS
ACTIVE
CREATE FAILED
Date creationDateTime
The time at which the batch inference job was created.
Date lastUpdatedDateTime
The time at which the batch inference job was last updated.
S3DataConfig s3DataSource
The URI of the Amazon S3 location that contains your input data. The Amazon S3 bucket must be in the same region as the API endpoint you are calling.
S3DataConfig s3DataDestination
Information on the Amazon S3 bucket in which the batch inference job's output is stored.
String batchInferenceJobArn
The Amazon Resource Name (ARN) of the batch inference job.
String jobName
The name of the batch inference job.
String status
The status of the batch inference job. The status is one of the following values:
PENDING
IN PROGRESS
ACTIVE
CREATE FAILED
Date creationDateTime
The time at which the batch inference job was created.
Date lastUpdatedDateTime
The time at which the batch inference job was last updated.
String failureReason
If the batch inference job failed, the reason for the failure.
String name
The name of the campaign.
String campaignArn
The Amazon Resource Name (ARN) of the campaign.
String solutionVersionArn
The Amazon Resource Name (ARN) of a specific version of the solution.
Integer minProvisionedTPS
Specifies the requested minimum provisioned transactions (recommendations) per second.
String status
The status of the campaign.
A campaign can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
DELETE PENDING > DELETE IN_PROGRESS
String failureReason
If a campaign fails, the reason behind the failure.
Date creationDateTime
The date and time (in Unix format) that the campaign was created.
Date lastUpdatedDateTime
The date and time (in Unix format) that the campaign was last updated.
CampaignUpdateSummary latestCampaignUpdate
String name
The name of the campaign.
String campaignArn
The Amazon Resource Name (ARN) of the campaign.
String status
The status of the campaign.
A campaign can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
DELETE PENDING > DELETE IN_PROGRESS
Date creationDateTime
The date and time (in Unix time) that the campaign was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the campaign was last updated.
String failureReason
If a campaign fails, the reason behind the failure.
String solutionVersionArn
The Amazon Resource Name (ARN) of the deployed solution version.
Integer minProvisionedTPS
Specifies the requested minimum provisioned transactions (recommendations) per second that Amazon Personalize will support.
String status
The status of the campaign update.
A campaign update can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
DELETE PENDING > DELETE IN_PROGRESS
String failureReason
If a campaign update fails, the reason behind the failure.
Date creationDateTime
The date and time (in Unix time) that the campaign update was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the campaign update was last updated.
String jobName
The name of the batch inference job to create.
String solutionVersionArn
The Amazon Resource Name (ARN) of the solution version that will be used to generate the batch inference recommendations.
Integer numResults
The number of recommendations to retreive.
BatchInferenceJobInput jobInput
The Amazon S3 path that leads to the input file to base your recommendations on. The input material must be in JSON format.
BatchInferenceJobOutput jobOutput
The path to the Amazon S3 bucket where the job's output will be stored.
String roleArn
The ARN of the Amazon Identity and Access Management role that has permissions to read and write to your input and out Amazon S3 buckets respectively.
String batchInferenceJobArn
The ARN of the batch inference job.
String name
A name for the new campaign. The campaign name must be unique within your account.
String solutionVersionArn
The Amazon Resource Name (ARN) of the solution version to deploy.
Integer minProvisionedTPS
Specifies the requested minimum provisioned transactions (recommendations) per second that Amazon Personalize will support.
String campaignArn
The Amazon Resource Name (ARN) of the campaign.
String name
The name for the new dataset group.
String roleArn
The ARN of the IAM role that has permissions to access the KMS key. Supplying an IAM role is only valid when also specifying a KMS key.
String kmsKeyArn
The Amazon Resource Name (ARN) of a KMS key used to encrypt the datasets.
String datasetGroupArn
The Amazon Resource Name (ARN) of the new dataset group.
String jobName
The name for the dataset import job.
String datasetArn
The ARN of the dataset that receives the imported data.
DataSource dataSource
The Amazon S3 bucket that contains the training data to import.
String roleArn
The ARN of the IAM role that has permissions to read from the Amazon S3 data source.
String datasetImportJobArn
The ARN of the dataset import job.
String name
The name for the dataset.
String schemaArn
The ARN of the schema to associate with the dataset. The schema defines the dataset fields.
String datasetGroupArn
The Amazon Resource Name (ARN) of the dataset group to add the dataset to.
String datasetType
The type of dataset.
One of the following (case insensitive) values:
Interactions
Items
Users
String datasetArn
The ARN of the dataset.
String schemaArn
The Amazon Resource Name (ARN) of the created schema.
String name
The name for the solution.
Boolean performHPO
Whether to perform hyperparameter optimization (HPO) on the specified or selected recipe. The default is
false.
When performing AutoML, this parameter is always true and you should not set it to
false.
Boolean performAutoML
Whether to perform automated machine learning (AutoML). The default is false. For this case, you
must specify recipeArn.
When set to true, Amazon Personalize analyzes your training data and selects the optimal
USER_PERSONALIZATION recipe and hyperparameters. In this case, you must omit recipeArn. Amazon
Personalize determines the optimal recipe by running tests with different values for the hyperparameters. AutoML
lengthens the training process as compared to selecting a specific recipe.
String recipeArn
The ARN of the recipe to use for model training. Only specified when performAutoML is false.
String datasetGroupArn
The Amazon Resource Name (ARN) of the dataset group that provides the training data.
String eventType
When your have multiple event types (using an EVENT_TYPE schema field), this parameter specifies
which event type (for example, 'click' or 'like') is used for training the model.
SolutionConfig solutionConfig
The configuration to use with the solution. When performAutoML is set to true, Amazon Personalize
only evaluates the autoMLConfig section of the solution configuration.
String solutionArn
The ARN of the solution.
String solutionArn
The Amazon Resource Name (ARN) of the solution containing the training configuration information.
String trainingMode
The scope of training to be performed when creating the solution version. The FULL option trains the
solution version based on the entirety of the input solution's training data, while the UPDATE
option processes only the data that has changed in comparison to the input solution. Choose UPDATE
when you want to incrementally update your solution version instead of creating an entirely new one.
The UPDATE option can only be used when you already have an active solution version created from the
input solution using the FULL option and the input solution was trained with the
native-recipe-hrnn-coldstart recipe.
String solutionVersionArn
The ARN of the new solution version.
String name
The name of the dataset.
String datasetArn
The Amazon Resource Name (ARN) of the dataset that you want metadata for.
String datasetGroupArn
The Amazon Resource Name (ARN) of the dataset group.
String datasetType
One of the following values:
Interactions
Items
Users
String schemaArn
The ARN of the associated schema.
String status
The status of the dataset.
A dataset can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
DELETE PENDING > DELETE IN_PROGRESS
Date creationDateTime
The creation date and time (in Unix time) of the dataset.
Date lastUpdatedDateTime
A time stamp that shows when the dataset was updated.
String name
The name of the dataset group.
String datasetGroupArn
The Amazon Resource Name (ARN) of the dataset group.
String status
The current status of the dataset group.
A dataset group can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
DELETE PENDING
String roleArn
The ARN of the IAM role that has permissions to create the dataset group.
String kmsKeyArn
The Amazon Resource Name (ARN) of the KMS key used to encrypt the datasets.
Date creationDateTime
The creation date and time (in Unix time) of the dataset group.
Date lastUpdatedDateTime
The last update date and time (in Unix time) of the dataset group.
String failureReason
If creating a dataset group fails, provides the reason why.
String name
The name of the dataset group.
String datasetGroupArn
The Amazon Resource Name (ARN) of the dataset group.
String status
The status of the dataset group.
A dataset group can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
DELETE PENDING
Date creationDateTime
The date and time (in Unix time) that the dataset group was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the dataset group was last updated.
String failureReason
If creating a dataset group fails, the reason behind the failure.
String jobName
The name of the import job.
String datasetImportJobArn
The ARN of the dataset import job.
String datasetArn
The Amazon Resource Name (ARN) of the dataset that receives the imported data.
DataSource dataSource
The Amazon S3 bucket that contains the training data to import.
String roleArn
The ARN of the AWS Identity and Access Management (IAM) role that has permissions to read from the Amazon S3 data source.
String status
The status of the dataset ACTIVE -or- CREATE FAILED
Date creationDateTime
The creation date and time (in Unix time) of the dataset import job.
Date lastUpdatedDateTime
The date and time (in Unix time) the dataset was last updated.
String failureReason
If a dataset import job fails, provides the reason why.
String datasetImportJobArn
The Amazon Resource Name (ARN) of the dataset import job.
String jobName
The name of the dataset import job.
String status
The status of the dataset ACTIVE -or- CREATE FAILED
Date creationDateTime
The date and time (in Unix time) that the dataset import job was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the dataset was last updated.
String failureReason
If a dataset import job fails, the reason behind the failure.
String name
The name of the schema.
String schemaArn
The Amazon Resource Name (ARN) of the schema.
String schema
The schema.
Date creationDateTime
The date and time (in Unix time) that the schema was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the schema was last updated.
String name
The name of the schema.
String schemaArn
The Amazon Resource Name (ARN) of the schema.
Date creationDateTime
The date and time (in Unix time) that the schema was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the schema was last updated.
String name
The name of the dataset.
String datasetArn
The Amazon Resource Name (ARN) of the dataset.
String datasetType
The dataset type. One of the following values:
Interactions
Items
Users
Event-Interactions
String status
The status of the dataset.
A dataset can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
DELETE PENDING > DELETE IN_PROGRESS
Date creationDateTime
The date and time (in Unix time) that the dataset was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the dataset was last updated.
String dataLocation
The path to the Amazon S3 bucket where the data that you want to upload to your dataset is stored. For example:
s3://bucket-name/training-data.csv
List<E> integerHyperParameterRanges
The integer-valued hyperparameters and their default ranges.
List<E> continuousHyperParameterRanges
The continuous hyperparameters and their default ranges.
List<E> categoricalHyperParameterRanges
The categorical hyperparameters and their default ranges.
String campaignArn
The Amazon Resource Name (ARN) of the campaign to delete.
String datasetGroupArn
The ARN of the dataset group to delete.
String datasetArn
The Amazon Resource Name (ARN) of the dataset to delete.
String eventTrackerArn
The Amazon Resource Name (ARN) of the event tracker to delete.
String schemaArn
The Amazon Resource Name (ARN) of the schema to delete.
String solutionArn
The ARN of the solution to delete.
String algorithmArn
The Amazon Resource Name (ARN) of the algorithm to describe.
Algorithm algorithm
A listing of the properties of the algorithm.
String batchInferenceJobArn
The ARN of the batch inference job to describe.
BatchInferenceJob batchInferenceJob
Information on the specified batch inference job.
String campaignArn
The Amazon Resource Name (ARN) of the campaign.
Campaign campaign
The properties of the campaign.
String datasetGroupArn
The Amazon Resource Name (ARN) of the dataset group to describe.
DatasetGroup datasetGroup
A listing of the dataset group's properties.
String datasetImportJobArn
The Amazon Resource Name (ARN) of the dataset import job to describe.
DatasetImportJob datasetImportJob
Information about the dataset import job, including the status.
The status is one of the following values:
CREATE PENDING
CREATE IN_PROGRESS
ACTIVE
CREATE FAILED
String datasetArn
The Amazon Resource Name (ARN) of the dataset to describe.
Dataset dataset
A listing of the dataset's properties.
String eventTrackerArn
The Amazon Resource Name (ARN) of the event tracker to describe.
EventTracker eventTracker
An object that describes the event tracker.
String featureTransformationArn
The Amazon Resource Name (ARN) of the feature transformation to describe.
FeatureTransformation featureTransformation
A listing of the FeatureTransformation properties.
String recipeArn
The Amazon Resource Name (ARN) of the recipe to describe.
Recipe recipe
An object that describes the recipe.
String schemaArn
The Amazon Resource Name (ARN) of the schema to retrieve.
DatasetSchema schema
The requested schema.
String solutionArn
The Amazon Resource Name (ARN) of the solution to describe.
Solution solution
An object that describes the solution.
String solutionVersionArn
The Amazon Resource Name (ARN) of the solution version.
SolutionVersion solutionVersion
The solution version.
String name
The name of the event tracker.
String eventTrackerArn
The ARN of the event tracker.
String accountId
The Amazon AWS account that owns the event tracker.
String trackingId
The ID of the event tracker. Include this ID in requests to the PutEvents API.
String datasetGroupArn
The Amazon Resource Name (ARN) of the dataset group that receives the event data.
String status
The status of the event tracker.
An event tracker can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
DELETE PENDING > DELETE IN_PROGRESS
Date creationDateTime
The date and time (in Unix format) that the event tracker was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the event tracker was last updated.
String name
The name of the event tracker.
String eventTrackerArn
The Amazon Resource Name (ARN) of the event tracker.
String status
The status of the event tracker.
An event tracker can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
DELETE PENDING > DELETE IN_PROGRESS
Date creationDateTime
The date and time (in Unix time) that the event tracker was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the event tracker was last updated.
String name
The name of the feature transformation.
String featureTransformationArn
The Amazon Resource Name (ARN) of the FeatureTransformation object.
Map<K,V> defaultParameters
Provides the default parameters for feature transformation.
Date creationDateTime
The creation date and time (in Unix time) of the feature transformation.
Date lastUpdatedDateTime
The last update date and time (in Unix time) of the feature transformation.
String status
The status of the feature transformation.
A feature transformation can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
String solutionVersionArn
The Amazon Resource Name (ARN) of the solution version for which to get metrics.
HPOObjective hpoObjective
The metric to optimize during HPO.
HPOResourceConfig hpoResourceConfig
Describes the resource configuration for HPO.
HyperParameterRanges algorithmHyperParameterRanges
The hyperparameters and their allowable ranges.
String maxNumberOfTrainingJobs
The maximum number of training jobs when you create a solution version. The maximum value for
maxNumberOfTrainingJobs is 40.
String maxParallelTrainingJobs
The maximum number of parallel training jobs when you create a solution version. The maximum value for
maxParallelTrainingJobs is 10.
List<E> integerHyperParameterRanges
The integer-valued hyperparameters and their ranges.
List<E> continuousHyperParameterRanges
The continuous hyperparameters and their ranges.
List<E> categoricalHyperParameterRanges
The categorical hyperparameters and their ranges.
String solutionVersionArn
The Amazon Resource Name (ARN) of the solution version from which the batch inference jobs were created.
String nextToken
The token to request the next page of results.
Integer maxResults
The maximum number of batch inference job results to return in each page. The default value is 100.
String solutionArn
The Amazon Resource Name (ARN) of the solution to list the campaigns for. When a solution is not specified, all the campaigns associated with the account are listed.
String nextToken
A token returned from the previous call to ListCampaigns for getting the next set of campaigns (if
they exist).
Integer maxResults
The maximum number of campaigns to return.
String datasetArn
The Amazon Resource Name (ARN) of the dataset to list the dataset import jobs for.
String nextToken
A token returned from the previous call to ListDatasetImportJobs for getting the next set of dataset
import jobs (if they exist).
Integer maxResults
The maximum number of dataset import jobs to return.
String datasetGroupArn
The Amazon Resource Name (ARN) of the dataset group that contains the datasets to list.
String nextToken
A token returned from the previous call to ListDatasetImportJobs for getting the next set of dataset
import jobs (if they exist).
Integer maxResults
The maximum number of datasets to return.
String datasetGroupArn
The ARN of a dataset group used to filter the response.
String nextToken
A token returned from the previous call to ListEventTrackers for getting the next set of event
trackers (if they exist).
Integer maxResults
The maximum number of event trackers to return.
String datasetGroupArn
The Amazon Resource Name (ARN) of the dataset group.
String nextToken
A token returned from the previous call to ListSolutions for getting the next set of solutions (if
they exist).
Integer maxResults
The maximum number of solutions to return.
String solutionArn
The Amazon Resource Name (ARN) of the solution.
String nextToken
A token returned from the previous call to ListSolutionVersions for getting the next set of solution
versions (if they exist).
Integer maxResults
The maximum number of solution versions to return.
String name
The name of the recipe.
String recipeArn
The Amazon Resource Name (ARN) of the recipe.
String algorithmArn
The Amazon Resource Name (ARN) of the algorithm that Amazon Personalize uses to train the model.
String featureTransformationArn
The ARN of the FeatureTransformation object.
String status
The status of the recipe.
String description
The description of the recipe.
Date creationDateTime
The date and time (in Unix format) that the recipe was created.
String recipeType
One of the following values:
PERSONALIZED_RANKING
RELATED_ITEMS
USER_PERSONALIZATION
Date lastUpdatedDateTime
The date and time (in Unix format) that the recipe was last updated.
String name
The name of the recipe.
String recipeArn
The Amazon Resource Name (ARN) of the recipe.
String status
The status of the recipe.
Date creationDateTime
The date and time (in Unix time) that the recipe was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the recipe was last updated.
String name
The name of the solution.
String solutionArn
The ARN of the solution.
Boolean performHPO
Whether to perform hyperparameter optimization (HPO) on the chosen recipe. The default is false.
Boolean performAutoML
When true, Amazon Personalize performs a search for the best USER_PERSONALIZATION recipe from the list specified
in the solution configuration (recipeArn must not be specified). When false (the default), Amazon
Personalize uses recipeArn for training.
String recipeArn
The ARN of the recipe used to create the solution.
String datasetGroupArn
The Amazon Resource Name (ARN) of the dataset group that provides the training data.
String eventType
The event type (for example, 'click' or 'like') that is used for training the model.
SolutionConfig solutionConfig
Describes the configuration properties for the solution.
AutoMLResult autoMLResult
When performAutoML is true, specifies the best recipe found.
String status
The status of the solution.
A solution can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
DELETE PENDING > DELETE IN_PROGRESS
Date creationDateTime
The creation date and time (in Unix time) of the solution.
Date lastUpdatedDateTime
The date and time (in Unix time) that the solution was last updated.
SolutionVersionSummary latestSolutionVersion
Describes the latest version of the solution, including the status and the ARN.
String eventValueThreshold
Only events with a value greater than or equal to this threshold are used for training a model.
HPOConfig hpoConfig
Describes the properties for hyperparameter optimization (HPO).
Map<K,V> algorithmHyperParameters
Lists the hyperparameter names and ranges.
Map<K,V> featureTransformationParameters
Lists the feature transformation parameters.
AutoMLConfig autoMLConfig
The AutoMLConfig object containing a list of recipes to search when AutoML is performed.
String name
The name of the solution.
String solutionArn
The Amazon Resource Name (ARN) of the solution.
String status
The status of the solution.
A solution can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
DELETE PENDING > DELETE IN_PROGRESS
Date creationDateTime
The date and time (in Unix time) that the solution was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the solution was last updated.
String solutionVersionArn
The ARN of the solution version.
String solutionArn
The ARN of the solution.
Boolean performHPO
Whether to perform hyperparameter optimization (HPO) on the chosen recipe. The default is false.
Boolean performAutoML
When true, Amazon Personalize searches for the most optimal recipe according to the solution configuration. When
false (the default), Amazon Personalize uses recipeArn.
String recipeArn
The ARN of the recipe used in the solution.
String eventType
The event type (for example, 'click' or 'like') that is used for training the model.
String datasetGroupArn
The Amazon Resource Name (ARN) of the dataset group providing the training data.
SolutionConfig solutionConfig
Describes the configuration properties for the solution.
Double trainingHours
The time used to train the model. You are billed for the time it takes to train a model. This field is visible only after Amazon Personalize successfully trains a model.
String trainingMode
The scope of training used to create the solution version. The FULL option trains the solution
version based on the entirety of the input solution's training data, while the UPDATE option
processes only the training data that has changed since the creation of the last solution version. Choose
UPDATE when you want to start recommending items added to the dataset without retraining the model.
The UPDATE option can only be used after you've created a solution version with the
FULL option and the training solution uses the native-recipe-hrnn-coldstart.
String status
The status of the solution version.
A solution version can be in one of the following states:
CREATE PENDING
CREATE IN_PROGRESS
ACTIVE
CREATE FAILED
String failureReason
If training a solution version fails, the reason for the failure.
Date creationDateTime
The date and time (in Unix time) that this version of the solution was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the solution was last updated.
String solutionVersionArn
The Amazon Resource Name (ARN) of the solution version.
String status
The status of the solution version.
A solution version can be in one of the following states:
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
Date creationDateTime
The date and time (in Unix time) that this version of a solution was created.
Date lastUpdatedDateTime
The date and time (in Unix time) that the solution version was last updated.
String failureReason
If a solution version fails, the reason behind the failure.
String campaignArn
The Amazon Resource Name (ARN) of the campaign.
String solutionVersionArn
The ARN of a new solution version to deploy.
Integer minProvisionedTPS
Specifies the requested minimum provisioned transactions (recommendations) per second that Amazon Personalize will support.
String campaignArn
The same campaign ARN as given in the request.
Copyright © 2019. All rights reserved.