View a markdown version of this page

CreateCampaign - Amazon Personalize

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.

CreateCampaign

Important

Vous engagez des frais de campagne pendant qu'elle est active. Pour éviter des coûts inutiles, veillez à supprimer la campagne lorsque vous aurez terminé. Pour plus d'informations sur les coûts des campagnes, consultez la section Tarification Amazon Personalize.

Crée une campagne qui déploie une version de la solution. Lorsqu'un client appelle les GetPersonalizedRanking API GetRecommendations et, une campagne est spécifiée dans la demande.

TPS provisionné minimum et Auto-Scaling

Important

Un montant élevé minProvisionedTPS augmentera vos coûts. Nous vous recommandons de commencer par 1 pour minProvisionedTPS (valeur par défaut). Suivez votre utilisation à l'aide CloudWatch des statistiques Amazon et minProvisionedTPS augmentez-la si nécessaire.

Lorsque vous créez une campagne Amazon Personalize, vous pouvez spécifier le nombre minimum de transactions provisionnées par seconde (minProvisionedTPS) pour la campagne. Il s'agit du débit de transaction de base pour la campagne provisionnée par Amazon Personalize. Il fixe les frais de facturation minimaux pour la campagne pendant qu'elle est active. Une transaction est une seule GetRecommendations ou une GetPersonalizedRanking demande. La valeur par défaut minProvisionedTPS est 1.

Si votre TPS augmente au-delà deminProvisionedTPS, Amazon Personalize redimensionne automatiquement la capacité provisionnée vers le haut et vers le bas, mais jamais en dessous. minProvisionedTPS Il y a un court délai pendant que la capacité est augmentée, ce qui peut entraîner une perte de transactions. Lorsque votre trafic diminue, la capacité revient auminProvisionedTPS.

Vous êtes facturé pour le TPS minimum provisionné ou, si vos demandes dépassent le TPSminProvisionedTPS, le TPS réel. Le TPS réel est le nombre total de demandes de recommandation que vous effectuez. Nous vous recommandons de commencer par une valeur faibleminProvisionedTPS, de suivre votre consommation à l'aide CloudWatch des statistiques Amazon, puis d'augmenter cette minProvisionedTPS valeur si nécessaire.

Pour plus d'informations sur les coûts des campagnes, consultez la section Tarification Amazon Personalize.

Statut

Une campagne peut se présenter dans l'un des états suivants :

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -ou- CREATE FAILED

  • DELETE PENDING > DELETE IN_PROGRESS

Pour connaître le statut de la campagne, appelez DescribeCampaign.

Note

Attendez la fin status de la campagne ACTIVE avant de demander des recommandations à la campagne.

Syntaxe de la requête

{ "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] }

Paramètres de demande

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

campaignConfig

Les détails de configuration d'une campagne.

Type : objet CampaignConfig

Obligatoire : non

minProvisionedTPS

Spécifie le nombre minimum de transactions provisionnées (recommandations) par seconde que Amazon Personalize prendra en charge. Un montant élevé minProvisionedTPS augmentera votre facture. Nous vous recommandons de commencer par 1 pour minProvisionedTPS (valeur par défaut). Suivez votre utilisation à l'aide CloudWatch des statistiques Amazon et minProvisionedTPS augmentez-la si nécessaire.

Type : entier

Plage valide : Valeur minimum de 1.

Obligatoire : non

name

Un nom pour la nouvelle campagne. Le nom de la campagne doit être unique sur votre compte.

Type : Chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.

Modèle : ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

Obligatoire : oui

solutionVersionArn

L'Amazon Resource Name (ARN) du modèle entraîné à déployer avec la campagne. 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 True dans le CampaignConfig.

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.

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):personalize:.*:.*:.+

Obligatoire : oui

tags

Liste des tags à appliquer à la campagne.

Type : tableau d’objets Tag

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

Obligatoire : non

Syntaxe de la réponse

{ "campaignArn": "string" }

Eléments de réponse

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

Amazon Resource Name (ARN) de la campagne.

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):personalize:.*:.*:.+

Erreurs

InvalidInputException

Fournissez une valeur valide pour le champ ou le paramètre.

Code d’état HTTP : 400

LimitExceededException

La limite du nombre de requêtes par seconde a été dépassée.

Code d’état HTTP : 400

ResourceAlreadyExistsException

La ressource spécifiée existe déjà.

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

TooManyTagsException

Vous avez dépassé le nombre maximum de balises que vous pouvez appliquer à cette ressource.

Code d’état HTTP : 400

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes :