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. # CreateCampaign **importante** Generará costos de campaña mientras esté activa. Para evitar costos innecesarios, asegúrese de eliminar la campaña cuando haya terminado. Para obtener información sobre los costos de campaña, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/). Crea una campaña que implementa una versión de solución. Cuando un cliente llama al [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)y [GetPersonalizedRanking](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html) APIs, en la solicitud, se especifica una campaña. **Valor TPS mínimo aprovisionado y escalado automático** **importante** Un valor elevado de `minProvisionedTPS` aumentará los costos. Le recomendamos empezar con 1 para `minProvisionedTPS` (el valor predeterminado). Realiza un seguimiento de tu consumo mediante CloudWatch las métricas de Amazon y auméntalo `minProvisionedTPS` según sea necesario. Al crear una campaña de Amazon Personalize, puede especificar el número mínimo de transacciones aprovisionadas por segundo (`minProvisionedTPS`) para la campaña. Este es el rendimiento de transacciones de línea base para la campaña aprovisionada por Amazon Personalize. Establece el cargo de facturación mínimo de la campaña mientras esté activa. Una transacción es una solicitud `GetRecommendations` o `GetPersonalizedRanking` simple. El valor predeterminado de `minProvisionedTPS` es 1. Si su TPS aumenta más de `minProvisionedTPS`, Amazon Personalize escala automáticamente la capacidad aprovisionada hacia arriba y hacia abajo, pero nunca por debajo de `minProvisionedTPS`. Se produce un breve retraso durante el aumento de la capacidad que podría provocar la pérdida de transacciones. Cuando se reduce el tráfico, la capacidad vuelve al valor de `minProvisionedTPS`. Se le cobrará por el valor de TPS mínimo aprovisionado o, si sus solicitudes superan el valor de `minProvisionedTPS`, el TPS real. El TPS real es el número total de solicitudes de recomendación que realiza. Te recomendamos empezar con un nivel bajo`minProvisionedTPS`, realizar un seguimiento de tu uso mediante CloudWatch las métricas de Amazon y, a continuación, aumentarlo `minProvisionedTPS` según sea necesario. Para obtener más información sobre los costos de las campañas, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/). **Estado** Una campaña puede tener uno de los siguientes estados: + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS Para conocer el estado de la campaña, llama [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html). **nota** Espera a que el `status` de la campaña sea `ACTIVE` antes de pedir recomendaciones a la campaña. **Relacionado APIs** + [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) + [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) + [UpdateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateCampaign.html) + [DeleteCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteCampaign.html) ## Sintaxis de la solicitud ``` { "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## Parámetros de la solicitud La solicitud acepta los siguientes datos en formato JSON. ** [campaignConfig](#API_CreateCampaign_RequestSyntax) ** Los detalles de la configuración de una campaña. Tipo: objeto [CampaignConfig](API_CampaignConfig.md) Obligatorio: no ** [minProvisionedTPS](#API_CreateCampaign_RequestSyntax) ** 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 auméntalo `minProvisionedTPS` según sea necesario. Tipo: entero Rango válido: valor mínimo de 1. Obligatorio: no ** [name](#API_CreateCampaign_RequestSyntax) ** Un nombre para la nueva campaña. El nombre de la campaña debe ser único en la cuenta. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63. Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` Obligatorio: sí ** [solutionVersionArn](#API_CreateCampaign_RequestSyntax) ** Nombre de recurso de Amazon (ARN) del modelo entrenado que se implementará con la campaña. 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: sí ** [tags](#API_CreateCampaign_RequestSyntax) ** Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican a la campaña. Tipo: matriz de objetos [Tag](API_Tag.md) Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos. Obligatorio: no ## Sintaxis de la respuesta ``` { "campaignArn": "string" } ``` ## Elementos de respuesta 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_CreateCampaign_ResponseSyntax) ** 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:.*:.*:.+` ## Errores ** InvalidInputException ** Proporcione un valor válido para el campo o el parámetro. Código de estado HTTP: 400 ** LimitExceededException ** Se ha excedido el límite en el número de solicitudes por segundo. Código de estado HTTP: 400 ** ResourceAlreadyExistsException ** El recurso especificado ya existe. 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 ** TooManyTagsException ** Ha superado el número máximo de etiquetas que puede aplicar a este recurso. Código de estado HTTP: 400 ## Véase también 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/CreateCampaign) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateCampaign) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateCampaign) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateCampaign) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateCampaign) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateCampaign) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateCampaign) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateCampaign) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateCampaign) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateCampaign)