기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 작업 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)