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á. # CreateCampaign **Importante** Os custos da campanha são acumulados enquanto ela está ativa. Para evitar custos desnecessários, certifique-se de excluir a campanha quando terminar. Para obter mais informações sobre os custos das campanhas, consulte [Preços do Amazon Personalize](https://aws.amazon.com/personalize/pricing/). Crie uma campanha que implanta uma versão da solução. Quando um cliente liga para o [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)e [GetPersonalizedRanking](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html) APIs, uma campanha é especificada na solicitação. **TPS provisionado mínimo e ajuste de escala automático** **Importante** Um `minProvisionedTPS` alto aumentará o custo. Recomendamos começar com 1 para `minProvisionedTPS` (o padrão). Monitore seu uso usando CloudWatch as métricas da Amazon e aumente as `minProvisionedTPS` conforme necessário. Ao criar uma campanha do Amazon Personalize, é possível especificar o mínimo de transações provisionadas por segundo (`minProvisionedTPS`) para a campanha. Esse é o throughput de transação básico para a campanha provisionada pelo Amazon Personalize. Ele define a cobrança mínima para a campanha enquanto ela está ativa. Transação é uma solicitação `GetRecommendations` ou `GetPersonalizedRanking` única. O `minProvisionedTPS` padrão é um. Se o TPS ultrapassar o `minProvisionedTPS`, o Amazon Personalize fará um ajuste de escala automático da capacidade provisionada, mas nunca a definirá como abaixo de `minProvisionedTPS`. Há um pequeno atraso no aumento da capacidade, o que pode causar perda de transações. Quando o tráfego é reduzido, a capacidade retorna ao `minProvisionedTPS`. Você recebe cobrança pelo TPS mínimo provisionado ou, se as solicitações excederem o `minProvisionedTPS`, o TPS real. O TPS real é o número total de solicitações de recomendação realizadas. Recomendamos começar com uma baixa`minProvisionedTPS`, monitorar seu uso usando CloudWatch as métricas da Amazon e, em seguida, aumentá-las `minProvisionedTPS` conforme necessário. Para obter mais informações sobre custos de campanhas, consulte [Preços do Amazon Personalize](https://aws.amazon.com/personalize/pricing/). **Status** Uma campanha pode estar em um dos seguintes estados: + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS Para obter o status da campanha, ligue [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html). **nota** Aguarde até que o `status` da campanha seja `ACTIVE` para pedir recomendações à campanha. **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) ## Sintaxe da solicitação ``` { "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## Parâmetros da solicitação A solicitação aceita os dados a seguir no formato JSON. ** [campaignConfig](#API_CreateCampaign_RequestSyntax) ** Os detalhes de configuração de uma campanha. Tipo: objeto [CampaignConfig](API_CampaignConfig.md) Obrigatório: não ** [minProvisionedTPS](#API_CreateCampaign_RequestSyntax) ** Especifica o mínimo de transações provisionadas (recomendações) solicitadas por segundo para o qual o Amazon Personalize oferecerá suporte. Uma `minProvisionedTPS` alta aumentará sua conta. Recomendamos começar com 1 para `minProvisionedTPS` (o padrão). Monitore seu uso usando CloudWatch as métricas da Amazon e aumente as `minProvisionedTPS` conforme necessário. Tipo: inteiro Intervalo válido: valor mínimo de 1. Obrigatório: não ** [name](#API_CreateCampaign_RequestSyntax) ** Um nome para a nova campanha. O nome da campanha deve ser exclusivo na sua conta. Tipo: string Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63. Padrão: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` Obrigatório: Sim ** [solutionVersionArn](#API_CreateCampaign_RequestSyntax) ** O nome de recurso da Amazon (ARN) do modelo treinado a ser implantado com a campanha. Para especificar a versão mais recente da solução, indique o ARN da *solução* no formato `SolutionArn/$LATEST`. Você deve usar esse formato se você `syncWithLatestSolutionVersion` definir como `True` no [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html). Para implantar um modelo que não seja a versão mais recente da solução, especifique o ARN da versão da solução. Para obter informações sobre as atualizações automáticas das campanhas, consulte [Habilitar as atualizações de campanha automáticas](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update). Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obrigatório: Sim ** [tags](#API_CreateCampaign_RequestSyntax) ** Uma lista de [tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) a serem aplicadas à campanha. Tipo: matriz de objetos [Tag](API_Tag.md) Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens. Obrigatório: não ## Sintaxe da resposta ``` { "campaignArn": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [campaignArn](#API_CreateCampaign_ResponseSyntax) ** O nome do recurso da Amazon (ARN) da campanha. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## Erros ** InvalidInputException ** Forneça um valor válido para o campo ou parâmetro. Código de status HTTP: 400 ** LimitExceededException ** O limite de número de solicitações por segundo foi excedido. Código de status HTTP: 400 ** ResourceAlreadyExistsException ** O recurso especificado já existe. Código de status HTTP: 400 ** ResourceInUseException ** O recurso especificado está em uso. Código de status HTTP: 400 ** ResourceNotFoundException ** Não foi possível encontrar o recurso especificado. Código de status HTTP: 400 ** TooManyTagsException ** Você excedeu o número máximo de tags que pode aplicar a esse recurso. Código de Status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando 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)