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
Crea una campagna che implementa una versione della soluzione. Quando un client chiama le GetPersonalizedRankingAPI GetRecommendationsand, 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 limiteminProvisionedTPS
, 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 aminProvisionedTPS
.
Ti viene addebitato il TPS minimo fornito 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 minimominProvisionedTPS
, 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
Stato
Una campagna può trovarsi 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
status
Attendi la fine della campagna ACTIVE
prima di chiedere consigli alla campagna.
API correlate
Sintassi della richiesta
{
"campaignConfig": {
"enableMetadataWithRecommendations": boolean
,
"itemExplorationConfig": {
"string
" : "string
"
},
"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
Campo obbligatorio: no
- minProvisionedTPS
-
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 perminProvisionedTPS
(impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon eminProvisionedTPS
aumentali se necessario.Tipo: integer
Intervallo valido: valore minimo di 1.
Campo 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\-_]*
Campo obbligatorio: sì
- solutionVersionArn
-
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
impostatoTrue
su. CampaignConfigPer 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.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+
Campo 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.
Campo 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
-
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 uno degli AWS SDK specifici della lingua, consulta quanto segue: