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á.
CreateRecommender
Cria um recomendador com a fórmula (um caso de uso de grupo de conjunto de dados de domínio) que você especificar. Você cria recomendadores para um grupo de conjuntos de dados de domínio e especifica o Amazon Resource Name (ARN) do recomendador ao fazer uma solicitação. GetRecommendations
Mínimo de solicitações de recomendação por segundo
Importante
Uma minRecommendationRequestsPerSecond alta aumentará sua conta. Recomendamos começar com 1 para minRecommendationRequestsPerSecond (o padrão). Acompanhe seu uso usando CloudWatch as métricas da Amazon e aumente as minRecommendationRequestsPerSecond conforme necessário.
Ao criar um recomendador, você pode configurar as solicitações mínimas de recomendação do recomendador por segundo. As solicitações mínimas de recomendação por segundo (minRecommendationRequestsPerSecond) especificam o throughput da solicitação de recomendação da linha de base provisionada pelo Amazon Personalize. O padrão minRecommendationRequests PerSecond é1. Uma solicitação de recomendação é uma operação GetRecommendations única. O throughput de solicitações é medido em solicitações por segundo, e o Amazon Personalize usa suas solicitações por segundo para derivar suas solicitações por hora e o preço do uso do seu recomendador.
Se as suas solicitações por segundo aumentarem além de minRecommendationRequestsPerSecond, o Amazon Personalize fará o ajuste de escala automático da capacidade provisionada para cima ou para baixo, mas nunca abaixo de minRecommendationRequestsPerSecond. Há um pequeno atraso no aumento da capacidade, o que pode causar perda de solicitações.
Sua fatura é a maior entre as solicitações mínimas por hora (com base em minRecommendationRequestsPerSecond) ou o número real de solicitações. O throughput real de solicitações usado é calculado como a média de solicitações/segundo em uma janela de uma hora. Recomendamos começar com o padrãominRecommendationRequestsPerSecond, monitorar seu uso usando CloudWatch as métricas da Amazon e, em seguida, aumentá-las minRecommendationRequestsPerSecond conforme necessário.
Status
Um recomendador pode estar em um dos seguintes estados:
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
-
STOP PENDING > STOP IN_PROGRESS > INACTIVE > START PENDING > START IN_PROGRESS > ACTIVE
-
DELETE PENDING > DELETE IN_PROGRESS
Para obter o status de recomendador, ligue DescribeRecommender.
nota
Aguarde até que o status do recomendador seja ACTIVE antes de pedir recomendações ao recomendador.
APIs relacionadas
Sintaxe da Solicitação
{
"datasetGroupArn": "string",
"name": "string",
"recipeArn": "string",
"recommenderConfig": {
"enableMetadataWithRecommendations": boolean,
"itemExplorationConfig": {
"string" : "string"
},
"minRecommendationRequestsPerSecond": number,
"trainingDataConfig": {
"excludedDatasetColumns": {
"string" : [ "string" ]
}
}
},
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}Parâmetros da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- datasetGroupArn
-
O nome do recurso da Amazon (ARN) do grupo de conjuntos de dados de domínio de destino para o recomendador.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):personalize:.*:.*:.+Exigido: Sim
- name
-
O nome do recomendador.
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\-_]*Exigido: Sim
- recipeArn
-
O nome do recurso da Amazon (ARN) da fórmula que o recomendador usará. Para um recomendador, uma fórmula é um caso de uso de grupo de conjuntos de dados do domínio. Somente casos de uso de grupo de conjuntos de dados de domínio podem ser usados para criar um recomendador. Para obter informações sobre casos de uso, consulte Como escolher casos de uso de recomendadores.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):personalize:.*:.*:.+Exigido: Sim
- recommenderConfig
-
Os detalhes de configuração do recomendador.
Tipo: objeto RecommenderConfig
Obrigatório: Não
-
Uma lista de tags para aplicar ao recomendador.
Tipo: matriz de objetos Tag
Membros da Matriz: número mínimo de 0 itens. Número máximo de 200 itens.
Obrigatório: Não
Sintaxe da Resposta
{
"recommenderArn": "string"
}Elementos de Resposta
Se a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- recommenderArn
-
O nome do recurso da Amazon (ARN) do recomendador.
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 um dos AWS SDKs específicos da linguagem, consulte o seguinte:
