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.
API associées
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é
minProvisionedTPSaugmentera votre facture. Nous vous recommandons de commencer par 1 pourminProvisionedTPS(valeur par défaut). Suivez votre utilisation à l'aide CloudWatch des statistiques Amazon etminProvisionedTPSaugmentez-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/$LATESTformat. Vous devez utiliser ce format si vous avez définisyncWithLatestSolutionVersionsurTruedans 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
-
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 :