CreateRecommender - Personalize

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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.

참고

추천자에게 추천을 요청하기 전에 추천자의 statusACTIVE가 될 때까지 기다립니다.

구문 요청

{ "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객체

필수 여부: 아니요

tags

추천자에 적용할 태그의 목록입니다.

유형: 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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.