UpdateCampaign - Amazon Personalize
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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 riqualificata della soluzione con una campagna esistente, modificare quella della minProvisionedTPS campagna o modificare la configurazione della campagna. Ad esempio, puoi impostare su true enableMetadataWithRecommendations per una campagna esistente.

Per aggiornare una campagna in modo che inizi automaticamente utilizzando la versione più recente della soluzione, specifica quanto segue:

  • Per il SolutionVersionArn parametro, specifica il formato Amazon Resource Name (ARN) della soluzione. SolutionArn/$LATEST

  • NelcampaignConfig, 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, consulta Creazione di una campagna.

Sintassi della richiesta

{
   "campaignArn": "string",
   "campaignConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "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:.*:.*:.+

Campo obbligatorio: sì

campaignConfig

I dettagli di configurazione di una campagna.

Tipo: oggetto CampaignConfig

Campo obbligatorio: no

minProvisionedTPS

Specifica 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: integer

Intervallo valido: valore minimo di 1.

Campo obbligatorio: no

solutionVersionArn

L'Amazon Resource Name (ARN) di un nuovo modello da implementare. Per specificare la versione più recente della soluzione, specificare l'ARN della soluzione in uso nel SolutionArn/$LATEST formato. È necessario utilizzare questo formato se è syncWithLatestSolutionVersion impostato True su. CampaignConfig

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.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):personalize:.*:.*:.+

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

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: