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** Ti vengono addebitati i costi della campagna mentre è attiva. Per evitare costi inutili, assicurati di eliminare la campagna quando hai finito. Per informazioni sui costi delle campagne, consulta i prezzi di [Amazon Personalize](https://aws.amazon.com/personalize/pricing/). Crea una campagna che implementa una versione della soluzione. Quando un client chiama [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)and [GetPersonalizedRanking](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html) APIs, nella richiesta viene specificata una campagna. **TPS con provisioning minimo e scalabilità automatica** **Importante** Un massimo `minProvisionedTPS` aumenterà i costi. Ti consigliamo di iniziare con 1 per `minProvisionedTPS` (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon e `minProvisionedTPS` aumentali se necessario. Quando crei una campagna Amazon Personalize, puoi specificare il numero minimo di transazioni assegnate al secondo (`minProvisionedTPS`) per la campagna. Questo è il throughput di transazione di base per la campagna fornita da Amazon Personalize. Imposta il costo minimo di fatturazione per la campagna mentre è attiva. Una transazione è una singola `GetRecommendations` `GetPersonalizedRanking` richiesta. L'impostazione predefinita `minProvisionedTPS` è 1. Se il tuo TPS supera il limite`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 nell'aumento della capacità che potrebbe causare la perdita delle transazioni. Quando il traffico diminuisce, la capacità torna a`minProvisionedTPS`. Ti viene addebitato il TPS minimo fornito 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 minimo`minProvisionedTPS`, di monitorare l'utilizzo utilizzando i CloudWatch parametri di Amazon e quindi di aumentarlo `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ò trovarsi in uno dei seguenti stati: + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oppure- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 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. **Correlati APIs** + [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) ** Speciifica le transazioni minime assegnate (raccomandazioni) richieste al secondo che Amazon Personalize supporterà. Un massimo `minProvisionedTPS` aumenterà la tua bolletta. Ti consigliamo di iniziare con 1 per `minProvisionedTPS` (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon e `minProvisionedTPS` aumentali 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: String 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 distribuire con la campagna. Per specificare la versione più recente della soluzione, specificare l'ARN della *soluzione nel `SolutionArn/$LATEST` formato*. È necessario utilizzare questo formato se è `syncWithLatestSolutionVersion` impostato `True` su. [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html) Per implementare un modello che non sia 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: String 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: String 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 ** Hai superato il numero massimo di tag che puoi applicare a questa risorsa. Codice di stato HTTP: 400 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, 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\$1\$1](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](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)