기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # API 참조 이 단원에서는 Personalize API 작업에 대한 설명서를 제공합니다. Personalize 엔드포인트 목록은AWS 일반 참조의 [AWS 리전 및 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/personalize.html)를 참조하세요.** **Topics** + [작업](API_Operations.md) + [데이터 타입](API_Types.md) + [일반적인 오류](CommonErrors.md) + [공통 파라미터](CommonParameters.md) # 작업 Personalize에서 지원하는 작업은 다음과 같습니다. + [CreateBatchInferenceJob](API_CreateBatchInferenceJob.md) + [CreateBatchSegmentJob](API_CreateBatchSegmentJob.md) + [CreateCampaign](API_CreateCampaign.md) + [CreateDataDeletionJob](API_CreateDataDeletionJob.md) + [CreateDataset](API_CreateDataset.md) + [CreateDatasetExportJob](API_CreateDatasetExportJob.md) + [CreateDatasetGroup](API_CreateDatasetGroup.md) + [CreateDatasetImportJob](API_CreateDatasetImportJob.md) + [CreateEventTracker](API_CreateEventTracker.md) + [CreateFilter](API_CreateFilter.md) + [CreateMetricAttribution](API_CreateMetricAttribution.md) + [CreateRecommender](API_CreateRecommender.md) + [CreateSchema](API_CreateSchema.md) + [CreateSolution](API_CreateSolution.md) + [CreateSolutionVersion](API_CreateSolutionVersion.md) + [DeleteCampaign](API_DeleteCampaign.md) + [DeleteDataset](API_DeleteDataset.md) + [DeleteDatasetGroup](API_DeleteDatasetGroup.md) + [DeleteEventTracker](API_DeleteEventTracker.md) + [DeleteFilter](API_DeleteFilter.md) + [DeleteMetricAttribution](API_DeleteMetricAttribution.md) + [DeleteRecommender](API_DeleteRecommender.md) + [DeleteSchema](API_DeleteSchema.md) + [DeleteSolution](API_DeleteSolution.md) + [DescribeAlgorithm](API_DescribeAlgorithm.md) + [DescribeBatchInferenceJob](API_DescribeBatchInferenceJob.md) + [DescribeBatchSegmentJob](API_DescribeBatchSegmentJob.md) + [DescribeCampaign](API_DescribeCampaign.md) + [DescribeDataDeletionJob](API_DescribeDataDeletionJob.md) + [DescribeDataset](API_DescribeDataset.md) + [DescribeDatasetExportJob](API_DescribeDatasetExportJob.md) + [DescribeDatasetGroup](API_DescribeDatasetGroup.md) + [DescribeDatasetImportJob](API_DescribeDatasetImportJob.md) + [DescribeEventTracker](API_DescribeEventTracker.md) + [DescribeFeatureTransformation](API_DescribeFeatureTransformation.md) + [DescribeFilter](API_DescribeFilter.md) + [DescribeMetricAttribution](API_DescribeMetricAttribution.md) + [DescribeRecipe](API_DescribeRecipe.md) + [DescribeRecommender](API_DescribeRecommender.md) + [DescribeSchema](API_DescribeSchema.md) + [DescribeSolution](API_DescribeSolution.md) + [DescribeSolutionVersion](API_DescribeSolutionVersion.md) + [GetSolutionMetrics](API_GetSolutionMetrics.md) + [ListBatchInferenceJobs](API_ListBatchInferenceJobs.md) + [ListBatchSegmentJobs](API_ListBatchSegmentJobs.md) + [ListCampaigns](API_ListCampaigns.md) + [ListDataDeletionJobs](API_ListDataDeletionJobs.md) + [ListDatasetExportJobs](API_ListDatasetExportJobs.md) + [ListDatasetGroups](API_ListDatasetGroups.md) + [ListDatasetImportJobs](API_ListDatasetImportJobs.md) + [ListDatasets](API_ListDatasets.md) + [ListEventTrackers](API_ListEventTrackers.md) + [ListFilters](API_ListFilters.md) + [ListMetricAttributionMetrics](API_ListMetricAttributionMetrics.md) + [ListMetricAttributions](API_ListMetricAttributions.md) + [ListRecipes](API_ListRecipes.md) + [ListRecommenders](API_ListRecommenders.md) + [ListSchemas](API_ListSchemas.md) + [ListSolutions](API_ListSolutions.md) + [ListSolutionVersions](API_ListSolutionVersions.md) + [ListTagsForResource](API_ListTagsForResource.md) + [StartRecommender](API_StartRecommender.md) + [StopRecommender](API_StopRecommender.md) + [StopSolutionVersionCreation](API_StopSolutionVersionCreation.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateCampaign](API_UpdateCampaign.md) + [UpdateDataset](API_UpdateDataset.md) + [UpdateMetricAttribution](API_UpdateMetricAttribution.md) + [UpdateRecommender](API_UpdateRecommender.md) + [UpdateSolution](API_UpdateSolution.md) Personalize 이벤트에서 지원하는 작업은 다음과 같습니다. + [PutActionInteractions](API_UBS_PutActionInteractions.md) + [PutActions](API_UBS_PutActions.md) + [PutEvents](API_UBS_PutEvents.md) + [PutItems](API_UBS_PutItems.md) + [PutUsers](API_UBS_PutUsers.md) Personalize 런타임에서 지원하는 작업은 다음과 같습니다. + [GetActionRecommendations](API_RS_GetActionRecommendations.md) + [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) + [GetRecommendations](API_RS_GetRecommendations.md) # Personalize Personalize에서 지원하는 작업은 다음과 같습니다. + [CreateBatchInferenceJob](API_CreateBatchInferenceJob.md) + [CreateBatchSegmentJob](API_CreateBatchSegmentJob.md) + [CreateCampaign](API_CreateCampaign.md) + [CreateDataDeletionJob](API_CreateDataDeletionJob.md) + [CreateDataset](API_CreateDataset.md) + [CreateDatasetExportJob](API_CreateDatasetExportJob.md) + [CreateDatasetGroup](API_CreateDatasetGroup.md) + [CreateDatasetImportJob](API_CreateDatasetImportJob.md) + [CreateEventTracker](API_CreateEventTracker.md) + [CreateFilter](API_CreateFilter.md) + [CreateMetricAttribution](API_CreateMetricAttribution.md) + [CreateRecommender](API_CreateRecommender.md) + [CreateSchema](API_CreateSchema.md) + [CreateSolution](API_CreateSolution.md) + [CreateSolutionVersion](API_CreateSolutionVersion.md) + [DeleteCampaign](API_DeleteCampaign.md) + [DeleteDataset](API_DeleteDataset.md) + [DeleteDatasetGroup](API_DeleteDatasetGroup.md) + [DeleteEventTracker](API_DeleteEventTracker.md) + [DeleteFilter](API_DeleteFilter.md) + [DeleteMetricAttribution](API_DeleteMetricAttribution.md) + [DeleteRecommender](API_DeleteRecommender.md) + [DeleteSchema](API_DeleteSchema.md) + [DeleteSolution](API_DeleteSolution.md) + [DescribeAlgorithm](API_DescribeAlgorithm.md) + [DescribeBatchInferenceJob](API_DescribeBatchInferenceJob.md) + [DescribeBatchSegmentJob](API_DescribeBatchSegmentJob.md) + [DescribeCampaign](API_DescribeCampaign.md) + [DescribeDataDeletionJob](API_DescribeDataDeletionJob.md) + [DescribeDataset](API_DescribeDataset.md) + [DescribeDatasetExportJob](API_DescribeDatasetExportJob.md) + [DescribeDatasetGroup](API_DescribeDatasetGroup.md) + [DescribeDatasetImportJob](API_DescribeDatasetImportJob.md) + [DescribeEventTracker](API_DescribeEventTracker.md) + [DescribeFeatureTransformation](API_DescribeFeatureTransformation.md) + [DescribeFilter](API_DescribeFilter.md) + [DescribeMetricAttribution](API_DescribeMetricAttribution.md) + [DescribeRecipe](API_DescribeRecipe.md) + [DescribeRecommender](API_DescribeRecommender.md) + [DescribeSchema](API_DescribeSchema.md) + [DescribeSolution](API_DescribeSolution.md) + [DescribeSolutionVersion](API_DescribeSolutionVersion.md) + [GetSolutionMetrics](API_GetSolutionMetrics.md) + [ListBatchInferenceJobs](API_ListBatchInferenceJobs.md) + [ListBatchSegmentJobs](API_ListBatchSegmentJobs.md) + [ListCampaigns](API_ListCampaigns.md) + [ListDataDeletionJobs](API_ListDataDeletionJobs.md) + [ListDatasetExportJobs](API_ListDatasetExportJobs.md) + [ListDatasetGroups](API_ListDatasetGroups.md) + [ListDatasetImportJobs](API_ListDatasetImportJobs.md) + [ListDatasets](API_ListDatasets.md) + [ListEventTrackers](API_ListEventTrackers.md) + [ListFilters](API_ListFilters.md) + [ListMetricAttributionMetrics](API_ListMetricAttributionMetrics.md) + [ListMetricAttributions](API_ListMetricAttributions.md) + [ListRecipes](API_ListRecipes.md) + [ListRecommenders](API_ListRecommenders.md) + [ListSchemas](API_ListSchemas.md) + [ListSolutions](API_ListSolutions.md) + [ListSolutionVersions](API_ListSolutionVersions.md) + [ListTagsForResource](API_ListTagsForResource.md) + [StartRecommender](API_StartRecommender.md) + [StopRecommender](API_StopRecommender.md) + [StopSolutionVersionCreation](API_StopSolutionVersionCreation.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateCampaign](API_UpdateCampaign.md) + [UpdateDataset](API_UpdateDataset.md) + [UpdateMetricAttribution](API_UpdateMetricAttribution.md) + [UpdateRecommender](API_UpdateRecommender.md) + [UpdateSolution](API_UpdateSolution.md) # CreateBatchInferenceJob Amazon S3에 저장된 항목 또는 사용자 목록을 기반으로 배치 추천을 생성하고 Amazon S3 버킷으로 추천을 내보냅니다. 배치 추천을 생성하려면 솔루션 버전의 ARN과 입력 및 출력 데이터에 대한 Amazon S3 URI를 지정합니다. 사용자 개인 맞춤, 인기 항목, 개인 맞춤형 순위 솔루션의 경우 배치 추론 작업은 입력 파일의 각 사용자 ID에 대한 추천 항목 목록을 생성합니다. 관련 항목 솔루션의 경우 작업은 입력 파일의 각 항목 ID에 대한 추천 항목 목록을 생성합니다. 자세한 내용은 [배치 추론 작업 생성](https://docs.aws.amazon.com/personalize/latest/dg/getting-batch-recommendations.html) 단원을 참조하세요. 유사-항목 레시피를 사용하는 경우 Amazon Personalize는 설명 테마를 배치 추천에 추가할 수 있습니다. 테마를 생성하려면 작업 모드를 `THEME_GENERATION`으로 설정하고 입력 데이터에 항목 이름이 포함된 필드의 이름을 지정하세요. 테마 생성에 대한 자세한 내용은 [콘텐츠 생성기에서 테마가 있는 배치 추천](https://docs.aws.amazon.com/personalize/latest/dg/themed-batch-recommendations.html)을 참조하세요. 지금-유행 또는 차선책-작업 레시피로는 배치 추천을 받을 수 없습니다. ## 구문 요청 ``` { "batchInferenceJobConfig": { "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number } }, "batchInferenceJobMode": "string", "filterArn": "string", "jobInput": { "s3DataSource": { "kmsKeyArn": "string", "path": "string" } }, "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "numResults": number, "roleArn": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ], "themeGenerationConfig": { "fieldsForThemeGeneration": { "itemName": "string" } } } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [batchInferenceJobConfig](#API_CreateBatchInferenceJob_RequestSyntax) ** 배치 추론 작업의 구성 세부 정보입니다. 유형: [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md)객체 필수 여부: 아니요 ** [batchInferenceJobMode](#API_CreateBatchInferenceJob_RequestSyntax) ** 배치 추론 작업의 모드. 유사한 항목 그룹을 설명하는 테마를 생성하려면 작업 모드를 `THEME_GENERATION`으로 설정합니다. 테마를 생성하지 않으려면 기본 `BATCH_INFERENCE`를 사용하세요. 테마가 있는 배치 추천을 받으면 추가 비용이 발생합니다. 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요. 타입: 문자열 유효 값: `BATCH_INFERENCE | THEME_GENERATION` 필수 여부: 아니요 ** [filterArn](#API_CreateBatchInferenceJob_RequestSyntax) ** 배치 추론 작업에 적용할 필터의 ARN입니다. 자세한 내용은 [배치 추천 필터링](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html) 단원을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [jobInput](#API_CreateBatchInferenceJob_RequestSyntax) ** 추천의 기반이 되는 입력 파일로 연결되는 S3 경로. 입력 구성 요소는 JSON 형식이어야 합니다. 유형: [BatchInferenceJobInput](API_BatchInferenceJobInput.md)객체 필수 항목 여부: 예 ** [jobName](#API_CreateBatchInferenceJob_RequestSyntax) ** 생성할 배치 추론 작업의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [jobOutput](#API_CreateBatchInferenceJob_RequestSyntax) ** 작업의 출력이 저장되는 S3 버킷의 경로. 유형: [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md)객체 필수 항목 여부: 예 ** [numResults](#API_CreateBatchInferenceJob_RequestSyntax) ** 검색할 추천 수. 유형: 정수 필수 항목 여부: 아니요 ** [roleArn](#API_CreateBatchInferenceJob_RequestSyntax) ** 자격 증명 및 액세스 관리 역할의 ARN으로, 입력 및 출력 S3 버킷에 대한 읽기 및 쓰기 권한을 각각 가지고 있습니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 예 ** [solutionVersionArn](#API_CreateBatchInferenceJob_RequestSyntax) ** 배치 추론 추천을 생성하는 데 사용할 솔루션 버전의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [tags](#API_CreateBatchInferenceJob_RequestSyntax) ** 배치 추론 작업에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ** [themeGenerationConfig](#API_CreateBatchInferenceJob_RequestSyntax) ** 테마 생성 작업의 경우 각 항목의 이름이 포함된 항목 데이터 세트의 열 이름을 지정하세요. 유형: [ThemeGenerationConfig](API_ThemeGenerationConfig.md)객체 필수 항목 여부: 아니요 ## 응답 구문 ``` { "batchInferenceJobArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [batchInferenceJobArn](#API_CreateBatchInferenceJob_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/CreateBatchInferenceJob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchInferenceJob) # CreateBatchSegmentJob 배치 세그먼트 작업을 생성합니다. 이 작업은 최대 5천만 개의 레코드를 처리할 수 있으며 입력 파일은 JSON 형식이어야 합니다. 자세한 내용은 [배치 추천 및 사용자 세그먼트 받기](https://docs.aws.amazon.com/personalize/latest/dg/recommendations-batch.html) 단원을 참조하세요. ## 구문 요청 ``` { "filterArn": "string", "jobInput": { "s3DataSource": { "kmsKeyArn": "string", "path": "string" } }, "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "numResults": number, "roleArn": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [filterArn](#API_CreateBatchSegmentJob_RequestSyntax) ** 배치 세그먼트 작업에 적용할 필터의 ARN입니다. 자세한 내용은 [배치 추천 필터링](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html) 단원을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [jobInput](#API_CreateBatchSegmentJob_RequestSyntax) ** 배치 세그먼트 작업을 생성하는 데 사용된 입력 데이터의 S3 경로. 유형: [BatchSegmentJobInput](API_BatchSegmentJobInput.md)객체 필수 여부: 예 ** [jobName](#API_CreateBatchSegmentJob_RequestSyntax) ** 생성할 배치 세그먼트 작업의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [jobOutput](#API_CreateBatchSegmentJob_RequestSyntax) ** 작업의 출력을 저장할 버킷의 S3 경로. 유형: [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md)객체 필수 항목 여부: 예 ** [numResults](#API_CreateBatchSegmentJob_RequestSyntax) ** 입력 데이터의 각 라인에 대해 배치 세그먼트 작업으로 생성된 예상 사용자 수. 세그먼트당 최대 사용자 수는 5백만 명입니다. 유형: 정수 필수 항목 여부: 아니요 ** [roleArn](#API_CreateBatchSegmentJob_RequestSyntax) ** 자격 증명 및 액세스 관리 역할의 ARN으로, 입력 및 출력 S3 버킷에 대한 읽기 및 쓰기 권한을 각각 가지고 있습니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 예 ** [solutionVersionArn](#API_CreateBatchSegmentJob_RequestSyntax) ** 배치 세그먼트 작업을 사용하여 배치 세그먼트를 생성하는 데 사용하려는 솔루션 버전의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [tags](#API_CreateBatchSegmentJob_RequestSyntax) ** 배치 세그먼트 작업에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "batchSegmentJobArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [batchSegmentJobArn](#API_CreateBatchSegmentJob_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/CreateBatchSegmentJob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchSegmentJob) # CreateCampaign **중요** 캠페인이 활성화되어 있는 동안 캠페인 비용이 발생합니다. 불필요한 비용을 방지하려면 완료 시 캠페인을 삭제해야 합니다. 캠페인 비용에 대한 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요. 솔루션 버전을 배포하는 캠페인을 생성합니다. 클라이언트가 [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) 및 [GetPersonalizedranking](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html) API를 호출하면 요청에 캠페인이 지정됩니다. **프로비저닝된 최소 TPS 및 자동 크기 조정** **중요** `minProvisionedTPS`가 높으면 비용이 증가합니다. `minProvisionedTPS`(기본값)의 경우 1부터 시작하는 것이 좋습니다. CloudWatch 지표를 사용하여 사용량을 추적하고 필요에 따라 `minProvisionedTPS`를 늘리세요. Amazon Personalize 캠페인을 생성할 때 캠페인에 대한 초당 최소 프로비저닝 트랜잭션 수(`minProvisionedTPS`)를 지정할 수 있습니다. 이는 Amazon Personalize에서 프로비저닝한 캠페인의 기준 트랜잭션 처리량입니다. 캠페인이 활성 상태일 때의 최소 청구 요금을 설정합니다. 트랜잭션은 단일 `GetRecommendations` 또는 `GetPersonalizedRanking` 요청으로 이루어집니다. 기본 `minProvisionedTPS` 값은 1입니다. TPS가 `minProvisionedTPS` 이상으로 증가할 경우 Amazon Personalize는 프로비저닝 용량을 자동으로 확장 및 축소하지만, `minProvisionedTPS` 이하로는 확장 및 축소하지 않습니다. 용량이 증가 중에 잠시 동안의 지연으로 거래 손실이 발생할 수 있습니다. 트래픽이 감소하면 용량은 `minProvisionedTPS`로 돌아옵니다. 프로비저닝된 최소 TPS에 대한 요금이 부과되며, 요청이 `minProvisionedTPS`를 초과하는 경우 실제 TPS에 대한 요금이 부과됩니다. 실제 TPS는 추천을 요청한 총 건수입니다. 낮은 `minProvisionedTPS`로 시작하여 CloudWatch 지표를 사용하여 사용량을 추적한 다음 필요에 따라 `minProvisionedTPS`를 늘리는 것이 좋습니다. 캠페인 비용에 대한 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요. **상태** 캠페인은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 캠페인 상태를 확인하려면 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html)을 호출합니다. **참고** 캠페인의 `status`이 `ACTIVE`가 될 때까지 기다렸다가 캠페인에 추천을 요청합니다. **관련 API** + [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) + [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) + [UpdateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateCampaign.html) + [DeleteCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteCampaign.html) ## 구문 요청 ``` { "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [campaignConfig](#API_CreateCampaign_RequestSyntax) ** 캠페인의 구성 세부 정보입니다. 유형: [CampaignConfig](API_CampaignConfig.md)객체 필수 여부: 아니요 ** [minProvisionedTPS](#API_CreateCampaign_RequestSyntax) ** Personalize에서 지원할 초당 요청된 최소 프로비저닝 트랜잭션(추천)을 지정합니다. `minProvisionedTPS`가 높으면 요금이 인상됩니다. `minProvisionedTPS`(기본값)의 경우 1부터 시작하는 것이 좋습니다. Amazon CloudWatch 지표를 사용하여 사용량을 추적하고 필요에 따라 `minProvisionedTPS`를 늘리세요. 타입: 정수 유효 범위: 최소값 1. 필수 여부: 아니요 ** [name](#API_CreateCampaign_RequestSyntax) ** 새 캠페인의 이름. 캠페인 이름은 계정 내에서 고유해야 합니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [solutionVersionArn](#API_CreateCampaign_RequestSyntax) ** 캠페인과 함께 배포할 학습된 모델의 Amazon 리소스 이름(ARN)입니다. 솔루션의 최신 솔루션 버전을 지정하려면 *솔루션*의 ARN을 `SolutionArn/$LATEST` 형식으로 지정합니다. [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html)에서 `syncWithLatestSolutionVersion`을 `True`로 설정한 경우 이 형식을 사용해야 합니다. 솔루션의 최신 솔루션 버전이 아닌 모델을 배포하려면 솔루션 버전의 ARN을 지정합니다. 자동 캠페인 업데이트에 대한 자세한 내용은 [자동 캠페인 업데이트 활성화](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [tags](#API_CreateCampaign_RequestSyntax) ** 캠페인에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)의 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "campaignArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [campaignArn](#API_CreateCampaign_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/CreateCampaign) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateCampaign) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateCampaign) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateCampaign) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateCampaign) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateCampaign) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateCampaign) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateCampaign) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateCampaign) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateCampaign) # CreateDataDeletionJob Amazon Personalize 데이터세트 그룹에서 특정 사용자에 대한 모든 참조를 일괄적으로 삭제하는 배치 작업을 생성합니다. Amazon S3 버킷의 userId CSV 파일에서 삭제할 사용자를 지정합니다. 작업이 완료되면 Amazon Personalize는 더 이상 사용자의 데이터를 학습하지 않으며 사용자 세그먼트를 생성할 때 사용자를 더 이상 고려하지 않습니다. 데이터 삭제 작업 생성에 대한 자세한 내용은 [사용자 삭제](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html)를 참조하세요. + 입력 파일은 사용자 ID를 나열하는 단일 USER\$1ID 열을 가진 CSV 파일이어야 합니다. CSV 파일 준비에 대한 자세한 내용은 [데이터 삭제 파일 준비 및 Amazon S3에 업로드](https://docs.aws.amazon.com/personalize/latest/dg/prepare-deletion-input-file.html)를 참조하세요. + Amazon Personalize에 userId의 입력 CSV 파일에 액세스할 수 있는 권한을 부여하려면 데이터 소스에서 읽을 수 있는 권한이 있는 IAM 서비스 역할을 지정해야 합니다. 이 역할에는 버킷 및 해당 콘텐츠에 대한 `GetObject` 및 `ListBucket` 권한이 필요합니다. 이러한 권한은 데이터 가져오기와 동일합니다. S3 버킷에 대한 액세스 권한의 부여에 대한 자세한 내용은 [S3 리소스에 대한 액세스 권한 Personalize에 부여](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html) 단원을 참조하세요. 작업을 생성한 후 데이터세트 및 모델에서 사용자에 대한 모든 참조를 삭제하는 데 최대 1일이 걸릴 수 있습니다. 작업이 완료될 때까지 Amazon Personalize는 학습 시 데이터를 계속 사용합니다. 사용자 세그먼트화 레시피를 사용하는 경우 사용자가 사용자 세그먼트에 표시될 수 있습니다. **상태** 데이터 삭제 작업은 다음 상태 중 하나를 가질 수 있습니다. + 보류 중 > 진행 중 > 완료 또는 실패 데이터 삭제 작업의 상태를 확인하려면 [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) API 작업을 직접적으로 호출하고 작업의 Amazon 리소스 이름(ARN)을 지정합니다. 상태가 FAILED인 경우 응답에는 작업이 실패한 이유를 설명하는 `failureReason` 키가 포함됩니다. **관련 API** + [ListDataDeletionJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDataDeletionJobs.html) + [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) ## 구문 요청 ``` { "datasetGroupArn": "string", "dataSource": { "dataLocation": "string" }, "jobName": "string", "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_CreateDataDeletionJob_RequestSyntax) ** 레코드를 삭제하려는 데이터세트를 포함하는 데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [dataSource](#API_CreateDataDeletionJob_RequestSyntax) ** 삭제할 사용자의 userId 목록이 포함된 Amazon S3 버킷입니다. 타입: [DataSource](API_DataSource.md)객체 필수 항목 여부: 예 ** [jobName](#API_CreateDataDeletionJob_RequestSyntax) ** 데이터 삭제 작업의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [roleArn](#API_CreateDataDeletionJob_RequestSyntax) ** Amazon S3 데이터 소스에서 읽을 권한이 있는 IAM 역할의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 예 ** [tags](#API_CreateDataDeletionJob_RequestSyntax) ** 데이터 삭제 작업에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)의 목록입니다. 타입: [Tag](API_Tag.md)객체 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "dataDeletionJobArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [dataDeletionJobArn](#API_CreateDataDeletionJob_ResponseSyntax) ** 데이터 삭제 작업의 Amazon 리소스 이름(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/CreateDataDeletionJob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataDeletionJob) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataDeletionJob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataDeletionJob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataDeletionJob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataDeletionJob) # CreateDataset 빈 데이터세트를 생성하고 지정된 데이터세트 그룹에 추가합니다. [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)을 사용하여 교육 데이터를 데이터세트로 가져옵니다. 다음과 같은 5가지 유형의 데이터 세트가 있습니다. + 항목 상호 작용 + Items + Users + 작업 상호 작용 + 작업 각 데이터세트 유형에는 필수 필드 유형과 연결된 스키마가 있습니다. 솔루션 생성이라고도 하는 모델 교육을 위해서는 `Item interactions`데이터세트만 필요합니다. 데이터세트는 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 데이터세트의 상태를 가져오려면 [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html)를 호출합니다. **관련 API** + [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html) + [ListDatasets](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasets.html) + [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) + [DeleteDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDataset.html) ## 구문 요청 ``` { "datasetGroupArn": "string", "datasetType": "string", "name": "string", "schemaArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_CreateDataset_RequestSyntax) ** 데이터세트를 추가할 데이터세트 그룹의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [datasetType](#API_CreateDataset_RequestSyntax) ** 데이터세트의 형식입니다. 다음 값 중 하나(대소문자 구분 안 함): + 상호작용 + Items + Users + 작업 + Action\$1Interactions 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `^[A-Za-z_]+$` 필수 여부: 예 ** [name](#API_CreateDataset_RequestSyntax) ** 데이터세트의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [schemaArn](#API_CreateDataset_RequestSyntax) ** 데이터세트와 연결할 스키마의 ARN입니다. 스키마가 데이터세트 필드를 정의합니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [tags](#API_CreateDataset_RequestSyntax) ** 데이터세트에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)의 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "datasetArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetArn](#API_CreateDataset_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/CreateDataset) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataset) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataset) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataset) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataset) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataset) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataset) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataset) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataset) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataset) # CreateDatasetExportJob 데이터세트의 데이터를 S3 버킷으로 내보내는 작업을 생성합니다. Personalize에서 학습 데이터를 내보내도록 허용하려면 S3 버킷에 대한 `PutObject`권한을 Personalize에 부여하는 서비스 연결 IAM 역할을 지정해야 합니다. 자세한 내용은 Personalize 개발자 안내서의 [데이터세트 내보내기](https://docs.aws.amazon.com/personalize/latest/dg/export-data.html) 단원을 참조하세요. **상태** 데이터세트 내보내기 작업은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED 내보내기 작업의 상태를 확인하려면 [DescribeDataSetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html)을 호출하고 데이터세트 내보내기 작업의 리소스 이름(ARN)을 지정합니다. 상태가 ACTIVE로 표시되면 데이터세트 가져오기가 완료된 것입니다, 상태가 CREATE FAILED로 표시되는 경우 응답에는 작업이 실패한 이유를 설명하는 `failureReason`키가 포함됩니다. ## 구문 요청 ``` { "datasetArn": "string", "ingestionMode": "string", "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetArn](#API_CreateDatasetExportJob_RequestSyntax) ** 가져온 데이터를 수신하는 데이터세트의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [ingestionMode](#API_CreateDatasetExportJob_RequestSyntax) ** 데이터를 가져온 방식에 따라 내보낼 데이터 데이터세트 가져오기 작업을 사용하여 가져온 `BULK`데이터만 내보내거나, 콘솔, PutEvents, PutUsers 및 PutItems 작업을 사용하여 점증적으로 가져온 `PUT`데이터만 내보내거나, 두 유형 모두에 대해 `ALL`을 내보내도록 선택할 수 있습니다. 기본 값은 `PUT`입니다. 타입: 문자열 유효 값: `BULK | PUT | ALL` 필수 여부: 아니요 ** [jobName](#API_CreateDatasetExportJob_RequestSyntax) ** 데이터세트 내보내기 작업의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [jobOutput](#API_CreateDatasetExportJob_RequestSyntax) ** 작업의 출력이 저장되는 S3 버킷의 경로. 유형: [DatasetExportJobOutput](API_DatasetExportJobOutput.md)객체 필수 여부: 예 ** [roleArn](#API_CreateDatasetExportJob_RequestSyntax) ** 출력 S3 버킷에 데이터를 추가할 권한이 있는 IAM 서비스 역할의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 예 ** [tags](#API_CreateDatasetExportJob_RequestSyntax) ** 데이터세트 내보내기 작업에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "datasetExportJobArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetExportJobArn](#API_CreateDatasetExportJob_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/CreateDatasetExportJob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetExportJob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetExportJob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetExportJob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetExportJob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetExportJob) # CreateDatasetGroup 빈 데이터세트 그룹을 생성합니다. 데이터세트 그룹은 Personalize 리소스를 위한 컨테이너입니다. 데이터세트 그룹은 데이터세트 유형별로 하나씩, 최대 3개의 데이터세트를 포함할 수 있습니다. + 항목 상호 작용 + Items + Users + 작업 + 작업 상호 작용 데이터세트 그룹은 도메인을 지정하고 추천자와 같은 사전 구성된 리소스를 사용하는 도메인 데이터세트 그룹이나, 캠페인과 함께 배포하는 솔루션 버전이 포함된 솔루션과 같은 사용자 지정 리소스를 사용하는 사용자 지정 데이터세트 그룹일 수 있습니다. 도메인 데이터세트 그룹으로 시작하는 경우에도 사용자 지정 사용 사례에 대한 레시피로 학습하고 캠페인과 함께 배포한 솔루션 및 솔루션 버전과 같은 사용자 지정 리소스를 추가할 수 있습니다. 데이터세트 그룹은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING 데이터세트 그룹의 상태를 가져오려면 [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html)를 호출합니다. 상태가 CREATE FAILED로 표시되는 경우 응답에는 생성이 실패한 이유를 설명하는 `failureReason`키가 포함됩니다. **참고** 데이터세트를 그룹에 추가하기 전에 데이터세트 그룹의 `status`이 `ACTIVE`가 될 때까지 기다려야 합니다. AWS Key Management Service (KMS) 키를 지정하여 그룹의 데이터 세트를 암호화할 수 있습니다. KMS 키를 지정하는 경우 키에 액세스할 권한이 있는 AWS Identity and Access Management (IAM) 역할도 포함시켜야 합니다. **요청 시 데이터세트 그룹 ARN이 필요한 API** + [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) + [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) + [솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) **관련 API** + [ListDatasetGroups](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetGroups.html) + [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) + [DeleteDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDatasetGroup.html) ## 구문 요청 ``` { "domain": "string", "kmsKeyArn": "string", "name": "string", "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [domain](#API_CreateDatasetGroup_RequestSyntax) ** 데이터세트 그룹의 도메인. 도메인 데이터세트 그룹을 생성하려면 도메인을 지정합니다. 지정하는 도메인에 따라 데이터세트의 기본 스키마와, 추천자가 사용할 수 있는 사용 사례가 결정됩니다. 도메인을 지정하지 않는 경우 캠페인과 함께 배포하는 솔루션 버전으로 사용자 지정 데이터세트 그룹을 생성합니다. 타입: 문자열 유효 값: `ECOMMERCE | VIDEO_ON_DEMAND` 필수 여부: 아니요 ** [kmsKeyArn](#API_CreateDatasetGroup_RequestSyntax) ** 데이터 세트를 암호화하는 데 사용되는 (KMS) 키의 Amazon 리소스 이름 AWS Key Management Service (ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` 필수 여부: 아니요 ** [name](#API_CreateDatasetGroup_RequestSyntax) ** 새로운 데이터세트 그룹의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [roleArn](#API_CreateDatasetGroup_RequestSyntax) ** AWS Identity and Access Management (KMS) 키에 액세스할 수 있는 권한이 있는 AWS Key Management Service (IAM) 역할의 ARN입니다. IAM 역할을 제공하는 것은 KMS 키를 함께 지정하는 경우에만 유효합니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 아니요 ** [tags](#API_CreateDatasetGroup_RequestSyntax) ** 데이터세트 그룹에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "datasetGroupArn": "string", "domain": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) ** 새 데이터세트 그룹의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ** [domain](#API_CreateDatasetGroup_ResponseSyntax) ** 새 도메인 데이터세트 그룹의 도메인. 타입: 문자열 유효 값: `ECOMMERCE | VIDEO_ON_DEMAND` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** LimitExceededException ** 초당 요청 수 한도를 초과했습니다. HTTP 상태 코드: 400 ** ResourceAlreadyExistsException ** 지정된 리소스가 이미 있습니다. HTTP 상태 코드: 400 ** TooManyTagsException ** 이 리소스에 적용할 수 있는 최대 태그 수를 초과했습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetGroup) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetGroup) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetGroup) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetGroup) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetGroup) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetGroup) # CreateDatasetImportJob 데이터 소스(S3 버킷)에서 Personalize 데이터세트로 학습 데이터를 가져오는 작업을 생성합니다. Personalize에서 학습 데이터를 가져오도록 허용하려면 Personalize가 데이터 사본을 만들어 내부적으로 처리하므로 데이터 소스에서 읽을 수 있는 권한이 있는 IAM 서비스 역할을 지정해야 합니다. S3 버킷에 대한 액세스 권한의 부여에 대한 자세한 내용은 [S3 리소스에 대한 액세스 권한 Personalize에 부여](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html) 단원을 참조하세요. 이미 추천자를 생성했거나 캠페인과 함께 사용자 지정 솔루션 버전을 배포한 경우 새 대량 레코드가 추천에 미치는 영향은 사용하는 도메인 사용 사례 또는 레시피에 따라 달라집니다. 자세한 내용은 [새 데이터가 실시간 추천에 미치는 영향](https://docs.aws.amazon.com/personalize/latest/dg/how-new-data-influences-recommendations.html) 단원을 참조하세요. **중요** 기본 설정으로 데이터세트 가져오기 작업은 대량으로 가져온 데이터세트의 기존 데이터를 대체합니다. 기존 데이터를 바꾸지 않고 새 레코드를 추가하려면 CreateDataSetImportJob 작업에서 가져오기 모드에 INCREMENTAL을 지정합니다. **상태** 데이터세트 가져오기 작업은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED 가져오기 작업의 상태를 확인하려면 데이터세트 가져오기 작업의 아마존 리소스 이름(ARN)을 제공하여 [DescribeDataSetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html)을 호출합니다. 상태가 ACTIVE로 표시되면 데이터세트 가져오기가 완료된 것이고, 상태가 CREATE FAILED로 표시되는 경우 응답에는 작업이 실패한 이유를 설명하는 `failureReason`키가 포함됩니다. **참고** 가져오기에는 시간이 필요합니다. 데이터세트를 사용하여 모델을 학습시키기 전에 상태가 ACTIVE로 나타날 때까지 기다려야 합니다. **관련 API** + [ListDatasetImportJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetImportJobs.html) + [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) ## 구문 요청 ``` { "datasetArn": "string", "dataSource": { "dataLocation": "string" }, "importMode": "string", "jobName": "string", "publishAttributionMetricsToS3": boolean, "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetArn](#API_CreateDatasetImportJob_RequestSyntax) ** 가져온 데이터를 수신하는 데이터세트의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [dataSource](#API_CreateDatasetImportJob_RequestSyntax) ** 가져올 학습 데이터가 들어 있는 S3 버킷. 유형: [DataSource](API_DataSource.md)객체 필수 여부: 예 ** [importMode](#API_CreateDatasetImportJob_RequestSyntax) ** 기존 데이터세트에 새 레코드를 추가하는 방법을 지정합니다. 기본 가져오기 모드는 `FULL`입니다. 이전에 데이터세트로 대량 레코드를 가져온 적이 없는 경우 `FULL`만 지정할 수 있습니다. + 데이터세트의 기존 대량 데이터를 모두 덮어쓰려면 `FULL`을 지정합니다. 개별적으로 가져온 데이터는 대체되지 않습니다. + 새 레코드를 데이터세트의 기존 데이터에 추가하려면 `INCREMENTAL`을 지정합니다. Personalize는 동일한 ID를 가진 모든 레코드를 새 레코드로 대체합니다. 타입: 문자열 유효 값: `FULL | INCREMENTAL` 필수 여부: 아니요 ** [jobName](#API_CreateDatasetImportJob_RequestSyntax) ** 데이터세트 가져오기 작업의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [publishAttributionMetricsToS3](#API_CreateDatasetImportJob_RequestSyntax) ** 지표 어트리뷰션을 생성한 경우 이 가져오기 작업에 대한 지표를 S3에 게시할지 여부를 지정합니다 유형: 부울 필수 항목 여부: 아니요 ** [roleArn](#API_CreateDatasetImportJob_RequestSyntax) ** S3 데이터 소스에서 읽을 권한이 있는 IAM 역할의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 아니요 ** [tags](#API_CreateDatasetImportJob_RequestSyntax) ** 데이터세트 가져오기 작업에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)의 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "datasetImportJobArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetImportJobArn](#API_CreateDatasetImportJob_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/CreateDatasetImportJob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetImportJob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetImportJob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetImportJob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetImportJob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetImportJob) # CreateEventTracker [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API를 사용하여 지정된 데이터세트 그룹에 이벤트 데이터를 추가할 때 사용하는 이벤트 트래커를 만듭니다. **참고** 이벤트 트래커 하나만 데이터세트 그룹과 연결할 수 있습니다. 기존의 이벤트 트래커와 동일한 데이터세트 그룹을 사용하여 `CreateEventTracker`를 호출하는 경우 오류가 발생합니다. 이벤트 트래커를 만들 때 응답에는 [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) 작업을 사용할 때 파라미터로 전달하는 추적 ID가 포함됩니다. 그러면 Amazon Personalize는 이벤트 트래커에서 지정한 데이터 세트 그룹의 항목 상호 작용 데이터 세트에 이벤트 데이터를 추가합니다. 이벤트 트래커는 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 이벤트 트래커의 상태를 확인하려면 [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html)를 호출합니다. **참고** 추적 ID를 사용하려면 이벤트 트래커가 ACTIVE 상태여야 합니다. **관련 API** + [ListEventTrackers](https://docs.aws.amazon.com/personalize/latest/dg/API_ListEventTrackers.html) + [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html) + [DeleteEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteEventTracker.html) ## 구문 요청 ``` { "datasetGroupArn": "string", "name": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_CreateEventTracker_RequestSyntax) ** 이벤트 데이터를 수신하는 데이터세트 그룹의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [name](#API_CreateEventTracker_RequestSyntax) ** 이벤트 트래커의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [tags](#API_CreateEventTracker_RequestSyntax) ** 이벤트 트래커에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)의 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "eventTrackerArn": "string", "trackingId": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [eventTrackerArn](#API_CreateEventTracker_ResponseSyntax) ** 이벤트 트래커의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ** [trackingId](#API_CreateEventTracker_ResponseSyntax) ** 이벤트 트래커의 ID. [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API에 대한 요청에 이 ID를 포함시킵니다. 유형: 문자열 길이 제약: 최대 길이 256. ## 오류 ** 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/CreateEventTracker) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateEventTracker) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateEventTracker) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateEventTracker) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateEventTracker) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateEventTracker) # CreateFilter 추천 필터를 생성합니다. 자세한 내용은 [추천 및 사용자 세그먼트 필터링](https://docs.aws.amazon.com/personalize/latest/dg/filter.html) 단원을 참조하세요. ## 구문 요청 ``` { "datasetGroupArn": "string", "filterExpression": "string", "name": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_CreateFilter_RequestSyntax) ** 필터가 속할 데이터세트 그룹의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [filterExpression](#API_CreateFilter_RequestSyntax) ** 필터 표현식은 추천에 포함되거나 추천에서 제외되는 항목을 정의합니다. 필터 표현식은 특정 형식 규칙을 따라야 합니다. 필터 표현식 구조 및 구문에 대한 자세한 정보는 [필터 표현식](https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html) 단원을 참조하세요. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 2500. 필수 여부: 예 ** [name](#API_CreateFilter_RequestSyntax) ** 생성할 필터의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [tags](#API_CreateFilter_RequestSyntax) ** 함수에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)의 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "filterArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [filterArn](#API_CreateFilter_ResponseSyntax) ** 새 필터의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** LimitExceededException ** 초당 요청 수 한도를 초과했습니다. HTTP 상태 코드: 400 ** ResourceAlreadyExistsException ** 지정된 리소스가 이미 있습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ** TooManyTagsException ** 이 리소스에 적용할 수 있는 최대 태그 수를 초과했습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateFilter) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateFilter) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateFilter) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateFilter) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateFilter) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateFilter) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateFilter) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateFilter) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateFilter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateFilter) # CreateMetricAttribution 지표 어트리뷰션을 생성합니다. 지표 어트리뷰션은 Personalize로 가져오는 데이터에 대한 보고서를 생성합니다. 데이터를 가져온 방법에 따라 CloudWatch 또는 S3에서 보고서를 볼 수 있습니다. 자세한 내용은 [추천의 영향 측정](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html) 단원을 참조하세요. ## 구문 요청 ``` { "datasetGroupArn": "string", "metrics": [ { "eventType": "string", "expression": "string", "metricName": "string" } ], "metricsOutputConfig": { "roleArn": "string", "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "name": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_CreateMetricAttribution_RequestSyntax) ** 지표 어트리뷰션에 대한 대상 데이터세트 그룹의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [metrics](#API_CreateMetricAttribution_RequestSyntax) ** 지표 어트리뷰션에 대한 지표 속성의 목록입니다. 각 지표 속성은 추적할 이벤트 유형과 함수를 지정합니다. 사용할 수 있는 함수는 `SUM()`또는 `SAMPLECOUNT()`입니다. SUM() 함수의 경우 데이터세트 유형(상호작용 또는 항목)과 합계할 열을 파라미터로 제공합니다. 예: SUM(Items.PRICE). 유형: [MetricAttribute](API_MetricAttribute.md)객체 어레이 어레이 멤버: 최대 항목 수 10개. 필수 여부: 예 ** [metricsOutputConfig](#API_CreateMetricAttribution_RequestSyntax) ** 지표 어트리뷰션에 대한 출력 구성 세부 정보입니다. 유형: [MetricAttributionOutput](API_MetricAttributionOutput.md)객체 필수 항목 여부: 예 ** [name](#API_CreateMetricAttribution_RequestSyntax) ** 지표 어트리뷰션의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ## 응답 구문 ``` { "metricAttributionArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [metricAttributionArn](#API_CreateMetricAttribution_ResponseSyntax) ** 새 지표 어트리뷰션의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** LimitExceededException ** 초당 요청 수 한도를 초과했습니다. HTTP 상태 코드: 400 ** ResourceAlreadyExistsException ** 지정된 리소스가 이미 있습니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateMetricAttribution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateMetricAttribution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateMetricAttribution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateMetricAttribution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateMetricAttribution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateMetricAttribution) # 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) # CreateSchema 지정된 스키마 문자열에서 Personalize 스키마를 생성합니다. 생성하는 스키마는 Avro JSON 형식이어야 합니다. Personalize는 3가지 스키마 변형을 인식합니다. 각 스키마는 데이터세트 유형과 연결되며 필수 필드 및 키워드 세트가 있습니다. 도메인 데이터세트 그룹의 데이터세트에 대한 스키마를 생성하는 경우 도메인 데이터세트 그룹의 도메인을 제공합니다. [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html)를 호출할 때 스키마를 지정합니다. 스키마에 대한 자세한 내용을 알아보려면 [데이터세트 및 스키마](https://docs.aws.amazon.com/personalize/latest/dg/how-it-works-dataset-schema.html)를 참조하세요. **관련 API** + [ListSchemas](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSchemas.html) + [DescribeSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSchema.html) + [DeleteSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSchema.html) ## 구문 요청 ``` { "domain": "string", "name": "string", "schema": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [domain](#API_CreateSchema_RequestSyntax) ** 스키마의 도메인. 도메인 데이터세트 그룹의 데이터세트에 대한 스키마를 생성하는 경우 도메인 데이터세트 그룹에서 생성할 때 선택한 도메인을 지정합니다. 타입: 문자열 유효 값: `ECOMMERCE | VIDEO_ON_DEMAND` 필수 여부: 아니요 ** [name](#API_CreateSchema_RequestSyntax) ** 스키마의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [schema](#API_CreateSchema_RequestSyntax) ** Avro JSON 형식의 스키마. 유형: 문자열 길이 제약: 최대 길이는 20,000입니다. 필수 항목 여부: 예 ## 응답 구문 ``` { "schemaArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [schemaArn](#API_CreateSchema_ResponseSyntax) ** 스키마의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** LimitExceededException ** 초당 요청 수 한도를 초과했습니다. HTTP 상태 코드: 400 ** ResourceAlreadyExistsException ** 지정된 리소스가 이미 있습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateSchema) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSchema) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSchema) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSchema) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSchema) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSchema) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSchema) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSchema) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSchema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSchema) # CreateSolution **중요** 기본적으로 모든 새 솔루션은 자동 학습을 사용합니다. 자동 학습을 사용하면 솔루션이 활성화되어 있는 동안 학습 비용이 발생합니다. 불필요한 비용을 방지하기 위해 완료되면 [솔루션을 업데이트](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html)하여 자동 학습을 끌 수 있습니다. 학습 비용에 대한 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요. 모델 학습(솔루션 버전 생성)을 위한 구성을 생성합니다. 이 구성에는 모델 훈련에 사용할 레시피와 학습 및 기능 변환 파라미터에 사용할 열과 같은 선택적 학습 구성이 포함됩니다. 솔루션 구성에 대한 자세한 내용은 [솔루션 생성 및 구성](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html)을 참조하세요. 기본적으로 새 솔루션은 자동 학습을 사용하여 7일마다 솔루션 버전을 생성합니다. 학습 빈도를 변경할 수 있습니다. 솔루션 버전 자동 생성은 솔루션이 ACTIVE 상태가 된 후 1시간 이내에 시작됩니다. 1시간 내에 솔루션 버전을 수동으로 생성하는 경우 솔루션은 첫 번째 자동 학습을 건너뜁니다. 자세한 내용은 [자동 학습 구성](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html)을 참조하세요. 자동 학습을 끄려면 `performAutoTraining`을 false로 설정합니다. 자동 학습을 끄는 경우 [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) 작업을 직접적으로 호출하여 솔루션 버전을 수동으로 생성해야 합니다. 학습이 시작된 후 [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) API 작업을 사용하여 솔루션 버전의 Amazon 리소스 이름(ARN)을 가져올 수 있습니다. 상태를 가져오려면 [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html)을 사용합니다. 학습이 완료되면 [GetSolutionMetrics](https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html)를 호출하여 모델 정확도를 평가할 수 있습니다. 솔루션 버전이 마음에 들면 [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html)울 사용하여 배포합니다. 캠페인은 [GetRecommentions](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) API를 통해 클라이언트에게 추천을 제공합니다. **참고** Personalize는 현재 솔루션 하이퍼파라미터에 대해 `hpoObjective`구성을 지원하지 않습니다. **상태** 솔루션은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 솔루션의 상태를 가져오려면 [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html)을 호출합니다. 수동 학습을 사용하는 경우 `CreateSolutionVersion`을 직접적으로 호출하기 전에 상태가 ACTIVE여야 합니다. **관련 API** + [UpdateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) + [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) + [솔루션 생성Version](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) + [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) + [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) + [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) + [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) ## 구문 요청 ``` { "datasetGroupArn": "string", "eventType": "string", "name": "string", "performAutoML": boolean, "performAutoTraining": boolean, "performHPO": boolean, "performIncrementalUpdate": boolean, "recipeArn": "string", "solutionConfig": { "algorithmHyperParameters": { "string" : "string" }, "autoMLConfig": { "metricName": "string", "recipeList": [ "string" ] }, "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] }, "eventValueThreshold": "string", "featureTransformationParameters": { "string" : "string" }, "hpoConfig": { "algorithmHyperParameterRanges": { "categoricalHyperParameterRanges": [ { "name": "string", "values": [ "string" ] } ], "continuousHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ], "integerHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ] }, "hpoObjective": { "metricName": "string", "metricRegex": "string", "type": "string" }, "hpoResourceConfig": { "maxNumberOfTrainingJobs": "string", "maxParallelTrainingJobs": "string" } }, "optimizationObjective": { "itemAttribute": "string", "objectiveSensitivity": "string" }, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_CreateSolution_RequestSyntax) ** 학습 데이터를 제공하는 데이터세트 그룹의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [eventType](#API_CreateSolution_RequestSyntax) ** 여러 이벤트 유형(`EVENT_TYPE` 스키마 필드 사용)이 있는 경우 이 파라미터는 모델 학습에 사용되는 이벤트 유형(예: ‘click’ 또는 ‘like’)입니다. `eventType`이 제공되지 않으면 Personalize는 유형에 관계없이 동일한 가중치로 모든 상호작용을 학습에 사용합니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** [name](#API_CreateSolution_RequestSyntax) ** 솔루션의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [performAutoML](#API_CreateSolution_RequestSyntax) ** 자동화된 기계 학습은 활성화하지 않는 것이 좋습니다. 대신 사용 사례를 사용 가능한 Personalize 레시피에 맞춥니다. 자세한 내용은 [레시피 선택](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html)을 참조하세요. 자동 기계 학습(AutoML) 수행 여부. 기본값은 `false`입니다. 이 경우에는 `recipeArn`를 지정해야 합니다. `true`로 설정하면 Personalize는 학습 데이터를 분석하고 최적의 USER\$1PERSONALIZATION 레시피와 하이퍼파라미터를 선택합니다. 이 경우에는 `recipeArn`을 생략해야 합니다. Personalize는 하이퍼파라미터에 대해 서로 다른 값으로 테스트를 실행하여 최적의 레시피를 결정합니다. AutoML을 사용할 경우 특정 레시피를 선택하는 것에 비해 학습 과정이 더 길어집니다. 유형: 부울 필수 항목 여부: 아니요 ** [performAutoTraining](#API_CreateSolution_RequestSyntax) ** 솔루션이 자동 학습을 사용하여 새 솔루션 버전(학습된 모델)을 생성하는지 여부입니다. 기본값은 `True` 며 솔루션은 7일마다 새 솔루션 버전을 자동으로 생성합니다. `AutoTrainingConfig`에서 `schedulingExpression`을 솔루션 구성의 일부로 지정하여 학습 빈도를 변경할 수 있습니다. 자동 학습에 대한 자세한 내용은 [자동 학습 구성](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html)을 참조하세요. 솔루션 버전 자동 생성은 솔루션이 ACTIVE 상태가 된 후 1시간 이내에 시작됩니다. 1시간 내에 솔루션 버전을 수동으로 생성하는 경우 솔루션은 첫 번째 자동 학습을 건너뜁니다. 학습이 시작된 후 [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) API 작업을 사용하여 솔루션 버전의 Amazon 리소스 이름(ARN)을 가져올 수 있습니다. 상태를 가져오려면 [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html)을 사용합니다. 유형: 부울 필수 항목 여부: 아니요 ** [performHPO](#API_CreateSolution_RequestSyntax) ** 지정 또는 선택한 레시피에서 하이퍼파라미터 최적화(HPO)를 수행할지 여부. 기본값은 `false`입니다. AutoML을 수행할 때 이 파라미터는 항상 `true`이므로 `false`로 설정하지 않아야 합니다. 유형: 부울 필수 항목 여부: 아니요 ** [performIncrementalUpdate](#API_CreateSolution_RequestSyntax) ** 모델에 대한 증분 훈련 업데이트를 수행할지 여부입니다. 활성화하면 전체 재훈련 없이 모델이 새 데이터에서 더 자주 학습할 수 있으므로 거의 실시간으로 개인화할 수 있습니다. 이 파라미터는 의미 체계 유사성 레시피를 사용하는 솔루션에서만 지원됩니다. 유형: 부울 필수 항목 여부: 아니요 ** [recipeArn](#API_CreateSolution_RequestSyntax) ** 모델 교육에 사용할 레시피의 Amazon 리소스 이름(ARN). `performAutoML`이 false인 경우 필수입니다. 다양한 Amazon Personalize 레시피 및 해당 ARN에 대한 자세한 내용은 [레시피 선택](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html)을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [solutionConfig](#API_CreateSolution_RequestSyntax) ** 솔루션의 구성 속성입니다. `performAutoML`가 true로 설정된 경우 Personalize는 솔루션 구성의 `autoMLConfig`섹션만 평가합니다. Personalize는 현재 `hpoObjective`구성을 지원하지 않습니다. 유형: [SolutionConfig](API_SolutionConfig.md)객체 필수 여부: 아니요 ** [tags](#API_CreateSolution_RequestSyntax) ** 솔루션에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)의 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "solutionArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [solutionArn](#API_CreateSolution_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/CreateSolution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolution) # CreateSolutionVersion 사용자 지정 데이터세트 그룹에서 활성 솔루션을 학습시키거나 재학습시킵니다. 솔루션은 [솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 작업을 사용하여 생성되며 `CreateSolutionVersion`를 호출하기 전에 ACTIVE 상태여야 합니다. 이 작업을 호출할 때마다 새 솔루션 버전이 생성됩니다. **상태** 솔루션 버전은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING + CREATE IN\$1PROGRESS + ACTIVE + CREATE FAILED + CREATE STOPPING + CREATE STOPPED 버전의 상태를 가져오려면 [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html)을 호출합니다. 상태가 ACTIVE로 표시될 때까지 기다렸다가 `CreateCampaign`을 호출합니다. 상태가 CREATE FAILED로 표시되는 경우 응답에는 작업이 실패한 이유를 설명하는 `failureReason`키가 포함됩니다. **관련 API** + [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) + [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) + [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) + [솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) + [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) + [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) ## 구문 요청 ``` { "name": "string", "solutionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ], "trainingMode": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [name](#API_CreateSolutionVersion_RequestSyntax) ** 솔루션 버전의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** [solutionArn](#API_CreateSolutionVersion_RequestSyntax) ** 학습 구성 정보가 포함된 솔루션의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [tags](#API_CreateSolutionVersion_RequestSyntax) ** 솔루션 버전에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)의 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ** [trainingMode](#API_CreateSolutionVersion_RequestSyntax) ** 솔루션 버전을 만들 때 수행할 학습의 범위. 기본값은 `FULL`입니다. 이렇게 하면 데이터세트 그룹 내 데이터세트의 전체 학습 데이터를 기반으로 완전히 새로운 모델이 생성됩니다. [사용자-개인 맞춤](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html)을 사용하는 경우 학습 모드를 `UPDATE`로 지정할 수 있습니다. 이렇게 하면 새 항목을 추천에 고려하도록 모델이 업데이트됩니다. 이는 전체 재학습에 해당되지 않습니다. 매주 전체 재학습을 이수해야 합니다. `UPDATE`을 지정하는 경우 Personalize는 솔루션 버전에 대한 자동 업데이트를 중지합니다. 업데이트를 재개하려면 학습 모드를 `FULL`로 설정한 상태에서 새 솔루션을 생성하여 캠페인에서 배포합니다. 자동 업데이트에 대한 자세한 내용은 [자동 업데이트](https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#maintaining-with-automatic-updates) 단원을 참조하세요. 이 `UPDATE`옵션은 `FULL`옵션을 사용하여 입력 솔루션에서 만든 활성 솔루션 버전이 이미 있고 입력 솔루션이 [사용자-개인 맞춤](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html) 레시피 또는 레거시 [HRNN-ColdStart](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-hrnn-coldstart.html) 레시피로 학습된 경우에만 사용할 수 있습니다. 타입: 문자열 유효 값: `FULL | UPDATE | AUTOTRAIN` 필수 항목 여부: 아니요 ## 응답 구문 ``` { "solutionVersionArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [solutionVersionArn](#API_CreateSolutionVersion_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/CreateSolutionVersion) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolutionVersion) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolutionVersion) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolutionVersion) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolutionVersion) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolutionVersion) # DeleteCampaign 솔루션 배포를 삭제하여 캠페인을 제거합니다. 캠페인의 기반이 되는 솔루션은 삭제되지 않으며 필요할 때 재배포할 수 있습니다. 삭제된 캠페인은 [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) 요청에서 더 이상 지정할 수 없습니다. 캠페인 생성에 대한 자세한 내용은 [캠페인 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html) 단원을 참조하세요. ## 구문 요청 ``` { "campaignArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [campaignArn](#API_DeleteCampaign_RequestSyntax) ** 삭제할 캠페인의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteCampaign) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteCampaign) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteCampaign) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteCampaign) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteCampaign) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteCampaign) # DeleteDataset 데이터세트를 삭제합니다. 관련 `DatasetImportJob`또는 `SolutionVersion`가 CREATE PENDING 또는 IN PROGRESS 상태인 경우 데이터세트를 삭제할 수 없습니다. 데이터세트 삭제에 대한 자세한 내용은 [데이터세트 삭제](https://docs.aws.amazon.com/personalize/latest/dg/delete-dataset.html)를 참조하세요. ## 구문 요청 ``` { "datasetArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetArn](#API_DeleteDataset_RequestSyntax) ** 삭제할 데이터세트의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteDataset) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteDataset) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteDataset) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteDataset) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteDataset) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteDataset) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteDataset) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteDataset) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteDataset) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteDataset) # DeleteDatasetGroup 데이터세트 그룹을 삭제합니다. 데이터세트 그룹을 삭제하려면 다음을 삭제해야 합니다. + 모든 연결된 이벤트 트래커. + 모든 연결된 솔루션. + 데이터세트 그룹 내 모든 데이터세트. ## 구문 요청 ``` { "datasetGroupArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_DeleteDatasetGroup_RequestSyntax) ** 삭제할 데이터세트 그룹의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteDatasetGroup) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteDatasetGroup) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteDatasetGroup) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteDatasetGroup) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteDatasetGroup) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteDatasetGroup) # DeleteEventTracker 이벤트 트래커를 삭제합니다. 데이터 세트 그룹에서 데이터 세트를 삭제하지 않습니다. 이벤트 트래커에 대한 자세한 내용은 [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) 단원을 참조하세요. ## 구문 요청 ``` { "eventTrackerArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [eventTrackerArn](#API_DeleteEventTracker_RequestSyntax) ** 삭제할 이벤트 트래커의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteEventTracker) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteEventTracker) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteEventTracker) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteEventTracker) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteEventTracker) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteEventTracker) # DeleteFilter 필터를 삭제합니다. ## 구문 요청 ``` { "filterArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [filterArn](#API_DeleteFilter_RequestSyntax) ** 삭제할 필터의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteFilter) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteFilter) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteFilter) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteFilter) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteFilter) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteFilter) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteFilter) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteFilter) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteFilter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteFilter) # DeleteMetricAttribution 지표 어트리뷰션을 삭제합니다. ## 구문 요청 ``` { "metricAttributionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [metricAttributionArn](#API_DeleteMetricAttribution_RequestSyntax) ** 지표 어트리뷰션의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteMetricAttribution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteMetricAttribution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteMetricAttribution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteMetricAttribution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteMetricAttribution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteMetricAttribution) # DeleteRecommender 추천자를 비활성화하고 제거합니다. 삭제된 추천자는 더 이상 [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) 요청에서 지정할 수 없습니다. ## 구문 요청 ``` { "recommenderArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [recommenderArn](#API_DeleteRecommender_RequestSyntax) ** 삭제할 추천자의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteRecommender) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteRecommender) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteRecommender) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteRecommender) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteRecommender) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteRecommender) # DeleteSchema 스키마를 삭제합니다. 스키마를 삭제하기 전에 해당 스키마를 참조하는 모든 데이터세트를 삭제해야 합니다. 스키마에 대한 자세한 내용은 [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html) 단원을 참조하세요. ## 구문 요청 ``` { "schemaArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [schemaArn](#API_DeleteSchema_RequestSyntax) ** 삭제할 스키마의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteSchema) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteSchema) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteSchema) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteSchema) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteSchema) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteSchema) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteSchema) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteSchema) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteSchema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteSchema) # DeleteSolution 솔루션의 모든 버전과 `Solution`객체 자체를 삭제합니다. 솔루션을 삭제하기 전에 해당 솔루션에 기반한 모든 캠페인을 삭제해야 합니다. 솔루션을 사용하는 캠페인을 확인하려면 [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html)를 호출하고 솔루션의 리소스 이름(ARN)을 제공합니다. 관련 `SolutionVersion`이 CREATE PENDING 또는 IN PROGRESS 상태인 경우 솔루션을 삭제할 수 없습니다. 솔루션에 대한 자세한 내용은 [솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 단원을 참조하세요. ## 구문 요청 ``` { "solutionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [solutionArn](#API_DeleteSolution_RequestSyntax) ** 삭제할 솔루션의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteSolution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteSolution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteSolution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteSolution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteSolution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteSolution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteSolution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteSolution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteSolution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteSolution) # DescribeAlgorithm 주어진 알고리즘을 설명합니다. ## 구문 요청 ``` { "algorithmArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [algorithmArn](#API_DescribeAlgorithm_RequestSyntax) ** 설명할 알고리즘의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "algorithm": { "algorithmArn": "string", "algorithmImage": { "dockerURI": "string", "name": "string" }, "creationDateTime": number, "defaultHyperParameterRanges": { "categoricalHyperParameterRanges": [ { "isTunable": boolean, "name": "string", "values": [ "string" ] } ], "continuousHyperParameterRanges": [ { "isTunable": boolean, "maxValue": number, "minValue": number, "name": "string" } ], "integerHyperParameterRanges": [ { "isTunable": boolean, "maxValue": number, "minValue": number, "name": "string" } ] }, "defaultHyperParameters": { "string" : "string" }, "defaultResourceConfig": { "string" : "string" }, "lastUpdatedDateTime": number, "name": "string", "roleArn": "string", "trainingInputMode": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [algorithm](#API_DescribeAlgorithm_ResponseSyntax) ** 알고리즘의 속성 목록입니다. 유형: [Algorithm](API_Algorithm.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeAlgorithm) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeAlgorithm) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeAlgorithm) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeAlgorithm) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeAlgorithm) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeAlgorithm) # DescribeBatchInferenceJob 이름, 리소스 이름(ARN), 상태, 입력 및 출력 구성, 추천 생성에 사용된 솔루션 버전의 ARN 등 배치 추론 작업의 속성을 가져옵니다. ## 구문 요청 ``` { "batchInferenceJobArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [batchInferenceJobArn](#API_DescribeBatchInferenceJob_RequestSyntax) ** 설명할 배치 추론 작업의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "batchInferenceJob": { "batchInferenceJobArn": "string", "batchInferenceJobConfig": { "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number } }, "batchInferenceJobMode": "string", "creationDateTime": number, "failureReason": "string", "filterArn": "string", "jobInput": { "s3DataSource": { "kmsKeyArn": "string", "path": "string" } }, "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "lastUpdatedDateTime": number, "numResults": number, "roleArn": "string", "solutionVersionArn": "string", "status": "string", "themeGenerationConfig": { "fieldsForThemeGeneration": { "itemName": "string" } } } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [batchInferenceJob](#API_DescribeBatchInferenceJob_ResponseSyntax) ** 지정된 배치 추론 작업에 대한 정보입니다. 유형: [BatchInferenceJob](API_BatchInferenceJob.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeBatchInferenceJob) # DescribeBatchSegmentJob 이름, 리소스 이름(ARN), 상태, 입력 및 출력 구성, 세그먼트를 생성하는 데 사용된 솔루션 버전의 ARN 등 배치 세그먼트 작업의 속성을 가져옵니다. ## 구문 요청 ``` { "batchSegmentJobArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [batchSegmentJobArn](#API_DescribeBatchSegmentJob_RequestSyntax) ** 설명할 배치 세그먼트 작업의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "batchSegmentJob": { "batchSegmentJobArn": "string", "creationDateTime": number, "failureReason": "string", "filterArn": "string", "jobInput": { "s3DataSource": { "kmsKeyArn": "string", "path": "string" } }, "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "lastUpdatedDateTime": number, "numResults": number, "roleArn": "string", "solutionVersionArn": "string", "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [batchSegmentJob](#API_DescribeBatchSegmentJob_ResponseSyntax) ** 지정된 배치 세그먼트 작업에 대한 정보입니다. 유형: [BatchSegmentJob](API_BatchSegmentJob.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeBatchSegmentJob) # DescribeCampaign 상태를 포함하여 해당 캠페인을 설명합니다. 캠페인은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS `status`가 `CREATE FAILED`인 경우 응답에는 이유를 설명하는 `failureReason`키가 포함됩니다. 캠페인에 대한 자세한 내용은 [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html) 단원을 참조하세요. ## 구문 요청 ``` { "campaignArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [campaignArn](#API_DescribeCampaign_RequestSyntax) ** 캠페인의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "campaign": { "campaignArn": "string", "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "latestCampaignUpdate": { "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "minProvisionedTPS": number, "solutionVersionArn": "string", "status": "string" }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [campaign](#API_DescribeCampaign_ResponseSyntax) ** `latestCampaignUpdate` 필드는 캠페인에 하나 이상의 `UpdateCampaign` 직접 호출이 있는 경우에만 반환됩니다. 캠페인의 속성. `latestCampaignUpdate` 필드는 캠페인에 하나 이상의 `UpdateCampaign` 직접 호출이 있는 경우에만 반환됩니다. 타입: [Campaign](API_Campaign.md) 객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeCampaign) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeCampaign) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeCampaign) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeCampaign) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeCampaign) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeCampaign) # DescribeDataDeletionJob 작업 상태를 포함하여 [CreateDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataDeletionJob.html)을 통해 생성되는 데이터 삭제 작업에 대해 설명합니다. ## 구문 요청 ``` { "dataDeletionJobArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [dataDeletionJobArn](#API_DescribeDataDeletionJob_RequestSyntax) ** 데이터 삭제 작업의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "dataDeletionJob": { "creationDateTime": number, "dataDeletionJobArn": "string", "datasetGroupArn": "string", "dataSource": { "dataLocation": "string" }, "failureReason": "string", "jobName": "string", "lastUpdatedDateTime": number, "numDeleted": number, "roleArn": "string", "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [dataDeletionJob](#API_DescribeDataDeletionJob_ResponseSyntax) ** 상태를 포함한 데이터 삭제 작업에 대한 정보입니다. 상태는 다음 값 중 하나일 수 있습니다. + PENDING + IN\$1PROGRESS + COMPLETED + FAILED 타입: [DataDeletionJob](API_DataDeletionJob.md) 객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDataDeletionJob) # DescribeDataset 지정된 데이터세트를 설명합니다. 데이터세트에 대한 자세한 내용은 [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) 단원을 참조하세요. ## 구문 요청 ``` { "datasetArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetArn](#API_DescribeDataset_RequestSyntax) ** 설명할 데이터세트의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "dataset": { "creationDateTime": number, "datasetArn": "string", "datasetGroupArn": "string", "datasetType": "string", "lastUpdatedDateTime": number, "latestDatasetUpdate": { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "schemaArn": "string", "status": "string" }, "name": "string", "schemaArn": "string", "status": "string", "trackingId": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [dataset](#API_DescribeDataset_ResponseSyntax) ** 데이터세트 속성 목록입니다. 유형: [Dataset](API_Dataset.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDataset) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDataset) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDataset) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDataset) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDataset) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDataset) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDataset) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDataset) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDataset) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDataset) # DescribeDatasetExportJob 내보내기 작업 상태를 포함하여 [CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html)으로 만든 데이터세트 내보내기 작업에 대해 설명합니다. ## 구문 요청 ``` { "datasetExportJobArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetExportJobArn](#API_DescribeDatasetExportJob_RequestSyntax) ** 설명할 데이터세트 내보내기 작업의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "datasetExportJob": { "creationDateTime": number, "datasetArn": "string", "datasetExportJobArn": "string", "failureReason": "string", "ingestionMode": "string", "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "lastUpdatedDateTime": number, "roleArn": "string", "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetExportJob](#API_DescribeDatasetExportJob_ResponseSyntax) ** 상태를 포함한 데이터세트 내보내기 작업에 대한 정보입니다. 상태는 다음 값 중 하나일 수 있습니다. + CREATE PENDING + CREATE IN\$1PROGRESS + ACTIVE + CREATE FAILED 유형: [DatasetExportJob](API_DatasetExportJob.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetExportJob) # DescribeDatasetGroup 지정된 데이터세트 그룹을 설명합니다. 데이터세트 그룹에 대한 자세한 내용은 [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html) 단원을 참조하세요. ## 구문 요청 ``` { "datasetGroupArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_DescribeDatasetGroup_RequestSyntax) ** 설명할 데이터세트 그룹의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "datasetGroup": { "creationDateTime": number, "datasetGroupArn": "string", "domain": "string", "failureReason": "string", "kmsKeyArn": "string", "lastUpdatedDateTime": number, "name": "string", "roleArn": "string", "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetGroup](#API_DescribeDatasetGroup_ResponseSyntax) ** 데이터세트 그룹 속성의 목록입니다. 유형: [DatasetGroup](API_DatasetGroup.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDatasetGroup) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetGroup) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetGroup) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetGroup) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetGroup) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetGroup) # DescribeDatasetImportJob 가져오기 작업 상태를 포함하여 [CreateDataSetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)을 통해 생성되는 데이터세트 가져오기 작업에 대해 설명합니다. ## 구문 요청 ``` { "datasetImportJobArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetImportJobArn](#API_DescribeDatasetImportJob_RequestSyntax) ** 설명할 데이터세트 가져오기 작업의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "datasetImportJob": { "creationDateTime": number, "datasetArn": "string", "datasetImportJobArn": "string", "dataSource": { "dataLocation": "string" }, "failureReason": "string", "importMode": "string", "jobName": "string", "lastUpdatedDateTime": number, "publishAttributionMetricsToS3": boolean, "roleArn": "string", "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetImportJob](#API_DescribeDatasetImportJob_ResponseSyntax) ** 상태를 포함한 데이터세트 가져오기 작업에 대한 정보입니다. 상태는 다음 값 중 하나일 수 있습니다. + CREATE PENDING + CREATE IN\$1PROGRESS + ACTIVE + CREATE FAILED 유형: [DatasetImportJob](API_DatasetImportJob.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetImportJob) # DescribeEventTracker 이벤트 트래커를 설명합니다. 응답에는 이벤트 트래커의 `trackingId`및 `status`가 포함됩니다. 이벤트 트래커에 대한 자세한 내용은 [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) 단원을 참조하세요. ## 구문 요청 ``` { "eventTrackerArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [eventTrackerArn](#API_DescribeEventTracker_RequestSyntax) ** 설명할 이벤트 트래커의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "eventTracker": { "accountId": "string", "creationDateTime": number, "datasetGroupArn": "string", "eventTrackerArn": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string", "trackingId": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [eventTracker](#API_DescribeEventTracker_ResponseSyntax) ** 이벤트 트래커를 설명하는 객체입니다. 유형: [EventTracker](API_EventTracker.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeEventTracker) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeEventTracker) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeEventTracker) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeEventTracker) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeEventTracker) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeEventTracker) # DescribeFeatureTransformation 주어진 특성 변환에 대해 설명합니다. ## 구문 요청 ``` { "featureTransformationArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [featureTransformationArn](#API_DescribeFeatureTransformation_RequestSyntax) ** 설명할 특성 변환의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "featureTransformation": { "creationDateTime": number, "defaultParameters": { "string" : "string" }, "featureTransformationArn": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [featureTransformation](#API_DescribeFeatureTransformation_ResponseSyntax) ** 특성 변환 속성의 목록입니다. 유형: [FeatureTransformation](API_FeatureTransformation.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeFeatureTransformation) # DescribeFilter 필터의 속성을 설명합니다. ## 구문 요청 ``` { "filterArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [filterArn](#API_DescribeFilter_RequestSyntax) ** 설명할 필터의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "filter": { "creationDateTime": number, "datasetGroupArn": "string", "failureReason": "string", "filterArn": "string", "filterExpression": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [filter](#API_DescribeFilter_ResponseSyntax) ** 필터 세부 정보입니다. 유형: [Filter](API_Filter.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeFilter) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeFilter) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeFilter) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeFilter) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeFilter) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeFilter) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeFilter) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeFilter) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeFilter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeFilter) # DescribeMetricAttribution 지표 어트리뷰션을 설명합니다. ## 구문 요청 ``` { "metricAttributionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [metricAttributionArn](#API_DescribeMetricAttribution_RequestSyntax) ** 지표 어트리뷰션의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "metricAttribution": { "creationDateTime": number, "datasetGroupArn": "string", "failureReason": "string", "lastUpdatedDateTime": number, "metricAttributionArn": "string", "metricsOutputConfig": { "roleArn": "string", "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "name": "string", "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [metricAttribution](#API_DescribeMetricAttribution_ResponseSyntax) ** 지표 어트리뷰션의 세부 정보입니다. 유형: [MetricAttribution](API_MetricAttribution.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeMetricAttribution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeMetricAttribution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeMetricAttribution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeMetricAttribution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeMetricAttribution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeMetricAttribution) # DescribeRecipe 레시피를 설명합니다. 레시피에는 다음 세 가지 항목이 포함되어 있습니다. + 모델을 학습시키는 알고리즘. + 학습을 제어하는 하이퍼파라미터. + 학습 전에 입력 데이터를 수정하기 위한 특성 변환 정보입니다. Personalize는 미리 정의된 레시피 세트를 제공합니다. [솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) API를 사용하여 솔루션을 생성할 때 레시피를 지정합니다. `CreateSolution`는 지정된 레시피의 알고리즘과 학습 데이터세트를 사용하여 모델을 학습시킵니다. 솔루션은 캠페인으로 배포될 경우 [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) API를 사용하여 추천을 제공할 수 있습니다. ## 구문 요청 ``` { "recipeArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [recipeArn](#API_DescribeRecipe_RequestSyntax) ** 설명할 레시피의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "recipe": { "algorithmArn": "string", "creationDateTime": number, "description": "string", "featureTransformationArn": "string", "lastUpdatedDateTime": number, "name": "string", "recipeArn": "string", "recipeType": "string", "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [recipe](#API_DescribeRecipe_ResponseSyntax) ** 레시피를 설명하는 객체입니다. 유형: [Recipe](API_Recipe.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeRecipe) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeRecipe) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeRecipe) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeRecipe) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeRecipe) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeRecipe) # DescribeRecommender 해당 추천자의 상태를 포함하여 해당 추천자에 대해 설명합니다. 추천자는 다음 상태 중 하나일 수 있습니다. + 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 `status`가 `CREATE FAILED`인 경우 응답에는 이유를 설명하는 `failureReason`키가 포함됩니다. 추천자가 생성되거나 삭제 중일 때 `modelMetrics`키는 null입니다. 추천자에 대한 자세한 내용은 [CreateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateRecommender.html) 단원을 참조하세요. ## 구문 요청 ``` { "recommenderArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [recommenderArn](#API_DescribeRecommender_RequestSyntax) ** 설명할 추천자의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "recommender": { "creationDateTime": number, "datasetGroupArn": "string", "failureReason": "string", "lastUpdatedDateTime": number, "latestRecommenderUpdate": { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "status": "string" }, "modelMetrics": { "string" : number }, "name": "string", "recipeArn": "string", "recommenderArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [recommender](#API_DescribeRecommender_ResponseSyntax) ** 추천자의 속성. 유형: [Recommender](API_Recommender.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeRecommender) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeRecommender) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeRecommender) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeRecommender) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeRecommender) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeRecommender) # DescribeSchema 스키마를 설명합니다. 스키마에 대한 자세한 내용은 [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html) 단원을 참조하세요. ## 구문 요청 ``` { "schemaArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [schemaArn](#API_DescribeSchema_RequestSyntax) ** 검색할 스키마의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "schema": { "creationDateTime": number, "domain": "string", "lastUpdatedDateTime": number, "name": "string", "schema": "string", "schemaArn": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [schema](#API_DescribeSchema_ResponseSyntax) ** 요청 받은 스키마. 유형: [DatasetSchema](API_DatasetSchema.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeSchema) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSchema) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSchema) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSchema) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSchema) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSchema) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSchema) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSchema) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSchema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSchema) # DescribeSolution 솔루션을 설명합니다. 솔루션에 대한 자세한 내용은 [솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 단원을 참조하세요. ## 구문 요청 ``` { "solutionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [solutionArn](#API_DescribeSolution_RequestSyntax) ** 설명할 솔루션의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "solution": { "autoMLResult": { "bestRecipeArn": "string" }, "creationDateTime": number, "datasetGroupArn": "string", "eventType": "string", "lastUpdatedDateTime": number, "latestSolutionUpdate": { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "performAutoTraining": boolean, "performIncrementalUpdate": boolean, "solutionUpdateConfig": { "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] } }, "status": "string" }, "latestSolutionVersion": { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "solutionVersionArn": "string", "status": "string", "trainingMode": "string", "trainingType": "string" }, "name": "string", "performAutoML": boolean, "performAutoTraining": boolean, "performHPO": boolean, "performIncrementalUpdate": boolean, "recipeArn": "string", "solutionArn": "string", "solutionConfig": { "algorithmHyperParameters": { "string" : "string" }, "autoMLConfig": { "metricName": "string", "recipeList": [ "string" ] }, "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] }, "eventValueThreshold": "string", "featureTransformationParameters": { "string" : "string" }, "hpoConfig": { "algorithmHyperParameterRanges": { "categoricalHyperParameterRanges": [ { "name": "string", "values": [ "string" ] } ], "continuousHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ], "integerHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ] }, "hpoObjective": { "metricName": "string", "metricRegex": "string", "type": "string" }, "hpoResourceConfig": { "maxNumberOfTrainingJobs": "string", "maxParallelTrainingJobs": "string" } }, "optimizationObjective": { "itemAttribute": "string", "objectiveSensitivity": "string" }, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "status": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [solution](#API_DescribeSolution_ResponseSyntax) ** 솔루션을 설명하는 객체입니다. 유형: [Solution](API_Solution.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeSolution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSolution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSolution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSolution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSolution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSolution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSolution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSolution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSolution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSolution) # DescribeSolutionVersion 솔루션의 특정 버전을 설명합니다. 솔루션에 대한 자세한 내용은 [솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 단원을 참조하세요 ## 구문 요청 ``` { "solutionVersionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [solutionVersionArn](#API_DescribeSolutionVersion_RequestSyntax) ** 솔루션 버전의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "solutionVersion": { "creationDateTime": number, "datasetGroupArn": "string", "eventType": "string", "failureReason": "string", "lastUpdatedDateTime": number, "name": "string", "performAutoML": boolean, "performHPO": boolean, "performIncrementalUpdate": boolean, "recipeArn": "string", "solutionArn": "string", "solutionConfig": { "algorithmHyperParameters": { "string" : "string" }, "autoMLConfig": { "metricName": "string", "recipeList": [ "string" ] }, "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] }, "eventValueThreshold": "string", "featureTransformationParameters": { "string" : "string" }, "hpoConfig": { "algorithmHyperParameterRanges": { "categoricalHyperParameterRanges": [ { "name": "string", "values": [ "string" ] } ], "continuousHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ], "integerHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ] }, "hpoObjective": { "metricName": "string", "metricRegex": "string", "type": "string" }, "hpoResourceConfig": { "maxNumberOfTrainingJobs": "string", "maxParallelTrainingJobs": "string" } }, "optimizationObjective": { "itemAttribute": "string", "objectiveSensitivity": "string" }, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "solutionVersionArn": "string", "status": "string", "trainingHours": number, "trainingMode": "string", "trainingType": "string", "tunedHPOParams": { "algorithmHyperParameters": { "string" : "string" } } } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [solutionVersion](#API_DescribeSolutionVersion_ResponseSyntax) ** 솔루션 버전. 유형: [SolutionVersion](API_SolutionVersion.md)객체 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeSolutionVersion) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSolutionVersion) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSolutionVersion) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSolutionVersion) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSolutionVersion) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSolutionVersion) # GetSolutionMetrics 지정된 솔루션 버전의 지표를 가져옵니다. ## 구문 요청 ``` { "solutionVersionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [solutionVersionArn](#API_GetSolutionMetrics_RequestSyntax) ** 지표를 가져올 솔루션 버전의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "metrics": { "string" : number }, "solutionVersionArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [metrics](#API_GetSolutionMetrics_ResponseSyntax) ** 솔루션 버전에 대한 지표. 자세한 내용은 [지표를 솔루션 버전 평가](https://docs.aws.amazon.com/personalize/latest/dg/working-with-training-metrics.html) 단원을 참조하세요. 유형: 문자열-double 맵 맵 항목: 최대 항목 수 100개. 키 길이 제약: 최대 길이 256. ** [solutionVersionArn](#API_GetSolutionMetrics_ResponseSyntax) ** 요청에서 지정한 것과 동일한 솔루션 버전 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/GetSolutionMetrics) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/GetSolutionMetrics) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/GetSolutionMetrics) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/GetSolutionMetrics) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/GetSolutionMetrics) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/GetSolutionMetrics) # ListBatchInferenceJobs 솔루션 버전에서 수행된 배치 추론 작업의 목록을 가져옵니다. ## 구문 요청 ``` { "maxResults": number, "nextToken": "string", "solutionVersionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [maxResults](#API_ListBatchInferenceJobs_RequestSyntax) ** 각 페이지에 반환되는 배치 추론 작업 결과의 최대 수. 기본 값은 100입니다. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListBatchInferenceJobs_RequestSyntax) ** 결과의 다음 번 페이지를 요청하기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ** [solutionVersionArn](#API_ListBatchInferenceJobs_RequestSyntax) ** 배치 추론 작업이 생성된 솔루션 버전의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ## 응답 구문 ``` { "batchInferenceJobs": [ { "batchInferenceJobArn": "string", "batchInferenceJobMode": "string", "creationDateTime": number, "failureReason": "string", "jobName": "string", "lastUpdatedDateTime": number, "solutionVersionArn": "string", "status": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [batchInferenceJobs](#API_ListBatchInferenceJobs_ResponseSyntax) ** 반환되는 각 작업에 대한 정보가 들어 있는 목록입니다. 유형: [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ** [nextToken](#API_ListBatchInferenceJobs_ResponseSyntax) ** 결과의 다음 번 페이지를 가져오기 위한 토큰. 값은 반환할 결과가 더 이상 없는 경우 `null`입니다. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListBatchInferenceJobs) # ListBatchSegmentJobs 지정한 솔루션 버전에서 수행된 배치 세그먼트 작업의 목록을 가져옵니다. ## 구문 요청 ``` { "maxResults": number, "nextToken": "string", "solutionVersionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [maxResults](#API_ListBatchSegmentJobs_RequestSyntax) ** 각 페이지에 반환되는 배치 세그먼트 작업 결과의 최대 수. 기본 값은 100입니다. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListBatchSegmentJobs_RequestSyntax) ** 결과의 다음 번 페이지를 요청하기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ** [solutionVersionArn](#API_ListBatchSegmentJobs_RequestSyntax) ** 배치 세그먼트 작업이 배치 세그먼트를 생성하는 데 사용한 솔루션 버전의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ## 응답 구문 ``` { "batchSegmentJobs": [ { "batchSegmentJobArn": "string", "creationDateTime": number, "failureReason": "string", "jobName": "string", "lastUpdatedDateTime": number, "solutionVersionArn": "string", "status": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [batchSegmentJobs](#API_ListBatchSegmentJobs_ResponseSyntax) ** 반환되는 각 작업에 대한 정보가 들어 있는 목록입니다. 유형: [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ** [nextToken](#API_ListBatchSegmentJobs_ResponseSyntax) ** 결과의 다음 번 페이지를 가져오기 위한 토큰. 값은 반환할 결과가 더 이상 없는 경우 `null`입니다. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListBatchSegmentJobs) # ListCampaigns 지정된 솔루션을 사용하는 캠페인의 목록을 반환합니다. 솔루션이 지정되지 않은 경우 해당 계정과 관련된 모든 캠페인이 나열됩니다. 응답은 리소스 이름(ARN)을 비롯하여 각 캠페인의 속성을 제공합니다. 캠페인에 대한 자세한 내용은 [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html) 단원을 참조하세요. ## 구문 요청 ``` { "maxResults": number, "nextToken": "string", "solutionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [maxResults](#API_ListCampaigns_RequestSyntax) ** 반환할 캠페인의 최대 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListCampaigns_RequestSyntax) ** 다음 번 캠페인 세트(있는 경우)를 가져오기 위해 이전에 [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html)를 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ** [solutionArn](#API_ListCampaigns_RequestSyntax) ** 캠페인을 나열할 솔루션의 리소스 이름(ARN)입니다. 솔루션이 지정되지 않은 경우 해당 계정과 관련된 모든 캠페인이 나열됩니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ## 응답 구문 ``` { "campaigns": [ { "campaignArn": "string", "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [campaigns](#API_ListCampaigns_ResponseSyntax) ** 캠페인의 목록입니다. 유형: [CampaignSummary](API_CampaignSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ** [nextToken](#API_ListCampaigns_ResponseSyntax) ** 다음 번 캠페인 세트를 가져오기 위한 토큰(있는 경우). 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListCampaigns) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListCampaigns) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListCampaigns) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListCampaigns) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListCampaigns) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListCampaigns) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListCampaigns) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListCampaigns) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListCampaigns) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListCampaigns) # ListDataDeletionJobs 생성 시간을 기준으로 정렬된 데이터세트 그룹의 데이터 삭제 작업 목록을 반환하고 가장 최근 항목을 먼저 반환합니다. 데이터세트 그룹을 지정하지 않으면 해당 계정과 관련된 모든 데이터 삭제 작업이 나열됩니다. 응답은 Amazon 리소스 이름(ARN)을 비롯하여 각 작업의 속성을 제공합니다. 데이터 삭제 작업에 대한 자세한 내용은 [사용자 삭제](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html)를 참조하세요. ## 구문 요청 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_ListDataDeletionJobs_RequestSyntax) ** 데이터 삭제 작업을 나열할 데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [maxResults](#API_ListDataDeletionJobs_RequestSyntax) ** 반환할 데이터 삭제 작업의 최대 수입니다. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListDataDeletionJobs_RequestSyntax) ** 다음 작업 세트(있는 경우)를 가져오기 위해 이전에 `ListDataDeletionJobs`를 직접적으로 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "dataDeletionJobs": [ { "creationDateTime": number, "dataDeletionJobArn": "string", "datasetGroupArn": "string", "failureReason": "string", "jobName": "string", "lastUpdatedDateTime": number, "status": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [dataDeletionJobs](#API_ListDataDeletionJobs_ResponseSyntax) ** 데이터 삭제 작업 목록입니다. 유형: [DataDeletionJobSummary](API_DataDeletionJobSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ** [nextToken](#API_ListDataDeletionJobs_ResponseSyntax) ** 다음 번 데이터 삭제 작업 세트(있는 경우)를 가져오기 위한 토큰입니다. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDataDeletionJobs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDataDeletionJobs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDataDeletionJobs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDataDeletionJobs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDataDeletionJobs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDataDeletionJobs) # ListDatasetExportJobs 지정된 데이터세트를 사용하는 데이터세트 내보내기 작업의 목록을 반환합니다. 데이터세트를 지정하지 않으면 해당 계정과 관련된 모든 데이터세트 내보내기 작업이 나열됩니다. 응답은 리소스 이름(ARN)을 비롯하여 각 데이터세트 내보내기 작업의 속성을 제공합니다. 데이터세트 내보내기 작업에 대한 자세한 내용은 [CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html) 단원을 참조하세요. 데이터세트에 대한 자세한 내용은 [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) 단원을 참조하세요. ## 구문 요청 ``` { "datasetArn": "string", "maxResults": number, "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetArn](#API_ListDatasetExportJobs_RequestSyntax) ** 데이터세트 내보내기 작업을 나열할 데이터세트의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [maxResults](#API_ListDatasetExportJobs_RequestSyntax) ** 반환할 데이터세트 내보내기 작업의 최대 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListDatasetExportJobs_RequestSyntax) ** 다음 번 데이터세트 내보내기 작업 세트(있는 경우)를 가져오기 위해 이전에 `ListDatasetExportJobs`을 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "datasetExportJobs": [ { "creationDateTime": number, "datasetExportJobArn": "string", "failureReason": "string", "jobName": "string", "lastUpdatedDateTime": number, "status": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetExportJobs](#API_ListDatasetExportJobs_ResponseSyntax) ** 데이터세트 내보내기 작업의 목록입니다. 유형: [DatasetExportJobSummary](API_DatasetExportJobSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ** [nextToken](#API_ListDatasetExportJobs_ResponseSyntax) ** 다음 번 데이터세트 내보내기 작업 세트(있는 경우)를 가져오기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasetExportJobs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetExportJobs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetExportJobs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetExportJobs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetExportJobs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetExportJobs) # ListDatasetGroups 데이터세트 그룹의 목록을 반환합니다. 응답은 리소스 이름(ARN)을 비롯하여 각 데이터세트 그룹의 속성을 제공합니다. 데이터세트 그룹에 대한 자세한 내용은 [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html) 단원을 참조하세요. ## 구문 요청 ``` { "maxResults": number, "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [maxResults](#API_ListDatasetGroups_RequestSyntax) ** 반환할 최대 데이터세트 그룹 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListDatasetGroups_RequestSyntax) ** 다음 번 데이터세트 그룹 세트(있는 경우)를 가져오기 위해 이전에 `ListDatasetGroups`을 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "datasetGroups": [ { "creationDateTime": number, "datasetGroupArn": "string", "domain": "string", "failureReason": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetGroups](#API_ListDatasetGroups_ResponseSyntax) ** 데이터세트 그룹의 목록입니다. 유형: [DatasetGroupSummary](API_DatasetGroupSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ** [nextToken](#API_ListDatasetGroups_ResponseSyntax) ** 다음 번 데이터세트 그룹 세트(있는 경우)를 가져오기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasetGroups) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetGroups) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetGroups) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetGroups) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetGroups) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetGroups) # ListDatasetImportJobs 지정된 데이터세트를 사용하는 데이터세트 가져오기 작업의 목록을 반환합니다. 데이터세트를 지정하지 않으면 해당 계정과 관련된 모든 데이터세트 가져오기 작업이 나열됩니다. 응답은 리소스 이름(ARN)을 비롯하여 각 데이터세트 가져오기 작업의 속성을 제공합니다. 데이터세트 가져오기 작업에 대한 자세한 내용은 [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html) 단원을 참조하세요. 데이터세트에 대한 자세한 내용은 [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) 단원을 참조하세요. ## 구문 요청 ``` { "datasetArn": "string", "maxResults": number, "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetArn](#API_ListDatasetImportJobs_RequestSyntax) ** 데이터세트 가져오기 작업을 나열할 데이터세트의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [maxResults](#API_ListDatasetImportJobs_RequestSyntax) ** 반환할 데이터세트 가져오기 작업의 최대 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListDatasetImportJobs_RequestSyntax) ** 다음 번 데이터세트 가져오기 작업 세트(있는 경우)를 가져오기 위해 이전에 `ListDatasetImportJobs`을 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "datasetImportJobs": [ { "creationDateTime": number, "datasetImportJobArn": "string", "failureReason": "string", "importMode": "string", "jobName": "string", "lastUpdatedDateTime": number, "status": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetImportJobs](#API_ListDatasetImportJobs_ResponseSyntax) ** 데이터세트 가져오기 작업의 목록입니다. 유형: [DatasetImportJobSummary](API_DatasetImportJobSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ** [nextToken](#API_ListDatasetImportJobs_ResponseSyntax) ** 다음 번 데이터세트 가져오기 작업 세트(있는 경우)를 가져오기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasetImportJobs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetImportJobs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetImportJobs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetImportJobs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetImportJobs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetImportJobs) # ListDatasets 지정된 데이터 세트 그룹에 포함된 데이터 세트의 목록을 반환합니다. 응답은 Amazon 리소스 이름(ARN)을 비롯하여 각 데이터 세트의 속성을 제공합니다. 데이터 세트에 대한 자세한 내용은 [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) 단원을 참조하세요. ## 구문 요청 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_ListDatasets_RequestSyntax) ** 나열할 데이터 세트가 포함된 데이터 세트 그룹의 Amazon 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [maxResults](#API_ListDatasets_RequestSyntax) ** 반환할 최대 데이터 세트 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListDatasets_RequestSyntax) ** 다음 번 데이터세트 가져오기 작업 세트(있는 경우)를 가져오기 위해 이전에 `ListDatasets`을 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "datasets": [ { "creationDateTime": number, "datasetArn": "string", "datasetType": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasets](#API_ListDatasets_ResponseSyntax) ** `Dataset` 객체 어레이. 각 객체는 메타데이터 정보를 제공합니다. 유형: [DatasetSummary](API_DatasetSummary.md) 객체 어레이 어레이 멤버: 최대 항목 수 100개. ** [nextToken](#API_ListDatasets_ResponseSyntax) ** 다음 번 데이터 세트 집합(있는 경우)을 가져오기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasets) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasets) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasets) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasets) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasets) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasets) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasets) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasets) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasets) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasets) # ListEventTrackers 해당 계정과 관련된 이벤트 트래커의 목록을 반환합니다. 응답은 리소스 이름(ARN) 과 추적 ID를 비롯하여 각 이벤트 트래커의 속성을 제공합니다. 이벤트 트래커에 대한 자세한 내용은 [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) 단원을 참조하세요. ## 구문 요청 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_ListEventTrackers_RequestSyntax) ** 응답을 필터링하는 데 사용되는 데이터세트 그룹의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [maxResults](#API_ListEventTrackers_RequestSyntax) ** 반환할 최대 이벤트 트래커 수 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListEventTrackers_RequestSyntax) ** 다음 번 이벤트 트래커 세트(있는 경우)를 가져오기 위해 이전에 `ListEventTrackers`을 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "eventTrackers": [ { "creationDateTime": number, "eventTrackerArn": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [eventTrackers](#API_ListEventTrackers_ResponseSyntax) ** 이벤트 트래커의 목록입니다. 유형: [EventTrackerSummary](API_EventTrackerSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ** [nextToken](#API_ListEventTrackers_ResponseSyntax) ** 다음 번 이벤트 트래커 세트(있는 경우)을 가져오기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListEventTrackers) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListEventTrackers) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListEventTrackers) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListEventTrackers) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListEventTrackers) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListEventTrackers) # ListFilters 지정된 데이터세트 그룹에 속하는 모든 필터를 나열합니다. ## 구문 요청 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_ListFilters_RequestSyntax) ** 해당 필터가 포함된 데이터세트 그룹의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [maxResults](#API_ListFilters_RequestSyntax) ** 반환할 최대 필터 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListFilters_RequestSyntax) ** 다음 번 필터 세트(있는 경우)를 가져오기 위해 이전에 `ListFilters`을 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "Filters": [ { "creationDateTime": number, "datasetGroupArn": "string", "failureReason": "string", "filterArn": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Filters](#API_ListFilters_ResponseSyntax) ** 반환된 필터의 목록입니다. 유형: [FilterSummary](API_FilterSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ** [nextToken](#API_ListFilters_ResponseSyntax) ** 다음 번 필터 세트(있는 경우)를 가져오기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListFilters) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListFilters) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListFilters) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListFilters) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListFilters) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListFilters) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListFilters) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListFilters) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListFilters) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListFilters) # ListMetricAttributionMetrics 해당 지표 어트리뷰션에 대한 지표를 나열합니다. ## 구문 요청 ``` { "maxResults": number, "metricAttributionArn": "string", "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [maxResults](#API_ListMetricAttributionMetrics_RequestSyntax) ** 한 결과 페이지에 반환할 수 있는 최대 지표 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [metricAttributionArn](#API_ListMetricAttributionMetrics_RequestSyntax) ** 속성을 검색할 지표 어트리뷰션의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [nextToken](#API_ListMetricAttributionMetrics_RequestSyntax) ** 다음 번 결과 페이지를 검색하기 위한 이전 요청의 페이지 매김 토큰을 지정합니다. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "metrics": [ { "eventType": "string", "expression": "string", "metricName": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [metrics](#API_ListMetricAttributionMetrics_ResponseSyntax) ** 지정된 지표 어트리뷰션에 대한 지표. 유형: [MetricAttribute](API_MetricAttribute.md)객체 어레이 어레이 멤버: 최대 항목 수 10개. ** [nextToken](#API_ListMetricAttributionMetrics_ResponseSyntax) ** 다음 번 결과 페이지를 검색하기 위한 이전 `ListMetricAttributionMetricsResponse`요청의 페이지 매김 토큰을 지정합니다. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListMetricAttributionMetrics) # ListMetricAttributions 지표 어트리뷰션을 나열합니다. ## 구문 요청 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_ListMetricAttributions_RequestSyntax) ** 지표 어트리뷰션의 데이터세트 그룹의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [maxResults](#API_ListMetricAttributions_RequestSyntax) ** 한 결과 페이지에 반환할 수 있는 최대 지표 어트리뷰션 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListMetricAttributions_RequestSyntax) ** 다음 번 결과 페이지를 검색하기 위한 이전 요청의 페이지 매김 토큰을 지정합니다. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "metricAttributions": [ { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "metricAttributionArn": "string", "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [metricAttributions](#API_ListMetricAttributions_ResponseSyntax) ** 지표 어트리뷰션의 목록입니다. 유형: [MetricAttributionSummary](API_MetricAttributionSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ** [nextToken](#API_ListMetricAttributions_ResponseSyntax) ** 다음 번 결과 페이지를 검색하기 위한 이전 요청의 페이지 매김 토큰을 지정합니다. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListMetricAttributions) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListMetricAttributions) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListMetricAttributions) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListMetricAttributions) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListMetricAttributions) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListMetricAttributions) # ListRecipes 사용 가능한 레시피의 목록을 반환합니다. 응답은 레시피의 리소스 이름(ARN)을 비롯하여 각 레시피의 속성을 제공합니다. ## 구문 요청 ``` { "domain": "string", "maxResults": number, "nextToken": "string", "recipeProvider": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [domain](#API_ListRecipes_RequestSyntax) ** 도메인 데이터세트 그룹의 도메인별로 반환된 레시피를 필터링합니다. 이 도메인의 레시피(도메인 데이터세트 그룹 사용 사례)만 응답에 포함됩니다. 도메인을 지정하지 않으면 모든 레시피가 반환됩니다. 타입: 문자열 유효 값: `ECOMMERCE | VIDEO_ON_DEMAND` 필수 여부: 아니요 ** [maxResults](#API_ListRecipes_RequestSyntax) ** 반환할 최대 레시피 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListRecipes_RequestSyntax) ** 다음 번 레시피 세트(있는 경우)를 가져오기 위해 이전에 `ListRecipes`을 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ** [recipeProvider](#API_ListRecipes_RequestSyntax) ** 기본값은 `SERVICE`입니다. 타입: 문자열 유효 값: `SERVICE` 필수 항목 여부: 아니요 ## 응답 구문 ``` { "nextToken": "string", "recipes": [ { "creationDateTime": number, "domain": "string", "lastUpdatedDateTime": number, "name": "string", "recipeArn": "string", "status": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [nextToken](#API_ListRecipes_ResponseSyntax) ** 다음 번 레시피 세트를 가져오기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ** [recipes](#API_ListRecipes_ResponseSyntax) ** 사용 가능한 레시피의 목록입니다. 유형: [RecipeSummary](API_RecipeSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListRecipes) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListRecipes) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListRecipes) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListRecipes) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListRecipes) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListRecipes) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListRecipes) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListRecipes) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListRecipes) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListRecipes) # ListRecommenders 지정된 도메인 데이터세트 그룹의 추천자 목록을 반환합니다. 도메인 데이터세트 그룹을 지정하지 않으면 해당 계정과 연결된 모든 추천자가 나열됩니다. 응답은 리소스 이름(ARN)을 비롯하여 각 추천자의 속성을 제공합니다. 추천자에 대한 자세한 내용은 [CreateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateRecommender.html) 단원을 참조하세요. ## 구문 요청 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_ListRecommenders_RequestSyntax) ** 추천자를 나열할 도메인 데이터세트 그룹의 리소스 이름(ARN)입니다. 도메인 데이터세트 그룹을 지정하지 않으면 해당 계정과 연결된 모든 추천자가 나열됩니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [maxResults](#API_ListRecommenders_RequestSyntax) ** 반환할 최대 추천자 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListRecommenders_RequestSyntax) ** 다음 번 추천자 세트(있는 경우)를 가져오기 위해 이전에 `ListRecommenders`을 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "nextToken": "string", "recommenders": [ { "creationDateTime": number, "datasetGroupArn": "string", "lastUpdatedDateTime": number, "name": "string", "recipeArn": "string", "recommenderArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "status": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [nextToken](#API_ListRecommenders_ResponseSyntax) ** 다음 번 추천자 세트(있는 경우)를 가져오기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ** [recommenders](#API_ListRecommenders_ResponseSyntax) ** 추천자의 목록입니다. 유형: [RecommenderSummary](API_RecommenderSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListRecommenders) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListRecommenders) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListRecommenders) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListRecommenders) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListRecommenders) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListRecommenders) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListRecommenders) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListRecommenders) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListRecommenders) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListRecommenders) # ListSchemas 해당 계정에 연결된 스키마의 목록을 반환합니다. 응답은 리소스 이름(ARN)을 비롯하여 각 스키마의 속성을 제공합니다. 스키마에 대한 자세한 내용은 [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html) 단원을 참조하세요. ## 구문 요청 ``` { "maxResults": number, "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [maxResults](#API_ListSchemas_RequestSyntax) ** 반환할 최대 스키마 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListSchemas_RequestSyntax) ** 다음 번 스키마 세트(있는 경우)를 가져오기 위해 이전에 `ListSchemas`을 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "nextToken": "string", "schemas": [ { "creationDateTime": number, "domain": "string", "lastUpdatedDateTime": number, "name": "string", "schemaArn": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [nextToken](#API_ListSchemas_ResponseSyntax) ** 다음 번 스키마 세트(있는 경우)를 가져오기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ** [schemas](#API_ListSchemas_ResponseSyntax) ** 스키마의 목록입니다. 유형: [DatasetSchemaSummary](API_DatasetSchemaSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ## 오류 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListSchemas) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSchemas) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSchemas) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSchemas) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSchemas) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSchemas) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSchemas) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSchemas) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSchemas) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSchemas) # ListSolutions 지정된 데이터세트 그룹의 솔루션 목록을 반환합니다. 데이터세트 그룹을 지정하지 않으면 해당 계정과 관련된 모든 솔루션이 나열됩니다. 응답은 Amazon 리소스 이름(ARN)을 비롯하여 각 솔루션의 속성을 제공합니다. 솔루션에 대한 자세한 내용은 [솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 단원을 참조하세요. ## 구문 요청 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetGroupArn](#API_ListSolutions_RequestSyntax) ** 데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [maxResults](#API_ListSolutions_RequestSyntax) ** 반환할 최대 솔루션 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListSolutions_RequestSyntax) ** 다음번 솔루션 세트(있는 경우)를 가져오기 위해 이전에 `ListSolutions`을 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ## 응답 구문 ``` { "nextToken": "string", "solutions": [ { "creationDateTime": number, "lastUpdatedDateTime": number, "name": "string", "recipeArn": "string", "solutionArn": "string", "status": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [nextToken](#API_ListSolutions_ResponseSyntax) ** 다음번 솔루션 세트(있는 경우)를 가져오기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ** [solutions](#API_ListSolutions_ResponseSyntax) ** 현재 솔루션의 목록입니다. 유형: [SolutionSummary](API_SolutionSummary.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListSolutions) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSolutions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSolutions) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSolutions) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSolutions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSolutions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSolutions) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSolutions) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSolutions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSolutions) # ListSolutionVersions 해당 솔루션의 솔루션 버전 목록을 반환합니다. 솔루션이 지정되지 않은 경우 해당 계정과 관련된 모든 솔루션 버전이 나열됩니다. 응답은 Amazon 리소스 이름(ARN)을 비롯하여 각 솔루션 버전의 속성을 제공합니다. ## 구문 요청 ``` { "maxResults": number, "nextToken": "string", "solutionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [maxResults](#API_ListSolutionVersions_RequestSyntax) ** 반환할 최대 솔루션 버전 수. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [nextToken](#API_ListSolutionVersions_RequestSyntax) ** 다음번 솔루션 버전 세트(있는 경우)를 가져오기 위해 이전에 `ListSolutionVersions`을 호출한 후 반환된 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` 필수 여부: 아니요 ** [solutionArn](#API_ListSolutionVersions_RequestSyntax) ** 솔루션의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ## 응답 구문 ``` { "nextToken": "string", "solutionVersions": [ { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "solutionVersionArn": "string", "status": "string", "trainingMode": "string", "trainingType": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [nextToken](#API_ListSolutionVersions_ResponseSyntax) ** 다음번 솔루션 버전 세트(있는 경우)를 가져오기 위한 토큰. 유형: 문자열 길이 제약: 최대 길이 1500. 패턴: `\p{ASCII}{0,1500}` ** [solutionVersions](#API_ListSolutionVersions_ResponseSyntax) ** 버전 속성을 설명하는 솔루션 버전의 목록입니다. 유형: [SolutionVersionSummary](API_SolutionVersionSummary.md) 객체 어레이 어레이 멤버: 최대 항목 수 100개. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** InvalidNextTokenException ** 토큰이 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListSolutionVersions) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSolutionVersions) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSolutionVersions) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSolutionVersions) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSolutionVersions) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSolutionVersions) # ListTagsForResource 리소스에 연결된 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)의 목록을 가져옵니다. ## 구문 요청 ``` { "resourceArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [resourceArn](#API_ListTagsForResource_RequestSyntax) ** 리소스의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [tags](#API_ListTagsForResource_ResponseSyntax) ** 리소스의 태그. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListTagsForResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListTagsForResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListTagsForResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListTagsForResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListTagsForResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListTagsForResource) # StartRecommender 상태가 INACTIVE인 추천자를 시작합니다. 추천자를 시작해도 새 모델이 생성되지는 않지만 추천자에 대한 청구 및 자동 재학습이 재개됩니다. ## 구문 요청 ``` { "recommenderArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [recommenderArn](#API_StartRecommender_RequestSyntax) ** 시작할 추천자의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "recommenderArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [recommenderArn](#API_StartRecommender_ResponseSyntax) ** 시작한 추천자의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/StartRecommender) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StartRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StartRecommender) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StartRecommender) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StartRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StartRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StartRecommender) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StartRecommender) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StartRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StartRecommender) # StopRecommender ACTIVE 상태의 추천자를 중지합니다. 추천자를 중지하면 해당 추천자에 대한 청구 및 자동 재학습이 중지됩니다. ## 구문 요청 ``` { "recommenderArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [recommenderArn](#API_StopRecommender_RequestSyntax) ** 중지할 추천자의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "recommenderArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [recommenderArn](#API_StopRecommender_ResponseSyntax) ** 중지한 추천자의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/StopRecommender) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StopRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StopRecommender) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StopRecommender) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StopRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StopRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StopRecommender) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StopRecommender) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StopRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StopRecommender) # StopSolutionVersionCreation 상태가 CREATE\$1PENDING 또는 CREATE IN\$1PROGRESS인 솔루션 버전의 생성을 중지합니다. 솔루션 버전의 현재 상태에 따라 솔루션 버전 상태가 다음과 같이 변경됩니다. + CREATE\$1PENDING > CREATE\$1STOPPED 또는 + CREATE\$1IN\$1PROGRESS > CREATE\$1STOPPING > CREATE\$1STOPPED 솔루션 버전 생성을 중지할 때까지 완료했던 모든 학습에 대한 요금은 청구됩니다. 중지된 후에는 솔루션 버전 생성을 재개할 수 없습니다. ## 구문 요청 ``` { "solutionVersionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [solutionVersionArn](#API_StopSolutionVersionCreation_RequestSyntax) ** 생성을 중지할 솔루션 버전의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StopSolutionVersionCreation) # TagResource 리소스에 태그 목록을 추가합니다. ## 구문 요청 ``` { "resourceArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [resourceArn](#API_TagResource_RequestSyntax) ** 리소스의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [tags](#API_TagResource_RequestSyntax) ** 리소스에 적용할 태그. 자세한 내용은 [Amazon Personalize 리소스 태그 지정](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)을 참조하세요. 타입: [Tag](API_Tag.md)객체 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** LimitExceededException ** 초당 요청 수 한도를 초과했습니다. 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/TagResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/TagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TagResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/TagResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/TagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/TagResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/TagResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/TagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TagResource) # UntagResource 리소스에 연결된 지정된 태그를 제거합니다. 자세한 내용은 [Amazon Personalize 리소스에서 태그 제거](https://docs.aws.amazon.com/personalize/latest/dg/tags-remove.html)를 참조하세요. ## 구문 요청 ``` { "resourceArn": "string", "tagKeys": [ "string" ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [resourceArn](#API_UntagResource_RequestSyntax) ** 리소스의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [tagKeys](#API_UntagResource_RequestSyntax) ** 제거할 태그의 키입니다. 유형: 문자열 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 길이 제약: 최소 길이 1. 최대 길이 128. 패턴: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ** TooManyTagKeysException ** 요청에 리소스에 연결할 수 있는 것보다 많은 태그 키가 포함되어 있습니다(리소스당 태그 키 50개). HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UntagResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UntagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UntagResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UntagResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UntagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UntagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UntagResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UntagResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UntagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UntagResource) # UpdateCampaign 기존 캠페인과 함께 재학습된 솔루션 버전을 배포하거나, 캠페인의 `minProvisionedTPS`를 변경하거나, 캠페인 구성을 수정하도록 캠페인을 업데이트합니다. 예를 들어 기존 캠페인에 대해 `enableMetadataWithRecommendations`를 true로 설정할 수 있습니다. 최신 솔루션 버전을 사용하여 캠페인을 자동으로 시작하도록 업데이트하려면 다음을 지정합니다. + `SolutionVersionArn` 파라미터에 솔루션의 Amazon 리소스 이름(ARN)을 `SolutionArn/$LATEST` 형식으로 지정합니다. + `campaignConfig`에서 `syncWithLatestSolutionVersion`을 `true`로 설정합니다. 캠페인을 업데이트하려면 캠페인 상태가 ACTIVE 또는 CREATE FAILED여야 합니다. [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) 작업을 사용하여 캠페인 상태를 확인합니다. **참고** 업데이트가 진행 중인 동안에도 캠페인에서 추천을 받을 수 있습니다. 캠페인은 최신 캠페인 업데이트 상태가 `Active`가 될 때까지 이전 솔루션 버전과 캠페인 구성을 사용하여 추천을 생성합니다. 코드 샘플을 비롯한 캠페인 업데이트에 대한 자세한 내용은 [캠페인 업데이트](https://docs.aws.amazon.com/personalize/latest/dg/update-campaigns.html) 단원을 참조하세요. 캠페인에 대한 자세한 내용은 [캠페인 생성](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html) 단원을 참조하세요. ## 구문 요청 ``` { "campaignArn": "string", "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "minProvisionedTPS": number, "solutionVersionArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [campaignArn](#API_UpdateCampaign_RequestSyntax) ** 캠페인의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [campaignConfig](#API_UpdateCampaign_RequestSyntax) ** 캠페인의 구성 세부 정보입니다. 유형: [CampaignConfig](API_CampaignConfig.md)객체 필수 여부: 아니요 ** [minProvisionedTPS](#API_UpdateCampaign_RequestSyntax) ** Personalize에서 지원할 초당 요청된 최소 프로비저닝 트랜잭션(추천)을 지정합니다. `minProvisionedTPS`가 높으면 요금이 인상됩니다. `minProvisionedTPS`(기본값)의 경우 1부터 시작하는 것이 좋습니다. Amazon CloudWatch 지표를 사용하여 사용량을 추적하고 필요에 따라 `minProvisionedTPS`를 늘리세요. 타입: 정수 유효 범위: 최소값 1. 필수 여부: 아니요 ** [solutionVersionArn](#API_UpdateCampaign_RequestSyntax) ** 배포할 새 모델의 Amazon 리소스 이름(ARN)입니다. 솔루션의 최신 솔루션 버전을 지정하려면 *솔루션*의 ARN을 `SolutionArn/$LATEST` 형식으로 지정합니다. [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html)에서 `syncWithLatestSolutionVersion`을 `True`로 설정한 경우 이 형식을 사용해야 합니다. 솔루션의 최신 솔루션 버전이 아닌 모델을 배포하려면 솔루션 버전의 ARN을 지정합니다. 자동 캠페인 업데이트에 대한 자세한 내용은 [자동 캠페인 업데이트 활성화](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ## 응답 구문 ``` { "campaignArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [campaignArn](#API_UpdateCampaign_ResponseSyntax) ** 요청에 제공된 것과 동일한 캠페인 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateCampaign) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateCampaign) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateCampaign) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateCampaign) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateCampaign) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateCampaign) # UpdateDataset 데이터세트를 업데이트하여 스키마를 새 스키마나 기존 스키마로 바꿉니다. 자세한 내용은 [데이터세트 스키마교체](https://docs.aws.amazon.com/personalize/latest/dg/updating-dataset-schema.html)를 참조하세요. ## 구문 요청 ``` { "datasetArn": "string", "schemaArn": "string" } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetArn](#API_UpdateDataset_RequestSyntax) ** 업데이트하려는 데이터세트의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [schemaArn](#API_UpdateDataset_RequestSyntax) ** 사용하려는 새 스키마의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` { "datasetArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetArn](#API_UpdateDataset_ResponseSyntax) ** 업데이트한 데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateDataset) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateDataset) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateDataset) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateDataset) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateDataset) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateDataset) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateDataset) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateDataset) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateDataset) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateDataset) # UpdateMetricAttribution 지표 어트리뷰션을 업데이트합니다. ## 구문 요청 ``` { "addMetrics": [ { "eventType": "string", "expression": "string", "metricName": "string" } ], "metricAttributionArn": "string", "metricsOutputConfig": { "roleArn": "string", "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "removeMetrics": [ "string" ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [addMetrics](#API_UpdateMetricAttribution_RequestSyntax) ** 지표 어트리뷰션에 새 지표 속성을 추가합니다. 유형: [MetricAttribute](API_MetricAttribute.md)객체 어레이 어레이 멤버: 최대 항목 수 10개. 필수 여부: 아니요 ** [metricAttributionArn](#API_UpdateMetricAttribution_RequestSyntax) ** 업데이트할 지표 어트리뷰션의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [metricsOutputConfig](#API_UpdateMetricAttribution_RequestSyntax) ** 메트릭 어트리뷰션을 위한 출력 구성. 유형: [MetricAttributionOutput](API_MetricAttributionOutput.md)객체 필수 여부: 아니요 ** [removeMetrics](#API_UpdateMetricAttribution_RequestSyntax) ** 지표 어트리뷰션에서 지표 속성을 제거합니다. 유형: 문자열 어레이 어레이 멤버: 최대 항목 수 10개. 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 응답 구문 ``` { "metricAttributionArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [metricAttributionArn](#API_UpdateMetricAttribution_ResponseSyntax) ** 업데이트한 지표 어트리뷰션에 대한 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceAlreadyExistsException ** 지정된 리소스가 이미 있습니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateMetricAttribution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateMetricAttribution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateMetricAttribution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateMetricAttribution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateMetricAttribution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateMetricAttribution) # UpdateRecommender 추천자 구성을 수정하도록 추천자를 업데이트합니다. 추천자를 업데이트하여 학습에 사용된 열을 수정하면 Personalize가 추천자를 지원하는 모델의 전체 재학습을 자동으로 시작합니다. 업데이트가 완료되더라도 추천자로부터 추천을 받을 수 있습니다. 추천자는 업데이트가 완료될 때까지 이전 구성을 사용합니다. 이 업데이트의 상태를 추적하려면 [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) 작업에서 반환된 `latestRecommenderUpdate`를 사용합니다. ## 구문 요청 ``` { "recommenderArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } } } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [recommenderArn](#API_UpdateRecommender_RequestSyntax) ** 수정할 추천자의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [recommenderConfig](#API_UpdateRecommender_RequestSyntax) ** 추천자의 구성 세부 정보입니다. 유형: [RecommenderConfig](API_RecommenderConfig.md)객체 필수 여부: 예 ## 응답 구문 ``` { "recommenderArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [recommenderArn](#API_UpdateRecommender_ResponseSyntax) ** 요청에 제공된 것과 동일한 추천자 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateRecommender) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateRecommender) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateRecommender) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateRecommender) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateRecommender) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateRecommender) # UpdateSolution 다른 자동 학습 구성을 사용하도록 Amazon Personalize 솔루션을 업데이트합니다. 솔루션을 업데이트할 때 솔루션이 자동 학습을 사용할지 여부를 변경할 수 있으며 학습 빈도를 변경할 수 있습니다. 솔루션 업데이트에 대한 자세한 내용은 [솔루션 업데이트](https://docs.aws.amazon.com/personalize/latest/dg/updating-solution.html)를 참조하세요. 솔루션 업데이트는 다음 상태 중 하나일 수 있습니다. CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED 솔루션 업데이트 상태를 가져오려면 [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) API 작업을 호출하고 `latestSolutionUpdate`에서 상태를 찾습니다. ## 구문 요청 ``` { "performAutoTraining": boolean, "performIncrementalUpdate": boolean, "solutionArn": "string", "solutionUpdateConfig": { "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] } } } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [performAutoTraining](#API_UpdateSolution_RequestSyntax) ** 솔루션이 자동 학습을 사용하여 새 솔루션 버전(학습된 모델)을 생성하는지 여부입니다. `AutoTrainingConfig`에서 `schedulingExpression`을 솔루션 구성의 일부로 지정하여 학습 빈도를 변경할 수 있습니다. 자동 학습을 켜면 솔루션 업데이트가 완료된 후 1시간 이내에 첫 번째 자동 학습이 시작됩니다. 1시간 내에 솔루션 버전을 수동으로 생성하는 경우 솔루션은 첫 번째 자동 학습을 건너뜁니다. 자동 학습에 대한 자세한 내용은 [자동 학습 구성](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html)을 참조하세요. 학습이 시작된 후 [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) API 작업을 사용하여 솔루션 버전의 Amazon 리소스 이름(ARN)을 가져올 수 있습니다. 상태를 가져오려면 [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html)을 사용합니다. 유형: 부울 필수 항목 여부: 아니요 ** [performIncrementalUpdate](#API_UpdateSolution_RequestSyntax) ** 모델에 대한 증분 훈련 업데이트를 수행할지 여부입니다. 활성화하면 전체 재훈련 없이 모델이 새 데이터에서 더 자주 학습할 수 있으므로 거의 실시간으로 개인화할 수 있습니다. 이 파라미터는 의미 체계 유사성 레시피를 사용하는 솔루션에서만 지원됩니다. 유형: 부울 필수 항목 여부: 아니요 ** [solutionArn](#API_UpdateSolution_RequestSyntax) ** 업데이트할 솔루션의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [solutionUpdateConfig](#API_UpdateSolution_RequestSyntax) ** 솔루션의 새 구성 세부 정보입니다. 유형: [SolutionUpdateConfig](API_SolutionUpdateConfig.md)객체 필수 항목 여부: 아니요 ## 응답 구문 ``` { "solutionArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [solutionArn](#API_UpdateSolution_ResponseSyntax) ** 요청에 제공된 것과 동일한 솔루션 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** LimitExceededException ** 초당 요청 수 한도를 초과했습니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateSolution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateSolution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateSolution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateSolution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateSolution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateSolution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateSolution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateSolution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateSolution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateSolution) # Personalize 이벤트 Personalize 이벤트에서 지원하는 작업은 다음과 같습니다. + [PutActionInteractions](API_UBS_PutActionInteractions.md) + [PutActions](API_UBS_PutActions.md) + [PutEvents](API_UBS_PutEvents.md) + [PutItems](API_UBS_PutItems.md) + [PutUsers](API_UBS_PutUsers.md) # PutActionInteractions 작업 상호 작용 이벤트 데이터를 기록합니다. *작업 상호 작용* 이벤트는 사용자와 *작업* 간의 상호 작용입니다. 사용자가 멤버십 프로그램에 등록하거나 앱을 다운로드하는 등의 작업을 행하는 경우를 예로 들 수 있습니다. 작업 상호 작용 기록에 대한 자세한 내용은 [작업 상호 작용 이벤트 기록](https://docs.aws.amazon.com/personalize/latest/dg/recording-action-interaction-events.html)을 참조하세요. 작업 데이터 세트의 작업에 대한 자세한 내용은 [작업 데이터 세트](https://docs.aws.amazon.com/personalize/latest/dg/actions-datasets.html)를 참조하세요. ## Request Syntax ``` POST /action-interactions HTTP/1.1 Content-type: application/json { "actionInteractions": [ { "actionId": "string", "eventId": "string", "eventType": "string", "impression": [ "string" ], "properties": "string", "recommendationId": "string", "sessionId": "string", "timestamp": number, "userId": "string" } ], "trackingId": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [actionInteractions](#API_UBS_PutActionInteractions_RequestSyntax) ** 세션의 작업 상호 작용 이벤트 목록. 타입: [ActionInteraction](API_UBS_ActionInteraction.md)객체 배열 어레이 멤버: 최소 항목 수 1개. 최대 항목 수 10개. 필수 항목 여부: 예 ** [trackingId](#API_UBS_PutActionInteractions_RequestSyntax) ** 작업 상호 작용 이벤트 트래커의 ID. 작업 상호 작용 데이터 세트를 생성하면 Amazon Personalize가 작업 상호 작용 이벤트 트래커를 생성합니다. 자세한 내용은 [작업 상호 작용 이벤트 트래커 ID](https://docs.aws.amazon.com/personalize/latest/dg/action-interaction-tracker-id.html)를 참조하세요. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 409 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutActionInteractions) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutActionInteractions) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutActionInteractions) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutActionInteractions) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutActionInteractions) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutActionInteractions) # PutActions 작업 데이터 세트에 작업을 하나 이상 추가합니다. 자세한 내용은 [개별적으로 작업 가져오기](https://docs.aws.amazon.com/personalize/latest/dg/importing-actions.html)를 참조하세요. ## Request Syntax ``` POST /actions HTTP/1.1 Content-type: application/json { "actions": [ { "actionId": "string", "properties": "string" } ], "datasetArn": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [actions](#API_UBS_PutActions_RequestSyntax) ** 작업 데이터 목록. 타입: [Action](API_UBS_Action.md)객체 배열 어레이 멤버: 최소 항목 수 1개. 최대 항목 수 10개. 필수 항목 여부: 예 ** [datasetArn](#API_UBS_PutActions_RequestSyntax) ** 하나 이상의 작업을 추가할 작업 데이터 세트의 Amazon 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 409 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutActions) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutActions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutActions) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutActions) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutActions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutActions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutActions) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutActions) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutActions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutActions) # PutEvents 항목 상호 작용 이벤트 데이터를 기록합니다. 자세한 내용은 [항목 상호 작용 이벤트 기록](https://docs.aws.amazon.com/personalize/latest/dg/recording-item-interaction-events.html)을 참조하세요. **참고** AWS Lambda 함수를 사용하여 PutEvents 작업을 호출하는 경우 함수의 실행 역할에 `*` `Resource` 요소의 와일드카드로 `personalize:PutEvents` 작업을 수행할 수 있는 권한이 있어야 합니다. ## Request Syntax ``` POST /events HTTP/1.1 Content-type: application/json { "eventList": [ { "eventId": "string", "eventType": "string", "eventValue": number, "impression": [ "string" ], "itemId": "string", "metricAttribution": { "eventAttributionSource": "string" }, "properties": "string", "recommendationId": "string", "sentAt": number } ], "sessionId": "string", "trackingId": "string", "userId": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [eventList](#API_UBS_PutEvents_RequestSyntax) ** 세션의 이벤트 데이터 목록입니다. 유형: [Event](API_UBS_Event.md)객체 어레이 어레이 멤버: 최소 항목 수 1개. 최대 항목 수 10개. 필수 여부: 예 ** [sessionId](#API_UBS_PutEvents_RequestSyntax) ** 해당 사용자의 방문과 연결된 세션 ID. 사용자가 웹 사이트를 처음 방문하거나 애플리케이션을 처음 사용할 때 애플리케이션에서 세션 ID를 생성합니다. Personalize는 사용자가 로그인하기 전에 세션 ID를 사용하여 이벤트를 해당 사용자와 연결합니다. 자세한 내용은 [항목 상호 작용 이벤트 기록](https://docs.aws.amazon.com/personalize/latest/dg/recording-item-interaction-events.html)을 참조하세요. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 항목 여부: 예 ** [trackingId](#API_UBS_PutEvents_RequestSyntax) ** 이벤트의 트랜잭션 ID. ID는 [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) API를 호출하면 생성됩니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 항목 여부: 예 ** [userId](#API_UBS_PutEvents_RequestSyntax) ** 이벤트와 연결된 사용자. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutEvents) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutEvents) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutEvents) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutEvents) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutEvents) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutEvents) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutEvents) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutEvents) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutEvents) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutEvents) # PutItems 항목 데이터세트에 하나 이상의 항목을 추가합니다. 자세한 내용은 [개별적으로 항목 가져오기](https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html)를 참조하세요. ## Request Syntax ``` POST /items HTTP/1.1 Content-type: application/json { "datasetArn": "string", "items": [ { "itemId": "string", "properties": "string" } ] } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetArn](#API_UBS_PutItems_RequestSyntax) ** 항목을 추가할 항목 데이터세트의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [items](#API_UBS_PutItems_RequestSyntax) ** 항목 데이터의 목록입니다. 유형: [Item](API_UBS_Item.md)객체 어레이 어레이 멤버: 최소 항목 수 1개. 최대 항목 수 10개. 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 409 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutItems) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutItems) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutItems) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutItems) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutItems) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutItems) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutItems) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutItems) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutItems) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutItems) # PutUsers 사용자 데이터세트에 사용자를 한 명 이상 추가합니다. 자세한 내용은 [개별적으로 사용자 가져오기](https://docs.aws.amazon.com/personalize/latest/dg/importing-users.html)를 참조하세요. ## Request Syntax ``` POST /users HTTP/1.1 Content-type: application/json { "datasetArn": "string", "users": [ { "properties": "string", "userId": "string" } ] } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [datasetArn](#API_UBS_PutUsers_RequestSyntax) ** 사용자를 추가할 사용자 데이터세트의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [users](#API_UBS_PutUsers_RequestSyntax) ** 사용자 데이터의 목록입니다. 유형: [User](API_UBS_User.md)객체 어레이 어레이 멤버: 최소 항목 수 1개. 최대 항목 수 10개. 필수 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 ``` ## Response Elements 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceInUseException ** 지정된 리소스가 이미 사용 중입니다. HTTP 상태 코드: 409 ** ResourceNotFoundException ** 지정된 리소스를 찾을 수 없습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutUsers) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutUsers) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutUsers) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutUsers) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutUsers) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutUsers) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutUsers) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutUsers) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutUsers) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutUsers) # Personalize 런타임 Personalize 런타임에서 지원하는 작업은 다음과 같습니다. + [GetActionRecommendations](API_RS_GetActionRecommendations.md) + [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) + [GetRecommendations](API_RS_GetRecommendations.md) # GetActionRecommendations 예측 점수를 기준으로 내림차순으로 정렬된 추천 작업 목록을 반환합니다. PERSONALIZED\$1ACTIONS 레시피로 교육된 솔루션 버전을 배포하는 사용자 지정 캠페인이 있는 경우 `GetActionRecommendations` API를 사용하세요. PERSONALIZED\$1ACTIONS 레시피에 대한 자세한 내용은 [PERSONALIZED\$1ACTIONS 레시피](https://docs.aws.amazon.com/personalize/latest/dg/nexts-best-action-recipes.html)를 참조하세요. 작업 추천을 받는 방법에 대한 자세한 내용은 [작업 추천 받기](https://docs.aws.amazon.com/personalize/latest/dg/get-action-recommendations.html)를 참조하세요. ## Request Syntax ``` POST /action-recommendations HTTP/1.1 Content-type: application/json { "campaignArn": "string", "filterArn": "string", "filterValues": { "string" : "string" }, "numResults": number, "userId": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [campaignArn](#API_RS_GetActionRecommendations_RequestSyntax) ** 작업 추천을 받기 위해 사용할 캠페인의 Amazon 리소스 이름(ARN)입니다. 이 캠페인은 PERSONALIZED\$1ACTIONS 레시피로 교육된 솔루션 버전을 배포해야 합니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [filterArn](#API_RS_GetActionRecommendations_RequestSyntax) ** 반환되는 추천에 적용할 필터의 ARN입니다. 자세한 내용은 [추천 필터링](https://docs.aws.amazon.com/personalize/latest/dg/filter.html) 단원을 참조하세요. 이 파라미터를 사용할 때는 필터 리소스가 `ACTIVE`이 맞는지 확인합니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [filterValues](#API_RS_GetActionRecommendations_RequestSyntax) ** 추천을 필터링할 때 사용할 값. 필터 표현식의 각 자리 표시자 파라미터에 대해 파라미터 이름(대/소문자 구분)을 키로 그리고 필터 값을 해당 값으로 각각 제공합니다. 한 파라미터의 여러 값을 쉼표로 구분합니다. `INCLUDE` 요소를 사용하여 작업을 포함하는 필터 표현식의 경우 표현식에 정의되어 있는 모든 파라미터의 값을 제공해야 합니다. `EXCLUDE` 요소를 사용하여 작업을 제외하는 표현식이 포함된 필터의 경우 `filter-values`를 생략할 수 있습니다. 이 경우 Personalize는 표현식의 해당 부분을 추천을 필터링하는 데 사용하지 않습니다. 자세한 내용은 [추천 및 사용자 세그먼트 필터링](https://docs.aws.amazon.com/personalize/latest/dg/filter.html) 단원을 참조하세요. 유형: 문자열 간 맵 맵 항목: 최대 항목 수 25개. 키 길이 제약: 최대 길이 50. 키 패턴: `[A-Za-z0-9_]+` 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** [numResults](#API_RS_GetActionRecommendations_RequestSyntax) ** 반환할 결과 수. 기본값은 5입니다. 최대값은 100입니다. 유형: 정수 유효 범위: 최소값 0. 필수 여부: 아니요 ** [userId](#API_RS_GetActionRecommendations_RequestSyntax) ** 작업 추천을 제공할 사용자의 사용자 ID입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "actionList": [ { "actionId": "string", "score": number } ], "recommendationId": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [actionList](#API_RS_GetActionRecommendations_ResponseSyntax) ** 예측 점수를 기준으로 내림차순으로 정렬된 작업 추천 목록입니다. 목록에는 최대 100개의 작업이 있을 수 있습니다. 작업 점수에 대한 자세한 내용은 [작업 추천 점수를 매기는 방식](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html)을 참조하세요. 유형: [PredictedAction](API_RS_PredictedAction.md)객체 어레이 ** [recommendationId](#API_RS_GetActionRecommendations_ResponseSyntax) ** 추천의 ID. 유형: 문자열 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정한 리소스가 존재하지 않습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetActionRecommendations) # GetPersonalizedRanking 해당 사용자에 대한 추천 항목 목록의 순위를 다시 매깁니다. 이 목록의 첫 번째 항목은 사용자가 관심을 보일 가능성이 가장 높은 항목으로 간주됩니다. **참고** 캠페인을 지원하는 솔루션은 PERSONALIZED\$1RANKING 유형 레시피를 사용하여 생성한 것이어야 합니다. ## Request Syntax ``` POST /personalize-ranking HTTP/1.1 Content-type: application/json { "campaignArn": "string", "context": { "string" : "string" }, "filterArn": "string", "filterValues": { "string" : "string" }, "inputList": [ "string" ], "metadataColumns": { "string" : [ "string" ] }, "userId": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [campaignArn](#API_RS_GetPersonalizedRanking_RequestSyntax) ** 순위를 생성하기 위해 사용할 캠페인의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 예 ** [context](#API_RS_GetPersonalizedRanking_RequestSyntax) ** 추천을 받을 때 사용할 컨텍스트 메타데이터. 컨텍스트 메타데이터에는 사용자의 현재 위치 또는 기기 유형과 같이 사용자의 추천을 받을 때 관련이 있을 수 있는 모든 상호작용 정보가 포함됩니다. 유형: 문자열-문자열 맵 맵 항목: 최대 항목 수 150개. 키 길이 제약: 최대 길이 150. 키 패턴: `[A-Za-z\d_]+` 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** [filterArn](#API_RS_GetPersonalizedRanking_RequestSyntax) ** 특정 사용자에 대한 추천에 항목을 포함시키거나 항목을 제외시키기 위해 만든 필터의 Amazon 리소스 이름(ARN)입니다. 자세한 내용은 [추천 필터링](https://docs.aws.amazon.com/personalize/latest/dg/filter.html) 단원을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [filterValues](#API_RS_GetPersonalizedRanking_RequestSyntax) ** 추천을 필터링할 때 사용할 값. 필터 표현식의 각 자리 표시자 파라미터에 대해 파라미터 이름(대/소문자 구분)을 키로 그리고 필터 값을 해당 값으로 각각 제공합니다. 한 파라미터의 여러 값을 쉼표로 구분합니다. `INCLUDE` 요소를 사용하여 항목을 포함시키는 필터 표현식의 경우 표현식에 정의되어 있는 모든 파라미터의 값을 제공해야 합니다. `EXCLUDE` 요소를 사용하여 항목을 제외시키는 표현식이 있는 필터의 경우 `filter-values`를 생략할 수 있습니다. 이 경우 Personalize는 표현식의 해당 부분을 사용하여 추천을 필터링하지 않습니다. 자세한 내용은 [추천 필터링](https://docs.aws.amazon.com/personalize/latest/dg/filter.html) 단원을 참조하세요. 유형: 문자열 간 맵 맵 항목: 최대 항목 수 25개. 키 길이 제약: 최대 길이 50. 키 패턴: `[A-Za-z0-9_]+` 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** [inputList](#API_RS_GetPersonalizedRanking_RequestSyntax) ** 순위를 매길 항목이 목록(`itemId` 기준). 항목이 학습 데이터세트에 포함되지 않은 경우 해당 항목은 순위가 재조정된 목록 끝에 추가됩니다. 추천에 메타데이터를 포함하는 경우 최대값은 50입니다. 포함하지 않는 경우 최대값은 500입니다. 유형: 문자열 배열 길이 제약: 최대 길이 256. 필수 항목 여부: 예 ** [metadataColumns](#API_RS_GetPersonalizedRanking_RequestSyntax) ** 캠페인을 만들거나 업데이트할 때 추천에서 메타데이터를 활성화한 경우 개인 맞춤 순위에 포함할 항목 데이터 세트의 메타데이터 열을 지정하세요. 맵 키는 `ITEMS`이고, 값은 항목 데이터 세트의 열 이름 목록입니다. 제공할 수 있는 최대 열 수는 10개입니다. 캠페인용 메타데이터 활성화에 대한 자세한 내용은 [캠페인용 추천의 메타데이터 활성화](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata)를 참조하세요. 유형: 문자열-문자열 어레이 맵 맵 항목: 최대 항목 수 1개입니다. 키 길이 제약: 최대 길이 256. 배열 멤버: 최대 항목 수는 99개입니다. 길이 제약: 최대 길이 150. 필수 여부: 아니요 ** [userId](#API_RS_GetPersonalizedRanking_RequestSyntax) ** 캠페인에서 순위를 제공하려는 대상 사용자. 유형: 문자열 길이 제약: 최대 길이 256. 필수 항목 여부: 예 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "personalizedRanking": [ { "itemId": "string", "metadata": { "string" : "string" }, "promotionName": "string", "reason": [ "string" ], "score": number } ], "recommendationId": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [personalizedRanking](#API_RS_GetPersonalizedRanking_ResponseSyntax) ** 사용자가 가장 관심을 가질 만한 순서의 항목 목록입니다. 최대값은 500입니다. 유형: [PredictedItem](API_RS_PredictedItem.md)객체 어레이 ** [recommendationId](#API_RS_GetPersonalizedRanking_ResponseSyntax) ** 추천의 ID. 유형: 문자열 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정한 리소스가 존재하지 않습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) # GetRecommendations 추천 항목의 목록을 반환합니다. 캠페인의 경우 캠페인의 Amazon 리소스 이름(ARN)이 필요하며 필요한 사용자 및 항목 입력은 다음과 같이 캠페인을 지원하는 솔루션을 생성하는 데 사용된 레시피 유형에 따라 달라집니다. + USER\$1PERSONALIZATION - `userId`필요, `itemId`는 사용되지 않음 + RELATED\$1ITEMS - `itemId`필요, `userId`는 사용되지 않음 **참고** PERSONALIZED\$1RANKING 유형의 레시피를 사용하여 만든 솔루션으로 지원되는 캠페인은 [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md)API를 사용합니다. 추천자의 경우 추천자의 ARN이 필요하며 필요한 항목과 사용자 입력은 해당 추천자를 지원하는 사용 사례(도메인 기반 레시피)에 따라 달라집니다. 사용 사례 요구 사항에 대한 자세한 내용은 [추천자 사용 사례 선택](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html) 단원을 참조하세요. ## Request Syntax ``` POST /recommendations HTTP/1.1 Content-type: application/json { "campaignArn": "string", "context": { "string" : "string" }, "filterArn": "string", "filterValues": { "string" : "string" }, "itemId": "string", "metadataColumns": { "string" : [ "string" ] }, "numResults": number, "promotions": [ { "filterArn": "string", "filterValues": { "string" : "string" }, "name": "string", "percentPromotedItems": number } ], "recommenderArn": "string", "userId": "string" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [campaignArn](#API_RS_GetRecommendations_RequestSyntax) ** 추천을 받기 위해 사용할 캠페인의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [context](#API_RS_GetRecommendations_RequestSyntax) ** 추천을 받을 때 사용할 컨텍스트 메타데이터. 컨텍스트 메타데이터에는 사용자의 현재 위치 또는 기기 유형과 같이 사용자의 추천을 받을 때 관련이 있을 수 있는 모든 상호작용 정보가 포함됩니다. 유형: 문자열-문자열 맵 맵 항목: 최대 항목 수 150개. 키 길이 제약: 최대 길이 150. 키 패턴: `[A-Za-z\d_]+` 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** [filterArn](#API_RS_GetRecommendations_RequestSyntax) ** 반환되는 추천에 적용할 필터의 ARN입니다. 자세한 내용은 [추천 필터링](https://docs.aws.amazon.com/personalize/latest/dg/filter.html) 단원을 참조하세요. 이 파라미터를 사용할 때는 필터 리소스가 `ACTIVE`이 맞는지 확인합니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [filterValues](#API_RS_GetRecommendations_RequestSyntax) ** 추천을 필터링할 때 사용할 값. 필터 표현식의 각 자리 표시자 파라미터에 대해 파라미터 이름(대/소문자 구분)을 키로 그리고 필터 값을 해당 값으로 각각 제공합니다. 한 파라미터의 여러 값을 쉼표로 구분합니다. `INCLUDE` 요소를 사용하여 항목을 포함시키는 필터 표현식의 경우 표현식에 정의되어 있는 모든 파라미터의 값을 제공해야 합니다. `EXCLUDE` 요소를 사용하여 항목을 제외시키는 표현식이 있는 필터의 경우 `filter-values`를 생략할 수 있습니다. 이 경우 Personalize는 표현식의 해당 부분을 사용하여 추천을 필터링하지 않습니다. 자세한 내용은 [추천 및 사용자 세그먼트 필터링](https://docs.aws.amazon.com/personalize/latest/dg/filter.html) 단원을 참조하세요. 유형: 문자열 간 맵 맵 항목: 최대 항목 수 25개. 키 길이 제약: 최대 길이 50. 키 패턴: `[A-Za-z0-9_]+` 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** [itemId](#API_RS_GetRecommendations_RequestSyntax) ** 추천을 제공할 항목 ID. `RELATED_ITEMS` 레시피 유형의 경우 필수. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** [metadataColumns](#API_RS_GetRecommendations_RequestSyntax) ** 캠페인 또는 추천자를 만들거나 업데이트할 때 추천에서 메타데이터를 활성화한 경우 항목 데이터 세트의 메타데이터 열을 지정하여 항목 추천에 포함하세요. 맵 키는 `ITEMS`이고, 값은 항목 데이터 세트의 열 이름 목록입니다. 제공할 수 있는 최대 열 수는 10개입니다. 캠페인용 메타데이터 활성화에 대한 자세한 내용은 [캠페인용 추천의 메타데이터 활성화](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata)를 참조하세요. 추천자용 메타데이터 활성화에 대한 자세한 내용은 [추천자용 추천의 메타데이터 활성화](https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata)를 참조하세요. 유형: 문자열-문자열 어레이 맵 맵 항목: 최대 항목 수 1개입니다. 키 길이 제약: 최대 길이 256. 배열 멤버: 최대 항목 수는 99개입니다. 길이 제약: 최대 길이 150. 필수 여부: 아니요 ** [numResults](#API_RS_GetRecommendations_RequestSyntax) ** 반환할 결과 수. 기본값은 25입니다. 추천에 메타데이터를 포함하는 경우 최대값은 50입니다. 포함하지 않는 경우 최대값은 500입니다. 유형: 정수 유효 범위: 최소값 0. 필수 여부: 아니요 ** [promotions](#API_RS_GetRecommendations_RequestSyntax) ** 추천 요청에 적용할 프로모션. 홍보는 추천 항목의 구성 가능한 하위 집합에 적용되는 추가 비즈니스 규칙을 정의합니다. 유형: [Promotion](API_RS_Promotion.md)객체 어레이 어레이 멤버: 최대 항목 수 1개. 필수 여부: 아니요 ** [recommenderArn](#API_RS_GetRecommendations_RequestSyntax) ** 추천을 받는 데 사용할 추천자의 Amazon 리소스 이름(ARN)입니다. 도메인 사용 사례에 대한 추천자를 사용하여 도메인 데이터세트 그룹을 생성한 경우 추천자 ARN을 제공합니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** [userId](#API_RS_GetRecommendations_RequestSyntax) ** 추천을 제공할 사용자 ID. `USER_PERSONALIZATION` 레시피 유형의 경우 필수. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-type: application/json { "itemList": [ { "itemId": "string", "metadata": { "string" : "string" }, "promotionName": "string", "reason": [ "string" ], "score": number } ], "recommendationId": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [itemList](#API_RS_GetRecommendations_ResponseSyntax) ** 예측 점수를 기준으로 내림차순으로 정렬된 추천 목록입니다. 목록에는 최대 500개의 항목이 있을 수 있습니다. 유형: [PredictedItem](API_RS_PredictedItem.md)객체 어레이 ** [recommendationId](#API_RS_GetRecommendations_ResponseSyntax) ** 추천의 ID. 유형: 문자열 ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 지정한 리소스가 존재하지 않습니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetRecommendations) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetRecommendations) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetRecommendations) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetRecommendations) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetRecommendations) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetRecommendations) # 데이터 타입 Personalize에서 지원하는 데이터 유형은 다음과 같습니다. + [Algorithm](API_Algorithm.md) + [AlgorithmImage](API_AlgorithmImage.md) + [AutoMLConfig](API_AutoMLConfig.md) + [AutoMLResult](API_AutoMLResult.md) + [AutoTrainingConfig](API_AutoTrainingConfig.md) + [BatchInferenceJob](API_BatchInferenceJob.md) + [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) + [BatchInferenceJobInput](API_BatchInferenceJobInput.md) + [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) + [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md) + [BatchSegmentJob](API_BatchSegmentJob.md) + [BatchSegmentJobInput](API_BatchSegmentJobInput.md) + [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) + [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md) + [Campaign](API_Campaign.md) + [CampaignConfig](API_CampaignConfig.md) + [CampaignSummary](API_CampaignSummary.md) + [CampaignUpdateSummary](API_CampaignUpdateSummary.md) + [CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md) + [ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md) + [DataDeletionJob](API_DataDeletionJob.md) + [DataDeletionJobSummary](API_DataDeletionJobSummary.md) + [Dataset](API_Dataset.md) + [DatasetExportJob](API_DatasetExportJob.md) + [DatasetExportJobOutput](API_DatasetExportJobOutput.md) + [DatasetExportJobSummary](API_DatasetExportJobSummary.md) + [DatasetGroup](API_DatasetGroup.md) + [DatasetGroupSummary](API_DatasetGroupSummary.md) + [DatasetImportJob](API_DatasetImportJob.md) + [DatasetImportJobSummary](API_DatasetImportJobSummary.md) + [DatasetSchema](API_DatasetSchema.md) + [DatasetSchemaSummary](API_DatasetSchemaSummary.md) + [DatasetSummary](API_DatasetSummary.md) + [DatasetUpdateSummary](API_DatasetUpdateSummary.md) + [DataSource](API_DataSource.md) + [DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md) + [DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md) + [DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md) + [DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md) + [EventParameters](API_EventParameters.md) + [EventsConfig](API_EventsConfig.md) + [EventTracker](API_EventTracker.md) + [EventTrackerSummary](API_EventTrackerSummary.md) + [FeatureTransformation](API_FeatureTransformation.md) + [FieldsForThemeGeneration](API_FieldsForThemeGeneration.md) + [Filter](API_Filter.md) + [FilterSummary](API_FilterSummary.md) + [HPOConfig](API_HPOConfig.md) + [HPOObjective](API_HPOObjective.md) + [HPOResourceConfig](API_HPOResourceConfig.md) + [HyperParameterRanges](API_HyperParameterRanges.md) + [IntegerHyperParameterRange](API_IntegerHyperParameterRange.md) + [MetricAttribute](API_MetricAttribute.md) + [MetricAttribution](API_MetricAttribution.md) + [MetricAttributionOutput](API_MetricAttributionOutput.md) + [MetricAttributionSummary](API_MetricAttributionSummary.md) + [OptimizationObjective](API_OptimizationObjective.md) + [Recipe](API_Recipe.md) + [RecipeSummary](API_RecipeSummary.md) + [Recommender](API_Recommender.md) + [RecommenderConfig](API_RecommenderConfig.md) + [RecommenderSummary](API_RecommenderSummary.md) + [RecommenderUpdateSummary](API_RecommenderUpdateSummary.md) + [S3DataConfig](API_S3DataConfig.md) + [Solution](API_Solution.md) + [SolutionConfig](API_SolutionConfig.md) + [SolutionSummary](API_SolutionSummary.md) + [SolutionUpdateConfig](API_SolutionUpdateConfig.md) + [SolutionUpdateSummary](API_SolutionUpdateSummary.md) + [SolutionVersion](API_SolutionVersion.md) + [SolutionVersionSummary](API_SolutionVersionSummary.md) + [Tag](API_Tag.md) + [ThemeGenerationConfig](API_ThemeGenerationConfig.md) + [TrainingDataConfig](API_TrainingDataConfig.md) + [TunedHPOParams](API_TunedHPOParams.md) Personalize 이벤트에서 지원하는 데이터 유형은 다음과 같습니다. + [Action](API_UBS_Action.md) + [ActionInteraction](API_UBS_ActionInteraction.md) + [Event](API_UBS_Event.md) + [Item](API_UBS_Item.md) + [MetricAttribution](API_UBS_MetricAttribution.md) + [User](API_UBS_User.md) Personalize 런타임에서 지원하는 데이터 유형은 다음과 같습니다. + [PredictedAction](API_RS_PredictedAction.md) + [PredictedItem](API_RS_PredictedItem.md) + [Promotion](API_RS_Promotion.md) # Personalize Personalize에서 지원하는 데이터 유형은 다음과 같습니다. + [Algorithm](API_Algorithm.md) + [AlgorithmImage](API_AlgorithmImage.md) + [AutoMLConfig](API_AutoMLConfig.md) + [AutoMLResult](API_AutoMLResult.md) + [AutoTrainingConfig](API_AutoTrainingConfig.md) + [BatchInferenceJob](API_BatchInferenceJob.md) + [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) + [BatchInferenceJobInput](API_BatchInferenceJobInput.md) + [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) + [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md) + [BatchSegmentJob](API_BatchSegmentJob.md) + [BatchSegmentJobInput](API_BatchSegmentJobInput.md) + [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) + [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md) + [Campaign](API_Campaign.md) + [CampaignConfig](API_CampaignConfig.md) + [CampaignSummary](API_CampaignSummary.md) + [CampaignUpdateSummary](API_CampaignUpdateSummary.md) + [CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md) + [ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md) + [DataDeletionJob](API_DataDeletionJob.md) + [DataDeletionJobSummary](API_DataDeletionJobSummary.md) + [Dataset](API_Dataset.md) + [DatasetExportJob](API_DatasetExportJob.md) + [DatasetExportJobOutput](API_DatasetExportJobOutput.md) + [DatasetExportJobSummary](API_DatasetExportJobSummary.md) + [DatasetGroup](API_DatasetGroup.md) + [DatasetGroupSummary](API_DatasetGroupSummary.md) + [DatasetImportJob](API_DatasetImportJob.md) + [DatasetImportJobSummary](API_DatasetImportJobSummary.md) + [DatasetSchema](API_DatasetSchema.md) + [DatasetSchemaSummary](API_DatasetSchemaSummary.md) + [DatasetSummary](API_DatasetSummary.md) + [DatasetUpdateSummary](API_DatasetUpdateSummary.md) + [DataSource](API_DataSource.md) + [DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md) + [DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md) + [DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md) + [DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md) + [EventParameters](API_EventParameters.md) + [EventsConfig](API_EventsConfig.md) + [EventTracker](API_EventTracker.md) + [EventTrackerSummary](API_EventTrackerSummary.md) + [FeatureTransformation](API_FeatureTransformation.md) + [FieldsForThemeGeneration](API_FieldsForThemeGeneration.md) + [Filter](API_Filter.md) + [FilterSummary](API_FilterSummary.md) + [HPOConfig](API_HPOConfig.md) + [HPOObjective](API_HPOObjective.md) + [HPOResourceConfig](API_HPOResourceConfig.md) + [HyperParameterRanges](API_HyperParameterRanges.md) + [IntegerHyperParameterRange](API_IntegerHyperParameterRange.md) + [MetricAttribute](API_MetricAttribute.md) + [MetricAttribution](API_MetricAttribution.md) + [MetricAttributionOutput](API_MetricAttributionOutput.md) + [MetricAttributionSummary](API_MetricAttributionSummary.md) + [OptimizationObjective](API_OptimizationObjective.md) + [Recipe](API_Recipe.md) + [RecipeSummary](API_RecipeSummary.md) + [Recommender](API_Recommender.md) + [RecommenderConfig](API_RecommenderConfig.md) + [RecommenderSummary](API_RecommenderSummary.md) + [RecommenderUpdateSummary](API_RecommenderUpdateSummary.md) + [S3DataConfig](API_S3DataConfig.md) + [Solution](API_Solution.md) + [SolutionConfig](API_SolutionConfig.md) + [SolutionSummary](API_SolutionSummary.md) + [SolutionUpdateConfig](API_SolutionUpdateConfig.md) + [SolutionUpdateSummary](API_SolutionUpdateSummary.md) + [SolutionVersion](API_SolutionVersion.md) + [SolutionVersionSummary](API_SolutionVersionSummary.md) + [Tag](API_Tag.md) + [ThemeGenerationConfig](API_ThemeGenerationConfig.md) + [TrainingDataConfig](API_TrainingDataConfig.md) + [TunedHPOParams](API_TunedHPOParams.md) # Algorithm 사용자 지정 알고리즘을 설명합니다. ## 내용 ** algorithmArn ** 알고리즘의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** algorithmImage ** 알고리즘 이미지에 대한 Docker 컨테이너의 URI입니다. 유형: [AlgorithmImage](API_AlgorithmImage.md)객체 필수 여부: 아니요 ** creationDateTime ** 알고리즘이 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** defaultHyperParameterRanges ** 기본 하이퍼파라미터, 범위, 조정 가능 여부를 지정합니다. 조정 가능한 하이퍼파라미터는 하이퍼파라미터 최적화(HPO) 중 값을 결정할 수 있습니다. 유형: [DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md)객체 필수 여부: 아니요 ** defaultHyperParameters ** 기본 하이퍼파라미터를 지정합니다. 유형: 문자열-문자열 맵 맵 항목: 최대 항목 수 100개. 키 길이 제약: 최대 길이 256. 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** defaultResourceConfig ** 기본 최대 학습 작업 및 병렬 학습 작업 수를 지정합니다. 유형: 문자열 간 맵 맵 항목: 최대 항목 수 100개. 키 길이 제약: 최대 길이 256. 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** lastUpdatedDateTime ** 알고리즘이 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 알고리즘의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** roleArn ** 역할의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** trainingInputMode ** 학습 입력 모드. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Algorithm) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Algorithm) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Algorithm) # AlgorithmImage 알고리즘 이미지를 설명합니다. ## 내용 ** dockerURI ** 알고리즘 이미지에 대한 Docker 컨테이너의 URI입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 예 ** name ** 알고리즘 이미지의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AlgorithmImage) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AlgorithmImage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AlgorithmImage) # AutoMLConfig 솔루션이 AutoML을 수행할 때([솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)에서 `performAutoML`이 true임) Personalize는 지정된 목록에서 지정된 지표를 최적화하는 레시피를 결정합니다. 그런 다음 Personalize는 해당 레시피를 솔루션에 사용합니다. ## 내용 ** metricName ** 최적화할 지표. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** recipeList ** 후보 레시피의 목록입니다. 유형: 문자열 어레이 어레이 멤버: 최대 항목 수 100개. 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoMLConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoMLConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoMLConfig) # AutoMLResult 솔루션이 AutoML을 수행하는 경우(`performAutoML`이 [솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)에서 true임) 지정된 지표를 가장 잘 최적화한 레시피를 지정합니다. ## 내용 ** bestRecipeArn ** 최적 레시피의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoMLResult) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoMLResult) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoMLResult) # AutoTrainingConfig `performAutoTraining`이 true일 때 사용할 자동 학습 구성입니다. ## 내용 ** schedulingExpression ** 새 솔루션 버전을 자동으로 학습시키는 빈도를 지정합니다. 비율 표현식을 비율(*값* *단위*) 형식으로 지정합니다. 값에 1\$130 사이의 숫자를 지정합니다. 단위의 경우 `day` 또는 `days`를 지정합니다. 예를 들어 5일마다 새 솔루션 버전을 자동으로 생성하려면 `rate(5 days)`를 지정합니다. 기본값은 7일마다 입니다. 자동 학습에 대한 자세한 내용은 [솔루션 생성 및 구성](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 16입니다. 패턴: `rate$\d+ days?$` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoTrainingConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoTrainingConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoTrainingConfig) # BatchInferenceJob 배치 추론 작업에 대한 정보가 포함되어 있습니다. ## 내용 ** batchInferenceJobArn ** 배치 추론 작업의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** batchInferenceJobConfig ** 배치 추론 작업의 구성 세부 정보의 문자열-문자열 맵. 유형: [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md)객체 필수 여부: 아니요 ** batchInferenceJobMode ** 작업 모드. 타입: 문자열 유효 값: `BATCH_INFERENCE | THEME_GENERATION` 필수 여부: 아니요 ** creationDateTime ** 배치 추론 작업이 생성된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 배치 추론 작업이 실패한 경우 실패의 원인입니다. 유형: 문자열 필수 여부: 아니요 ** filterArn ** 배치 추론 작업에 사용된 필터의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** jobInput ** 배치 추론 작업을 생성하는 데 사용되는 입력 데이터로 이어지는 S3 경로입니다. 유형: [BatchInferenceJobInput](API_BatchInferenceJobInput.md)객체 필수 여부: 아니요 ** jobName ** 배치 추론 작업의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** jobOutput ** 배치 추론 작업을 통해 생성된 출력 데이터가 들어 있는 S3 버킷. 유형: [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md)객체 필수 여부: 아니요 ** lastUpdatedDateTime ** 배치 추론 작업이 마지막으로 업데이트된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** numResults ** 배치 추론 작업에서 생성된 추천 수. 이 숫자에는 실패한 입력 레코드에 대해 생성된 오류 메시지가 포함됩니다. 유형: Integer 필수 여부: 아니요 ** roleArn ** 배치 추론 작업을 요청한 Amazon Identity and Access Management(IAM) 역할의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 아니요 ** solutionVersionArn ** 배치 추론 작업이 생성된 솔루션 버전의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 배치 추론 작업의 상태입니다. 상태는 다음 값 중 하나일 수 있습니다. + PENDING + IN PROGRESS + ACTIVE + CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** themeGenerationConfig ** 작업의 테마 생성 설정. 유형: [ThemeGenerationConfig](API_ThemeGenerationConfig.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJob) # BatchInferenceJobConfig 배치 추론 작업의 구성 세부 정보입니다. ## 내용 ** itemExplorationConfig ** Personalize가 항목을 추천할 때 사용하는 항목 탐색량을 구성하는 데 사용할 탐색 구성 하이퍼파라미터(`explorationWeight` 및 `explorationItemAgeCutOff`포함)를 지정하는 문자열-문자열 맵. [사용자-개인 맞춤](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html)을 참조하세요. 유형: 문자열-문자열 맵 맵 항목: 최대 항목 수 100개. 키 길이 제약: 최대 길이 256. 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** rankingInfluence ** POPULARITY 및 FRESHNESS에 대한 순위 영향 값의 맵입니다. 각 키에 대해 순위 요소가 최종 권장 사항에 미치는 영향을 결정하는 0.0에서 1.0 사이의 숫자 값을 지정합니다. 값이 1.0에 가까우면 계수에 더 많은 가중치가 부여되고, 값이 0.0에 가까우면 영향을 줄일 수 있습니다. 지정하지 않으면 둘 다 기본값은 0.0입니다. 유형: 문자열-double 맵 유효한 키: `POPULARITY | FRESHNESS` 유효한 범위: 최소값 0. 최댓값은 1. 필수 여부: 아니요 ## 참고 언어별AWSSDKs + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobConfig) + [AWSJava V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobConfig) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobConfig) # BatchInferenceJobInput 배치 추론 작업의 입력 구성. ## 내용 ** s3DataSource ** 입력 데이터가 포함된 S3 위치의 URI입니다. S3 버킷이 호출하는 API 엔드포인트와 동일한 리전에 있어야 합니다. 유형: [S3DataConfig](API_S3DataConfig.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobInput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobInput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobInput) # BatchInferenceJobOutput 배치 추론 작업의 출력 구성 파라미터. ## 내용 ** s3DataDestination ** 배치 추론 작업의 출력이 저장된 S3 버킷에 대한 정보입니다. 유형: [S3DataConfig](API_S3DataConfig.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobOutput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobOutput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobOutput) # BatchInferenceJobSummary [Batch InferenceJob](https://docs.aws.amazon.com/personalize/latest/dg/API_BatchInferenceJob.html)의 잘린 버전. [ListBatchInferenceJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListBatchInferenceJobs.html) 작업은 배치 추론 작업 요약 목록을 반환합니다. ## 내용 ** batchInferenceJobArn ** 배치 추론 작업의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** batchInferenceJobMode ** 작업 모드. 타입: 문자열 유효 값: `BATCH_INFERENCE | THEME_GENERATION` 필수 여부: 아니요 ** creationDateTime ** 배치 추론 작업이 생성된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 배치 추론 작업이 실패한 경우 실패의 원인입니다. 유형: 문자열 필수 여부: 아니요 ** jobName ** 배치 추론 작업의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** lastUpdatedDateTime ** 배치 추론 작업이 마지막으로 업데이트된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** solutionVersionArn ** 배치 추론 작업에 사용된 솔루션 버전의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 배치 추론 작업의 상태입니다. 상태는 다음 값 중 하나일 수 있습니다. + PENDING + IN PROGRESS + ACTIVE + CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobSummary) # BatchSegmentJob 배치 세그먼트 작업에 대한 정보가 들어 있습니다. ## 내용 ** batchSegmentJobArn ** 배치 세그먼트 작업의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** creationDateTime ** 배치 세그먼트 작업이 생성된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 배치 세그먼트 작업이 실패한 경우 실패의 원인입니다. 유형: 문자열 필수 여부: 아니요 ** filterArn ** 배치 세그먼트 작업에 사용된 필터의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** jobInput ** 배치 세그먼트 작업을 생성하는 데 사용되는 입력 데이터로 이어지는 S3 경로입니다. 유형: [BatchSegmentJobInput](API_BatchSegmentJobInput.md)객체 필수 여부: 아니요 ** jobName ** 배치 세그먼트 작업의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** jobOutput ** 배치 세그먼트 작업을 통해 생성된 출력 데이터가 들어 있는 S3 버킷. 유형: [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md)객체 필수 여부: 아니요 ** lastUpdatedDateTime ** 배치 세그먼트 작업이 마지막으로 업데이트된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** numResults ** 입력 데이터의 각 라인에 대해 배치 세그먼트 작업으로 생성된 예상 사용자 수입니다. 세그먼트당 최대 사용자 수는 5백만 명입니다. 유형: Integer 필수 여부: 아니요 ** roleArn ** 배치 세그먼트 작업을 요청한 Amazon Identity and Access Management(IAM) 역할의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 아니요 ** solutionVersionArn ** 배치 세그먼트 작업이 배치 세그먼트를 생성할 때 사용한 솔루션 버전의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 배치 세그먼트 작업의 상태입니다. 상태는 다음 값 중 하나일 수 있습니다. + PENDING + IN PROGRESS + ACTIVE + CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJob) # BatchSegmentJobInput 배치 세그먼트 작업의 입력 구성. ## 내용 ** s3DataSource ** S3 입력 또는 출력 버킷의 구성 세부 정보입니다. 유형: [S3DataConfig](API_S3DataConfig.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobInput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobInput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobInput) # BatchSegmentJobOutput 배치 세그먼트 작업의 출력 구성 파라미터. ## 내용 ** s3DataDestination ** S3 입력 또는 출력 버킷의 구성 세부 정보입니다. 유형: [S3DataConfig](API_S3DataConfig.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobOutput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobOutput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobOutput) # BatchSegmentJobSummary [배치 세그먼트 작업](https://docs.aws.amazon.com/personalize/latest/dg/API_BatchSegmentJob.html) 데이터 유형의 잘린 버전. [List배치 세그먼트 작업s](https://docs.aws.amazon.com/personalize/latest/dg/API_ListBatchSegmentJobs.html) 작업은 배치 세그먼트 작업 요약 목록을 반환합니다. ## 내용 ** batchSegmentJobArn ** 배치 세그먼트 작업의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** creationDateTime ** 배치 세그먼트 작업이 생성된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 배치 세그먼트 작업이 실패한 경우 실패의 원인입니다. 유형: 문자열 필수 여부: 아니요 ** jobName ** 배치 세그먼트 작업의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** lastUpdatedDateTime ** 배치 세그먼트 작업이 마지막으로 업데이트된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** solutionVersionArn ** 배치 세그먼트 작업이 배치 세그먼트를 생성할 때 사용한 솔루션 버전의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 배치 세그먼트 작업의 상태입니다. 상태는 다음 값 중 하나일 수 있습니다. + PENDING + IN PROGRESS + ACTIVE + CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobSummary) # Campaign 솔루션 버전의 배포를 설명하는 객체입니다. 캠페인에 대한 자세한 내용은 [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html) 단원을 참조하세요. ## 내용 ** campaignArn ** 캠페인의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** campaignConfig ** 캠페인의 구성 세부 정보입니다. 유형: [CampaignConfig](API_CampaignConfig.md)객체 필수 여부: 아니요 ** creationDateTime ** 캠페인을 만든 날짜 및 시간(Unix 형식) 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 캠페인이 실패할 경우, 실패의 원인. 유형: 문자열 필수 여부: 아니요 ** lastUpdatedDateTime ** 캠페인이 마지막으로 업데이트된 날짜 및 시간(Unix 형식). 유형: 타임스탬프 필수 여부: 아니요 ** latestCampaignUpdate ** 캠페인 업데이트 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API를 호출합니다. `latestCampaignUpdate` 필드는 캠페인에 하나 이상의 `UpdateCampaign` 직접 호출이 있는 경우에만 반환됩니다. 유형: [CampaignUpdateSummary](API_CampaignUpdateSummary.md)객체 필수 여부: 아니요 ** minProvisionedTPS ** 초당 요청된 최소 프로비저닝 트랜잭션(추천)을 지정합니다. `minProvisionedTPS`가 높으면 요금이 인상됩니다. `minProvisionedTPS`(기본값)의 경우 1부터 시작하는 것이 좋습니다. Amazon CloudWatch 지표를 사용하여 사용량을 추적하고 필요에 따라 `minProvisionedTPS`를 늘리세요. 타입: 정수 유효 범위: 최소값 1. 필수 여부: 아니요 ** name ** 캠페인의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** solutionVersionArn ** 캠페인에서 사용하는 솔루션 버전의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 캠페인의 상태입니다. 캠페인은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Campaign) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Campaign) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Campaign) # CampaignConfig 캠페인의 구성 세부 정보입니다. ## 내용 ** enableMetadataWithRecommendations ** 추천이 포함된 메타데이터가 캠페인에 활성화되어 있는지 여부입니다. 활성화한 경우 추천 요청에 항목 데이터 세트의 열을 지정할 수 있습니다. Amazon Personalize는 추천 응답의 각 항목에 대해 이 데이터를 반환합니다. 캠페인용 메타데이터 활성화에 대한 자세한 내용은 [캠페인용 추천의 메타데이터 활성화](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata)를 참조하세요. 추천에서 메타데이터를 활성화하면 추가 비용이 발생합니다. 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요. 유형: 부울 필수 항목 여부: 아니요 ** itemExplorationConfig ** Personalize가 항목을 추천할 때 사용하는 항목 탐색량을 구성하는 데 사용할 탐색 구성 하이퍼파라미터(`explorationWeight` 및 `explorationItemAgeCutOff`포함)를 지정합니다. 솔루션에서 [사용자-개인 맞춤](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html) 레시피를 사용하는 경우에만 `itemExplorationConfig`데이터를 제공합니다. 유형: 문자열-문자열 맵 맵 항목: 최대 항목 수 100개. 키 길이 제약: 최대 길이 256. 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** rankingInfluence ** POPULARITY 및 FRESHNESS에 대한 순위 영향 값의 맵입니다. 각 키에 대해 순위 요소가 최종 권장 사항에 미치는 영향을 결정하는 0.0에서 1.0 사이의 숫자 값을 지정합니다. 값이 1.0에 가까우면 계수에 더 많은 가중치가 부여되고, 값이 0.0에 가까우면 영향을 줄일 수 있습니다. 지정하지 않으면 둘 다 기본값은 0.0입니다. 유형: 문자열-double 맵 유효한 키: `POPULARITY | FRESHNESS` 유효한 범위: 최소값 0. 최댓값은 1. 필수 여부: 아니요 ** syncWithLatestSolutionVersion ** 캠페인이 솔루션의 최신 솔루션 버전(학습된 모델)을 사용하도록 자동으로 업데이트되는지 여부입니다. `True`를 지정하는 경우 `SolutionVersionArn` 파라미터에 대해 *솔루션*의 ARN을 지정해야 합니다. `SolutionArn/$LATEST` 형식이어야 합니다. 기본값은 `False`이며 캠페인을 수동으로 업데이트하여 최신 솔루션 버전을 배포해야 합니다. 자동 캠페인 업데이트에 대한 자세한 내용은 [자동 캠페인 업데이트 활성화](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update) 섹션을 참조하세요. 유형: 부울 필수 여부: 아니요 ## 참고 언어별AWSSDKs + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignConfig) + [AWSJava V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignConfig) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignConfig) # CampaignSummary 캠페인의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API를 호출합니다. ## 내용 ** campaignArn ** 캠페인의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** creationDateTime ** 캠페인이 생성된 날짜 및 시간(Unix 시간) 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 캠페인이 실패할 경우, 실패의 원인. 유형: 문자열 필수 여부: 아니요 ** lastUpdatedDateTime ** 캠페인이 마지막으로 업데이트된 날짜 및 시간(Unix 시간)입니다. 유형: 타임스탬프 필수 여부: 아니요 ** name ** 캠페인의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** status ** 캠페인의 상태입니다. 캠페인은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignSummary) # CampaignUpdateSummary 캠페인 업데이트 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API를 호출합니다. ## 내용 ** campaignConfig ** 캠페인의 구성 세부 정보입니다. 유형: [CampaignConfig](API_CampaignConfig.md)객체 필수 여부: 아니요 ** creationDateTime ** 캠페인 업데이트가 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 캠페인 업데이트가 실패할 경우, 실패의 원인. 유형: 문자열 필수 여부: 아니요 ** lastUpdatedDateTime ** 캠페인이 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** minProvisionedTPS ** Personalize에서 지원할 초당 요청된 최소 프로비저닝 트랜잭션(추천)을 지정합니다. 타입: 정수 유효 범위: 최소값 1. 필수 여부: 아니요 ** solutionVersionArn ** 배포된 솔루션 버전의 Amazon 리소스 이름(ARN) 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 캠페인 업데이트의 상태입니다. 캠페인 업데이트는 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignUpdateSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignUpdateSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignUpdateSummary) # CategoricalHyperParameterRange 범주형 하이퍼파라미터의 이름과 범위를 제공합니다. ## 내용 ** name ** 하이퍼파라미터의 이름입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** values ** 하이퍼파라미터의 범주 목록입니다. 유형: 문자열 어레이 어레이 멤버: 최대 항목 수 100개. 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CategoricalHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CategoricalHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CategoricalHyperParameterRange) # ContinuousHyperParameterRange 지속적 하이퍼파라미터의 이름과 범위를 제공합니다. ## 내용 ** maxValue ** 하이퍼파라미터에 허용되는 최대값. 유형: Double 유효 범위: 최소값 -1000000. 필수 여부: 아니요 ** minValue ** 하이퍼파라미터에 허용되는 최소값. 유형: Double 유효 범위: 최소값 -1000000. 필수 여부: 아니요 ** name ** 하이퍼파라미터의 이름입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ContinuousHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ContinuousHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ContinuousHyperParameterRange) # DataDeletionJob Amazon Personalize 데이터세트 그룹에서 특정 사용자에 대한 모든 참조를 일괄적으로 삭제하는 작업에 대해 설명합니다. 데이터 삭제 작업 생성에 대한 자세한 내용은 [사용자 삭제](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html)를 참조하세요. ## 내용 ** creationDateTime ** 데이터 삭제 작업의 생성 날짜 및 시간(Unix 시간)입니다. 유형: 타임스탬프 필수 여부: 아니요 ** dataDeletionJobArn ** 데이터 삭제 작업의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** datasetGroupArn ** 작업이 레코드를 삭제하는 데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** dataSource ** 데이터세트에 업로드할 데이터 또는 Amazon Personalize에서 삭제할 레코드 목록이 포함된 데이터 소스를 설명합니다. 유형: [DataSource](API_DataSource.md)객체 필수 여부: 아니요 ** failureReason ** 데이터 삭제 작업이 실패한 경우 그 이유를 제공합니다. 유형: 문자열 필수 여부: 아니요 ** jobName ** 데이터 삭제 작업의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** lastUpdatedDateTime ** 데이터 삭제 작업이 마지막으로 업데이트된 날짜 및 시간(Unix 시간)입니다. 유형: 타임스탬프 필수 여부: 아니요 ** numDeleted ** COMPLETED 작업에서 삭제된 레코드 수입니다. 유형: Integer 필수 여부: 아니요 ** roleArn ** Amazon S3 데이터 소스에서 읽을 권한이 있는 IAM 역할의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 아니요 ** status ** 데이터 삭제 작업의 상태입니다. 데이터 삭제 작업은 다음 상태 중 하나를 가질 수 있습니다. + 보류 중 > 진행 중 > 완료 또는 실패 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataDeletionJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataDeletionJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataDeletionJob) # DataDeletionJobSummary 데이터 삭제 작업의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) API 작업을 직접적으로 호출합니다. ## 내용 ** creationDateTime ** 데이터 삭제 작업의 생성 날짜 및 시간(Unix 시간)입니다. 유형: 타임스탬프 필수 여부: 아니요 ** dataDeletionJobArn ** 데이터 삭제 작업의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** datasetGroupArn ** 작업이 레코드를 삭제하는 데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** failureReason ** 데이터 삭제 작업이 실패한 경우 그 이유를 제공합니다. 유형: 문자열 필수 여부: 아니요 ** jobName ** 데이터 삭제 작업의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** lastUpdatedDateTime ** 데이터 삭제 작업이 마지막으로 업데이트된 날짜 및 시간(Unix 시간)입니다. 유형: 타임스탬프 필수 여부: 아니요 ** status ** 데이터 삭제 작업의 상태입니다. 데이터 삭제 작업은 다음 상태 중 하나를 가질 수 있습니다. + 보류 중 > 진행 중 > 완료 또는 실패 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataDeletionJobSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataDeletionJobSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataDeletionJobSummary) # Dataset 데이터세트에 대한 메타데이터를 제공합니다. ## 내용 ** creationDateTime ** 데이터세트 생성 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** datasetArn ** 메타데이터를 원하는 데이터세트의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** datasetGroupArn ** 데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** datasetType ** 다음 값 중 하나입니다. + 상호작용 + Items + Users + 작업 + Action\$1Interactions 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `^[A-Za-z_]+$` 필수 여부: 아니요 ** lastUpdatedDateTime ** 데이터세트가 업데이트된 시기를 보여주는 타임스탬프. 유형: 타임스탬프 필수 여부: 아니요 ** latestDatasetUpdate ** 데이터세트의 최신 업데이트를 설명합니다. 유형: [DatasetUpdateSummary](API_DatasetUpdateSummary.md)객체 필수 여부: 아니요 ** name ** 데이터세트의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** schemaArn ** 연결된 스키마의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 데이터세트의 상태입니다. 데이터세트는 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** trackingId ** 작업 상호 작용 데이터 세트의 이벤트 트래커 ID입니다. `PutActionInteractions` API 작업에서 트래커의 ID를 지정합니다. Amazon Personalize는 이를 사용하여 새 데이터를 데이터 세트 그룹의 작업 상호 작용 데이터 세트로 전달합니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별AWSSDKs + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Dataset) + [AWSJava V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Dataset) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Dataset) # DatasetExportJob 데이터세트를 S3 버킷으로 내보내는 작업을 설명합니다. 자세한 내용은 [CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html)을 참조하세요. 데이터세트 내보내기 작업은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED ## 내용 ** creationDateTime ** 데이터세트 내보내기 작업의 생성 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** datasetArn ** 내보낼 데이터세트의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** datasetExportJobArn ** 데이터세트 내보내기 작업의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** failureReason ** 데이터세트 내보내기 작업이 실패한 경우 그 이유를 제공합니다. 유형: 문자열 필수 여부: 아니요 ** ingestionMode ** 데이터를 가져온 방식에 따라 내보낼 데이터. 데이터세트 가져오기 작업을 사용하여 가져온 `BULK`데이터를 내보내거나, 콘솔, PutEvents, PutUsers 및 PutItems 작업을 사용하여 점증적으로 가져온 `PUT`데이터를 내보내거나, 두 유형 모두에 대해 `ALL`을 내보내도록 선택할 수 있습니다. 기본 값은 `PUT`입니다. 타입: 문자열 유효 값: `BULK | PUT | ALL` 필수 여부: 아니요 ** jobName ** 내보내기 작업의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** jobOutput ** 작업의 출력이 저장되는 S3 버킷의 경로입니다. 예: `s3://bucket-name/folder-name/` 유형: [DatasetExportJobOutput](API_DatasetExportJobOutput.md)객체 필수 여부: 아니요 ** lastUpdatedDateTime ** 데이터세트 내보내기 작업의 상태가 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** roleArn ** 출력 S3 버킷에 데이터를 추가할 권한이 있는 IAM 서비스 역할의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 데이터세트 내보내기 작업의 상태입니다. 데이터세트 내보내기 작업은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJob) # DatasetExportJobOutput 데이터세트 내보내기 작업의 출력 구성 파라미터. ## 내용 ** s3DataDestination ** S3 입력 또는 출력 버킷의 구성 세부 정보입니다. 유형: [S3DataConfig](API_S3DataConfig.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJobOutput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJobOutput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJobOutput) # DatasetExportJobSummary 데이터세트 내보내기 작업의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html) API를 호출합니다. ## 내용 ** creationDateTime ** 데이터세트 내보내기 작업이 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** datasetExportJobArn ** 데이터세트 내보내기 작업의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** failureReason ** 데이터세트 내보내기 작업이 실패할 경우, 실패의 원인. 유형: 문자열 필수 여부: 아니요 ** jobName ** 데이터세트 내보내기 작업의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** lastUpdatedDateTime ** 데이터세트 내보내기 작업 상태가 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** status ** 데이터세트 내보내기 작업의 상태입니다. 데이터세트 내보내기 작업은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJobSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJobSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJobSummary) # DatasetGroup 데이터 세트 그룹은 관련 데이터 세트(항목 상호 작용, 사용자, 항목, 작업, 작업 상호 작용)의 모음입니다. [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html)을 호출하여 데이터세트 그룹을 생성합니다. 그런 다음 데이터세트를 생성하고 [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html)를 호출하여 데이터세트 그룹에 추가합니다. 데이터세트 그룹은 [솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)을 호출하여 솔루션을 생성하고 교육하는 데 사용됩니다. 데이터세트 그룹에는 한 가지 유형의 데이터세트만 포함되어 있을 수 있습니다. AWS Key Management Service(KMS) 키를 지정하여 그룹의 데이터세트를 암호화할 수 있습니다. ## 내용 ** creationDateTime ** 데이터세트 그룹의 생성 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** datasetGroupArn ** 데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** domain ** 도메인 데이터세트 그룹의 도메인. 타입: 문자열 유효 값: `ECOMMERCE | VIDEO_ON_DEMAND` 필수 여부: 아니요 ** failureReason ** 데이터세트 그룹 생성이 실패할 경우 이유를 제공합니다. 유형: 문자열 필수 여부: 아니요 ** kmsKeyArn ** 데이터세트를 암호화하는 데 사용되는 AWS Key Management Service(KMS) 키의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` 필수 여부: 아니요 ** lastUpdatedDateTime ** 데이터세트 그룹의 마지막 업데이트 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 데이터세트 그룹의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** roleArn ** AWS Key Management Service(KMS) 키에 액세스할 수 있는 권한이 있는 AWS Identity and Access Management(IAM) 역할의 ARN입니다. IAM 역할을 제공하는 것은 KMS 키를 함께 지정하는 경우에만 유효합니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 아니요 ** status ** 데이터세트 그룹의 현재 상태입니다. 데이터세트 그룹은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetGroup) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetGroup) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetGroup) # DatasetGroupSummary 데이터세트 그룹의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) API를 호출합니다. ## 내용 ** creationDateTime ** 데이터세트 그룹이 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** datasetGroupArn ** 데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** domain ** 도메인 데이터세트 그룹의 도메인. 타입: 문자열 유효 값: `ECOMMERCE | VIDEO_ON_DEMAND` 필수 여부: 아니요 ** failureReason ** 데이터세트 그룹 생성이 실패할 경우, 실패의 원인. 유형: 문자열 필수 여부: 아니요 ** lastUpdatedDateTime ** 데이터세트 그룹이 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 데이터세트 그룹의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** status ** 데이터세트 그룹의 상태입니다. 데이터세트 그룹은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetGroupSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetGroupSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetGroupSummary) # DatasetImportJob 데이터 소스(S3 버킷)에서 Personalize 데이터세트로 학습 데이터를 가져오는 작업을 설명합니다. 자세한 내용을 알아보려면 [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)을 참조하세요. 데이터세트 가져오기 작업은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED ## 내용 ** creationDateTime ** 데이터세트 가져오기 작업의 생성 날짜 및 시간(Unix 시간) 유형: 타임스탬프 필수 여부: 아니요 ** datasetArn ** 가져온 데이터를 수신하는 데이터세트의 Amazon 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** datasetImportJobArn ** 데이터세트 가져오기 작업의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** dataSource ** 가져올 학습 데이터가 들어 있는 S3 버킷. 유형: [DataSource](API_DataSource.md)객체 필수 여부: 아니요 ** failureReason ** 데이터세트 가져오기 작업이 실패할 경우 그 이유를 제공합니다. 유형: 문자열 필수 여부: 아니요 ** importMode ** 데이터세트 가져오기 작업에서 새 레코드를 가져오는 데 사용되는 가져오기 모드. 타입: 문자열 유효 값: `FULL | INCREMENTAL` 필수 여부: 아니요 ** jobName ** 가져오기 작업의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** lastUpdatedDateTime ** 데이터세트가 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** publishAttributionMetricsToS3 ** 작업이 지표 어트리뷰션을 위해 S3에 지표를 게시하는지 여부. 유형: 부울 필수 여부: 아니요 ** roleArn ** S3 데이터 소스에서 읽을 권한이 있는 IAM 역할의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 데이터세트 가져오기 작업의 상태입니다. 데이터세트 가져오기 작업은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetImportJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetImportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetImportJob) # DatasetImportJobSummary 데이터세트 가져오기 작업의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) API를 호출합니다. ## 내용 ** creationDateTime ** 데이터세트 가져오기 작업이 생성된 날짜 및 시간(Unix 시간) 유형: 타임스탬프 필수 여부: 아니요 ** datasetImportJobArn ** 데이터세트 가져오기 작업의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** failureReason ** 데이터세트 가져오기 작업이 실패할 경우, 실패의 원인. 유형: 문자열 필수 여부: 아니요 ** importMode ** 데이터세트 가져오기 작업이 데이터세트의 데이터를 업데이트하는 데 사용된 가져오기 모드. 자세한 내용은 [기존 대량 데이터 업데이트](https://docs.aws.amazon.com/personalize/latest/dg/updating-existing-bulk-data.html)를 참조하세요. 타입: 문자열 유효 값: `FULL | INCREMENTAL` 필수 여부: 아니요 ** jobName ** 데이터세트 가져오기 작업의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** lastUpdatedDateTime ** 데이터세트 가져오기 작업 상태가 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** status ** 데이터세트 가져오기 작업의 상태입니다. 데이터세트 가져오기 작업은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetImportJobSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetImportJobSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetImportJobSummary) # DatasetSchema 데이터세트의 스키마를 설명합니다. 스키마에 대한 자세한 내용은 [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html) 단원을 참조하세요. ## 내용 ** creationDateTime ** 스키마가 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** domain ** 도메인 데이터세트 그룹의 데이터세트에 대해 생성한 스키마의 도메인. 타입: 문자열 유효 값: `ECOMMERCE | VIDEO_ON_DEMAND` 필수 여부: 아니요 ** lastUpdatedDateTime ** 스키마가 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 스키마의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** schema ** 스키마. 유형: 문자열 길이 제약: 최대 길이는 20,000입니다. 필수 여부: 아니요 ** schemaArn ** 스키마의 Amazon 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSchema) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSchema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSchema) # DatasetSchemaSummary 데이터세트 스키마의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSchema.html) API를 호출합니다. ## 내용 ** creationDateTime ** 스키마가 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** domain ** 도메인 데이터세트 그룹의 데이터세트에 대해 생성한 스키마의 도메인. 타입: 문자열 유효 값: `ECOMMERCE | VIDEO_ON_DEMAND` 필수 여부: 아니요 ** lastUpdatedDateTime ** 스키마가 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 스키마의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** schemaArn ** 스키마의 Amazon 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSchemaSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSchemaSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSchemaSummary) # DatasetSummary 데이터세트의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) API를 호출합니다. ## 내용 ** creationDateTime ** 데이터세트가 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** datasetArn ** 데이터세트의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** datasetType ** 데이터세트 유형. 다음 값 중 하나입니다. + 상호작용 + Items + Users + 이벤트 상호작용 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `^[A-Za-z_]+$` 필수 여부: 아니요 ** lastUpdatedDateTime ** 데이터세트가 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 데이터세트의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** status ** 데이터세트의 상태입니다. 데이터세트는 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별AWSSDKs + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSummary) + [AWSJava V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSummary) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSummary) # DatasetUpdateSummary 데이터세트 업데이트에 대해 설명합니다. ## 내용 ** creationDateTime ** 데이터세트 업데이트의 생성 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 데이터세트 업데이트가 실패할 경우 그 이유를 제공합니다. 유형: 문자열 필수 여부: 아니요 ** lastUpdatedDateTime ** 데이터세트의 마지막 업데이트 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** schemaArn ** 데이터세트의 이전 스키마를 대체한 스키마의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 데이터세트 업데이트의 상태. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetUpdateSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetUpdateSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetUpdateSummary) # DataSource 데이터세트에 업로드할 데이터 또는 Amazon Personalize에서 삭제할 레코드 목록이 포함된 데이터 소스를 설명합니다. ## 내용 ** dataLocation ** 데이터세트 가져오기 작업의 경우 데이터세트에 업로드하려는 데이터가 저장되는 Amazon S3 버킷의 경로입니다. 데이터 삭제 작업의 경우 삭제할 레코드 목록을 저장하는 Amazon S3 버킷의 경로입니다. 예: `s3://bucket-name/folder-name/fileName.csv` CSV 파일이 Amazon S3 버킷의 폴더에 있고 가져오기 작업 또는 데이터 삭제 작업에서 여러 파일을 고려하도록 할 경우 폴더 경로를 지정할 수 있습니다. 데이터 삭제 작업을 통해 Amazon Personalize는 폴더와 하위 폴더의 모든 파일을 사용합니다. 폴더 이름 뒤에 `/`가 있는 다음 구문을 사용하세요. `s3://bucket-name/folder-name/` 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `(s3|http|https)://.+` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataSource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataSource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataSource) # DefaultCategoricalHyperParameterRange 범주형 하이퍼파라미터의 이름과 기본 범위 및 하이퍼파라미터의 조정 가능 여부를 제공합니다. 조정 가능한 하이퍼파라미터는 하이퍼파라미터 최적화(HPO) 중 값을 결정할 수 있습니다. ## 내용 ** isTunable ** 하이퍼파라미터의 조정 가능 여부. 유형: 부울 필수 여부: 아니요 ** name ** 하이퍼파라미터의 이름입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** values ** 하이퍼파라미터의 범주 목록입니다. 유형: 문자열 어레이 어레이 멤버: 최대 항목 수 100개. 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) # DefaultContinuousHyperParameterRange 지속적 하이퍼파라미터의 이름과 기본 범위 및 하이퍼파라미터의 조정 가능 여부를 제공합니다. 조정 가능한 하이퍼파라미터는 하이퍼파라미터 최적화(HPO) 중 값을 결정할 수 있습니다. ## 내용 ** isTunable ** 하이퍼파라미터의 조정 가능 여부. 유형: 부울 필수 여부: 아니요 ** maxValue ** 하이퍼파라미터에 허용되는 최대값. 유형: Double 유효 범위: 최소값 -1000000. 필수 여부: 아니요 ** minValue ** 하이퍼파라미터에 허용되는 최소값. 유형: Double 유효 범위: 최소값 -1000000. 필수 여부: 아니요 ** name ** 하이퍼파라미터의 이름입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultContinuousHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultContinuousHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultContinuousHyperParameterRange) # DefaultHyperParameterRanges 하이퍼파라미터와 해당 기본 범위를 지정합니다. 하이퍼파라미터에는 범주형, 연속 또는 정수 값이 지정될 수 있습니다. ## 내용 ** categoricalHyperParameterRanges ** 범주형 하이퍼파라미터와 해당 기본 범위. 유형: [DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. 필수 여부: 아니요 ** continuousHyperParameterRanges ** 지속적 하이퍼파라미터와 기본 범위. 유형: [DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. 필수 여부: 아니요 ** integerHyperParameterRanges ** 정수 값 하이퍼파라미터와 해당 기본 범위. 유형: [DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultHyperParameterRanges) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultHyperParameterRanges) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultHyperParameterRanges) # DefaultIntegerHyperParameterRange 정수 값 하이퍼파라미터의 이름과 기본 범위, 하이퍼파라미터의 조정 가능 여부를 제공합니다. 조정 가능한 하이퍼파라미터는 하이퍼파라미터 최적화(HPO) 중 값을 결정할 수 있습니다. ## 내용 ** isTunable ** 하이퍼파라미터를 조정할 수 있는지 여부를 나타냅니다. 유형: 부울 필수 여부: 아니요 ** maxValue ** 하이퍼파라미터에 허용되는 최대값. 유형: 정수 유효 범위: 최대값 1000000. 필수 여부: 아니요 ** minValue ** 하이퍼파라미터에 허용되는 최소값. 유형: 정수 유효 범위: 최소값 -1000000. 필수 여부: 아니요 ** name ** 하이퍼파라미터의 이름입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultIntegerHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultIntegerHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultIntegerHyperParameterRange) # EventParameters 솔루션 생성에 사용되는 이벤트의 파라미터를 설명합니다. ## 내용 ** eventType ** 솔루션 생성에 고려할 이벤트 유형의 이름입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** eventValueThreshold ** 이벤트 유형의 임계값입니다. 값이 이 임계값보다 크거나 같은 이벤트만 솔루션 생성에 고려됩니다. 유형: 더블 필수 여부: 아니요 ** weight ** 이벤트 유형의 가중치입니다. 가중치가 높을수록 생성된 솔루션에서 해당 이벤트 유형의 중요도가 높아집니다. 유형: Double 유효한 범위: 최소값 0. 최댓값은 1. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventParameters) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventParameters) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventParameters) # EventsConfig 솔루션 생성에 사용되는 이벤트의 구성을 설명합니다. ## 내용 ** eventParametersList ** 이벤트 유형과 이벤트 값 임계치 및 가중치를 포함하는 이벤트 파라미터 목록입니다. 유형: [EventParameters](API_EventParameters.md)객체 어레이 어레이 멤버: 최대 항목 수 10개. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventsConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventsConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventsConfig) # EventTracker 이벤트 트래커에 대한 정보를 제공합니다. ## 내용 ** accountId ** 이벤트 트래커를 소유하고 있는 AWS계정. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** creationDateTime ** 이벤트 트래커가 생성된 날짜 및 시간(Unix 형식). 유형: 타임스탬프 필수 여부: 아니요 ** datasetGroupArn ** 이벤트 데이터를 수신하는 데이터세트 그룹의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** eventTrackerArn ** 이벤트 트래커의 ARN. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** lastUpdatedDateTime ** 이벤트 트래커가 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 이벤트 트래커의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** status ** 이벤트 트래커의 상태. 이벤트 트래커는 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** trackingId ** 이벤트 트래커의 ID. [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API에 대한 요청에 이 ID를 포함시킵니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventTracker) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventTracker) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventTracker) # EventTrackerSummary 이벤트 트래커의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html) API를 호출합니다. ## 내용 ** creationDateTime ** 이벤트 트래커가 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** eventTrackerArn ** 이벤트 트래커의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** lastUpdatedDateTime ** 이벤트 트래커가 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 이벤트 트래커의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** status ** 이벤트 트래커의 상태. 이벤트 트래커는 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventTrackerSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventTrackerSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventTrackerSummary) # FeatureTransformation 특성 변환 정보를 제공합니다. 특성 변환은 원시 입력 데이터를 모델 학습에 더 적합한 형태로 수정하는 프로세스입니다. ## 내용 ** creationDateTime ** 특성 변환의 생성 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** defaultParameters ** 특성 변환을 위한 기본 파라미터를 제공합니다. 유형: 문자열-문자열 맵 맵 항목: 최대 항목 수 100개. 키 길이 제약: 최대 길이 256. 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** featureTransformationArn ** 특성 변환 객체의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** lastUpdatedDateTime ** 특성 변환의 마지막 업데이트 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 특성 변환의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** status ** 특성 변환의 상태. 특성 변환은 다음 중 하나의 상태일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FeatureTransformation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FeatureTransformation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FeatureTransformation) # FieldsForThemeGeneration 테마 생성을 위한 구성 세부 정보의 문자열-문자열 맵. ## 내용 ** itemName ** 데이터 세트에 있는 각 항목의 이름을 저장하는 항목 데이터 세트 열의 이름. 유형: 문자열 길이 제약: 최대 길이 150. 패턴: `[A-Za-z_][A-Za-z\d_]*` 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FieldsForThemeGeneration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FieldsForThemeGeneration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FieldsForThemeGeneration) # Filter ARN, 상태, 필터 표현식 등 추천 필터에 대한 정보가 들어 있습니다. ## 내용 ** creationDateTime ** 필터가 생성된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** datasetGroupArn ** 필터가 속한 데이터세트 그룹의 ARN. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** failureReason ** 필터가 실패한 경우 실패 원인. 유형: 문자열 필수 여부: 아니요 ** filterArn ** 필터의 ARN. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** filterExpression ** 추천 결과에서 필터로 걸러낼 항목 상호작용 유형을 지정합니다. 필터 표현식은 특정 형식 규칙을 따라야 합니다. 필터 표현식 구조 및 구문에 대한 정보는 [필터 표현식](https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html) 단원을 참조하세요. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 2500. 필수 여부: 아니요 ** lastUpdatedDateTime ** 필터가 마지막으로 업데이트된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** name ** 필터의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** status ** 필터의 상태. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Filter) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Filter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Filter) # FilterSummary 필터 속성의 간략한 요약. ## 내용 ** creationDateTime ** 필터가 생성된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** datasetGroupArn ** 필터가 속한 데이터세트 그룹의 ARN. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** failureReason ** 필터가 실패한 경우 실패 원인. 유형: 문자열 필수 여부: 아니요 ** filterArn ** 필터의 ARN. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** lastUpdatedDateTime ** 필터가 마지막으로 업데이트된 시간. 유형: 타임스탬프 필수 여부: 아니요 ** name ** 필터의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** status ** 필터의 상태. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FilterSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FilterSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FilterSummary) # HPOConfig 하이퍼파라미터 최적화(HPO)에 대한 속성을 설명합니다. ## 내용 ** algorithmHyperParameterRanges ** 하이퍼파라미터와 해당 허용 범위. 유형: [HyperParameterRanges](API_HyperParameterRanges.md)객체 필수 여부: 아니요 ** hpoObjective ** HPO 중 최적화할 지표. Personalize는 현재 `hpoObjective`구성을 지원하지 않습니다. 유형: [HPOObjective](API_HPOObjective.md)객체 필수 여부: 아니요 ** hpoResourceConfig ** HPO에 대한 리소스 구성을 설명합니다. 유형: [HPOResourceConfig](API_HPOResourceConfig.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOConfig) # HPOObjective 하이퍼파라미터 최적화(HPO) 중 최적화할 지표. **참고** Amazon Personalize는 현재 `hpoObjective` 구성을 지원하지 않습니다. ## 내용 ** metricName ** 지표의 이름. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** metricRegex ** 학습 작업 로그에서 지표를 찾기 위한 정규식. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** type ** 지표의 유형. 유효 값은 `Maximize`및 `Minimize`입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOObjective) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOObjective) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOObjective) # HPOResourceConfig 하이퍼파라미터 최적화(HPO)를 위한 리소스 구성을 설명합니다. ## 내용 ** maxNumberOfTrainingJobs ** 솔루션 버전을 생성할 때 최대 학습 작업 수. `maxNumberOfTrainingJobs`의 최대값은 `40`입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** maxParallelTrainingJobs ** 솔루션 버전을 생성할 때 최대 병행 학습 작업 수. `maxParallelTrainingJobs`의 최댓값은 `10`입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOResourceConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOResourceConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOResourceConfig) # HyperParameterRanges 하이퍼파라미터와 해당 범위를 지정합니다. 하이퍼파라미터에는 범주형, 연속 또는 정수 값이 지정될 수 있습니다. ## 내용 ** categoricalHyperParameterRanges ** 하이퍼파라미터와 해당 범위. 유형: [CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. 필수 여부: 아니요 ** continuousHyperParameterRanges ** 연속 하이퍼파라미터와 해당 범위. 유형: [ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. 필수 여부: 아니요 ** integerHyperParameterRanges ** 정수 값 하이퍼파라미터와 해당 범위. 유형: [IntegerHyperParameterRange](API_IntegerHyperParameterRange.md)객체 어레이 어레이 멤버: 최대 항목 수 100개. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HyperParameterRanges) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HyperParameterRanges) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HyperParameterRanges) # IntegerHyperParameterRange 정수 값 하이퍼파라미터의 이름과 범위를 제공합니다. ## 내용 ** maxValue ** 하이퍼파라미터에 허용되는 최대값. 유형: 정수 유효 범위: 최대값 1000000. 필수 여부: 아니요 ** minValue ** 하이퍼파라미터에 허용되는 최소값. 유형: 정수 유효 범위: 최소값 -1000000. 필수 여부: 아니요 ** name ** 하이퍼파라미터의 이름입니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/IntegerHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/IntegerHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/IntegerHyperParameterRange) # MetricAttribute 지표 어트리뷰션이 보고하는 지표에 대한 정보가 들어 있습니다. 자세한 내용은 [추천 영향 측정](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html) 단원을 참조하세요. ## 내용 ** eventType ** 지표의 이벤트 유형. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 예 ** expression ** 속성의 표현식. 사용할 수 있는 함수는 `SUM()`또는 `SAMPLECOUNT()`입니다. SUM() 함수의 경우 데이터세트 유형(상호작용 또는 항목)과 합계할 열을 파라미터로 제공합니다. 예: SUM(Items.PRICE). 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 예 ** metricName ** 지표의 이름. 이름은 CloudWatch 또는 S3에서 지표를 식별하는 데 도움이 됩니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttribute) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttribute) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttribute) # MetricAttribution 지표 어트리뷰션에 대한 정보가 들어 있습니다. 지표 어트리뷰션은 Personalize로 가져오는 데이터에 대한 보고서를 생성합니다. 데이터를 가져온 방법에 따라 CloudWatch 또는 S3에서 보고서를 볼 수 있습니다. 자세한 내용은 [추천 영향 측정](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html) 단원을 참조하세요. ## 내용 ** creationDateTime ** 지표 어트리뷰션의 생성 날짜 시간. 유형: 타임스탬프 필수 여부: 아니요 ** datasetGroupArn ** 지표 어트리뷰션의 데이터세트 그룹 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** failureReason ** 지표 어트리뷰션의 실패 이유. 유형: 문자열 필수 여부: 아니요 ** lastUpdatedDateTime ** 지표 어트리뷰션의 마지막 업데이트 날짜 시간. 유형: 타임스탬프 필수 여부: 아니요 ** metricAttributionArn ** 지표 어트리뷰션의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** metricsOutputConfig ** 지표 어트리뷰션의 출력 구성. 유형: [MetricAttributionOutput](API_MetricAttributionOutput.md)객체 필수 여부: 아니요 ** name ** 지표 어트리뷰션의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** status ** 지표 어트리뷰션의 상태. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttribution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttribution) # MetricAttributionOutput 지표 어트리뷰션에 대한 출력 구성 세부 정보. ## 내용 ** roleArn ** 출력 S3 버킷에 데이터를 추가하고 CloudWatch에 지표를 추가할 권한이 있는 IAM 서비스 역할의 리소스 이름(ARN). 자세한 내용은 [추천 영향 측정](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html) 단원을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 예 ** s3DataDestination ** S3 입력 또는 출력 버킷의 구성 세부 정보. 유형: [S3DataConfig](API_S3DataConfig.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttributionOutput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttributionOutput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttributionOutput) # MetricAttributionSummary 지표 어트리뷰션의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeMetricAttribution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeMetricAttribution.html)을 호출합니다. ## 내용 ** creationDateTime ** 지표 어트리뷰션의 생성 날짜 시간. 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 지표 어트리뷰션의 실패 이유. 유형: 문자열 필수 여부: 아니요 ** lastUpdatedDateTime ** 지표 어트리뷰션의 마지막 업데이트 날짜 시간. 유형: 타임스탬프 필수 여부: 아니요 ** metricAttributionArn ** 지표 어트리뷰션의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** name ** 지표 어트리뷰션의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** status ** 지표 어트리뷰션의 상태. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttributionSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttributionSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttributionSummary) # OptimizationObjective 스트리밍 시간 최대화 또는 수익 증대와 같은 솔루션의 추가 목표를 설명합니다. 자세한 내용은 [솔루션 최적화](https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html) 단원을 참조하세요. ## 내용 ** itemAttribute ** 최적화 목표와 관련된 항목 데이터세트의 숫자 메타데이터 열. 예: VIDEO\$1LENGTH(스트리밍 시간 최대화) 또는 PRICE(수익 최대화). 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 150. 필수 여부: 아니요 ** objectiveSensitivity ** Personalize가 최적화 목표의 중요성과 관련성의 균형을 맞추는 방법을 지정합니다. 타입: 문자열 유효 값: `LOW | MEDIUM | HIGH | OFF` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/OptimizationObjective) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/OptimizationObjective) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/OptimizationObjective) # Recipe 레시피에 대한 정보를 제공합니다. 각 레시피는 사용자가 [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 작업을 사용할 때 Personalize가 모델 학습에 사용하는 알고리즘을 제공합니다. ## 내용 ** algorithmArn ** Personalize가 모형 학습에 사용하는 알고리즘의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** creationDateTime ** 레시피가 생성된 날짜 및 시간(Unix 형식). 유형: 타임스탬프 필수 여부: 아니요 ** description ** 레시피에 대한 설명. 유형: 문자열 필수 여부: 아니요 ** featureTransformationArn ** FeatureTransformation 객체의 ARN. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** lastUpdatedDateTime ** 레시피가 마지막으로 업데이트된 날짜 및 시간(Unix 형식). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 레시피의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** recipeArn ** 레시피의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** recipeType ** 다음 값 중 하나입니다. + PERSONALIZED\$1RANKING + RELATED\$1ITEMS + USER\$1PERSONALIZATION 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** status ** 레시피의 상태. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Recipe) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Recipe) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Recipe) # RecipeSummary 레시피의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeRecipe](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecipe.html) API를 호출합니다. ## 내용 ** creationDateTime ** 레시피가 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** domain ** 레시피의 도메인(레시피가 도메인 데이터세트 그룹 사용 사례인 경우). 타입: 문자열 유효 값: `ECOMMERCE | VIDEO_ON_DEMAND` 필수 여부: 아니요 ** lastUpdatedDateTime ** 레시피가 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 레시피의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** recipeArn ** 레시피의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 레시피의 상태. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecipeSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecipeSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecipeSummary) # Recommender 도메인 데이터세트 그룹의 추천 생성기에 대해 설명합니다. 도메인 데이터세트 그룹에서 특정 도메인 사용 사례(도메인 레시피)에 대한 추천자를 만들고 [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) 요청에서 추천자를 지정합니다. ## 내용 ** creationDateTime ** 추천자가 생성된 날짜 및 시간(Unix 형식). 유형: 타임스탬프 필수 여부: 아니요 ** datasetGroupArn ** 추천자가 포함된 도메인 데이터세트 그룹의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** failureReason ** 추천자가 실패할 경우 실패의 원인. 유형: 문자열 필수 여부: 아니요 ** lastUpdatedDateTime ** 추천자가 마지막으로 업데이트된 날짜 및 시간(Unix 형식). 유형: 타임스탬프 필수 여부: 아니요 ** latestRecommenderUpdate ** 추천자에 대한 최신 업데이트의 요약을 제공합니다. 유형: [RecommenderUpdateSummary](API_RecommenderUpdateSummary.md)객체 필수 여부: 아니요 ** modelMetrics ** 추천자의 성과를 판단하는 데 도움이 되는 평가 지표를 제공합니다. 자세한 내용은 [추천자 평가](https://docs.aws.amazon.com/personalize/latest/dg/evaluating-recommenders.html) 단원을 참조하세요. 유형: 문자열-double 맵 맵 항목: 최대 항목 수 100개. 키 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** name ** 추천자의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** recipeArn ** 추천자가 생성된 레시피(도메인 데이터세트 그룹 사용 사례)의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** recommenderArn ** 추천자의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** recommenderConfig ** 추천자의 구성 세부 정보. 유형: [RecommenderConfig](API_RecommenderConfig.md)객체 필수 여부: 아니요 ** status ** 추천자의 상태. 추천자는 다음 상태 중 하나일 수 있습니다. + 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 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Recommender) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Recommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Recommender) # RecommenderConfig 추천자의 구성 세부 정보. ## 내용 ** enableMetadataWithRecommendations ** 추천이 포함된 메타데이터가 추천자에 활성화되어 있는지 여부입니다. 활성화한 경우 추천 요청에 항목 데이터 세트의 열을 지정할 수 있습니다. Amazon Personalize는 추천 응답의 각 항목에 대해 이 데이터를 반환합니다. 추천자용 메타데이터 활성화에 대한 자세한 내용은 [추천자용 추천의 메타데이터 활성화](https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata)를 참조하세요. 추천에서 메타데이터를 활성화하면 추가 비용이 발생합니다. 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요. 유형: 부울 필수 여부: 아니요 ** itemExplorationConfig ** Personalize가 항목을 추천할 때 사용하는 항목 탐색량을 구성하는 데 사용할 탐색 구성 하이퍼파라미터(`explorationWeight` 및 `explorationItemAgeCutOff`포함)를 지정합니다. 추천자가 사용자를 위한 개인 맞춤형 추천을 생성하는 경우에만 `itemExplorationConfig`데이터를 제공합니다(인기 항목 또는 유사 항목 제외). 유형: 문자열-문자열 맵 맵 항목: 최대 항목 수 100개. 키 길이 제약: 최대 길이 256. 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** minRecommendationRequestsPerSecond ** Personalize에서 지원하는 초당 요청된 최소 프로비저닝 추천 요청을 지정합니다. `minRecommendationRequestsPerSecond`가 높으면 요금이 인상됩니다. `minRecommendationRequestsPerSecond`(기본값)의 경우 1부터 시작하는 것이 좋습니다. CloudWatch 지표를 사용하여 사용량을 추적하고 필요에 따라 `minRecommendationRequestsPerSecond`를 늘리세요. 타입: 정수 유효 범위: 최소값 1. 필수 여부: 아니요 ** trainingDataConfig ** 도메인 추천자를 생성할 때 사용할 학습 데이터 구성을 지정합니다. 유형: [TrainingDataConfig](API_TrainingDataConfig.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderConfig) # RecommenderSummary 추천자의 속성에 대한 요약을 제공합니다. ## 내용 ** creationDateTime ** 추천자가 생성된 날짜 및 시간(Unix 형식). 유형: 타임스탬프 필수 여부: 아니요 ** datasetGroupArn ** 추천자가 포함된 도메인 데이터세트 그룹의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** lastUpdatedDateTime ** 추천자가 마지막으로 업데이트된 날짜 및 시간(Unix 형식). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 추천자의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** recipeArn ** 추천자가 생성된 레시피(도메인 데이터세트 그룹 사용 사례)의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** recommenderArn ** 추천자의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** recommenderConfig ** 추천자의 구성 세부 정보. 유형: [RecommenderConfig](API_RecommenderConfig.md)객체 필수 여부: 아니요 ** status ** 추천자의 상태. 추천자는 다음 상태 중 하나일 수 있습니다. + 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 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderSummary) # RecommenderUpdateSummary 추천자 업데이트의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) API를 호출합니다. ## 내용 ** creationDateTime ** 추천자 업데이트가 생성된 날짜 및 시간(Unix 형식). 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 추천자 업데이트가 실패할 경우 실패의 원인. 유형: 문자열 필수 여부: 아니요 ** lastUpdatedDateTime ** 추천자 업데이트가 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** recommenderConfig ** 추천자 업데이트 구성 세부 정보. 유형: [RecommenderConfig](API_RecommenderConfig.md)객체 필수 여부: 아니요 ** status ** 추천자 업데이트의 상태. 추천자 업데이트는 다음 상태 중 하나일 수 있습니다. CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderUpdateSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderUpdateSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderUpdateSummary) # S3DataConfig S3 입력 또는 출력 버킷의 구성 세부 정보. ## 내용 ** path ** S3 버킷의 파일 경로. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `(s3|http|https)://.+` 필수 여부: 예 ** kmsKeyArn ** Personalize가 입력 및 출력 파일을 암호화하거나 해독하는 데 사용하는 AWS Key Management Service(KMS) 키의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/S3DataConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/S3DataConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/S3DataConfig) # Solution **중요** 기본적으로 모든 새 솔루션은 자동 학습을 사용합니다. 자동 학습을 사용하면 솔루션이 활성화되어 있는 동안 학습 비용이 발생합니다. 불필요한 비용을 방지하기 위해 완료되면 [솔루션을 업데이트](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html)하여 자동 학습을 끌 수 있습니다. 학습 비용에 대한 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요. 솔루션에 대한 정보를 제공하는 객체. 솔루션에는 Amazon Personalize가 추천을 생성하는 데 사용하는 사용자 지정 레시피, 사용자 지정 파라미터 및 학습된 모델(솔루션 버전)이 포함됩니다. 솔루션을 생성한 후에는 해당 구성을 변경할 수 없습니다. 변경해야 하는 경우 Amazon Personalize 콘솔로 [솔루션을 복제](https://docs.aws.amazon.com/personalize/latest/dg/cloning-solution.html)하거나 새 솔루션을 생성할 수 있습니다. ## 내용 ** autoMLResult ** `performAutoML`이 true인 경우 찾은 최상의 레시피를 지정합니다. 유형: [AutoMLResult](API_AutoMLResult.md)객체 필수 여부: 아니요 ** creationDateTime ** 솔루션 생성 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** datasetGroupArn ** 학습 데이터를 제공하는 데이터세트 그룹의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** eventType ** 모델 학습에 사용되는 이벤트 유형(예: ‘click’ 또는 ‘like’). `eventType`이 제공되지 않으면 Personalize는 유형에 관계없이 동일한 가중치로 모든 상호작용을 학습에 사용합니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** lastUpdatedDateTime ** 솔루션이 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** latestSolutionUpdate ** 솔루션에 대한 최신 업데이트의 요약을 제공합니다. 유형: [SolutionUpdateSummary](API_SolutionUpdateSummary.md)객체 필수 여부: 아니요 ** latestSolutionVersion ** 상태 및 ARN을 포함하여 솔루션의 최신 버전을 설명합니다. 유형: [SolutionVersionSummary](API_SolutionVersionSummary.md)객체 필수 여부: 아니요 ** name ** 솔루션의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** performAutoML ** 자동화된 기계 학습은 활성화하지 않는 것이 좋습니다. 대신 사용 사례를 사용 가능한 Personalize 레시피에 맞춥니다. 자세한 내용은 [Determining your use case](https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html)(사용 사례 결정)를 참조하세요. true인 경우 Personalize는 솔루션 구성에 지정된 목록에서 최상의 USER\$1PERSONALIZATION 레시피 검색을 수행합니다(`recipeArn`은 지정하면 안 됨). false(기본값)인 경우 Personalize는 학습에 `recipeArn`을 사용합니다. 유형: 부울 필수 항목 여부: 아니요 ** performAutoTraining ** 솔루션이 솔루션 버전을 자동으로 생성할지 여부를 지정합니다. 기본값은 `True` 며 솔루션은 7일마다 새 솔루션 버전을 자동으로 생성합니다. 자동 학습에 대한 자세한 내용은 [솔루션 생성 및 구성](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html) 섹션을 참조하세요. 유형: 부울 필수 항목 여부: 아니요 ** performHPO ** 선택한 레시피에서 하이퍼파라미터 최적화(HPO)를 수행할지 여부. 기본값은 `false`입니다. 유형: 부울 필수 항목 여부: 아니요 ** performIncrementalUpdate ** 모델에서 증분 훈련 업데이트를 수행할지 여부를 나타내는 부울 값입니다. 활성화하면 전체 재훈련 없이 모델이 새 데이터에서 더 자주 학습할 수 있으므로 거의 실시간으로 개인화할 수 있습니다. 이 파라미터는 의미 체계 유사성 레시피를 사용하는 솔루션에서만 지원됩니다. 유형: 부울 필수 항목 여부: 아니요 ** recipeArn ** 솔루션을 생성하는 데 사용된 레시피의 ARN. `performAutoML`이 false인 경우 필수입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** solutionArn ** 솔루션의 ARN. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** solutionConfig ** 솔루션의 구성 속성을 설명합니다. 유형: [SolutionConfig](API_SolutionConfig.md)객체 필수 여부: 아니요 ** status ** 솔루션의 상태. 솔루션은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별AWSSDKs + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Solution) + [AWSJava V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Solution) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Solution) # SolutionConfig 솔루션의 구성 속성을 설명합니다. ## 내용 ** algorithmHyperParameters ** 알고리즘 하이퍼파라미터와 해당 값을 나열합니다. 유형: 문자열-문자열 맵 맵 항목: 최대 항목 수 100개. 키 길이 제약: 최대 길이 256. 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** autoMLConfig ** AutoML이 수행될 때 검색할 레시피 목록이 포함된 [AutoMLConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_AutoMLConfig.html) 객체. 유형: [AutoMLConfig](API_AutoMLConfig.md)객체 필수 여부: 아니요 ** autoTrainingConfig ** 사용할 자동 학습 구성을 지정합니다. 유형: [AutoTrainingConfig](API_AutoTrainingConfig.md)객체 필수 여부: 아니요 ** eventsConfig ** 이벤트 파라미터 목록을 포함하는 이벤트의 구성을 설명합니다. 최대 10개의 이벤트 파라미터를 지정할 수 있습니다. 이벤트는 솔루션 생성에 사용됩니다. 유형: [EventsConfig](API_EventsConfig.md)객체 필수 여부: 아니요 ** eventValueThreshold ** 값이 이 임계값보다 크거나 같은 이벤트만 모델 학습용으로 사용됩니다. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** featureTransformationParameters ** 특성 변환 파라미터를 나열합니다. 유형: 문자열 간 맵 맵 항목: 최대 항목 수 100개. 키 길이 제약: 최대 길이 256. 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** hpoConfig ** 하이퍼파라미터 최적화(HPO)에 대한 속성을 설명합니다. 유형: [HPOConfig](API_HPOConfig.md)객체 필수 여부: 아니요 ** optimizationObjective ** 스트리밍 시간 최대화 또는 수익 증대와 같은 솔루션의 추가 목표를 설명합니다. 자세한 내용은 [솔루션 최적화](https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html) 단원을 참조하세요. 유형: [OptimizationObjective](API_OptimizationObjective.md)객체 필수 여부: 아니요 ** trainingDataConfig ** 사용자 지정 솔루션 버전(학습된 모델)을 만들 때 사용할 학습 데이터 구성을 지정합니다. 유형: [TrainingDataConfig](API_TrainingDataConfig.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionConfig) # SolutionSummary 솔루션의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) API를 호출합니다. ## 내용 ** creationDateTime ** 솔루션이 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** lastUpdatedDateTime ** 솔루션이 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 솔루션의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** recipeArn ** 솔루션에서 사용하는 레시피의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** solutionArn ** 솔루션의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 솔루션의 상태. 솔루션은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionSummary) # SolutionUpdateConfig 솔루션 업데이트의 구성 세부 정보입니다. ## 내용 ** autoTrainingConfig ** `performAutoTraining`이 true일 때 사용할 자동 학습 구성입니다. 유형: [AutoTrainingConfig](API_AutoTrainingConfig.md)객체 필수 여부: 아니요 ** eventsConfig ** 이벤트 파라미터 목록을 포함하는 이벤트의 구성을 설명합니다. 최대 10개의 이벤트 파라미터를 지정할 수 있습니다. 이벤트는 솔루션 생성에 사용됩니다. 유형: [EventsConfig](API_EventsConfig.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionUpdateConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionUpdateConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionUpdateConfig) # SolutionUpdateSummary 솔루션 업데이트의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) API를 호출합니다. ## 내용 ** creationDateTime ** 솔루션 업데이트가 생성된 날짜 및 시간(Unix 형식)입니다. 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 솔루션 업데이트가 실패할 경우 실패의 이유입니다. 유형: 문자열 필수 항목 여부: 아니요 ** lastUpdatedDateTime ** 솔루션 업데이트가 마지막으로 업데이트된 날짜 및 시간(Unix 시간)입니다. 유형: 타임스탬프 필수 여부: 아니요 ** performAutoTraining ** 솔루션이 솔루션 버전을 자동으로 생성하는지 여부입니다. 유형: 부울 필수 항목 여부: 아니요 ** performIncrementalUpdate ** 모델에서 증분 훈련 업데이트를 수행할지 여부를 나타내는 부울 값입니다. 활성화하면 활성 캠페인이 있는 솔루션 버전에 대해 증분 훈련이 수행되므로 전체 재훈련 없이 모델을 더 자주 새 데이터에서 학습할 수 있으므로 거의 실시간으로 개인화할 수 있습니다. 이 파라미터는 의미 체계 유사성 레시피를 사용하는 솔루션에서만 지원됩니다. 기본값은 `true`입니다. 특정 점수 및 속성(예: aws-semantic-similarity 레시피를 사용하여 순위를 매기는 데 사용되는 항목 인기도 및 신선도 업데이트)은 다음 전체 훈련이 발생할 때까지 업데이트되지 않을 수 있습니다. 유형: 부울 필수 항목 여부: 아니요 ** solutionUpdateConfig ** 솔루션의 새 구성 세부 정보입니다. 유형: [SolutionUpdateConfig](API_SolutionUpdateConfig.md)객체 필수 여부: 아니요 ** status ** 솔루션 업데이트의 상태입니다. 솔루션 업데이트는 다음 상태 중 하나일 수 있습니다. CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ## 참고 언어별AWSSDKs + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionUpdateSummary) + [AWSJava V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionUpdateSummary) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionUpdateSummary) # SolutionVersion 사용자 지정 데이터세트 그룹에 있는 [솔루션](https://docs.aws.amazon.com/personalize/latest/dg/API_Solution.html)의 특정 버전에 대한 정보를 제공하는 객체. ## 내용 ** creationDateTime ** 솔루션의 이 버전이 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** datasetGroupArn ** 학습 데이터를 제공하는 데이터세트 그룹의 리소스 이름(ARN). 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** eventType ** 모델 학습에 사용되는 이벤트 유형(예: ‘click’ 또는 ‘like’). 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** failureReason ** 솔루션 버전의 학습이 실패할 경우 실패의 원인. 유형: 문자열 필수 항목 여부: 아니요 ** lastUpdatedDateTime ** 솔루션이 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** name ** 솔루션 버전의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** performAutoML ** true인 경우 Personalize는 솔루션 구성에 따라 가장 최적의 레시피를 검색합니다. false(기본값)인 경우 Personalize는 `recipeArn`을 사용합니다. 유형: 부울 필수 항목 여부: 아니요 ** performHPO ** 선택한 레시피에서 하이퍼파라미터 최적화(HPO)를 수행할지 여부. 기본값은 `false`입니다. 유형: 부울 필수 항목 여부: 아니요 ** performIncrementalUpdate ** 솔루션 버전이 증분 업데이트를 수행해야 하는지 여부입니다. true로 설정하면 trainingMode은 최근 훈련 이후 변경된 데이터만 처리합니다. 이는 사용자-개인 맞춤 레시피를 사용하는 솔루션 버전에서만 사용할 수 있습니다. 유형: 부울 필수 항목 여부: 아니요 ** recipeArn ** 솔루션에서 사용된 레시피의 ARN. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** solutionArn ** 솔루션의 ARN. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** solutionConfig ** 솔루션의 구성 속성을 설명합니다. 유형: [SolutionConfig](API_SolutionConfig.md)객체 필수 여부: 아니요 ** solutionVersionArn ** 솔루션 버전의 ARN. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 솔루션 버전의 상태. 솔루션 버전은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING + CREATE IN\$1PROGRESS + ACTIVE + CREATE FAILED + CREATE STOPPING + CREATE STOPPED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** trainingHours ** 모델을 학습시키는 데 사용된 시간. 모델을 학습시키는 데 걸리는 시간에 따라 요금이 청구됩니다. 이 필드는 Personalize가 모델을 성공적으로 학습시킨 후에만 표시됩니다. 유형: Double 유효 범위: 최소값은 0입니다. 필수 여부: 아니요 ** trainingMode ** 솔루션 버전을 만들 때 수행할 학습의 범위. `FULL` 학습은 데이터세트 그룹의 모든 데이터를 고려합니다. `UPDATE`는 최근 학습 이후 변경된 데이터만 처리합니다. User-Personalization 레시피로 생성된 솔루션 버전만 `UPDATE`를 사용할 수 있습니다. 타입: 문자열 유효 값: `FULL | UPDATE | AUTOTRAIN` 필수 여부: 아니요 ** trainingType ** 솔루션 버전이 자동으로 생성되었는지 아니면 수동으로 생성되었는지 여부입니다. 타입: 문자열 유효 값: `AUTOMATIC | MANUAL` 필수 여부: 아니요 ** tunedHPOParams ** 하이퍼파라미터 최적화를 수행한 경우, 성능이 가장 좋은 모델의 하이퍼파라미터 값이 포함됩니다. 유형: [TunedHPOParams](API_TunedHPOParams.md)객체 필수 여부: 아니요 ## 참고 언어별AWSSDKs + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionVersion) + [AWSJava V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionVersion) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionVersion) # SolutionVersionSummary 솔루션 버전의 속성에 대한 요약을 제공합니다. 전체 목록을 보려면 [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) API를 호출합니다. ## 내용 ** creationDateTime ** 솔루션의 이 버전의 생성된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** failureReason ** 솔루션 버전이 실패할 경우 실패의 원인. 유형: 문자열 필수 여부: 아니요 ** lastUpdatedDateTime ** 솔루션 버전이 마지막으로 업데이트된 날짜 및 시간(Unix 시간). 유형: 타임스탬프 필수 여부: 아니요 ** solutionVersionArn ** 솔루션 버전의 리소스 이름(ARN) 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** status ** 솔루션 버전의 상태. 솔루션 버전은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** trainingMode ** 솔루션 버전을 만들 때 수행할 학습의 범위. `FULL` 학습은 데이터세트 그룹의 모든 데이터를 고려합니다. `UPDATE`는 최근 학습 이후 변경된 데이터만 처리합니다. User-Personalization 레시피로 생성된 솔루션 버전만 `UPDATE`를 사용할 수 있습니다. 타입: 문자열 유효 값: `FULL | UPDATE | AUTOTRAIN` 필수 여부: 아니요 ** trainingType ** 솔루션 버전이 자동으로 생성되었는지 아니면 수동으로 생성되었는지 여부입니다. 타입: 문자열 유효 값: `AUTOMATIC | MANUAL` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionVersionSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionVersionSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionVersionSummary) # Tag 리소스를 분류하고 구성하는 데 도움이 되도록 리소스에 적용하는 메타데이터. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 자세한 내용은 [Amazon Personalize 리소스 태그 지정](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)을 참조하세요. ## 내용 ** tagKey ** 하나의 태그를 구성하는 키-값 쌍의 일부분. 키는 더 구체적인 태그 값에 대해 범주와 같은 역할을 하는 일반적인 레이블입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이 128. 패턴: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 필수 여부: 예 ** tagValue ** 하나의 태그를 구성하는 키-값 쌍의 선택적 부분. 하나의 값은 태그 범주(키) 내에서 서술자 역할을 수행합니다. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256입니다. 패턴: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Tag) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Tag) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Tag) # ThemeGenerationConfig 배치 추론 작업으로 테마를 생성하기 위한 구성 세부 정보. ## 내용 ** fieldsForThemeGeneration ** 배치 추론 작업에 대한 설명 테마를 생성하는 데 사용되는 필드입니다. 타입: [FieldsForThemeGeneration](API_FieldsForThemeGeneration.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ThemeGenerationConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ThemeGenerationConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ThemeGenerationConfig) # TrainingDataConfig 도메인 추천자 또는 사용자 지정 솔루션 버전(학습된 모델)을 만들 때 사용할 학습 데이터 구성. ## 내용 ** excludedDatasetColumns ** 학습에서 제외시킬 열을 지정합니다. 각 키는 데이터세트 유형이고 각 값은 열 목록입니다. Personalize가 추천을 생성하는 데 사용하는 데이터를 제어하는 열은 제외시킵니다. 예를 들어, 추천을 필터링하는 데만 사용하려는 열이 있을 수 있습니다. 이 열을 학습에서 제외할 수 있으며, Personalize는 필터링할 때만 이 열을 고려합니다. 유형: 문자열-문자열 어레이 맵 맵 항목: 최대 항목 수 3개. 키 길이 제약: 최대 길이는 256입니다. 키 패턴: `^[A-Za-z_]+$` 어레이 멤버: 최대 항목 수 50개. 길이 제약: 최대 길이 150. 패턴: `[A-Za-z_][A-Za-z\d_]*` 필수 여부: 아니요 ** includedDatasetColumns ** 훈련에서 포함할 열을 지정합니다. 각 키는 데이터세트 유형이고 각 값은 열 목록입니다. Personalize가 추천을 생성하는 데 사용하는 데이터를 제어하는 열을 포함합니다. 예를 들어 항목 데이터 세트에 여러 열이 있을 수 있지만 교육에는 제목과 설명만 사용하고 싶을 수 있습니다. 훈련에는이 두 열만 포함할 수 있으며 Amazon Personalize는 훈련에는 포함된 열만 고려합니다. 유형: 문자열-문자열 어레이 맵 맵 항목: 최대 항목 수 3개. 키 길이 제약: 최대 길이는 256입니다. 키 패턴: `^[A-Za-z_]+$` 어레이 멤버: 최대 항목 수 50개. 길이 제약: 최대 길이 150. 패턴: `[A-Za-z_][A-Za-z\d_]*` 필수 여부: 아니요 ## 참고 언어별AWSSDKs + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TrainingDataConfig) + [AWSJava V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TrainingDataConfig) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TrainingDataConfig) # TunedHPOParams 하이퍼파라미터 최적화(HPO)를 수행한 경우, 성능이 가장 좋은 모델의 하이퍼파라미터 값이 포함됩니다. ## 내용 ** algorithmHyperParameters ** 성능이 가장 좋은 모델의 하이퍼파라미터 값 목록. 유형: 문자열-문자열 맵 맵 항목: 최대 항목 수 100개. 키 길이 제약: 최대 길이 256. 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TunedHPOParams) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TunedHPOParams) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TunedHPOParams) # Personalize 이벤트 Personalize 이벤트에서 지원하는 데이터 유형은 다음과 같습니다. + [Action](API_UBS_Action.md) + [ActionInteraction](API_UBS_ActionInteraction.md) + [Event](API_UBS_Event.md) + [Item](API_UBS_Item.md) + [MetricAttribution](API_UBS_MetricAttribution.md) + [User](API_UBS_User.md) # Action `PutActions` API를 사용하여 작업 데이터 세트에 추가된 작업 메타데이터를 나타냅니다. 자세한 내용은 [개별적으로 작업 가져오기](https://docs.aws.amazon.com/personalize/latest/dg/importing-actions.html)를 참조하세요. ## 내용 ** actionId ** 작업과 연결된 ID. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 예 ** properties ** 작업별 메타데이터의 문자열 맵. 맵의 각 요소는 키-값 쌍으로 이루어져 있습니다. 예를 들어 `{"value": "100"}`입니다. 키는 작업 데이터 세트 스키마의 필드와 일치하는 낙타 대문자 이름을 사용합니다. 이전 예제에서 `value`는 작업 스키마에 정의된 'VALUE' 필드와 일치합니다. 범주형 문자열 데이터의 경우 단일 작업에 여러 범주를 포함시키려면 파이프 구분자(`|`)로 각 범주를 구분합니다. 예를 들어 `\"Deluxe|Premium\"`입니다. 타입: 문자열 길이 제약: 최소 길이 1. 최대 길이는 32,000입니다. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Action) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Action) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Action) # ActionInteraction `PutActionInteractions` API를 사용하여 전송된 작업 상호 작용 이벤트를 나타냅니다. ## 내용 ** actionId ** 사용자가 상호 작용한 작업의 ID. 이는 작업 상호 작용 스키마의 `ACTION_ID` 필드에 해당합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 예 ** eventType ** 작업 상호 작용 이벤트의 유형. `Viewed`, `Taken`, `Not Taken` 이벤트 유형을 지정할 수 있습니다. 작업 상호 작용 이벤트 유형 데이터에 대한 자세한 내용은 [이벤트 유형 데이터](https://docs.aws.amazon.com/personalize/latest/dg/action-interaction-event-type-data.html)를 참조하세요. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 예 ** sessionId ** 해당 사용자의 방문과 연결된 ID. 애플리케이션은 사용자가 웹 사이트를 처음 방문하거나 애플리케이션을 사용할 때 고유한 `sessionId`을 생성합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 예 ** timestamp ** 작업 상호 작용 이벤트가 발생한 시점의 타임스탬프. 타임스탬프는 Unix epoch 시간 형식(초)이어야 합니다. 유형: 타임스탬프 필수 여부: 예 ** eventId ** 이벤트와 연결된 ID. 이벤트 ID가 제공되지 않은 경우 Personalize는 이벤트에 대한 고유한 ID를 생성합니다. 이벤트 ID는 모델 입력으로 사용되지 않습니다. Amazon Personalize는 이벤트 ID를 사용하여 고유한 이벤트를 구분합니다. 동일한 이벤트 ID를 가진 첫 번째 이벤트 이후의 모든 후속 이벤트는 모델 학습에 사용되지 않습니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 아니요 ** impression ** 사용자에게 보여준 작업의 순서를 나타내는 작업 ID 목록. 예를 들어 `["actionId1", "actionId2", "actionId3"]`입니다. Amazon Personalize는 작업 상호 작용 이벤트의 노출 데이터를 사용하지 않습니다. 대신 각 작업에 대해 여러 이벤트를 기록하고 `Viewed` 이벤트 유형을 사용합니다. 타입: 문자열 배열 어레이 멤버: 최소 항목 수 1개. 최대 항목 수 25개. 길이 제약: 최소 길이 1. 최대 길이는 256. 필수 여부: 아니요 ** properties ** 기록하도록 선택할 수 있는 이벤트별 데이터의 문자열 맵. 예를 들어, 사용자가 작업 ID 이외의 작업을 수행하는 경우 사용자가 수행한 작업 수를 전송할 수도 있습니다. 맵의 각 항목은 키-값 쌍으로 이루어져 있습니다. 예: `{"numberOfActions": "12"}` 키는 작업 상호 작용 스키마의 필드와 일치하는 낙타 대문자 이름을 사용합니다. 위 예제에서 `numberOfActions`는 작업 상호 작용 스키마에 정의된 'NUMBER\$1OF\$1ACTIONS' 필드와 일치합니다. 다음은 속성의 키워드로 포함할 수 없습니다(대소문자 구분 없음). + userId + sessionid + eventType + 타임스탬프 + recommendationId + impression 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 1024. 필수 여부: 아니요 ** recommendationId ** 사용자가 상호 작용한 작업이 포함된 추천 목록의 ID. 유형: 문자열 길이 제약: 최소 길이 1자. 최대 길이 40자. 필수 여부: 아니요 ** userId ** 작업과 상호 작용한 사용자의 ID. 이는 작업 상호 작용 스키마의 `USER_ID` 필드에 해당합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/ActionInteraction) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/ActionInteraction) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/ActionInteraction) # Event `PutEvents` API를 사용하여 전송된 항목 상호 작용 이벤트 정보를 나타냅니다. ## 내용 ** eventType ** 이벤트의 유형(예: 클릭 또는 다운로드). 이 속성은 항목 상호 작용 데이터 세트 스키마의 `EVENT_TYPE` 필드에 해당하며 추적 중인 이벤트 유형에 따라 달라집니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 예 ** sentAt ** 이벤트가 발생한 시점의 클라이언트측 타임스탬프(Unix 시간). 유형: 타임스탬프 필수 여부: 예 ** eventId ** 이벤트와 연결된 ID. 이벤트 ID가 제공되지 않은 경우 Personalize는 이벤트에 대한 고유한 ID를 생성합니다. 이벤트 ID는 모델 입력으로 사용되지 않습니다. Amazon Personalize는 이벤트 ID를 사용하여 고유한 이벤트를 구분합니다. 동일한 이벤트 ID를 가진 첫 번째 이벤트 이후의 모든 후속 이벤트는 모델 학습에 사용되지 않습니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 아니요 ** eventValue ** 항목 상호 작용 스키마의 `EVENT_VALUE` 필드에 해당하는 이벤트 값. 유형: Float 필수 여부: 아니요 ** impression ** 사용자에게 보여준 항목의 순서를 나타내는 항목 ID 목록. 예를 들어 `["itemId1", "itemId2", "itemId3"]`입니다. 이벤트의 노출 데이터를 수동으로 기록할 항목의 목록을 제공합니다. 노출 데이터 기록에 대한 자세한 내용은 [노출 데이터 기록](https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data) 단원을 참조하세요. 유형: 문자열 어레이 어레이 멤버: 최소 항목 수 1개. 최대 항목 수 25개. 길이 제약: 최소 길이 1. 최대 길이는 256. 필수 여부: 아니요 ** itemId ** 항목 상호 작용 데이터 세트 스키마의 `ITEM_ID` 필드에 해당하는 항목 ID 키. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 아니요 ** metricAttribution ** 이벤트와 관련된 지표 어트리뷰션에 대한 정보가 들어 있습니다. 지표 어트리뷰션에 대한 자세한 내용은 [추천 영향 측정](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html) 단원을 참조하세요. 유형: [MetricAttribution](API_UBS_MetricAttribution.md)객체 필수 여부: 아니요 ** properties ** 기록하도록 선택할 수 있는 이벤트별 데이터의 문자열 맵. 예를 들어 사용자가 사이트에 있는 영화 ID(`itemId`) 및 등급(`eventValue`) 이외의 영화에 등급을 매기는 경우 사용자가 만든 영화 등급 수를 보낼 수도 있습니다. 맵의 각 항목은 키-값 쌍으로 이루어져 있습니다. 예: `{"numberOfRatings": "12"}` 키는 항목 상호 작용 데이터 세트 스키마의 필드와 일치하는 낙타 대문자 이름을 사용합니다. 위 예제에서 `numberOfRatings`는 항목 상호 작용 데이터 세트 스키마에 정의된 'NUMBER\$1OF\$1RATINGS' 필드와 일치합니다. 다음은 속성의 키워드로 포함할 수 없습니다(대소문자 구분 없음). + userId + sessionid + eventType + 타임스탬프 + recommendationId + impression 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 1024. 필수 여부: 아니요 ** recommendationId ** 사용자가 상호작용한 항목이 포함된 추천 목록의 ID. Personalize가 사용자에게 보여주는 추천을 노출 데이터로 암시적으로 기록하도록 하려면 `recommendationId`을 제공합니다. 또는 지표 어트리뷰션을 사용하여 추천의 영향을 측정하는 경우 `recommendationId`을 제공합니다. 노출 데이터 기록에 대한 자세한 내용은 [노출 데이터 기록](https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data) 단원을 참조하세요. 지표 어트리뷰션 생성에 대한 자세한 내용은 [추천 영향 측정](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html) 단원을 참조하세요. 유형: 문자열 길이 제약: 최소 길이 1자. 최대 길이 40자. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Event) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Event) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Event) # Item `PutItems` API를 사용하여 항목 데이터세트에 추가된 항목 메타데이터를 나타냅니다. 자세한 내용은 [개별적으로 항목 가져오기](https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html)를 참조하세요. ## 내용 ** itemId ** 항목과 연결된 ID. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 예 ** properties ** 항목별 메타데이터의 문자열 맵. 맵의 각 요소는 키-값 쌍으로 이루어져 있습니다. 예를 들어 `{"numberOfRatings": "12"}`입니다. 키는 항목 데이터세트 스키마의 필드와 일치하는 낙타 대문자 이름을 사용합니다. 이전 예제에서 `numberOfRatings`는 항목 스키마에 정의된 ‘NUMBER\$1OF\$1RATINGS’ 필드와 일치합니다. 범주형 문자열 데이터의 경우 단일 항목에 여러 범주를 포함시키려면 파이프(`|`)로 각 범주를 구분합니다. 예를 들어 `\"Horror|Action\"`입니다. 타입: 문자열 길이 제약: 최소 길이 1. 최대 길이는 32,000입니다. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Item) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Item) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Item) # MetricAttribution 이벤트와 관련된 지표 어트리뷰션에 대한 정보가 들어 있습니다. 지표 어트리뷰션에 대한 자세한 내용은 [추천 영향 측정](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html) 단원을 참조하세요. ## 내용 ** eventAttributionSource ** 이벤트의 출처(예: 타사). 유형: 문자열 길이 제약: 최대 길이 1024. 패턴: `^[\x20-\x7E]*[\x21-\x7E]+[\x20-\x7E]*$` 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/MetricAttribution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/MetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/MetricAttribution) # User `PutUsers` API를 사용하여 사용자 데이터세트에 추가된 항목 메타데이터를 나타냅니다. 자세한 내용은 [개별적으로 사용자 가져오기](https://docs.aws.amazon.com/personalize/latest/dg/importing-users.html)를 참조하세요. ## 내용 ** userId ** 사용자와 연결된 ID. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 예 ** properties ** 사용자별 메타데이터의 문자열 맵. 맵의 각 요소는 키-값 쌍으로 이루어져 있습니다. 예를 들어 `{"numberOfVideosWatched": "45"}`입니다. 키는 사용자 데이터세트 스키마의 필드와 일치하는 낙타 대문자 이름을 사용합니다. 이전 예제에서 `numberOfVideosWatched`는 사용자 스키마에 정의된 ‘NUMBER\$1OF\$1VIDEOS\$1WATCHED’ 필드와 일치합니다. 범주형 문자열 데이터의 경우 단일 사용자에 여러 범주를 포함시키려면 파이프(`|`)로 각 범주를 구분합니다. 예를 들어 `\"Member|Frequent shopper\"`입니다. 타입: 문자열 길이 제약: 최소 길이 1. 최대 길이는 24,000입니다. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/User) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/User) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/User) # Personalize 런타임 Personalize 런타임에서 지원하는 데이터 유형은 다음과 같습니다. + [PredictedAction](API_RS_PredictedAction.md) + [PredictedItem](API_RS_PredictedItem.md) + [Promotion](API_RS_Promotion.md) # PredictedAction 작업을 식별하는 객체. [GetActionRecommendations](API_RS_GetActionRecommendations.md) API는 `PredictedAction` 목록을 반환합니다. ## 내용 ** actionId ** 추천 작업의 ID. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** score ** 추천 작업의 점수. 작업 점수에 대한 자세한 내용은 [작업 추천 점수를 매기는 방식](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html)을 참조하세요. 유형: 더블 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedAction) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedAction) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedAction) # PredictedItem 항목을 식별하는 객체. [GetRecommendations](API_RS_GetRecommendations.md) 및 [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md)API는 `PredictedItem`목록을 반환합니다. ## 내용 ** itemId ** 추천 항목 ID. 유형: 문자열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** metadata ** 항목 데이터 세트의 항목에 대한 메타데이터입니다. 유형: 문자열 간 맵 키 길이 제약: 최대 길이 150. 값 길이 제약: 최대 길이는 20,000입니다. 필수 여부: 아니요 ** promotionName ** 예상 항목이 포함된 홍보의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** reason ** User-Personalization-v2를 사용하는 경우 항목이 추천 사항에 포함된 이유 목록입니다. 가능한 이유는 다음과 같습니다. + 프로모션된 항목 - 추천 요청에 적용한 프로모션의 일부로 항목이 포함되었음을 나타냅니다. + 탐색 - 항목이 탐색에 포함되었음을 나타냅니다. 탐색을 통해 상호작용 데이터가 적거나 사용자에 대한 관련성이 낮은 항목이 추천에 포함됩니다. 탐색에 대한 자세한 내용은 [탐색](https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#about-exploration) 섹션을 참조하세요. + 인기 항목 - 항목이 자리 표시자 인기 항목으로 포함되었음을 나타냅니다. 필터를 사용하는 경우 필터가 제거하는 추천 사항 수에 따라 Amazon Personalize는 추천 요청에 대한 `numResults`를 충족하기 위해 자리 표시자 항목을 추가할 수 있습니다. 이러한 항목은 상호 작용 데이터를 기반으로 필터 기준을 충족하는 인기 있는 항목입니다. 사용자에 대한 관련성 점수가 없습니다. 유형: 문자열 배열 길이 제약: 최대 길이 256. 필수 여부: 아니요 ** score ** 해당 항목이 다음 번 사용자 선택이 될 것이라는 모델의 확실성을 수치로 나타냅니다. 점수 산정 로직에 대한 자세한 내용은 [추천 점수](getting-recommendations.md#how-scores-work)단원을 참조하세요. 유형: 더블 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedItem) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedItem) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedItem) # Promotion 홍보에 대한 정보가 들어 있습니다. 홍보는 추천 항목의 구성 가능한 하위 집합에 적용되는 추가 비즈니스 규칙을 정의합니다. ## 내용 ** filterArn ** 홍보에 사용되는 필터의 리소스 이름(ARN). 이 필터는 홍보 항목의 기준을 정의합니다. 자세한 내용은 [홍보 필터](https://docs.aws.amazon.com/personalize/latest/dg/promoting-items.html#promotion-filters) 단원을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` 필수 여부: 아니요 ** filterValues ** 항목을 홍보할 때 사용할 값. 홍보 표현식의 각 자리 표시자 파라미터에 대해 파라미터 이름(대/소문자 구분)을 키로 그리고 필터 값을 해당 값으로 각각 제공합니다. 한 파라미터의 여러 값을 쉼표로 구분합니다. `INCLUDE` 요소를 사용하여 항목을 포함시키는 필터 표현식의 경우 표현식에 정의되어 있는 모든 파라미터의 값을 제공해야 합니다. `EXCLUDE` 요소를 사용하여 항목을 제외하는 표현식이 포함된 필터의 경우 `filter-values`를 생략할 수 있습니다. 이 경우 Personalize는 표현식의 해당 부분을 추천을 필터링하는 데 사용하지 않습니다. 필터 생성에 대한 자세한 내용은 [추천 및 사용자 세그먼트 필터링](https://docs.aws.amazon.com/personalize/latest/dg/filter.html) 단원을 참조하세요. 유형: 문자열-문자열 맵 맵 항목: 최대 항목 수 25개. 키 길이 제약: 최대 길이 50. 키 패턴: `[A-Za-z0-9_]+` 값 길이 제약: 최대 길이 1000. 필수 여부: 아니요 ** name ** 홍보의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 아니요 ** percentPromotedItems ** 홍보를 적용할 추천 항목의 비율. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/Promotion) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/Promotion) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/Promotion) # 일반적인 오류 이 단원에는 모든 AWS서비스의 API 작업에 대한 일반 오류가 나와 있습니다. 이 서비스의 API 작업에 대한 오류는 해당 API 작업 항목을 참조하세요. **AccessDeniedException** 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다. HTTP 상태 코드: 400 **IncompleteSignature** 요청 서명이 AWS표준을 준수하지 않습니다. HTTP 상태 코드: 400 **InternalFailure** 알 수 없는 오류, 예외 또는 장애 때문에 요청 처리가 실패했습니다. HTTP 상태 코드: 500 **InvalidAction** 요청된 동작 또는 작업이 유효하지 않습니다. 작업을 올바로 입력했는지 확인합니다. HTTP 상태 코드: 400 **InvalidClientTokenId** 제공된 X.509 인증서 또는 AWS액세스 키 ID가 AWS의 레코드에 존재하지 않습니다. HTTP 상태 코드: 403 **NotAuthorized** 이 작업을 수행하려면 권한이 있어야 합니다. HTTP 상태 코드: 400 **OptInRequired** AWS 액세스 키 ID는 서비스에 대한 구독이 필요합니다. HTTP 상태 코드: 403 **RequestExpired** 요청이 요청상의 날짜 스탬프로부터 15분 이상, 또는 요청 만료 날짜(예: 미리 서명된 URL)로부터 15분 이상 경과한 후 서비스에 도달했거나, 요청상의 날짜 스탬프가 15분 이상 미래입니다. HTTP 상태 코드: 400 **ServiceUnavailable** 서버의 일시적 장애로 인해 요청이 실패했습니다. HTTP 상태 코드: 503 **ThrottlingException** 요청 제한 때문에 요청이 거부되었습니다. HTTP 상태 코드: 400 **ValidationError** 입력이 AWS서비스에서 지정한 제약에 충족되지 않습니다. HTTP 상태 코드: 400 # 공통 파라미터 다음 목록에는 모든 작업이 쿼리 문자열을 사용하여 Signature Version 4 요청에 서명하는 데 사용하는 파라미터가 포함되어 있습니다. 작업별 파라미터는 그 작업에 대한 항목에 나열되어 있습니다. 서명 버전 4에 대한 자세한 내용은 *IAM 사용 설명서*의 [AWS API 요청 서명을](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) 참조하세요. **X-Amz-Algorithm** 요청 서명을 생성하는 데 사용된 해시 알고리즘입니다. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 유효 값: `AWS4-HMAC-SHA256` 필수 항목 여부: 조건부 **X-Amz-Credential** 자격 증명 범위 값이며 액세스 키, 날짜, 대상으로 하는 리전, 요청하는 서비스 및 종료 문자열("aws4\$1request")이 포함된 문자열입니다. 값은 다음 형식으로 표시됩니다. *access\$1key*/*YYYYMMDD*/*region*/*service*/aws4\$1request. 자세한 내용은 *IAM 사용 설명서*의 [서명된 AWS API 요청 생성을](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) 참조하세요. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-Date** 서명을 만드는 데 사용되는 날짜입니다. 형식은 ISO 8601 기본 형식(YYYYMMDD'T'HHMMSS'Z')이어야 합니다. 예를 들어 다음 날짜 시간은 유효한 X-Amz-Date 값: `20120325T120000Z`. 조건: X-Amz-Date는 모든 요청에서 옵션이지만 서명 요청에 사용되는 날짜보다 우선할 때 사용됩니다. 날짜 헤더가 ISO 8601 기본 형식으로 지정된 경우 X-Amz-Date가 필요하지 않습니다. X-Amz-Date를 사용하는 경우 항상 Date 헤더의 값을 재정의합니다. 자세한 내용은 *IAM 사용 설명서*[의 AWS API 요청 서명 요소를](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) 참조하세요. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-Security-Token** AWS Security Token Service ()에 대한 호출을 통해 얻은 임시 보안 토큰입니다AWS STS. AWS STS의 임시 보안 인증 정보를 지원하는 서비스 목록은 **IAM 사용 설명서의 [IAM으로 작업하는AWS 서비스](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)를 참조하세요. 조건:에서 임시 보안 자격 증명을 사용하는 경우 보안 토큰을 포함해야 AWS STS합니다. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-Signature** 서명할 문자열과 파생된 서명 키에서 계산된 16진수로 인코딩된 서명을 지정합니다. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-SignedHeaders** 표준 요청의 일부로 포함된 모든 HTTP 헤더를 지정합니다. 서명된 헤더 지정에 대한 자세한 내용은 *IAM 사용 설명서*의 [서명된 AWS API 요청 생성을](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) 참조하세요. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 필수 항목 여부: 조건부