As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Atualizar a configuração de uma campanha do Amazon Personalize
Para alterar o [TPS mínimo provisionado](campaigns.md#min-tps-auto-scaling) da campanha, implantar manualmente uma nova versão da solução ou modificar a configuração de uma campanha, por exemplo, ativando a inclusão dos metadados nas recomendações, é necessário atualizar a campanha de forma manual.
As situações a seguir não exigem uma atualização manual da campanha:
+ Caso sua campanha use atualizações automáticas, não será necessário fazer isso manualmente para implantar a versão mais recente da solução treinada de forma automática ou manual. Para obter mais informações, consulte [Atualizações automáticas da campanha](campaigns.md#create-campaign-automatic-latest-sv-update).
+ Com a fórmula User-Personalization v2, User-Personalization ou Next-Best-Action, o Amazon Personalize atualiza automaticamente a versão mais recente da solução a cada duas horas para incluir novos itens ou ações nas recomendações. Sua campanha usa automaticamente a versão atualizada da solução.
Atualize manualmente uma campanha com o console do Amazon Personalize, a AWS Command Line Interface (AWS CLI) ou SDKs do AWS.
**nota**
Para atualizar uma campanha e ativar a inclusão de metadados nas recomendações, é necessário ter um conjunto de dados de itens com uma coluna de metadados. Não é necessário usar os metadados no treinamento.
Se sua campanha tiver implantado anteriormente uma versão da solução que usava a fórmula User-Personalization-v2 ou Personalized-Ranking-v2, e você estiver migrando para uma versão mais antiga das fórmulas, a inclusão de metadados fica desativada por padrão. Você pode ativar essa inclusão ao atualizar a campanha. Para obter mais informações, consulte [Habilitar metadados nas recomendações](campaigns.md#create-campaign-return-metadata).
**Topics**
+ [Atualização de uma campanha (console)](#update-campaign-console)
+ [Atualização de uma campanha (AWS CLI)](#update-campaign-cli)
+ [Atualização de uma campanha (SDKs do AWS)](#update-campaign-sdk)
## Atualização de uma campanha (console)
Para implantar uma versão reciclada manualmente da solução ou para fazer alterações na configuração da campanha, atualize-a.
**Para atualizar uma campanha (console)**
1. Acesse [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home), abra o console do Amazon Personalize e faça login na sua conta.
1. Escolha o grupo de conjuntos de dados com a campanha que você deseja atualizar.
1. No painel de navegação, selecione **Campaigns (Campanhas)**.
1. Na página **Campanhas**, escolha a campanha que você deseja atualizar.
1. Na página de detalhes da campanha, escolha **Atualizar**.
1. Na página **Atualizar campanha**, faça suas alterações. Por exemplo, se você estiver implantando uma versão reciclada da solução, para **ID da versão da solução**, escolha o número de identificação para a nova versão da solução.
1. Selecione **Atualizar**. O Amazon Personalize atualiza a campanha para usar a nova versão da solução e quaisquer configurações alteradas.
## Atualização de uma campanha (AWS CLI)
Para implantar uma nova versão da solução, alterar [TPS mínimo provisionado](campaigns.md#min-tps-auto-scaling) da campanha ou alterar a configuração da sua campanha, você deve atualizá-la. Use o comando `update-campaign` a seguir para atualizar uma campanha para usar uma nova versão da solução com AWS CLI.
Substitua `campaign arn` pelo Amazon Resource Name (ARN) da campanha que você deseja atualizar. Substitua `new solution version arn` pela versão da solução que você deseja implantar.
```
aws personalize update-campaign \
--campaign-arn campaign arn \
--solution-version-arn new solution version arn \
--min-provisioned-tps 1
```
## Atualização de uma campanha (SDKs do AWS)
Para implantar uma nova versão da solução, alterar [TPS mínimo provisionado](campaigns.md#min-tps-auto-scaling) da campanha ou alterar a configuração da sua campanha, você deve atualizá-la. Use o código a seguir para atualizar uma campanha com o SDK for Python (Boto3) ou o SDK para Java 2.x. Para obter uma lista completa de parâmetros, consulte [UpdateCampaign](API_UpdateCampaign.md).
------
#### [ SDK for Python (Boto3) ]
Use o método `update_campaign` a seguir para implantar uma nova versão da solução. Substitua `campaign arn` pelo Amazon Resource Name (ARN) da campanha que você deseja atualizar, substitua `new solution version arn` pelo novo ARN da versão da solução e, opcionalmente, altere `minProvisionedTPS`.
```
import boto3
personalize = boto3.client('personalize')
response = personalize.update_campaign(
campaignArn = 'campaign arn',
solutionVersionArn = 'new solution version arn',
minProvisionedTPS = 1,
)
arn = response['campaignArn']
description = personalize.describe_campaign(campaignArn = arn)['campaign']
print('Name: ' + description['name'])
print('ARN: ' + description['campaignArn'])
print('Status: ' + description['status'])
```
------
#### [ SDK for Java 2.x ]
Use o método `updateCampaign` a seguir para atualizar uma campanha para usar uma nova versão da solução. Passe como parâmetros um cliente do serviço do Amazon Personalize, o Amazon Resource Name (ARN) da nova versão da solução e [TPS mínimo provisionado](campaigns.md#min-tps-auto-scaling).
```
public static void updateCampaign(PersonalizeClient personalizeClient,
String campaignArn,
String solutionVersionArn,
Integer minProvisionedTPS) {
try {
// build the updateCampaignRequest
UpdateCampaignRequest updateCampaignRequest = UpdateCampaignRequest.builder()
.campaignArn(campaignArn)
.solutionVersionArn(solutionVersionArn)
.minProvisionedTPS(minProvisionedTPS)
.build();
// update the campaign
personalizeClient.updateCampaign(updateCampaignRequest);
DescribeCampaignRequest campaignRequest = DescribeCampaignRequest.builder()
.campaignArn(campaignArn)
.build();
DescribeCampaignResponse campaignResponse = personalizeClient.describeCampaign(campaignRequest);
Campaign updatedCampaign = campaignResponse.campaign();
System.out.println("The Campaign status is " + updatedCampaign.status());
} catch (PersonalizeException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
------