Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # CreateCampaign **Importante** Sostieni i costi della campagna mentre è attiva. Per evitare costi inutili, assicurati di eliminare la campagna al termine. Per informazioni sui costi della campagna, consulta i prezzi [ di ](https://aws.amazon.com/personalize/pricing/) Amazon Personalize. Crea una campagna che implementa una versione della soluzione. Quando un client chiama le [ GetPersonalizedRanking ](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html) API [ GetRecommendations ](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) and, nella richiesta viene specificata una campagna. **TPS minimo previsto e Auto-Scaling ** **Importante** Un valore elevato `minProvisionedTPS` aumenterà i costi. Ti consigliamo di iniziare con 1 per `minProvisionedTPS` (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando CloudWatch le metriche di Amazon e aumentale `minProvisionedTPS` se necessario. Quando crei una campagna Amazon Personalize, puoi specificare le transazioni minime previste al secondo (`minProvisionedTPS`) per la campagna. Questo è il throughput delle transazioni di base per la campagna fornita da Amazon Personalize. Imposta il costo di fatturazione minimo per la campagna mentre è attiva. Una transazione è una singola operazione `GetRecommendations` o `GetPersonalizedRanking` richiesta. L'impostazione predefinita `minProvisionedTPS` è 1. Se il TPS aumenta oltre`minProvisionedTPS`, Amazon Personalize ridimensiona automaticamente la capacità assegnata verso l'alto e verso il basso, ma mai al di sotto. `minProvisionedTPS` Si verifica un breve ritardo dovuto all'aumento della capacità che potrebbe causare la perdita delle transazioni. Quando il traffico si riduce, la capacità ritorna al`minProvisionedTPS`. Ti viene addebitato il TPS minimo previsto o, se le tue richieste superano il`minProvisionedTPS`, il TPS effettivo. Il TPS effettivo è il numero totale di richieste di raccomandazione effettuate. Ti consigliamo di iniziare con un valore basso`minProvisionedTPS`, monitorare l'utilizzo utilizzando le CloudWatch metriche di Amazon e quindi aumentarle `minProvisionedTPS` se necessario. Per ulteriori informazioni sui costi delle campagne, consulta i prezzi di [ Amazon Personalize. ](https://aws.amazon.com/personalize/pricing/) **Stato** Una campagna può essere in uno dei seguenti stati: + CREATE PENDING > CREATE IN\_PROGRESS > ACTIVE -oppure- CREATE FAILED + DELETE PENDING > DELETE IN\_PROGRESS Per conoscere lo stato della campagna, chiama [ DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html). **Nota** `status`Attendi la fine della campagna `ACTIVE` prima di chiedere consigli alla campagna. **API correlate** + [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) + [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) + [UpdateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateCampaign.html) + [DeleteCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteCampaign.html) ## Sintassi della richiesta ``` { "campaignConfig": { "enableMetadataWithRecommendations": {{boolean}}, "itemExplorationConfig": { "{{string}}" : "{{string}}" }, "rankingInfluence": { "{{string}}" : {{number}} }, "syncWithLatestSolutionVersion": {{boolean}} }, "minProvisionedTPS": {{number}}, "name": "{{string}}", "solutionVersionArn": "{{string}}", "tags": [ { "tagKey": "{{string}}", "tagValue": "{{string}}" } ] } ``` ## Parametri della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [campaignConfig](#API_CreateCampaign_RequestSyntax) ** I dettagli di configurazione di una campagna. Tipo: oggetto [CampaignConfig](API_CampaignConfig.md) Obbligatorio: no ** [minProvisionedTPS](#API_CreateCampaign_RequestSyntax) ** Specifica le transazioni minime richieste con provisioning (raccomandazioni) al secondo che Amazon Personalize supporterà. Un valore massimo `minProvisionedTPS` aumenterà la tua fattura. Ti consigliamo di iniziare con 1 per `minProvisionedTPS` (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando CloudWatch le metriche di Amazon e aumentale `minProvisionedTPS` se necessario. Tipo: numero intero Intervallo valido: valore minimo di 1. Obbligatorio: no ** [name](#API_CreateCampaign_RequestSyntax) ** Un nome per la nuova campagna. Il nome della campagna deve essere univoco all'interno del tuo account. Tipo: stringa Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri. Modello: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` Obbligatorio: sì ** [solutionVersionArn](#API_CreateCampaign_RequestSyntax) ** L'Amazon Resource Name (ARN) del modello addestrato da implementare con la campagna. Per specificare la versione più recente della soluzione, specifica l'ARN della * soluzione * in formato. `SolutionArn/$LATEST` È necessario utilizzare questo formato se è `syncWithLatestSolutionVersion` impostato `True` su. [ CampaignConfig ](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html) Per distribuire un modello che non è la versione più recente della soluzione, specifica l'ARN della versione della soluzione. Per ulteriori informazioni sugli aggiornamenti automatici delle campagne, consulta [ Abilitazione degli aggiornamenti automatici delle campagne. ](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update) Tipo: stringa Limitazioni di lunghezza: lunghezza massima di 256. Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obbligatorio: sì ** [tags](#API_CreateCampaign_RequestSyntax) ** Un elenco di [ tag ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare alla campagna. Tipo: matrice di oggetti [Tag](API_Tag.md) Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi. Obbligatorio: no ## Sintassi della risposta ``` { "campaignArn": "string" } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [campaignArn](#API_CreateCampaign_ResponseSyntax) ** L'Amazon Resource Name (ARN) della campagna. Tipo: stringa Limitazioni di lunghezza: lunghezza massima di 256. Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## Errori ** InvalidInputException ** Fornisci un valore valido per il campo o il parametro. Codice di stato HTTP: 400 ** LimitExceededException ** Il limite del numero di richieste al secondo è stato superato. Codice di stato HTTP: 400 ** ResourceAlreadyExistsException ** La risorsa specificata esiste già. Codice di stato HTTP: 400 ** ResourceInUseException ** La risorsa specificata è in uso. Codice di stato HTTP: 400 ** ResourceNotFoundException ** Impossibile trovare la risorsa specificata. Codice di stato HTTP: 400 ** TooManyTagsException ** È stato superato il numero massimo di tag che è possibile applicare a questa risorsa. Codice di stato HTTP: 400 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: + [AWS Interfaccia a riga di comando V2 ](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateCampaign) + [AWS SDK per .NET V4 ](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateCampaign) + [AWS SDK per C\+\+ ](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateCampaign) + [AWS SDK per Go v2 ](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateCampaign) + [AWS SDK per Java V2 ](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateCampaign) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateCampaign) + [AWS SDK per Kotlin ](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateCampaign) + [AWS SDK per PHP V3 ](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateCampaign) + [AWS SDK per Python (Boto3) ](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateCampaign) + [AWS SDK per Ruby V3 ](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateCampaign)