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

# GetActionRecommendations
<a name="API_RS_GetActionRecommendations"></a>

예측 점수를 기준으로 내림차순으로 정렬된 추천 작업 목록을 반환합니다. PERSONALIZED\_ACTIONS 레시피로 교육된 솔루션 버전을 배포하는 사용자 지정 캠페인이 있는 경우 `GetActionRecommendations` API를 사용하세요.

PERSONALIZED\_ACTIONS 레시피에 대한 자세한 내용은 [PERSONALIZED\_ACTIONS 레시피](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
<a name="API_RS_GetActionRecommendations_RequestSyntax"></a>

```
POST /action-recommendations HTTP/1.1
Content-type: application/json

{
   "campaignArn": "{{string}}",
   "filterArn": "{{string}}",
   "filterValues": { 
      "{{string}}" : "{{string}}" 
   },
   "numResults": {{number}},
   "userId": "{{string}}"
}
```

## URI 요청 파라미터
<a name="API_RS_GetActionRecommendations_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_RS_GetActionRecommendations_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [campaignArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-campaignArn"></a>
작업 추천을 받기 위해 사용할 캠페인의 Amazon 리소스 이름(ARN)입니다. 이 캠페인은 PERSONALIZED\_ACTIONS 레시피로 교육된 솔루션 버전을 배포해야 합니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
필수 여부: 아니요

 ** [filterArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterArn"></a>
반환되는 추천에 적용할 필터의 ARN입니다. 자세한 내용은 [추천 필터링](https://docs.aws.amazon.com/personalize/latest/dg/filter.html) 단원을 참조하세요.  
이 파라미터를 사용할 때는 필터 리소스가 `ACTIVE`이 맞는지 확인합니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
필수 여부: 아니요

 ** [filterValues](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterValues"></a>
추천을 필터링할 때 사용할 값. 필터 표현식의 각 자리 표시자 파라미터에 대해 파라미터 이름(대/소문자 구분)을 키로 그리고 필터 값을 해당 값으로 각각 제공합니다. 한 파라미터의 여러 값을 쉼표로 구분합니다.  
`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) **   <a name="personalize-RS_GetActionRecommendations-request-numResults"></a>
반환할 결과 수. 기본값은 5입니다. 최대값은 100입니다.  
유형: 정수  
유효 범위: 최소값 0.  
필수 여부: 아니요

 ** [userId](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-userId"></a>
작업 추천을 제공할 사용자의 사용자 ID입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
필수 여부: 아니요

## 응답 구문
<a name="API_RS_GetActionRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "actionList": [ 
      { 
         "actionId": "string",
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

## 응답 요소
<a name="API_RS_GetActionRecommendations_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [actionList](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-actionList"></a>
예측 점수를 기준으로 내림차순으로 정렬된 작업 추천 목록입니다. 목록에는 최대 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) **   <a name="personalize-RS_GetActionRecommendations-response-recommendationId"></a>
추천의 ID.  
유형: 문자열

## 오류
<a name="API_RS_GetActionRecommendations_Errors"></a>

 ** InvalidInputException **   
필드 또는 파라미터에 유효한 값을 제공합니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정한 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

## 참고
<a name="API_RS_GetActionRecommendations_SeeAlso"></a>

언어별 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\+\+](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)