Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Actualización de la configuración de una campaña de Amazon Personalize
<a name="update-campaigns"></a>

Para cambiar el [TPS mínimo aprovisionado](campaigns.md#min-tps-auto-scaling) de la campaña, implementar de forma manual una nueva versión de solución o modificar la configuración de una campaña (por ejemplo, activar la opción de incluir metadatos en las recomendaciones), debe actualizar la campaña de modo manual. 

 Lo que se indica a continuación no requiere una actualización manual de la campaña: 
+ Si la campaña usa actualizaciones de campaña automáticas, no tiene que actualizarla para implementar la última versión de solución configurada entrenada de forma automática o manual. Para obtener más información, consulte [Actualizaciones de campaña automáticas](campaigns.md#create-campaign-automatic-latest-sv-update). 
+  Con User-Personalization-v2, User-Personalization o Next-Best-Action, Amazon Personalize actualiza automáticamente la última versión de solución cada dos horas para incluir nuevos elementos o acciones en las recomendaciones. La campaña utiliza automáticamente la versión actualizada de la solución. 

Puede actualizar una campaña con la consola de Amazon Personalize, AWS Command Line Interface (AWS CLI) o los SDK de AWS.

**nota**  
Para actualizar una campaña con el fin de incluir metadatos en las recomendaciones, debe tener un conjunto de datos de elementos con una columna de metadatos. No es necesario usar los metadatos en el entrenamiento.  
Si la campaña ha implementado anteriormente una versión de solución que utilizaba User-Personalization-v2 o Personalized-Ranking-v2, y va a cambiar a una versión anterior de las recetas, la opción de incluir metadatos está desactivada de forma predeterminada. Puede activarla al actualizar la campaña. Para obtener más información, consulte [Metadatos de elemento en las recomendaciones](campaigns.md#create-campaign-return-metadata).

**Topics**
+ [Actualización de una campaña (consola)](#update-campaign-console)
+ [Actualización de una campaña (AWS CLI)](#update-campaign-cli)
+ [Actualización de una campaña (SDK de AWS)](#update-campaign-sdk)

## Actualización de una campaña (consola)
<a name="update-campaign-console"></a>

Para implementar una versión de la solución reentrenada manualmente o realizar cambios en la configuración de su campaña, debe actualizar su campaña.

**Para actualizar una campaña (consola)**

1. Abra la consola de Amazon Personalize en [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home) e inicie sesión en su cuenta.

1.  Elija el grupo de conjuntos de datos con la campaña que desea actualizar. 

1. En el panel de navegación, seleccione **Campañas**.

1. En la página **Campañas**, elija la campaña que desea actualizar.

1. En la página de detalles de la campaña, seleccione **Actualizar**.

1. En la página **Actualizar campaña**, realice los cambios. Por ejemplo, si va a implementar una versión reentrada de la solución, en el campo **ID de la versión de la solución**, elija el número de identificación de la nueva versión de la solución.

1. Elija **Actualizar**. Amazon Personalize actualiza la campaña para usar la nueva versión de la solución y cualquier configuración modificada.

## Actualización de una campaña (AWS CLI)
<a name="update-campaign-cli"></a>

Para implementar una nueva versión de la solución, cambiar el [TPS mínimo aprovisionado](campaigns.md#min-tps-auto-scaling) de la campaña o cambiar la configuración de la campaña, debe actualizarla. Use el siguiente comando `update-campaign` para actualizar una campaña y usar una nueva versión de la solución con AWS CLI. 

Reemplace `campaign arn` por el nombre de recurso de Amazon (ARN) de la campaña que desea actualizar. Reemplace `new solution version arn` por la versión de la solución que desea implementar. 

```
aws personalize update-campaign \
--campaign-arn campaign arn \
--solution-version-arn new solution version arn \
--min-provisioned-tps 1
```

## Actualización de una campaña (SDK de AWS)
<a name="update-campaign-sdk"></a>

Para implementar una nueva versión de la solución, cambiar el [TPS mínimo aprovisionado](campaigns.md#min-tps-auto-scaling) de la campaña o cambiar la configuración de la campaña, debe actualizarla. Utilice el siguiente código para actualizar una campaña con el SDK para Python (Boto3) o el SDK para Java 2.x. Para obtener una lista completa de parámetros, consulte [UpdateCampaign](API_UpdateCampaign.md). 

------
#### [ SDK for Python (Boto3) ]

Use el siguiente método `update_campaign` para implementar una nueva versión de la solución. Reemplace `campaign arn` por el nombre de recurso de Amazon (ARN) de la campaña que desea actualizar, reemplace `new solution version arn` por el ARN de la nueva versión de solución y, si lo desea, cambie `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 el siguiente método `updateCampaign` para actualizar una campaña y usar una nueva versión de la solución. Pase como parámetros un cliente de servicio Amazon Personalize, el nombre de recurso de Amazon (ARN) de la nueva versión de la solución y [TPS mínimo aprovisionado](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);
    }
}
```

------