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
Crea una campagna che implementa una versione della soluzione. Quando un client chiama le GetPersonalizedRanking API GetRecommendations 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 oltreminProvisionedTPS, 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 alminProvisionedTPS.
Ti viene addebitato il TPS minimo previsto o, se le tue richieste superano ilminProvisionedTPS, il TPS effettivo. Il TPS effettivo è il numero totale di richieste di raccomandazione effettuate. Ti consigliamo di iniziare con un valore bassominProvisionedTPS, 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.
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.
Nota
statusAttendi la fine della campagna ACTIVE prima di chiedere consigli alla campagna.
API correlate
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
-
I dettagli di configurazione di una campagna.
Tipo: oggetto CampaignConfig
Obbligatorio: no
- minProvisionedTPS
-
Specifica le transazioni minime richieste con provisioning (raccomandazioni) al secondo che Amazon Personalize supporterà. Un valore massimo
minProvisionedTPSaumenterà la tua fattura. Ti consigliamo di iniziare con 1 perminProvisionedTPS(impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando CloudWatch le metriche di Amazon e aumentaleminProvisionedTPSse necessario.Tipo: numero intero
Intervallo valido: valore minimo di 1.
Obbligatorio: no
- name
-
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
-
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 èsyncWithLatestSolutionVersionimpostatoTruesu. CampaignConfigPer 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.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Obbligatorio: sì
-
Un elenco di tag da applicare alla campagna.
Tipo: matrice di oggetti Tag
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
-
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:
