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.

# UpdateCampaign
<a name="API_UpdateCampaign"></a>

 Actualiza una campaña para implementar una versión de solución reentrenada con una campaña existente, cambiar `minProvisionedTPS` de la campaña o modificar la configuración de la campaña. Por ejemplo, puede establecer `enableMetadataWithRecommendations` en true en el caso de una campaña existente.

 Para actualizar una campaña a fin de que comience automáticamente con la versión más reciente de la solución, especifique lo siguiente:
+ Para el parámetro `SolutionVersionArn`, especifique el nombre de recurso de Amazon (ARN) de la solución en el formato `SolutionArn/$LATEST`. 
+  En `campaignConfig`, establezca `syncWithLatestSolutionVersion` en `true`. 

Para actualizar una campaña, el estado de la campaña debe ser ACTIVE o CREATE FAILED. Comprueba el estado de la campaña mediante la [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html)operación.

**nota**  
Puede seguir recibiendo recomendaciones de una campaña mientras haya una actualización en curso. La campaña utilizará la versión de la solución y la configuración de la campaña anterior para generar recomendaciones hasta que el estado de la última actualización de la campaña sea `Active`. 

Para obtener más información sobre la actualización de una campaña, incluidos ejemplos de código, consulte [Actualización de una campaña](https://docs.aws.amazon.com/personalize/latest/dg/update-campaigns.html). Para obtener información acerca de las campañas, consulte [Creación de una campaña](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html).

## Sintaxis de la solicitud
<a name="API_UpdateCampaign_RequestSyntax"></a>

```
{
   "campaignArn": "string",
   "campaignConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "rankingInfluence": { 
         "string" : number 
      },
      "syncWithLatestSolutionVersion": boolean
   },
   "minProvisionedTPS": number,
   "solutionVersionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_UpdateCampaign_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [campaignArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignArn"></a>
El nombre de recurso de Amazon (ARN) de la campaña.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [campaignConfig](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignConfig"></a>
Los detalles de la configuración de una campaña.  
Tipo: objeto [CampaignConfig](API_CampaignConfig.md)  
Obligatorio: no

 ** [minProvisionedTPS](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-minProvisionedTPS"></a>
Especifica el número mínimo de transacciones aprovisionadas (recomendaciones) por segundo solicitadas que Amazon Personalize va a admitir. Un valor elevado de `minProvisionedTPS` aumentará su factura. Le recomendamos empezar con 1 para `minProvisionedTPS` (el valor predeterminado). Realiza un seguimiento de tu consumo mediante CloudWatch las métricas de Amazon y `minProvisionedTPS` auméntalas según sea necesario.  
Tipo: entero  
Rango válido: valor mínimo de 1.  
Obligatorio: no

 ** [solutionVersionArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-solutionVersionArn"></a>
Nombre de recurso de Amazon (ARN) del nuevo modelo que se va a implementar. Para especificar la versión más reciente de la solución, especifique el ARN de la *solución* en formato `SolutionArn/$LATEST`. Debes usar este formato si lo `syncWithLatestSolutionVersion` configuras `True` en [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html).   
 Para implementar un modelo que no sea la última versión de solución, especifique el ARN de la versión de solución.   
 Para obtener más información sobre las actualizaciones de campaña automáticas, consulte [Habilitación de las actualizaciones de campaña automáticas](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update).   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_UpdateCampaign_ResponseSyntax"></a>

```
{
   "campaignArn": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateCampaign_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [campaignArn](#API_UpdateCampaign_ResponseSyntax) **   <a name="personalize-UpdateCampaign-response-campaignArn"></a>
El mismo ARN de campaña que figura en la solicitud.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_UpdateCampaign_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateCampaign_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateCampaign)