AWS Partner Central API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Partner Central API 참조](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 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]` 범위가 있을 수 없습니다. 언제든지 공유당 최대 하나의 개방형 `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` (상위 공유의 현재 버전), `CreatedDate``LastModifiedDate`, 및 공유에 적용된 모든 태그가 반환됩니다.
파트너는 할당의와 함께 `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`, 및 감사 타임스탬프`ExpirationDate``Status``MarketplaceRevenueShareVersion`와 같은 각 할당에 대한 요약 정보가 포함됩니다.
## 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`.