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

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

수익 속성 IDs 작업

수익 속성 ID는AWS Marketplace 제품 수익을 특정AWS Marketplace 제안 및/또는AWS파트너 중앙 기회에 매핑하는 거래 수준 식별자입니다. 제품 수준 파트너 수익 측정(PRM) 구현을 기반으로 구축됩니다. PRM은 Marketplace 제품의 총 귀속 수익을 캡처하고, 수익 속성 ID는 지정한 월별 비용 할당 백분율에 따라 해당 수익을 특정 거래에 매핑합니다.

수익 속성 서비스는 수익 속성 IDs하고 월별 비용 할당 항목을 비동기적으로 관리하기 위해 APIs를 노출합니다.

수익 속성 ID란 무엇입니까?

수익 속성 ID에는 두 개의 계층이 있습니다.

수익 속성 ID는 두 가지 방법으로 사용할 수 있습니다.

수익 속성 IDs 작업

파트너는 수익 속성 서비스를 통해 수익 속성 IDs와 월별 비용 할당 항목을 관리할 수 있습니다. 수명 주기는 어트리뷰션 레코드 흐름(생성, 업데이트, 검색, 나열)과 할당 흐름(배치 작업 시작, 결과 폴링, 개별 항목 검색, 어트리뷰션 항목 나열)의 두 가지 독립 흐름을 통해 진행됩니다.

수익 속성 ID 생성

첫 번째 단계는 CreateRevenueAttribution API 작업을 사용하여 수익 속성 ID를 생성하는 것입니다. 반환된 Id 및는 리소스 태그 값으로 즉시 사용하거나 사용자 에이전트 문자열에서AWS사용 속성을 지정할 Arn 수 있습니다.

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

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

모범 사례: 거래가 특정 Marketplace 목록에 고정될 MarketplaceProduct.ProductIdentifier 때마다 제공합니다. 이를 통해는 호출하는 파트너 계정 또는 파트너 계정 연결(PAC)을 통해 연결된 자회사 계정이 제품을 소유하고 있는지AWS확인하고 응답에 확인된 ProductCode 및 ProductType (예: SaaS, AMI, ML)를 표시할 수 있습니다. 승인된 계정이 제품을 소유하지 않은 경우 API는 이유와 ValidationException 함께를 반환합니다PRODUCT_NOT_FOUND_OR_NOT_OWNED.

응답은 새 Id (형식 ra-[a-z0-9]{13}), , Arn확인된 MarketplaceProduct 속성 및 초기 Version 숫자(1부터 시작하여 각 후속 업데이트 시 증분)를 반환합니다.

월별 비용 할당 항목 추가

수익 속성 ID가 생성되면 파트너는 StartRevenueAttributionAllocationsTask API 작업을 통해 월별 비용 할당 항목 배치를 제출하여AWS Marketplace 제안 및/또는 ACE 기회를 여기에 연결합니다. 이는 작업당 최대 250개의 할당 변경(CREATE 및/또는 UPDATE)을 허용하는 비동기 작업입니다.

각 할당 항목은 다음을 지정합니다.

지정된 수익 속성 ID 및 동일한 결제 월의 모든 할당 항목에 대한 총 비용 할당 %는 100%를 초과해서는 안 됩니다. 합계가 100%를 초과하면 레코드당 오류 코드로 비동기 비즈니스 검증 중에 문제가 되는 항목이 거부됩니다.

동기 검증: 기본 셰이프 검증을 동기적으로 StartRevenueAttributionAllocationsTask 수행합니다(필드 유형, 패턴, 배치 크기). 기본 검증이 통과하면 API는 상태가 TaskId 인를 반환합니다IN_PROGRESS. 비즈니스 검증(캡 검사, 불변성 규칙, Marketplace 및 ACE에 대한 종속성 조회)은 비동기적으로 실행되며 레코드별 결과는를 통해 검색됩니다GetRevenueAttributionAllocationsTask.

제출된 작업을 모니터링하기 위해 파트너는 수익 속성 리소스 ID 또는 ARNGetRevenueAttributionAllocationsTask으로 폴링합니다. 응답은에서 IN_PROGRESS로 진행되고COMPLETED(개별 레코드의 성공 또는 실패 여부에 관계없이) 다음을 반환합니다.

파트너는 작업 결과를 즉시 검색해야 합니다. 작업이 완료되면 레코드별 결과를 조정하고 실패한 항목을 수정하여 새 작업에 다시 제출할 수 있습니다.

월별 비용 할당 항목 편집

비용 할당 항목은 다음 규칙을 사용하여 결제 월별로 관리됩니다.

이번 달 7일 이후에는 이전 결제 월의 어트리뷰션을 더 이상 수정할 수 없습니다. 현재 또는 향후 달 항목에 대한 업데이트는 다음 월별 결제 주기부터 적용됩니다. 이전 달의 과거 속성은 소급하여 다시 계산되지 않습니다.

할당 항목에 UPDATE 대한 업데이트는 영향을 받는 각 항목에 대해가 로 Operation 설정된 동일한 StartRevenueAttributionAllocationsTask API 작업을 통해 제출됩니다. 비동기 작업 패턴은 업데이트 및 생성을 균일하게 처리합니다.

수익 속성 ID 업데이트

파트너는 UpdateRevenueAttribution API 작업을 사용하여 기존 수익 속성 IDDescription의를 업데이트할 수 있습니다. 어트리뷰션 레코드 자체는 변경할 수 없습니다. 생성 후에는 NameMarketplaceProduct, 및 tag-on-create 값을 변경할 수 없습니다. 리소스에 태그를 다시 지정하려면 어트리뷰션의 ARN에서 표준AWS태그 지정 작업을 사용합니다.

수익 속성 ID를 업데이트할 때 파트너는 다음을 제공해야 합니다.

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

낙관적 잠금: Version 필드는 마지막으로 검색된 이후 속성이 변경되지 않은 경우에만 업데이트가 적용되도록 합니다. 제출된가 현재 리소스 버전과 일치하지 Version 않으면와 함께 업데이트가 거부ConflictException되고 제출된 및 현재 버전 번호가 포함된 메시지가 표시됩니다. 모범 사례는 각 업데이트 GetRevenueAttribution 전에를 사용하여 최신 버전을 검색하는 것입니다.

수익 속성 ID 세부 정보 보기

파트너는 GetRevenueAttribution API 작업을 사용하여 단일 수익 속성 ID에 대한 전체 정보를 검색할 수 있습니다. 반환:

리소스 메타데이터:

Marketplace 제품 속성(생성 시 MarketplaceProduct가 설정된 경우):

감사 정보:

파트너는 필요에 따라 Version 요청에 특정를 제공하여 과거 버전의 어트리뷰션을 검색할 수 있습니다. 최신를 반환Version하려면 생략합니다.

파트너는 특정 월별 비용 할당 항목을 검색하기 위해 항목의와 함께 GetRevenueAttributionAllocation API 작업을 사용합니다AllocationId. 그러면 제안 ID 또는 기회 ID, 결제 월, 비용 할당 %, 고객AWS계정 ID, 항목의 상태 및 감사 정보가 반환됩니다.

수익 속성 IDs 나열

파트너는 ListRevenueAttributions API 작업을 사용하여 계정의 모든 수익 속성 IDs를 볼 수 있습니다. 필터링 및 정렬 기능이 있는 속성 요약의 페이지 매김 목록을 반환합니다.

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

파트너는 Sort 파라미터를 사용하여 결과 정렬을 구성할 수 있습니다.

응답에는 Arn, , Id, , Catalog, Name확인된 MarketplaceProduct 속성, CreatedDate, Version, LastModifiedDate최신 및 TotalRevenueAttributionAssociationCount (속성에 연결된 활성 월별 비용 할당 항목 수)의 각 속성에 대한 요약이 포함됩니다.

MaxResults (기본값 25, 최대 100) 및 NextToken를 사용하여 큰 결과 집합을 페이지 매김합니다. 추가 페이지를 사용할 수 있는 NextToken 경우 응답에이 포함됩니다.

월별 비용 할당 항목 나열

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

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

응답에는 AllocationId, 관련 제안 ID 또는 기회 ID, 고객AWS계정 ID, 결제 월, 비용 할당 %, 항목의 이름과 상태, 감사 타임스탬프 등 각 항목에 대한 요약 정보가 포함됩니다.

대시보드 구축: ListRevenueAttributions 및의 조합ListRevenueAttributionAllocations은 파트너 대시보드 생성을 지원하도록 설계되었습니다. 파트너는 다음과 같은 뷰를 빌드할 수 있습니다.