CreateCampaign - Personalize

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

CreateCampaign

중요

캠페인이 활성화되어 있는 동안에는 캠페인 비용이 발생합니다. 불필요한 비용이 발생하지 않도록 하려면 완료 후 캠페인을 삭제하세요. 캠페인 비용에 대한 자세한 내용은 Amazon Personalize 가격을 참조하십시오.

솔루션 버전을 배포하는 캠페인을 생성합니다. 클라이언트가 GetRecommendationsGetPersonalizedRankingAPI를 호출하면 요청에 캠페인이 지정됩니다.

프로비저닝된 최소 TPS 및 자동 크기 조정

중요

minProvisionedTPS가 높으면 비용이 증가합니다. minProvisionedTPS(기본값)의 경우 1부터 시작하는 것이 좋습니다. Amazon CloudWatch 지표를 사용하여 사용량을 추적하고 minProvisionedTPS 필요에 따라 사용량을 늘리십시오.

Amazon Personalize 캠페인을 생성할 때 캠페인에 대한 초당 최소 프로비저닝 트랜잭션 수(minProvisionedTPS)를 지정할 수 있습니다. 이는 Amazon Personalize에서 프로비저닝한 캠페인의 기준 트랜잭션 처리량입니다. 캠페인이 활성 상태일 때의 최소 청구 요금을 설정합니다. 트랜잭션은 단일 GetRecommendations 또는 GetPersonalizedRanking 요청으로 이루어집니다. 기본 minProvisionedTPS 값은 1입니다.

TPS가 minProvisionedTPS 이상으로 증가할 경우 Amazon Personalize는 프로비저닝 용량을 자동으로 확장 및 축소하지만, minProvisionedTPS 이하로는 확장 및 축소하지 않습니다. 용량이 증가 중에 잠시 동안의 지연으로 거래 손실이 발생할 수 있습니다. 트래픽이 감소하면 용량은 minProvisionedTPS로 돌아옵니다.

프로비저닝된 최소 TPS에 대한 요금이 부과되며, 요청이 minProvisionedTPS를 초과하는 경우 실제 TPS에 대한 요금이 부과됩니다. 실제 TPS는 추천을 요청한 총 건수입니다. 낮은 minProvisionedTPS 수치부터 시작하여 Amazon CloudWatch 측정치를 사용하여 사용량을 추적한 다음 minProvisionedTPS 필요에 따라 늘리는 것이 좋습니다.

캠페인 비용에 대한 자세한 내용은 Amazon Personalize 요금을 참조하세요.

상태

캠페인은 다음 상태 중 하나일 수 있습니다.

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE 또는 CREATE FAILED

  • DELETE PENDING > DELETE IN_PROGRESS

캠페인 상태를 알아보려면 전화하십시오 DescribeCampaign.

참고

캠페인의 statusACTIVE가 될 때까지 기다렸다가 캠페인에 추천을 요청합니다.

구문 요청

{ "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "syncWithLatestSolutionVersion": boolean }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] }

요청 파라미터

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

campaignConfig

캠페인의 구성 세부 정보입니다.

유형: CampaignConfig객체

필수 여부: 아니요

minProvisionedTPS

Personalize에서 지원할 초당 요청된 최소 프로비저닝 트랜잭션(추천)을 지정합니다. minProvisionedTPS가 높으면 요금이 인상됩니다. minProvisionedTPS(기본값)의 경우 1부터 시작하는 것이 좋습니다. Amazon CloudWatch 지표를 사용하여 사용량을 추적하고 minProvisionedTPS 필요에 따라 사용량을 늘리십시오.

타입: 정수

유효 범위: 최소값 1.

필수 여부: 아니요

name

새 캠페인의 이름. 캠페인 이름은 계정 내에서 고유해야 합니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이 63.

패턴: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

필수 사항 여부: Yes

solutionVersionArn

캠페인과 함께 배포할 학습된 모델의 Amazon 리소스 이름 (ARN). 솔루션의 최신 솔루션 버전을 지정하려면 솔루션의 ARN을 형식으로 SolutionArn/$LATEST 지정하십시오. True에서 syncWithLatestSolutionVersion 로 설정한 경우 이 형식을 사용해야 합니다. CampaignConfig

솔루션의 최신 솔루션 버전이 아닌 모델을 배포하려면 솔루션 버전의 ARN을 지정하세요.

자동 캠페인 업데이트에 대한 자세한 내용은 자동 캠페인 업데이트 활성화를 참조하십시오.

타입: 문자열

길이 제약: 최대 길이 256.

패턴: arn:([a-z\d-]+):personalize:.*:.*:.+

필수 사항 여부: Yes

tags

캠페인에 적용할 태그의 목록입니다.

유형: Tag객체 어레이

어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

필수 여부: 아니요

응답 구문

{ "campaignArn": "string" }

응답 요소

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

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

campaignArn

캠페인의 리소스 이름(ARN)입니다.

타입: 문자열

길이 제약: 최대 길이 256.

패턴: arn:([a-z\d-]+):personalize:.*:.*:.+

Errors

InvalidInputException

필드 또는 파라미터에 유효한 값을 제공합니다.

HTTP 상태 코드: 400

LimitExceededException

초당 요청 수 한도를 초과했습니다.

HTTP 상태 코드: 400

ResourceAlreadyExistsException

지정된 리소스가 이미 있습니다.

HTTP 상태 코드: 400

ResourceInUseException

지정된 리소스가 이미 사용 중입니다.

HTTP 상태 코드: 400

ResourceNotFoundException

지정된 리소스를 찾을 수 없습니다.

HTTP 상태 코드: 400

TooManyTagsException

이 리소스에 적용할 수 있는 최대 태그 수를 초과했습니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.