기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateRecommender 지정한 레시피(도메인 데이터세트 그룹 사용 사례)로 추천자를 생성합니다. 도메인 데이터세트 그룹에 대한 추천자를 생성하고 [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) 요청을 만들 때 해당 추천자의 리소스 이름(ARN)을 지정합니다. **초당 최소 추천 요청 수** **중요** `minRecommendationRequestsPerSecond`가 높으면 요금이 인상됩니다. `minRecommendationRequestsPerSecond`(기본값)의 경우 1부터 시작하는 것이 좋습니다. CloudWatch 지표를 사용하여 사용량을 추적하고 필요에 따라 `minRecommendationRequestsPerSecond`를 늘리세요. 추천을 생성할 때 추천의 초당 최소 추천 요청을 구성할 수 있습니다. 초당 최소 추천 요청(`minRecommendationRequestsPerSecond`)은 Personalize에서 프로비저닝하는 기본 추천 요청 처리량을 지정합니다. 기본 초당 최소 권장 요청 수는 `1`입니다. 추천 요청은 단일한 `GetRecommendations`작업입니다. 요청 처리량은 초당 요청 수로 측정되며 Personalize는 초당 요청을 사용하여 시간당 요청 및 추천 사용 요금을 도출합니다. 초당 요청의 수가 `minRecommendationRequestsPerSecond`이상으로 증가할 경우, Personalize는 프로비저닝된 용량을 자동으로 확장 및 축소하지만 `minRecommendationRequestsPerSecond`미만으로는 절대 그렇게 하지 않습니다. 용량이 증가 중에 잠시 동안의 지연으로 요청의 손실이 발생할 수 있습니다. 요금은 시간당 최소 요청 수(초당 최소 추천 요청 수 기준) 또는 실제 요청 수 중 더 큰 금액입니다. 실제 요청 처리량은 1시간 이내의 초당 평균 요청 수로 계산됩니다. 기본값 `minRecommendationRequestsPerSecond`로 시작하여 CloudWatch 지표를 사용하여 사용량을 추적한 다음 필요에 따라 `minRecommendationRequestsPerSecond`를 늘리는 것이 좋습니다. **상태** 추천자는 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE + DELETE PENDING > DELETE IN\$1PROGRESS 추천자 상태를 확인하려면 [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html)를 호출합니다. **참고** 추천자에게 추천을 요청하기 전에 추천자의 `status`가 `ACTIVE`가 될 때까지 기다립니다. **관련 API** + [ListRecommenders](https://docs.aws.amazon.com/personalize/latest/dg/API_ListRecommenders.html) + [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) + [UpdateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateRecommender.html) + [DeleteRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteRecommender.html) ## 구문 요청 ``` { "datasetGroupArn": "string", "name": "string", "recipeArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_CreateRecommender_RequestSyntax) ** 추천자에 대한 대상 도메인 데이터세트 그룹의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [name](#API_CreateRecommender_RequestSyntax) ** 추천자의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [recipeArn](#API_CreateRecommender_RequestSyntax) ** 추천자가 사용할 레시피의 리소스 이름(ARN)입니다. 추천자의 경우 레시피는 도메인 데이터세트 그룹 사용 사례입니다. 도메인 데이터세트 그룹 사용 사례만 추천자를 만드는 데 사용할 수 있습니다. 사용 사례에 대한 자세한 내용은 [추천자 사용 사례 선택](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html) 단원을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) ** 추천자의 구성 세부 정보입니다. 유형: [RecommenderConfig](API_RecommenderConfig.md)객체 필수 여부: 아니요 ** [tags](#API_CreateRecommender_RequestSyntax) ** 추천자에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)의 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "recommenderArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [recommenderArn](#API_CreateRecommender_ResponseSyntax) ** 추천자의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** LimitExceededException ** 초당 요청 수 한도를 초과했습니다. HTTP 상태 코드: 400 ** ResourceAlreadyExistsException ** 지정된 리소스가 이미 있습니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ** TooManyTagsException ** 이 리소스에 적용할 수 있는 최대 태그 수를 초과했습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateRecommender) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateRecommender) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateRecommender) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateRecommender) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateRecommender) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateRecommender)