describe_recommender
(**kwargs)¶Describes the given recommender, including its status.
A recommender can be in one of the following states:
When the status
is CREATE FAILED
, the response includes the failureReason
key, which describes why.
The modelMetrics
key is null when the recommender is being created or deleted.
For more information on recommenders, see CreateRecommender.
See also: AWS API Documentation
Request Syntax
response = client.describe_recommender(
recommenderArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the recommender to describe.
{
'recommender': {
'recommenderArn': 'string',
'datasetGroupArn': 'string',
'name': 'string',
'recipeArn': 'string',
'recommenderConfig': {
'itemExplorationConfig': {
'string': 'string'
},
'minRecommendationRequestsPerSecond': 123
},
'creationDateTime': datetime(2015, 1, 1),
'lastUpdatedDateTime': datetime(2015, 1, 1),
'status': 'string',
'failureReason': 'string',
'latestRecommenderUpdate': {
'recommenderConfig': {
'itemExplorationConfig': {
'string': 'string'
},
'minRecommendationRequestsPerSecond': 123
},
'creationDateTime': datetime(2015, 1, 1),
'lastUpdatedDateTime': datetime(2015, 1, 1),
'status': 'string',
'failureReason': 'string'
},
'modelMetrics': {
'string': 123.0
}
}
}
Response Structure
The properties of the recommender.
The Amazon Resource Name (ARN) of the recommender.
The Amazon Resource Name (ARN) of the Domain dataset group that contains the recommender.
The name of the recommender.
The Amazon Resource Name (ARN) of the recipe (Domain dataset group use case) that the recommender was created for.
The configuration details of the recommender.
Specifies the exploration configuration hyperparameters, including explorationWeight
and explorationItemAgeCutOff
, you want to use to configure the amount of item exploration Amazon Personalize uses when recommending items. Provide itemExplorationConfig
data only if your recommenders generate personalized recommendations for a user (not popular items or similar items).
Specifies the requested minimum provisioned recommendation requests per second that Amazon Personalize will support.
The date and time (in Unix format) that the recommender was created.
The date and time (in Unix format) that the recommender was last updated.
The status of the recommender.
A recommender can be in one of the following states:
If a recommender fails, the reason behind the failure.
Provides a summary of the latest updates to the recommender.
The configuration details of the recommender update.
Specifies the exploration configuration hyperparameters, including explorationWeight
and explorationItemAgeCutOff
, you want to use to configure the amount of item exploration Amazon Personalize uses when recommending items. Provide itemExplorationConfig
data only if your recommenders generate personalized recommendations for a user (not popular items or similar items).
Specifies the requested minimum provisioned recommendation requests per second that Amazon Personalize will support.
The date and time (in Unix format) that the recommender update was created.
The date and time (in Unix time) that the recommender update was last updated.
The status of the recommender update.
A recommender can be in one of the following states:
If a recommender update fails, the reason behind the failure.
Provides evaluation metrics that help you determine the performance of a recommender. For more information, see Evaluating a recommender.
Exceptions
Personalize.Client.exceptions.InvalidInputException
Personalize.Client.exceptions.ResourceNotFoundException