View a markdown version of this page

Marketplace 수익 공유 작업 - AWS 파트너 센트럴
Marketplace 수익 공유란 무엇입니까?Marketplace 수익 공유 작업Marketplace 수익 공유 태그 지정

AWS Partner Central API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 AWS Partner Central API 참조를 참조하세요.

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

Marketplace 수익 공유 작업

Marketplace 수익 공유는AWS Marketplace를 통해 수집된 제품 총 수익의 일부를 선언하는AWS Marketplace 제품에 대한 입력입니다.는이 입력을AWS사용하여 파트너의 Marketplace 수집 수익과 다른 수익 신호를 상호 연관시킵니다.

Marketplace Revenue Share Service는 APIs 노출하여 Marketplace Revenue Share 리소스를 생성, 검색 및 나열하고 할당(파트너가 선언한 수익 공유 비율 및 유효 날짜 기간)을 관리합니다. 표준AWS태그 지정 작업은 Marketplace Revenue Share 리소스에서 지원됩니다.

Marketplace 수익 공유란 무엇입니까?

Marketplace 수익 공유에는 두 개의 계층이 있습니다.

  • 공유 - Marketplace 로 식별되는 단일AWS Marketplace 제품에 대한 입력입니다ProductId. 제품당 Marketplace 수익 공유는 정확히 1개입니다.

  • 하나 이상의 할당 - 각 할당은 RevenueSharePercent 및 유효 날짜 기간(EffectiveDate, 선택 사항)을 선언합니다ExpirationDate. 공유는 시간이 지남에 따라 많은 할당을 가질 수 있지만 언제든지 하나의 ACTIVE 할당만 적용될 수 있습니다.

할당에는 다음과 같은 주요 속성이 있습니다.

  • 상태 - ACTIVE 또는 INACTIVE. 생성 시 상태는 기본적으로 로 설정됩니다ACTIVE. ACTIVE 할당만 수익 계산 및 중복 검사에 참여합니다.

  • 겹치는 불변성 - 단일 공유 내에서 두 ACTIVE 할당에 겹치는 [EffectiveDate, ExpirationDate] 범위가 있을 수 없습니다. 언제든지 공유당 최대 1개의 개방형 ACTIVE 할당( 없음ExpirationDate)이 허용됩니다.

Marketplace 수익 공유 작업

파트너는 Marketplace Revenue Share Service를 통해 Marketplace Revenue Shares 및 할당을 관리합니다. 수명 주기는 공유 흐름(생성, 검색, 나열, 태그)과 할당 흐름(생성, 업데이트, 소프트 삭제, 검색, 목록)의 두 흐름을 통해 진행됩니다.

Marketplace 수익 공유 생성

첫 번째 단계는 CreateMarketplaceRevenueShare API 작업을 사용하여 Marketplace 제품에 대한AWS Marketplace 수익 공유를 생성하는 것입니다. 공유는 Marketplace에서 식별ProductId되며 모든 후속 할당을 위한 컨테이너 역할을 합니다.

Marketplace 수익 공유를 생성할 때 파트너는 다음을 제공해야 합니다.

  • Catalog - AWS 프로덕션용 또는 테스트Sandbox용.

  • ProductId - 25자 Marketplace 제품 ID입니다. 패턴: [a-z0-9]{25}.

파트너는 선택적으로 다음을 제공할 수 있습니다.

  • Tags - 생성 시 리소스 조직에 대해 최대 50개의 키-값 페어. 생성 후 TagResource를 사용하여 태그를 추가합니다.

  • ClientToken - 재시도 시 중복 생성을 방지하기 위한 멱등성 토큰입니다. 최대 64자입니다. SDKs이 토큰을 자동으로 생성합니다.

제품 검증: 생성 시 서비스는AWS Marketplace를 통해 호출자의 계정 또는 PAC(파트너 계정 연결)를 통해 호출자에게 연결된 자회사 계정이 제품을 소유하고 있는지 확인합니다. 제품이 없거나 호출자에게 소유 계정이 승인되지 않은 경우 API는 이유와 ValidationException 함께를 반환합니다PRODUCT_NOT_FOUND_OR_NOT_OWNED.

제품당 공유 1개: 동일한 ProductId에서 동일한에 대한 두 번째 CreateMarketplaceRevenueShare 호출은를 Catalog 반환합니다ConflictException.

응답은 공유의 Arn (형식 arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}), Catalog, ProductId, 초기 Version 숫자(각 할당 변형에 대해 1부터 시작하여 증분) 및 생성 시 적용된 모든 태그를 반환합니다.

할당 추가

Marketplace 수익 공유가 생성되면 파트너는 CreateMarketplaceRevenueShareAllocation API 작업을 통해 할당을 생성하여 수익 공유 비율과 유효 날짜 기간을 선언합니다.

할당을 생성할 때 파트너는 다음을 제공해야 합니다.

  • Catalog - AWS 또는 Sandbox.

  • MarketplaceRevenueShareIdentifier - 상위 공유의 식별자입니다.

  • RevenueSharePercent - 10진수로 제공된 Marketplace를 통해 수집된 제품 수익의 백분율입니다(예: 0.45 45%).

  • EffectiveDate -이 할당이 적용되는 달력 날짜입니다. 형식: YYYY-MM-DD

응답은 할당Id(형식 mrsa-[A-Za-z0-9]{13}), 할당 상태(ACTIVE생성 시) 및 상위 공유의 범프Version(모든 할당 변형에서 공유당 단일 버전 정수가 범프되어 후속 할당 업데이트에서 낙관적 잠금에 사용됨)를 반환합니다.

할당 업데이트

파트너는 UpdateMarketplaceRevenueShareAllocation API 작업을 사용하여 할당을 업데이트할 수 있습니다. 업데이트 가능한 필드는 할당이 미래 날짜인지, 현재 유효한지 또는 과거 날짜인지에 따라 달라집니다.

할당을 업데이트할 때 파트너는 다음을 제공해야 합니다.

  • Catalog - AWS 또는 Sandbox.

  • MarketplaceRevenueShareIdentifier - 상위 공유의 식별자입니다.

  • AllocationId - 업데이트할 할당의 mrsa- ID입니다.

  • MarketplaceRevenueShareVersion - 할당에 대한 낙관적 잠금을 위한 상위 공유의 현재 버전입니다. 범프 충돌은를 반환합니다ConflictException.

파트너는 선택적으로 다음을 제공할 수 있습니다.

  • RevenueSharePercent - 업데이트된 수익 공유 비율입니다. 미래 날짜의 할당에서만 편집할 수 있습니다.

  • EffectiveDate - 업데이트된 유효 날짜입니다. 미래 날짜의 할당에서만 편집할 수 있습니다.

  • ExpirationDate - 업데이트된 만료 날짜입니다. 미래 날짜 할당(모든 값 > EffectiveDate) 및 현재 유효하거나 개방형 할당(모든 값 )에서 편집할 수 있습니다≥ today.

  • Status - ACTIVE 또는 INACTIVE. 를 로 설정하면 할당이 INACTIVE 소프트 삭제됩니다. 미래 날짜의 할당에서만 편집할 수 있습니다.

  • ClientToken - 멱등성 토큰입니다.

Marketplace 수익 공유 세부 정보 보기

파트너는 GetMarketplaceRevenueShare API 작업을 사용하여 단일 Marketplace 수익 공유에 대한 전체 정보를 검색할 수 있습니다. 그러면 공유의 Arn, Catalog, ProductId, Version (상위 공유의 현재 버전), CreatedDateLastModifiedDate, 및 공유에 적용된 모든 태그가 반환됩니다.

파트너는 할당의와 함께 GetMarketplaceRevenueShareAllocation API 작업을 사용하여 단일 할당을 검색할 수 있습니다Id. 반환:

  • 할당 Id 및 상위 공유의 입니다MarketplaceRevenueShareArn.

  • RevenueSharePercent, EffectiveDate, ExpirationDate.

  • Status (ACTIVE 또는 INACTIVE).

  • 후속 업데이트 시 낙관적 잠금을 MarketplaceRevenueShareVersion 위한 상위 공유의 입니다.

  • CreatedDate 및 LastModifiedDate.

Marketplace 수익 공유 나열

파트너는 ListMarketplaceRevenueShares API 작업을 사용하여 자신의 계정이 소유한 모든 Marketplace 수익 공유를 볼 수 있습니다. 페이지가 매겨진 공유 요약 목록이 반환됩니다.

파트너는 다음을 기준으로 결과를 필터링할 수 있습니다.

  • Catalog - AWS 또는 Sandbox (필수).

  • ProductIds - 검색할 특정 Marketplace 제품 IDs의 목록입니다.

응답에는 Arn, , Catalog, 최신 ProductId, CreatedDate및 각 공유에 대한 요약Version이 포함됩니다LastModifiedDate.

MaxResults 및 NextToken를 사용하여 대규모 결과 집합을 페이지 매김합니다.

할당 나열

파트너는 ListMarketplaceRevenueShareAllocations API 작업을 사용하여 특정 Marketplace 수익 공유에 대한 할당을 나열할 수 있습니다. 그러면 필터링 기능이 있는 할당 요약의 페이지가 매겨진 목록이 반환됩니다.

파트너는 다음을 기준으로 결과를 필터링할 수 있습니다.

  • Status - ACTIVE 또는 INACTIVE.

  • 유효 날짜 범위 - 유효 날짜가 특정 기간 내에 속하는 할당을 검색EffectiveDateOnOrBefore하는 EffectiveDateOnOrAfter /입니다.

응답에는 Id, , , RevenueSharePercent, EffectiveDate, 및 감사 타임스탬프ExpirationDateStatusMarketplaceRevenueShareVersion와 같은 각 할당에 대한 요약 정보가 포함됩니다.

Marketplace 수익 공유 태그 지정

표준AWS태그 지정 작업은 Marketplace Revenue Share 리소스에서 지원됩니다.

  • TagResource - Marketplace 수익 공유에 태그를 추가하거나 덮어씁니다. 공유당 최대 50개의 태그.

  • UntagResource - 키별로 특정 태그를 제거합니다.

  • ListTagsForResource - Marketplace 수익 공유에 현재 적용된 모든 태그를 검색합니다.

할당은 태그를 지원하지 않습니다. 상위 공유에 태그를 지정하여 관련 할당을 구성합니다.

각 태그 지정 작업은 공유의 Arn (형식 arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId})를 리소스 식별자로 수락합니다. Standard AWS tag-on-create는의 Tags 필드를 통해서도 지원됩니다CreateMarketplaceRevenueShare.