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.
APIs relacionadas
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 paraminProvisionedTPS
(o padrão). Monitore seu uso com as métricas do Amazon CloudWatch e aumente ominProvisionedTPS
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
-
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: