UpdateCampaign - Personalize
구문 요청요청 파라미터응답 구문응답 요소Errors참고

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

UpdateCampaign

기존 캠페인과 함께 재학습된 솔루션 버전을 배포하거나, 캠페인의 minProvisionedTPS를 변경하거나, 캠페인 구성을 수정하도록 캠페인을 업데이트합니다. 예를 들어 기존 캠페인에 대해 enableMetadataWithRecommendations을 true로 설정할 수 있습니다.

최신 솔루션 버전을 사용하여 캠페인을 자동으로 시작하도록 업데이트하려면 다음을 지정합니다.

  • SolutionVersionArn 파라미터에 솔루션의 Amazon 리소스 이름(ARN)을 SolutionArn/$LATEST 형식으로 지정합니다.

  • campaignConfig에서 syncWithLatestSolutionVersion을 true로 설정합니다.

캠페인을 업데이트하려면 캠페인 상태가 ACTIVE 또는 CREATE FAILED여야 합니다. DescribeCampaign 작업을 사용하여 캠페인 상태를 확인합니다.

참고

업데이트가 진행 중인 동안에도 캠페인에서 추천을 받을 수 있습니다. 캠페인은 최신 캠페인 업데이트 상태가 Active가 될 때까지 이전 솔루션 버전과 캠페인 구성을 사용하여 추천을 생성합니다.

코드 샘플을 비롯한 캠페인 업데이트에 대한 자세한 내용은 캠페인 업데이트 단원을 참조하세요. 캠페인에 대한 자세한 내용은 캠페인 생성 단원을 참조하세요.

구문 요청

{
   "campaignArn": "string",
   "campaignConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "syncWithLatestSolutionVersion": boolean
   },
   "minProvisionedTPS": number,
   "solutionVersionArn": "string"
}

요청 파라미터

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

campaignArn

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

유형: 문자열

길이 제약: 최대 길이 256.

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

필수 여부: 예

campaignConfig

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

유형: CampaignConfig객체

필수 여부: 아니요

minProvisionedTPS

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

타입: 정수

유효 범위: 최소값 1.

필수 항목 여부: 아니요

solutionVersionArn

배포할 새 모델의 Amazon 리소스 이름(ARN)입니다. 솔루션의 최신 솔루션 버전을 지정하려면 솔루션의 ARN을 SolutionArn/$LATEST 형식으로 지정합니다. CampaignConfig에서 syncWithLatestSolutionVersion을 True로 설정한 경우 이 형식을 사용해야 합니다.

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

자동 캠페인 업데이트에 대한 자세한 내용은 자동 캠페인 업데이트 활성화 섹션을 참조하세요.

유형: 문자열

길이 제약: 최대 길이 256.

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

필수 여부: 아니요

응답 구문

{
   "campaignArn": "string"
}

응답 요소

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

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

campaignArn

요청에 제공된 것과 동일한 캠페인 ARN입니다.

유형: 문자열

길이 제약: 최대 길이 256.

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

Errors

InvalidInputException

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

HTTP 상태 코드: 400

ResourceInUseException

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

HTTP 상태 코드: 400

ResourceNotFoundException

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

HTTP 상태 코드: 400

참고

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