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