

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Mettre à jour la configuration d'une campagne Amazon Personalize
<a name="update-campaigns"></a>

Pour modifier votre campagne[TPS minimum provisionné](campaigns.md#min-tps-auto-scaling), déployer manuellement une nouvelle version de solution ou modifier la configuration d'une campagne, par exemple en activant l'option permettant d'inclure des métadonnées dans les recommandations, vous devez mettre à jour manuellement la campagne. 

 Les actions suivantes ne nécessitent pas de mise à jour manuelle de la campagne : 
+ Si votre campagne utilise des mises à jour automatiques, vous n'êtes pas obligé de la mettre à jour pour déployer la dernière version de votre solution entraînée automatiquement ou manuellement. Pour de plus amples informations, veuillez consulter [Mises à jour automatiques des campagnes](campaigns.md#create-campaign-automatic-latest-sv-update). 
+  Avec User-Personalization-v 2, User-Personalization, ou Next-Best-Action, Amazon Personalize met automatiquement à jour la dernière version de votre solution toutes les deux heures pour inclure de nouveaux éléments ou actions dans les recommandations. Votre campagne utilise automatiquement la version mise à jour de la solution. 

Vous mettez à jour manuellement une campagne à l'aide de la console Amazon Personalize, AWS Command Line Interface (AWS CLI) ou AWS SDKs.

**Note**  
Pour mettre à jour une campagne afin d'activer l'option permettant d'inclure des métadonnées dans les recommandations, vous devez disposer d'un jeu de données Items avec une colonne de métadonnées. Vous n'êtes pas obligé d'utiliser les métadonnées lors de l'entraînement.  
Si votre campagne a précédemment déployé une version de solution utilisant User-Personalization-v 2 ou Personalized-Ranking-v 2, et que vous passez à une ancienne version des recettes, l'option d'inclusion des métadonnées est désactivée par défaut. Vous pouvez l'activer lorsque vous mettez à jour la campagne. Pour de plus amples informations, veuillez consulter [Métadonnées des éléments dans les recommandations](campaigns.md#create-campaign-return-metadata).

**Topics**
+ [Mettre à jour une campagne (console)](#update-campaign-console)
+ [Mettre à jour une campagne (AWS CLI)](#update-campaign-cli)
+ [Mettre à jour une campagne (AWS SDKs)](#update-campaign-sdk)

## Mettre à jour une campagne (console)
<a name="update-campaign-console"></a>

Pour déployer une version de solution reformatée manuellement ou apporter des modifications à la configuration de votre campagne, vous devez mettre à jour votre campagne.

**Pour mettre à jour une campagne (console)**

1. Ouvrez la console Amazon Personalize [https://console.aws.amazon.com/personalize/chez](https://console.aws.amazon.com/personalize/home) vous et connectez-vous à votre compte.

1.  Choisissez le groupe de jeux de données contenant la campagne que vous souhaitez mettre à jour. 

1. Dans le volet de navigation, choisissez **Campaigns (Campagnes)**.

1. Sur la page **Campagnes**, choisissez la campagne que vous souhaitez mettre à jour.

1. Sur la page des détails de la campagne, choisissez **Mettre à jour**.

1. Sur la page **Mettre à jour la campagne**, apportez vos modifications. Par exemple, si vous déployez une version de solution recyclée, choisissez le numéro d'identification de la nouvelle **version de solution dans le champ ID** de version de solution.

1. Choisissez **Mettre à jour**. Amazon Personalize met à jour la campagne afin d'utiliser la nouvelle version de la solution et toutes les configurations modifiées.

## Mettre à jour une campagne (AWS CLI)
<a name="update-campaign-cli"></a>

Pour déployer une nouvelle version de solution, modifier celle de [TPS minimum provisionné](campaigns.md#min-tps-auto-scaling) votre campagne ou modifier la configuration de votre campagne, vous devez mettre à jour votre campagne. Utilisez la `update-campaign` commande suivante pour mettre à jour une campagne afin d'utiliser une nouvelle version de solution avec le AWS CLI. 

`campaign arn`Remplacez-le par le Amazon Resource Name (ARN) de la campagne que vous souhaitez mettre à jour. `new solution version arn`Remplacez-le par la version de solution que vous souhaitez déployer. 

```
aws personalize update-campaign \
--campaign-arn campaign arn \
--solution-version-arn new solution version arn \
--min-provisioned-tps 1
```

## Mettre à jour une campagne (AWS SDKs)
<a name="update-campaign-sdk"></a>

Pour déployer une nouvelle version de solution, modifier votre campagne [TPS minimum provisionné](campaigns.md#min-tps-auto-scaling) ou modifier la configuration de votre campagne, vous devez mettre à jour votre campagne. Utilisez le code suivant pour mettre à jour une campagne avec le SDK pour Python (Boto3) ou le SDK pour Java 2.x. Pour obtenir une liste complète de paramètres, consultez [UpdateCampaign](API_UpdateCampaign.md). 

------
#### [ SDK for Python (Boto3) ]

Utilisez la `update_campaign` méthode suivante pour déployer une nouvelle version de solution. `campaign arn`Remplacez-le par le nom de ressource Amazon (ARN) de la campagne que vous souhaitez mettre à jour, remplacez le `new solution version arn` par l'ARN de la nouvelle version de la solution et modifiez éventuellement le`minProvisionedTPS`.

```
import boto3

personalize = boto3.client('personalize')

response = personalize.update_campaign(
    campaignArn = 'campaign arn',
    solutionVersionArn = 'new solution version arn',
    minProvisionedTPS = 1,
)

arn = response['campaignArn']

description = personalize.describe_campaign(campaignArn = arn)['campaign']
print('Name: ' + description['name'])
print('ARN: ' + description['campaignArn'])
print('Status: ' + description['status'])
```

------
#### [ SDK for Java 2.x ]

Utilisez la `updateCampaign` méthode suivante pour mettre à jour une campagne afin d'utiliser une nouvelle version de solution. Transmettez comme paramètres un client du service Amazon Personalize, le nom de ressource Amazon (ARN) de la nouvelle version de la solution et le[TPS minimum provisionné](campaigns.md#min-tps-auto-scaling). 

```
public static void updateCampaign(PersonalizeClient personalizeClient, 
                                String campaignArn,
                                String solutionVersionArn, 
                                Integer minProvisionedTPS) {

    try {    
        // build the updateCampaignRequest
        UpdateCampaignRequest updateCampaignRequest = UpdateCampaignRequest.builder()
            .campaignArn(campaignArn)
            .solutionVersionArn(solutionVersionArn)
            .minProvisionedTPS(minProvisionedTPS)
            .build();
        
        // update the campaign
        personalizeClient.updateCampaign(updateCampaignRequest);
        
        DescribeCampaignRequest campaignRequest = DescribeCampaignRequest.builder()
              .campaignArn(campaignArn)
              .build();
    
        DescribeCampaignResponse campaignResponse = personalizeClient.describeCampaign(campaignRequest);
        Campaign updatedCampaign = campaignResponse.campaign();
        
        System.out.println("The Campaign status is " + updatedCampaign.status());
    
    } catch (PersonalizeException e) {
        System.err.println(e.awsErrorDetails().errorMessage());
        System.exit(1);
    }
}
```

------