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à.
UpdateCampaign
Aggiorna una campagna per implementare una versione della soluzione riqualificata con una campagna esistente, modificare la campagna o modificare la configurazione della campagna. minProvisionedTPS Ad esempio, puoi impostare su true enableMetadataWithRecommendations per una campagna esistente.
Per aggiornare una campagna in modo che venga avviata automaticamente utilizzando la versione più recente della soluzione, specifica quanto segue:
-
Per il
SolutionVersionArnparametro, specifica l'Amazon Resource Name (ARN) della tua soluzione nelSolutionArn/$LATESTformato. -
In
campaignConfig, impostato susyncWithLatestSolutionVersion.true
Per aggiornare una campagna, lo stato della campagna deve essere ATTIVO o CREATE FAILED. Controlla lo stato della campagna utilizzando l'DescribeCampaignoperazione.
Nota
Puoi comunque ricevere consigli da una campagna mentre è in corso un aggiornamento. La campagna utilizzerà la versione precedente della soluzione e la configurazione della campagna per generare consigli fino allo stato dell'ultimo aggiornamento della campagnaActive.
Per ulteriori informazioni sull'aggiornamento di una campagna, inclusi esempi di codice, vedi Aggiornamento di una campagna. Per ulteriori informazioni sulle campagne, vedi Creazione di una campagna.
Sintassi della richiesta
{
"campaignArn": "string",
"campaignConfig": {
"enableMetadataWithRecommendations": boolean,
"itemExplorationConfig": {
"string" : "string"
},
"rankingInfluence": {
"string" : number
},
"syncWithLatestSolutionVersion": boolean
},
"minProvisionedTPS": number,
"solutionVersionArn": "string"
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- campaignArn
-
L'Amazon Resource Name (ARN) della campagna.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Obbligatorio: sì
- 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
- solutionVersionArn
-
L'Amazon Resource Name (ARN) di un nuovo modello da implementare. 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: 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
-
Lo stesso ARN della campagna indicato nella richiesta.
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
- ResourceInUseException
-
La risorsa specificata è in uso.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Impossibile trovare la risorsa specificata.
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:
