CreateCampaign - Amazon Personalize

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

Crie uma campanha que implanta uma versão da solução. Quando um cliente chama as APIs GetRecommendations e GetPersonalizedRanking, 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 com as métricas do Amazon CloudWatch e aumente o 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 iniciar com um minProvisionedTPS baixo, monitorar seu uso com as métricas do Amazon CloudWatch e aumentar o minProvisionedTPS conforme necessário.

Para obter mais informações sobre custos de campanhas, consulte Preços do Amazon Personalize.

Status

Uma campanha pode estar em um dos seguintes estados:

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

  • DELETE PENDING > DELETE IN_PROGRESS

Para obter o status da campanha, chame DescribeCampaign.

nota

Aguarde até que o status da campanha seja ACTIVE para pedir recomendações à campanha.

Sintaxe da Solicitação

{ "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" } }, "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

Os detalhes de configuração de uma campanha.

Tipo: objeto CampaignConfig

Obrigatório: não

minProvisionedTPS

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 com as métricas do Amazon CloudWatch e aumente o minProvisionedTPS conforme necessário.

Tipo: inteiro

Intervalo válido: valor mínimo de 1.

Obrigatório: não

name

Um nome para a nova campanha. O nome da campanha deve ser exclusivo na sua conta.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 63.

Padrão: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

Obrigatório: sim

solutionVersionArn

O nome do recurso da Amazon (ARN) da versão da solução a ser implantada.

Tipo: string

Restrições de tamanho: tamanho máximo de 256.

Padrão: arn:([a-z\d-]+):personalize:.*:.*:.+

Obrigatório: sim

tags

Uma lista de tags a serem aplicadas à campanha.

Tipo: matriz de objetos Tag

Membros da Matriz: número mínimo de 0 itens. O número máximo é 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

O nome do recurso da Amazon (ARN) da campanha.

Tipo: string

Restrições de tamanho: tamanho máximo de 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

Ver também

Para mais informações sobre como usar essa API em um dos AWS SDKs de idiomas específicos, consulte o seguinte: