Personalize / Client / update_campaign

update_campaign#

Personalize.Client.update_campaign(**kwargs)#

Updates a campaign by either deploying a new solution or changing the value of the campaign’s minProvisionedTPS parameter.

To update a campaign, the campaign status must be ACTIVE or CREATE FAILED. Check the campaign status using the DescribeCampaign operation.

Note

You can still get recommendations from a campaign while an update is in progress. The campaign will use the previous solution version and campaign configuration to generate recommendations until the latest campaign update status is Active.

For more information on campaigns, see CreateCampaign.

See also: AWS API Documentation

Request Syntax

response = client.update_campaign(
    campaignArn='string',
    solutionVersionArn='string',
    minProvisionedTPS=123,
    campaignConfig={
        'itemExplorationConfig': {
            'string': 'string'
        }
    }
)
Parameters:

  • campaignArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the campaign.

  • solutionVersionArn (string) – The ARN of a new solution version to deploy.

  • minProvisionedTPS (integer) – Specifies the requested minimum provisioned transactions (recommendations) per second that Amazon Personalize will support. A high minProvisionedTPS will increase your bill. We recommend starting with 1 for minProvisionedTPS (the default). Track your usage using Amazon CloudWatch metrics, and increase the minProvisionedTPS as necessary.

  • campaignConfig (dict) –

    The configuration details of a campaign.

    • itemExplorationConfig (dict) –

      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 solution uses the User-Personalization recipe.

      • (string) –

        • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'campaignArn': 'string'
}

Response Structure

  • (dict) –

    • campaignArn (string) –

      The same campaign ARN as given in the request.

Exceptions

  • Personalize.Client.exceptions.InvalidInputException

  • Personalize.Client.exceptions.ResourceNotFoundException

  • Personalize.Client.exceptions.ResourceInUseException