기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateRecommender
지정한 레시피(도메인 데이터세트 그룹 사용 사례)로 추천자를 생성합니다. 도메인 데이터세트 그룹에 대한 추천자를 생성하고 요청 시 추천자의 Amazon 리소스 이름 (ARN) 을 지정합니다. GetRecommendations
초당 최소 추천 요청 수
중요
minRecommendationRequestsPerSecond
가 높으면 요금이 인상됩니다. minRecommendationRequestsPerSecond
(기본값)의 경우 1부터 시작하는 것이 좋습니다. Amazon CloudWatch 지표를 사용하여 사용량을 추적하고 minRecommendationRequestsPerSecond
필요에 따라 사용량을 늘리십시오.
추천을 생성할 때 추천의 초당 최소 추천 요청을 구성할 수 있습니다. 초당 최소 추천 요청(minRecommendationRequestsPerSecond
)은 Personalize에서 프로비저닝하는 기본 추천 요청 처리량을 지정합니다. 기본값은 minRecommendationRequests PerSecond 입니다1
. 추천 요청은 단일한 GetRecommendations
작업입니다. 요청 처리량은 초당 요청 수로 측정되며 Personalize는 초당 요청을 사용하여 시간당 요청 및 추천 사용 요금을 도출합니다.
초당 요청의 수가 minRecommendationRequestsPerSecond
이상으로 증가할 경우, Personalize는 프로비저닝된 용량을 자동으로 확장 및 축소하지만 minRecommendationRequestsPerSecond
미만으로는 절대 그렇게 하지 않습니다. 용량이 증가 중에 잠시 동안의 지연으로 요청의 손실이 발생할 수 있습니다.
요금은 시간당 최소 요청 수 (기준 minRecommendationRequestsPerSecond) 와 실제 요청 수 중 더 큰 금액입니다. 실제 요청 처리량은 1시간 이내의 초당 평균 요청 수로 계산됩니다. minRecommendationRequestsPerSecond
기본값부터 시작하여 Amazon CloudWatch 메트릭을 사용하여 사용량을 추적한 다음 minRecommendationRequestsPerSecond
필요에 따라 늘리는 것이 좋습니다.
상태
추천자는 다음 상태 중 하나일 수 있습니다.
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE 또는 CREATE FAILED
-
STOP PENDING > STOP IN_PROGRESS > INACTIVE > START PENDING > START IN_PROGRESS > ACTIVE
-
DELETE PENDING > DELETE IN_PROGRESS
추천자 상태를 확인하려면 전화하십시오 DescribeRecommender.
참고
추천자에게 추천을 요청하기 전에 추천자의 status
가 ACTIVE
가 될 때까지 기다립니다.
구문 요청
{
"datasetGroupArn": "string
",
"name": "string
",
"recipeArn": "string
",
"recommenderConfig": {
"enableMetadataWithRecommendations": boolean
,
"itemExplorationConfig": {
"string
" : "string
"
},
"minRecommendationRequestsPerSecond": number
,
"trainingDataConfig": {
"excludedDatasetColumns": {
"string
" : [ "string
" ]
}
}
},
"tags": [
{
"tagKey": "string
",
"tagValue": "string
"
}
]
}
요청 파라미터
요청은 JSON 형식으로 다음 데이터를 받습니다.
- datasetGroupArn
-
추천자에 대한 대상 도메인 데이터세트 그룹의 리소스 이름(ARN)입니다.
타입: 문자열
길이 제약: 최대 길이 256.
패턴:
arn:([a-z\d-]+):personalize:.*:.*:.+
필수 사항 여부: Yes
- name
-
추천자의 이름.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이 63.
패턴:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*
필수 사항 여부: Yes
- recipeArn
-
추천자가 사용할 레시피의 리소스 이름(ARN)입니다. 추천자의 경우 레시피는 도메인 데이터세트 그룹 사용 사례입니다. 도메인 데이터세트 그룹 사용 사례만 추천자를 만드는 데 사용할 수 있습니다. 사용 사례에 대한 자세한 내용은 추천자 사용 사례 선택 단원을 참조하세요.
타입: 문자열
길이 제약: 최대 길이 256.
패턴:
arn:([a-z\d-]+):personalize:.*:.*:.+
필수 사항 여부: Yes
- recommenderConfig
-
추천자의 구성 세부 정보입니다.
유형: RecommenderConfig객체
필수 여부: 아니요
-
추천자에 적용할 태그의 목록입니다.
유형: Tag객체 어레이
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.
필수 여부: 아니요
응답 구문
{
"recommenderArn": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- recommenderArn
-
추천자의 리소스 이름(ARN)입니다.
타입: 문자열
길이 제약: 최대 길이 256.
패턴:
arn:([a-z\d-]+):personalize:.*:.*:.+
Errors
- InvalidInputException
-
필드 또는 파라미터에 유효한 값을 제공합니다.
HTTP 상태 코드: 400
- LimitExceededException
-
초당 요청 수 한도를 초과했습니다.
HTTP 상태 코드: 400
- ResourceAlreadyExistsException
-
지정된 리소스가 이미 있습니다.
HTTP 상태 코드: 400
- ResourceInUseException
-
지정된 리소스가 이미 사용 중입니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정된 리소스를 찾을 수 없습니다.
HTTP 상태 코드: 400
- TooManyTagsException
-
이 리소스에 적용할 수 있는 최대 태그 수를 초과했습니다.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.