

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.

# UpdateCampaign
<a name="API_UpdateCampaign"></a>

 Met à jour une campagne pour déployer une version de solution adaptée avec une campagne existante, modifier votre campagne ou modifier la `minProvisionedTPS` configuration de votre campagne. Par exemple, vous pouvez `enableMetadataWithRecommendations` définir la valeur true pour une campagne existante.

 Pour mettre à jour une campagne afin qu'elle démarre automatiquement avec la dernière version de la solution, spécifiez les éléments suivants :
+ Pour le `SolutionVersionArn` paramètre, spécifiez l'Amazon Resource Name (ARN) de votre solution au `SolutionArn/$LATEST` format. 
+  Dans le`campaignConfig`, réglez `syncWithLatestSolutionVersion` sur`true`. 

Pour mettre à jour une campagne, son statut doit être ACTIF ou AVOIR ÉCHOUÉ À CRÉER. Vérifiez le statut de la campagne à l'aide de l'[DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html)opération.

**Note**  
Vous pouvez toujours obtenir des recommandations issues d'une campagne pendant qu'une mise à jour est en cours. La campagne utilisera la version de solution et la configuration de campagne précédentes pour générer des recommandations jusqu'à ce que le dernier statut de mise à jour de la campagne soit atteint`Active`. 

Pour plus d'informations sur la mise à jour d'une campagne, y compris des exemples de code, voir [Mettre à jour une campagne](https://docs.aws.amazon.com/personalize/latest/dg/update-campaigns.html). Pour plus d'informations sur les campagnes, consultez la section [Création d'une campagne](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html).

## Syntaxe de la requête
<a name="API_UpdateCampaign_RequestSyntax"></a>

```
{
   "campaignArn": "string",
   "campaignConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "rankingInfluence": { 
         "string" : number 
      },
      "syncWithLatestSolutionVersion": boolean
   },
   "minProvisionedTPS": number,
   "solutionVersionArn": "string"
}
```

## Paramètres de demande
<a name="API_UpdateCampaign_RequestParameters"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [campaignArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignArn"></a>
Amazon Resource Name (ARN) de la campagne.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatoire : oui

 ** [campaignConfig](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignConfig"></a>
Les détails de configuration d'une campagne.  
Type : objet [CampaignConfig](API_CampaignConfig.md)  
Obligatoire : non

 ** [minProvisionedTPS](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-minProvisionedTPS"></a>
Spécifie le nombre minimum de transactions provisionnées demandées (recommandations) par seconde qu'Amazon Personalize prendra en charge. Un montant élevé `minProvisionedTPS` fera augmenter votre facture. Nous vous recommandons de commencer par 1 pour `minProvisionedTPS` (valeur par défaut). Suivez votre consommation à l'aide CloudWatch des statistiques Amazon et augmentez-les `minProvisionedTPS` si nécessaire.  
Type : entier  
Plage valide : Valeur minimum de 1.  
Obligatoire : non

 ** [solutionVersionArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-solutionVersionArn"></a>
Le nom de ressource Amazon (ARN) d'un nouveau modèle à déployer. Pour spécifier la dernière version de votre solution, spécifiez l'ARN de votre *solution* au `SolutionArn/$LATEST` format. Vous devez utiliser ce format si vous avez défini `syncWithLatestSolutionVersion` sur [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html). `True`   
 Pour déployer un modèle qui n'est pas la dernière version de votre solution, spécifiez l'ARN de la version de la solution.   
 Pour plus d'informations sur les mises à jour automatiques des campagnes, consultez la section [Activation des mises à jour automatiques des campagnes](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update).   
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatoire : non

## Syntaxe de la réponse
<a name="API_UpdateCampaign_ResponseSyntax"></a>

```
{
   "campaignArn": "string"
}
```

## Eléments de réponse
<a name="API_UpdateCampaign_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [campaignArn](#API_UpdateCampaign_ResponseSyntax) **   <a name="personalize-UpdateCampaign-response-campaignArn"></a>
Le même ARN de campagne que celui indiqué dans la demande.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Erreurs
<a name="API_UpdateCampaign_Errors"></a>

 ** InvalidInputException **   
Entrez une valeur valide pour le champ ou le paramètre.  
Code d’état HTTP : 400

 ** ResourceInUseException **   
La ressource spécifiée est en cours d'utilisation.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
Impossible de trouver la ressource spécifiée.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_UpdateCampaign_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateCampaign) 