기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS Marketplace 이벤트에 대한 판매자 알림
구독 변경, 비공개 제안 수락, 전문 서비스 요청 등 AWS Marketplace 제품과 관련된 중요한 이벤트에 대한 알림을 받을 수 있습니다. Amazon EventBridge는 프로그래밍 방식의 통합에 권장되는 접근 방식이며 이메일 알림도 사용할 수 있습니다. SNS 주제는 기존 통합에 계속 사용할 수 있지만 Amazon EventBridge로 대체되고 있습니다. 이 주제에서는 사용 가능한 알림 및 이벤트 옵션에 대한 개요를 제공합니다.
+ **EventBridge** - EventBridge를 사용하여 제안이 생성될 때와 AWS Marketplace같이에서 발생하는 작업에 대한 이벤트를 수신할 수 있습니다. 이벤트에는 ID, 만료 날짜, 제품 세부 정보 등의 정보가 포함되어 있습니다. 자세한 내용은 [Amazon EventBridge 이벤트](notifications-eventbridge.md) 및 [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)를 참조하세요. SaaS 제품에 대한 자세한 내용은 섹션을 참조하세요[Amazon EventBridge를 사용하여 SaaS 구독 이벤트 관리](saas-eventbridge-integration.md).
+ **이메일 알림** - 내에서 판매자 AWS Marketplace , 구매자 및 독립 소프트웨어 공급업체(ISVs)는 이메일 알림을 받을 수 있습니다.는 루트 계정을 AWS Marketplace 사용하여 AWS 계정의 이메일로 자동 이메일을 실시간으로 전송하여 AWS Marketplace 제안 및 계약에 대한 업데이트를 제공합니다. 알림에 대한 사용자 지정 이메일 별칭을 추가하고 이메일 알림에서 수신자 구독을 취소할 수도 있습니다. 자세한 내용은 [AWS Marketplace 이벤트에 대한 이메일 알림 관리](email-notifications.md) 단원을 참조하십시오.
+ **Amazon SNS 주제** - 제품의 고객 구독 변경 사항에 대한 알림을 받으려면 제품 생성 중에 AWS Marketplace 제공되는에 대한 Amazon SNS 주제를 구독하면 됩니다. 예를 들어, 고객이 언제 비공개 제안을 수락하는지 알 수 있습니다. 자세한 내용은 제품 유형에 대한 Amazon SNS 주제를 참조하세요.
**중요**
AWS Marketplace SaaS 제품에 대한 SNS 알림이 Amazon EventBridge 알림으로 대체되고 있습니다. SNS와 통합된 기존 SaaS 제품이 있는 경우 해당 제품은 계속 작동합니다. 새 목록은 결국 SNS 대신 Amazon EventBridge 사용으로 전환됩니다. 자세한 내용은 [Amazon EventBridge를 사용하여 SaaS 구독 이벤트 관리](saas-eventbridge-integration.md) 단원을 참조하십시오.
+ [서비스형 소프트웨어(SaaS) 제품](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-notification.html)
+ [Amazon Machine Image(AMI) 제품](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-notification.html)
+ [컨테이너 제품](https://docs.aws.amazon.com/marketplace/latest/userguide/container-notification.html)
다음 주제에서는 AWS Marketplace의 알림 및 이벤트에 대한 자세한 정보를 제공합니다.
**Topics**
+ [AWS Marketplace 이벤트에 대한 이메일 알림 관리](email-notifications.md)
+ [Amazon EventBridge 이벤트](notifications-eventbridge.md)
# AWS Marketplace 이벤트에 대한 이메일 알림 관리
AWS Marketplace 는 제안, 계약, 구독, 제품, 보안, 결제 및 결제, Private Marketplace에 업데이트에 대한 이메일 알림을 보냅니다. 독립 소프트웨어 개발 판매 회사(ISV), AWS Marketplace 채널 파트너 및 고객은 이메일 알림을 받을 수 있습니다. 제안 및 계약 업데이트를 위해 전송된 이메일 알림의 예제와 세부 정보는 [지원되는 이메일 알림](#event-types) 섹션을 참조하세요.
AWS Marketplace 는 AWS 계정의 [루트 사용자](https://docs.aws.amazon.com/accounts/latest/reference/root-user.html)와 연결된 이메일 주소로 이메일 알림을 보냅니다. AWS 계정과 연결된 이메일 주소를 업데이트하려면 [AWS 계정의 기본 연락처 업데이트를 참조하세요](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html). 알림에 대한 [사용자 지정 이메일 별칭을 추가](#adding-updating-email-addresses)하고 이메일 알림에서 [수신자 구독을 취소](#unsubscribe-notifications)할 수도 있습니다.
**참고**
AWS Marketplace 이메일이 누락된 경우 스팸 폴더를 확인하거나 이메일 설정을 조정합니다. 의 이메일 알림 AWS Marketplace 은에서 전송됩니다`no-reply@marketplace.aws`. Google 및 Yahoo와 같은 공급자는 이러한 데이터를 필터링할 수 있습니다. 지침은 [유효한 이메일이 스팸(Google)으로 가는 것을 방지](https://support.google.com/mail/answer/1366858?sjid=4026678185875351798-NA#unmark_spam) 또는 [Block and unblock email addresses in Yahoo Mail](https://help.yahoo.com/kb/SLN28140.html)을 참조하세요.
**Topics**
+ [지원되는 이메일 알림](#event-types)
+ [필드 설명](#email-notification-field-descriptions)
+ [알림 관리](#manage-notifications)
## 지원되는 이메일 알림
기계 학습 제품을 제외한 모든 제품 및 요금 유형에 대해 다음 이메일 알림이 지원됩니다.
**Topics**
+ [제안 및 제안 세트](#email-details-offers)
+ [계약](#email-details-agreements)
+ [가변 결제](#email-details-variable-payments)
+ [지급](#email-details-disbursements)
+ [은행 계좌 세부 정보 추가](#add-bank-account-details)
+ [취소 및 결제 조정](#email-details-cancellations-adjustments)
### 제안 및 제안 세트
다음 표에는 제안 및 제안 세트에 대한 이벤트가 나와 있습니다. 제안은 구매자의 제품 사용에 대한 일련의 조건입니다. 자세한 정보는 [AWS Marketplace 제품에 대한 비공개 제안 준비](private-offers-overview.md) 섹션을 참조하세요. 제안 세트를 사용하면 여러 비공개 제안을 원클릭 구매 환경으로 결합할 수 있습니다. 자세한 정보는 [다중 제품 솔루션 준비](multi-product-solutions.md) 섹션을 참조하세요.
**참고**
AWS Marketplace 채널 파트너가 ISV의 제품을 포함하는 제안 세트를 생성하면 해당 ISV는 알림을 받지 않습니다.
| 이메일 | Event | 수신자 | 제목 | 필드 |
| --- | --- | --- | --- | --- |
| 제안 게시됨 CP 알림 CPPO | AWS Marketplace 채널 파트너 비공개 제안 게시. | 채널 파트너 | AWS Marketplace 채널 파트너 비공개 제안 게시 | 고객 AWS 계정 ID, ISV 이름, ISV AWS 계정 ID, 제품 이름, 제품 ID, 제안 ID, 기회 ID, 제안 게시 날짜, 제안 만료 날짜 |
| 제안 게시됨 ISV 알림 CPPO | AWS Marketplace 채널 파트너 비공개 제안 게시. | ISV | AWS Marketplace 채널 파트너 비공개 제안 게시 | 고객 AWS 계정 IDs, 채널 파트너, 채널 파트너 AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 기회 ID, 제안 게시 날짜, 제안 만료 날짜, 도매 가격 |
| OfferPubISVNotificationSCPO-1.0 | 판매자가 AWS Marketplace 채널 파트너 비공개 제안을 게시합니다. | ISV 또는 AWS Marketplace 채널 파트너 | 비공개 제안 게시됨 | 고객 AWS 계정 IDs, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 제안 게시 날짜, 제안 만료 날짜, 총 계약 금액 |
| 리셀러 기회 만료됨 | AWS Marketplace 채널 파트너 판매 권한 부여가 만료됩니다. | AWS Marketplace 채널 파트너 | 제안: 만료된 판매 권한 보기 | ISV, 제품 이름, 제품 ID |
| 리셀러 기회 취소됨 | ISV가 AWS Marketplace 채널 파트너 판매 권한 부여를 취소합니다. | AWS Marketplace 채널 파트너 | 제안: 비활성화된 판매 권한 보기 | ISV, 제품 이름, 제품 ID |
| 리셀러 기회 생성됨 | ISV는 AWS Marketplace 채널 파트너를 위한 판매 권한 부여 또는 기회를 생성합니다. | AWS Marketplace 채널 파트너 | 제안: 새 판매 권한을 위한 비공개 제안 생성 | ISV, 제품 이름, 제품 ID, 판매 승인 기간 |
| 제안 세트 게시됨 | 판매자가 제안 세트를 게시합니다. | ISV 또는 AWS Marketplace 채널 파트너 | 제안 세트 게시됨 | 제안 세트 ID, 제안 세트 이름, 제안 ID(들), 제안 이름(들) |
### 계약
ISVs와 AWS Marketplace 채널 파트너는 구매자가 공개 제안, 비공개 제안 또는 AWS Marketplace 채널 파트너 비공개 제안을 수락하면 이메일 알림을 받습니다. 제안이 수락되면 계약이 만들어집니다. 계약 수명 주기 이벤트에 대한 이메일 알림도 전송됩니다. 여기에는 구매자 수락 후 계약 시작, 취소, 교체 및 실패가 포함됩니다. 다음 테이블에는 계약 이벤트에 대해 전송되는 이메일이 나와 있습니다. 이메일 알림은 현재 일부 제품 유형에 사용할 수 있습니다. 특정 제품 유형에는 아직 이 기능이 없을 수 있습니다.
| 이메일 | Event | 수신자 | 제목 | 필드 |
| --- | --- | --- | --- | --- |
| 제안 수락됨 - 비공개 또는 공개 제안 | AWS Marketplace 고객이 공개 또는 비공개 제안을 수락합니다. | ISV | 고객이 AWS Marketplace 제안을 수락했습니다. | 고객 회사 이름, 고객 AWS 계정 ID, 제품 이름, 제품 ID, 계약 ID, 계약 시작 날짜, 계약 종료 날짜, 계약 수락 날짜, 구매 금액 |
| 제안 수락됨 - AWS Marketplace 채널 파트너 비공개 제안입니다. | AWS Marketplace 고객이 AWS Marketplace 채널 파트너 비공개 제안을 수락합니다. | ISV | 고객이 AWS Marketplace 채널 파트너 비공개 제안을 수락했습니다. | 고객 회사 이름, 고객 AWS 계정 ID, 채널 파트너 이름, 채널 파트너 AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 계약 ID, 계약 시작 날짜, 계약 종료 날짜, 계약 수락 날짜, 도매 가격 |
| 제안 수락됨 - AWS Marketplace 채널 파트너 비공개 제안입니다. | AWS Marketplace 고객이 AWS Marketplace 채널 파트너 비공개 제안을 수락합니다. | AWS Marketplace 채널 파트너 | 고객이 AWS Marketplace 채널 파트너 비공개 제안을 수락했습니다. | 고객 회사 이름, 고객 AWS 계정 ID, ISV 이름, ISV AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 계약 ID, 계약 시작 날짜, 계약 종료 날짜, 계약 수락 날짜, 도매 가격, 마진, 구매 금액 |
| 계약 시작됨 - 비공개 제안 | 계약 또는 구독 제품에 대한 AWS Marketplace 계약은 향후 시작일이 있는 비공개 제안에서 시작되었습니다. | ISV | AWS Marketplace 계약이 시작되었습니다. | 고객 AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 계약 ID, 계약 시작 날짜, 계약 종료 날짜, 구매 금액 |
| 계약 시작 - AWS Marketplace 채널 파트너 비공개 제안 | 계약 또는 구독 제품에 대한 AWS Marketplace 계약이 AWS Marketplace 채널 파트너 비공개 제안에서 시작되었습니다. | ISV | AWS Marketplace 계약이 시작되었습니다. | 고객 AWS 계정 ID, 채널 파트너 이름, 채널 파트너 AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 계약 ID, 계약 시작 날짜, 계약 종료 날짜, 도매 가격 |
| 계약 시작됨 - 비공개 제안 | AWS Marketplace 채널 파트너 비공개 제안을 수락하면 계약 또는 구독 제품에 대한 계약이 시작됩니다. | AWS Marketplace 채널 파트너 | AWS Marketplace 계약이 시작되었습니다. | 고객 AWS 계정 ID, ISV 이름, ISV AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 계약 ID, 계약 시작 날짜, 계약 종료 날짜, 마진, 구매 금액 |
| 계약 취소됨 - 비공개 또는 공개 제안 | 비공개 또는 공개 제안 계약 취소입니다. | ISV | AWS Marketplace 계약이 취소되었습니다. | 고객 AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 계약 ID, 계약 시작 날짜, 계약 종료 날짜 |
| 계약 취소됨 - AWS Marketplace 채널 파트너 비공개 제안 | AWS Marketplace 채널 파트너 비공개 제안 계약의 취소. | ISV | AWS Marketplace 계약이 취소되었습니다. | 고객 AWS 계정 ID, 채널 파트너, 채널 파트너 AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 계약 ID, 계약 시작 날짜, 계약 종료 날짜 |
| 계약 취소됨 - 채널 파트너 비공개 제안 | AWS Marketplace 채널 파트너 비공개 제안 계약의 취소. | AWS Marketplace 채널 파트너 | AWS Marketplace 계약이 취소되었습니다. | 고객 AWS 계정 ID, ISV, ISV AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 계약 ID, 계약 시작 날짜, 계약 종료 날짜 |
| 규정 준수 실패 - 공식 판매자 | 고객 결제 실패로 인해 AWS Marketplace 계약이 실패합니다. | 제안을 생성한 ISV 또는 AWS Marketplace 채널 파트너 | 필요한 작업: AWS Marketplace 계약 생성 실패 | 구독 AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 계약 ID |
| 결제 실패 - 공식 판매자 | 고객 결제 실패로 인해 AWS Marketplace 계약이 실패합니다. | 제안을 생성한 ISV 또는 AWS Marketplace 채널 파트너 | AWS Marketplace 계약에 대한 결제 실패 | 고객 AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 계약 ID |
| 계약이 대체됨 - 비공개 제안 | AWS Marketplace 계약이 다른 계약으로 대체됩니다. | ISV | AWS Marketplace 계약이 대체되었습니다. | 회사 이름, 고객 AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 새 계약 ID, 계약 시작 날짜, 계약 종료 날짜, 새 구매 금액 |
| 계약 대체됨 - 채널 파트너 비공개 제안 | AWS Marketplace 계약이 다른 계약으로 대체됩니다. | ISV | AWS Marketplace 계약이 대체되었습니다. | 회사 이름, 고객 AWS 계정 ID, 채널 파트너, 채널 파트너 AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 새 계약 ID, 계약 시작 날짜, 계약 종료 날짜, 도매 가격 |
| 계약 대체됨 - 채널 파트너 비공개 제안 | AWS Marketplace 계약이 다른 계약으로 대체됩니다. | AWS Marketplace 채널 파트너 | AWS Marketplace 계약이 대체되었습니다. | 회사 이름, 고객 AWS 계정 ID, ISV 이름, ISV AWS 계정 ID, 제품 이름, 제품 ID, 제안 이름, 제안 ID, 새 계약 ID, 계약 시작 날짜, 계약 종료 날짜, 도매 가격, 마진, 새 구매 금액 |
### 가변 결제
판매자와 구매자는 전문 서비스 비공개 제안에 대한 가변 결제 사용과 관련된 이메일 알림을 받게 됩니다. 가변 결제에 대한 자세한 내용은 섹션을 참조하세요[에서 전문 서비스 제품 요금 책정 AWS Marketplace](proserv-variable-payments.md).
| 이메일 | Event | 수신자 | 제목 | 필드 |
| --- | --- | --- | --- | --- |
| 결제 요청 - 승인됨 | 결제 승인 | Seller | AWS Marketplace 결제 요청이 승인되었습니다. | 고객 AWS 계정 ID, 결제 요청 수락 날짜, 제안 ID, 계약 ID, 결제 요청 ID, 결제 요청 금액, 결제 요청 통화 코드 |
| 결제 요청 - 거부됨 | 결제 거부 | Seller | AWS Marketplace 결제 요청이 거부되었습니다. | 고객 AWS 계정 ID, 결제 요청 거부 날짜, 제안 ID, 계약 ID, 결제 요청 ID, 결제 요청 금액, 결제 요청 통화 코드 |
| 결제 요청 - 자동 승인 | 자동 승인: 결제 생성 \$1 알림(결제 요청 생성 후 1, 3, 7, 9일에 이메일 전송) | 구매자 | AWS Marketplace 결제 요청을 받았습니다. | 자동 승인 날짜, 제안 ID, 계약 ID, 결제 요청 ID, 결제 요청 생성 날짜, 결제 요청 금액, 결제 요청 통화 코드 |
| 결제 요청 - 수동 승인 | 수동 승인: 결제 생성 \$1 알림(계약 날짜까지 7일마다 이메일 전송) | 구매자 | AWS Marketplace 결제 요청을 받았습니다. | 제안 ID, 계약 ID, 결제 요청 ID, 결제 요청 생성 날짜, 결제 요청 금액, 결제 요청 통화 코드 |
| 결제 요청 - 취소됨 | 결제 취소됨 | 구매자 | 판매자가 AWS Marketplace 결제 요청을 취소했습니다. | 제안 ID, 계약 ID, 결제 요청 취소 날짜, 결제 요청 ID, 결제 요청 금액, 결제 요청 통화 코드 |
### 지급
ISVs 및 채널 파트너는 잘못된 은행 계좌 세부 정보로 인해 지급이 일시 중지되면 이메일 알림을 받습니다.
| 이메일 | Event | 수신자 | 제목 | 필드 |
| --- | --- | --- | --- | --- |
| 지급이 일시 중지됨 - 잘못된 은행 계좌 정보 | AWS Marketplace 는 잘못된 은행 계좌 세부 정보로 인해 판매자에 대한 지급을 일시 중지합니다. | ISV 및 AWS Marketplace 채널 파트너 | 지급 일시 중지 | 리소스 ARN |
`Resource ARN` 필드에 잘못된 은행 계좌 Amazon 리소스 번호(ARN)가 표시됩니다. AWS Marketplace Management Portal(AMMP)에서 [은행 계좌를 추가하여](#add-bank-account-details)이 문제를 해결할 수 있습니다.
### 은행 계좌 세부 정보 추가
AWS Marketplace Management Portal(AMMP)에 은행 계좌 세부 정보를 추가하여 지급에서 잘못된 은행 계좌 ARN 오류를 수정합니다.
`Resource ARN` 필드에는 잘못된 은행 계좌의 ARN이 표시됩니다. 문제를 해결하려면 AWS Marketplace 관리 포털에 은행 계좌를 추가합니다. 다음 단계에서는 그 방법을 설명합니다.
**은행 계좌 세부 정보를 추가하려면**
1. AWS Marketplace 판매자 계정으로 [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/)에 로그인합니다.
1. 메뉴 모음에서 **설정**을 선택합니다.
1. **결제 정보** 탭을 선택합니다.
1. **은행 계좌** 섹션에서 **은행 계좌 추가**를 선택합니다.
1. 은행 계좌 세부 정보를 추가하고 정확성을 검토합니다. 자세한 내용은 이 안내서의 앞부분에서 [3단계: 은행 계좌 정보 제공](provide-bank-information.md) 섹션을 참조하세요.
1. 구매자로부터 결제를 받으려면 **지급 방법**에서 **지급 방법 추가**를 선택합니다.
1. 고객확인제도(KYC) 및 은행 계좌를 확인하라는 메시지가 표시되면 확인 단계를 따릅니다.
1. 변경 내용을 저장합니다.
### 취소 및 결제 조정
판매자, 구매자 및 ISVs(CPPO용)는 계약 취소 및 결제 조정 이벤트에 대한 이메일 알림을 받습니다. 다음 표에는 취소 및 결제 조정 이벤트에 대해 전송되는 이메일이 나와 있습니다.
**취소 요청 이메일**
| Event | 수신자 | 제목 | 필드 |
| --- | --- | --- | --- |
| 취소 요청 제출됨 | 판매자, 구매자, 제조업체(CPPO) | 계약 취소 요청을 제출했습니다. | 구매자 계정 ID, 계약 ID, 제품 ID, 제안 ID, 요청 ID, 요청 날짜, 요청 만료 날짜, 취소 이유, 추가 세부 정보, 응답 양식 URL |
| 취소 요청 승인됨(구매자 또는 자동 승인됨) | 판매자, 구매자, 제조업체(CPPO) | 계약 취소 요청 승인됨 | 계약 ID, 제품 ID, 제안 ID, 요청 ID, 요청 날짜, 취소 이유, 취소 날짜 |
| 취소 요청 거부됨 | 판매자, 구매자, 제조업체(CPPO) | 계약 취소 요청 거부됨 | 계약 ID, 제품 ID, 제안 ID, 요청 ID, 요청 날짜, 취소 이유, 거부 이유, 거부 날짜 |
| 취소 요청 취소 | 판매자, 구매자, 제조업체(CPPO) | 계약 취소 요청 취소 | 계약 ID, 제품 ID, 제안 ID, 요청 ID, 요청 날짜, 철회 이유 |
| 취소 요청 검증 실패 | 판매자만 | 계약 취소 요청 실패 | 계약 ID, 제품 ID, 요청 ID, 요청 날짜, 취소 이유 |
**결제 조정 이메일**
| Event | 수신자 | 제목 | 필드 |
| --- | --- | --- | --- |
| 결제 조정 처리됨 | 판매자, 구매자, 제조업체(CPPO) | 결제 조정 처리됨 | 계약 ID, 제품 ID, 제안 ID, 요청 ID, 인보이스 ID(들), 통화 코드가 포함된 환급 금액, 요청 날짜, 결제 조정 이유 |
| 결제 조정 실패 | 판매자만 | 결제 조정 요청 실패 | 계약 ID, 제품 ID, 요청 ID, 인보이스 ID(들), 요청 날짜, 결제 조정 이유 |
**참고**
CPPO 계약의 경우 ISV(제조업체)는 채널 파트너가 취소 및 결제 조정 요청을 제출하거나 완료할 때 알림을 받습니다. 그러나 채널 파트너 마진 정보를 보호하기 위해 구매자에게 보내는 환불 금액 및 메시지는 ISV 알림에 포함되지 **않습니다**.
## 필드 설명
다음 표에는 [제안 및 제안 세트](#email-details-offers) 및 [계약](#email-details-agreements) 테이블에서 참조되는 필드에 대한 설명이 나와 있습니다.
| 필드 | 설명 |
| --- | --- |
| 고객 회사 이름 | 구독자의 회사 이름입니다. |
| 고객 AWS 계정 ID | 제품을 구독한 AWS 계정의 ID입니다. |
| ISV 이름 | 판매자 회사 이름입니다. |
| ISV AWS 계정 ID | 판매자 AWS 계정의 ID입니다. |
| 제품 이름 | 제품의 제목입니다. |
| 제품 ID | 소프트웨어 제품의 익숙한 고유 식별자입니다. |
| 제안 이름 | 제안의 제목입니다. |
| 제안 ID | 구매자가 서명한 제안의 식별자입니다. |
| 제안 표시 여부 | 공개 제안인지, 비공개 제안인지 또는 기업 계약 제안인지 나타냅니다. |
| 계약 ID | 제품 사용을 시작하기 위해 제안자와 수락자 간에 체결한 계약의 고유한 계약 데이터 피드 참조입니다. |
| 계약 시작 날짜 | 고객의 제품 구독이 시작되는 날짜로, `MM-DD-YYYY` 형식입니다. 미래 날짜의 계약인 경우 이 날짜가 수락 날짜와 다를 수 있습니다. |
| 계약 수락 날짜 | 고객이 제품을 구독한 날짜로, `MM-DD-YYYY` 형식입니다. |
| 계약 종료 날짜 | 계약이 만료되는 날짜로, `MM-DD-YYYY` 형식입니다. 과금형/종량제 구독의 경우 이 날짜는 `JAN-1-9999`로 설정됩니다. |
| 계약 종료 날짜 | 계약이 만료되는 날짜로, `MM-DD-YYYY` 형식입니다. 과금형/종량제 구독의 경우 이 날짜는 `JAN-1-9999`로 설정됩니다. |
| 구매 금액 | 계약의 예상 비용으로, 총 계약 가치라고도 합니다. 이는 SaaS, 전문 서비스 및 서버 제품 유형과 계약 또는 연간 요금 유형에 적용됩니다. |
| 채널 파트너 회사 이름 | 고객에게 재판매할 목적으로 ISV로부터 도매로 제품 또는 서비스를 구매한 계정의 이름입니다. |
| 채널 파트너 AWS 계정 ID | 고객에게 재판매하기 위해 ISV에서 제품 또는 서비스를 구매한 AWS Marketplace 채널 파트너의 AWS 계정 ID입니다. |
| 도매 가격 | 제품을 AWS Marketplace 채널 파트너에게 재판매하기 위한 ISV의 도매 비용입니다. |
| 통화 코드 | 계약의 예상 비용과 관련된 제안 요금 통화입니다. |
| 다음 계약 ID | 갱신되거나 업그레이드된 계약의 계약 ID입니다. |
| 제안 게시 날짜 | 판매자가 제안을 게시한 날짜입니다. |
| 제안 만료 날짜 | 제안이 만료되는 날짜입니다. |
| 기회 ID | 등록된 기회에 대한 고유 식별자입니다. |
| 판매 권한 부여 기간 | 판매 권한에서 지정된 할인을 사용하여 리셀러가 제안을 만들 수 있는 기간입니다. |
## 알림 관리
다음 주제에서는 이벤트에 대한 이메일 알림을 관리하는 방법을 설명합니다.
### 이메일 주소 추가 또는 업데이트
AWS Marketplace Management Portal을 사용하여 사용자 지정 이메일 알림을 받을 이메일 주소를 10개까지 추가할 수 있습니다.
**이메일 주소를 추가 또는 업데이트하는 방법**
1. [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/)에 로그인합니다.
1. **설정에서** **알림** 탭을 선택합니다.
1. **사용자 지정 알림을 위한 이메일**에서 **이메일 주소 추가**를 선택합니다.
1. **수신자 세부 정보**의 **이메일 주소** 필드에 사용자 지정 이메일 주소를 입력합니다.
1. (선택 사항) **새 수신자 추가**를 선택하여 다른 이메일 주소를 추가합니다(최대 10개).
1. **제출**을 선택합니다.
### 알림에서 수신자 구독 해제
이메일 주소를 제거하여 사용자 지정 이메일 알림에서 수신자를 구독 해제할 수 있습니다.
**이벤트 알림에서 수신자를 구독 해제하는 방법**
1. [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/)에 로그인합니다.
1. **설정에서** **알림** 탭을 선택합니다.
1. **사용자 지정 알림을 위한 이메일**에서 **이메일 주소 업데이트**를 선택합니다.
1. **수신자 세부 정보**에서 **제거**를 선택하여 이메일 주소를 제거합니다.
1. **제출**을 선택합니다.
**참고**
이메일의 링크를 사용하여 구독 해제할 수도 있습니다.
# Amazon EventBridge 이벤트
판매자는 Amazon EventBridge를 사용하여 AWS Marketplace의 이벤트에 대한 알림을 받을 수 있습니다. 예를 들어 제안이 생성될 AWS Marketplace 때에서 *이벤트를* 수신할 수 있습니다. **이벤트에는 ID, 만료 날짜, 제품 세부 정보 등의 세부 정보가 포함되어 있습니다. EventBridge는 애플리케이션을 다양한 소스의 데이터와 연결하는 데 사용할 수 있는 이벤트 버스 서비스입니다. 자세한 내용은 [**Amazon EventBridge 사용 설명서](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)를 참조하세요. 다음 섹션에서는 EventBridge 콘솔의 Marketplace 카탈로그 서비스에 있는 이벤트에 대한 자세한 정보를 제공합니다.
**Topics**
+ [새 제안에 대한 이벤트](#events-offerreleased)
+ [변경 세트에 대한 이벤트](#events-changesets)
+ [보안 요약 보고서 이벤트](#events-security-report)
+ [지급 이벤트](#events-for-disbursements)
+ [계약 이벤트](#events-for-agreements)
+ [라이선스 이벤트](#events-for-licenses)
+ [취소 이벤트](#events-for-cancellations)
+ [결제 조정 이벤트](#events-for-billing-adjustments)
이 주제
| 판매자 조치 | 이벤트 수신 | 관련 주제 |
| --- | --- | --- |
| 독립 소프트웨어 개발 판매 회사(ISV)가 제안을 생성하고 구매할 수 있게 설정 | Offer Released | [새 제안에 대한 이벤트](#events-offerreleased) |
| 채널 파트너가 ISV의 제품을 사용하여 제안 생성 | Offer Released | [새 제안에 대한 이벤트](#events-offerreleased) |
| 채널 파트너가 제안 생성 | Offer Released | [새 제안에 대한 이벤트](#events-offerreleased) |
| ISV에서 새 제안 세트 생성 | OfferSet Released | [새 제안에 대한 이벤트](#events-offerreleased) |
| 채널 파트너가 새 제안 세트 생성 | OfferSet Released | [새 제안에 대한 이벤트](#events-offerreleased) |
| 변경 세트 성공 | Change Set Succeeded | [변경 세트에 대한 이벤트](#events-changesets) |
| 변경 세트 실패 | Change Set Failed | [변경 세트에 대한 이벤트](#events-changesets) |
| 변경 세트가 취소됨 | Change Set Cancelled | [변경 세트에 대한 이벤트](#events-changesets) |
| ISV 제품에서 보안 취약성이 감지됨 | Products Security Report Created | [보안 요약 보고서 이벤트](#events-security-report) |
| 고객이 SaaS 제품 구독 | Purchase Agreement Created | [계약 이벤트](#events-for-agreements) |
| 고객의 SaaS 계약 개정 | Purchase Agreement Amended | [계약 이벤트](#events-for-agreements) |
| 고객이 SaaS 구독을 취소함 | Purchase Agreement Ended | [계약 이벤트](#events-for-agreements) |
| 고객의 SaaS 권한 변경 | License Updated | [라이선스 이벤트](#events-for-licenses) |
| 고객의 SaaS 권한이 취소됨 | License Deprovisioned | [라이선스 이벤트](#events-for-licenses) |
| 판매자가 취소 요청을 제출합니다. | Agreement Cancellation Request Pending Approval - Proposer | [취소 이벤트](#events-for-cancellations) |
| 취소 요청이 승인되거나 자동 승인됨 | Agreement Cancellation Request Approved - Proposer | [취소 이벤트](#events-for-cancellations) |
| 구매자가 취소 요청을 거부함 | Agreement Cancellation Request Rejected - Proposer | [취소 이벤트](#events-for-cancellations) |
| 판매자가 취소 요청 철회 | Agreement Cancellation Request Cancelled - Proposer | [취소 이벤트](#events-for-cancellations) |
| 취소 요청이 검증에 실패함 | Agreement Cancellation Request Validation Failed - Proposer | [취소 이벤트](#events-for-cancellations) |
| 결제 조정이 처리됨 | Purchase Agreement Billing Adjustment Completed - Proposer | [결제 조정 이벤트](#events-for-billing-adjustments) |
| 결제 조정이 검증에 실패함 | Purchase Agreement Billing Adjustment Failed - Proposer | [결제 조정 이벤트](#events-for-billing-adjustments) |
## 새 제안에 대한 이벤트
판매자가 제안을 생성하고 구매할 수 있게 만들면 `Offer Released`라는 세부 정보 유형의 이벤트를 받을 수 있습니다.
**참고**
EventBridge 규칙 생성에 대한 자세한 내용은 **Amazon EventBridge 사용 설명서의 [Amazon EventBridge 규칙](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)을 참조하세요.
다음은 ISV가 생성한 새 제안에 대한 이벤트 본문 예시입니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Offer Released",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2023-08-26T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/offer-1234567890123"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"offer": {
"id": "offer-1234567890123",
"arn": "arn:aws:catalog:us-east-1:123456789012:Offer/offer-1234567890123",
"name": "Offer Name",
"expirationDate": "2025-08-26T00:00:00Z"
},
"product": {
"id": "bbbbaaaa-abcd-1111-abcd-666666666666",
"arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
"title": "Product Title"
},
"manufacturer": {
"accountId": "123456789012",
"name": "Manufacturer Account Name"
},
"sellerOfRecord": {
"accountId": "123456789012",
"name": "Seller Account Name"
},
"targetedBuyerAccountIds": [
"999988887777",
"111122223333"
]
}
}
```
다음은 채널 파트너가 ISV의 제품을 사용하여 제안을 생성할 때의 이벤트 본문 예시입니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Offer Released",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2023-08-26T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"offer": {
"id": "offer-1234567890123",
"arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
"name": "Offer Name",
"expirationDate": "2025-08-26T00:00:00Z"
},
"product": {
"id": "bbbbaaaa-abcd-1111-abcd-666666666666",
"arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
"title": "Product Title"
},
"manufacturer": {
"accountId": "123456789012",
"name": "Manufacturer Account Name"
},
"sellerOfRecord": {
"accountId": "987654321098",
"name": "Seller Account Name"
},
"targetedBuyerAccountIds": ["999988887777", "111122223333"],
}
}
}
```
다음은 채널 파트너가 제안을 생성할 때의 이벤트 본문 예시입니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Offer Released",
"source": "aws.marketplacecatalog",
"account": "987654321098",
"time": "2023-08-26T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"offer": {
"id": "offer-1234567890123",
"arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
"name": "Offer Name",
"expirationDate": "2025-08-26T00:00:00Z"
},
"product": {
"id": "bbbbaaaa-abcd-1111-abcd-666666666666",
"arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
"title": "Product Title"
},
"manufacturer": {
"accountId": "123456789012",
"name": "Manufacturer Account Name"
},
"sellerOfRecord": {
"accountId": "987654321098",
"name": "Seller Account Name"
},
"targetedBuyerAccountIds": ["999988887777", "111122223333"],
}
}
}
```
다음은 파트너(ISV 또는 채널 파트너)가 게시한 새 제안 세트에 대한 이벤트 본문의 예입니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "OfferSet Released",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2023-08-26T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/OfferSet/offerset-1234567890123"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"offerSet": {
"id": "offerset-1234567890123",
"arn": "arn:aws:catalog:us-east-1:987654321098:OfferSet/offerset-1234567890123",
"name": "Offer Set Name",
},
"associatedOffers": [
{
"offer": {
"id": "offer-1234567890123",
"arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
"name": "Offer Name",
}
},
...
]
}
}
```
## 변경 세트에 대한 이벤트
변경 세트가 완료되면 판매자, 채널 파트너 및 프라이빗 마켓플레이스 관리자가 이벤트를 받을 수 있습니다. AWS Marketplace Catalog API는 변경 세트가 성공, 실패 또는 취소됨 상태로 완료되면 이벤트를 전송합니다. 이러한 이벤트의 소스는 `aws.marketplacecatalog`이며 가능한 세부 정보 유형 값은 `Change Set Succeeded`, `Change Set Failed` 및 `Change Set Cancelled`입니다.
**참고**
변경 세트에 대한 자세한 내용은 **AWS Marketplace Catalog API 참조의 [변경 세트 작업](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets)을 참조하세요.
각 이벤트에는 변경 세트 ID, 변경 세트 이름, 이벤트 세부 정보 유형, 실패 코드(실패한 요청의 경우), 요청 시작 및 종료 시간과 같은 변경 요청 세부 정보가 포함됩니다. 이렇게 하면 `DescribeChangeSet` 작업을 지속적으로 쿼리하거나에서 변경 요청의 AWS Marketplace Management Portal 상태를 확인하지 않고도 변경 세트를 모니터링할 수 있습니다.
**참고**
EventBridge 규칙 생성에 대한 자세한 내용은 **Amazon EventBridge 사용 설명서의 [Amazon EventBridge 규칙](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)을 참조하세요.
다음은 `Change Set Succeeded` 세부 정보 유형에 대한 이벤트 본문 예시입니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Change Set Succeeded",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2022-11-01T13:12:22Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
],
"detail": {
"requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"Catalog": "AWSMarketplace",
"ChangeSetId": "76yesvf8y165pa4f98td2crtg",
"ChangeSetName": "Create my product",
"StartTime": "2018-02-27T13:45:22Z",
"EndTime": "2018-02-27T14:55:22Z"
}
}
```
다음은 `Change Set Failed` 세부 정보 유형에 대한 이벤트 본문 예시입니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Change Set Failed",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2022-11-01T13:12:22Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
],
"detail": {
"requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"Catalog": "AWSMarketplace",
"ChangeSetId": "76yesvf8y165pa4f98td2crtg",
"ChangeSetName": "Create my product",
"StartTime": "2018-02-27T13:45:22Z",
"EndTime": "2018-02-27T14:55:22Z",
"FailureCode": "CLIENT_ERROR"
}
}
```
다음은 `Change Set Cancelled` 세부 정보 유형에 대한 이벤트 본문 예시입니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Change Set Cancelled",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2022-11-01T13:12:22Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
],
"detail": {
"requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"Catalog": "AWSMarketplace",
"ChangeSetId": "76yesvf8y165pa4f98td2crtg",
"ChangeSetName": "Create my product",
"StartTime": "2018-02-27T13:45:22Z",
"EndTime": "2018-02-27T14:55:22Z"
}
}
```
## 보안 요약 보고서 이벤트
판매자의 제품에서 보안 취약성이 감지되면 요약 보고서 이벤트와 미해결 제품 문제에 대한 정기 알림을 받을 수 있습니다. 이러한 이벤트의 소스는 `aws.marketplacecatalog`이고 세부 정보 유형은 `Products Security Report Created`입니다.
각 이벤트에는 감지된 문제가 있는 제품 및 버전 수, 영향을 받는 최신 버전 수, 이러한 제품 또는 버전의 일시적 제한을 방지하기 위해 해결이 필요한 날짜의 요약이 있습니다.
**참고**
EventBridge 규칙 생성에 대한 자세한 내용은 **Amazon EventBridge 사용 설명서의 [Amazon EventBridge 규칙](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)을 참조하세요.
보안 이벤트 관리에 대한 자세한 내용은 *AWS 블로그*의 [AWS Marketplace에서 제품 카탈로그의 보안을 개선하는 방법](https://aws.amazon.com/blogs/awsmarketplace/how-to-improve-security-your-product-catalog-aws-marketplace/) 블로그 게시물을 참조하세요.
다음은 `Products Security Report Created` 세부 정보 유형에 대한 이벤트 본문 예시입니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Products Security Report Created",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2023-10-31T00:00:00Z",
"region": "us-east-1",
"resources": [],
"detail": {
"numberOfProductsWithIssues": 1,
"numberOfVersionsWithIssues": 1,
"numberOfLatestVersionsWithIssues": 1,
"newIssuesFound": true,
"upcomingResolutionDueDate": "2023-12-01T00:00:00Z",
"requestId": "533fa17d-3e97-5051-bcaf-1fae45fb3f8b"
}
}
```
## 지급 이벤트
잘못된 은행 계좌 세부 정보로 인해 판매자 은행 계좌에 대한 지급이 실패하면 AWS Marketplace ISVs 및 채널 파트너가 이벤트를 수신할 수 있습니다.
다음 JSON 이벤트 코드에서 이러한 이벤트의 `source` 값은 `aws.marketplace`이고 `detail-type` 값은 `Disbursement Paused`입니다. `resources` 값은 잘못된 은행 계좌 Amazon 리소스 번호(ARN)를 보여줍니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Disbursement Paused",
"source": "aws.marketplace",
"account":"",
"time": "2022-11-01T13:12:22Z",
"region": "us-east-1",
"resources": ["arn:aws:payments:us-east-1:1234567890:paymentinstrument:123"],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace"
}
}
```
잘못된 은행 계좌 세부 정보 문제를 해결하려면 AWS Marketplace 관리 포털에 은행 계좌 세부 정보를 추가합니다. 지침은 [은행 계좌 세부 정보를 추가하려면](email-notifications.md#resolve-invalid-bank-account-details) 섹션을 참조하세요.
Amazon EventBridge 규칙 생성에 대한 자세한 내용은 **Amazon EventBridge 사용 설명서의 [Amazon EventBridge 규칙](https://docs.aws.amazon.com//eventbridge/latest/userguide/eb-rules.html)을 참조하세요.
## 계약 이벤트
계약 이벤트가 발생하면 판매자는 구매 계약 수명 주기 변경에 대한 알림을 받을 수 있습니다.
EventBridge 규칙 생성에 대한 자세한 내용은 **Amazon EventBridge 사용 설명서의 [Amazon EventBridge 규칙](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)을 참조하세요.
다음은 **구매 계약 생성 - 제안자에** 대한 이벤트 본문의 예입니다.
**참고**
채널 파트너 비공개 제안(CPPO)의 경우 재판매 권한 부여 ID가 채워지고 Marketplace 직접 제안(MPPO)의 경우이 값은 null입니다.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Created - Proposer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"intent": "NEW",
"status": "ACTIVE",
"acceptanceTime": "2024-06-26T21:36:03Z",
"startTime": "2024-08-30T21:36:03Z",
"endTime": "2025-05-30T21:36:03Z"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
다음은 **구매 계약 생성 - 제조업체**에 대한 이벤트 본문의 예입니다.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Created - Manufacturer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"intent": "NEW",
"status": "ACTIVE",
"acceptanceTime": "2024-06-26T21:36:03Z",
"startTime": "2024-08-30T21:36:03Z",
"endTime": "2025-05-30T21:36:03Z"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
다음은 **구매 계약 수정 - 제안자에** 대한 이벤트 본문의 예입니다.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Amended - Proposer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"intent": "AMEND",
"status": "ACTIVE",
"acceptanceTime": "2024-06-26T21:36:03Z",
"startTime": "2024-08-30T21:36:03Z",
"endTime": "2025-05-30T21:36:03Z"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
다음은 **구매 계약 수정 - 제조업체**에 대한 이벤트 본문의 예입니다.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Amended - Manufacturer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"intent": "AMEND",
"status": "ACTIVE",
"acceptanceTime": "2024-06-26T21:36:03Z",
"startTime": "2024-08-30T21:36:03Z",
"endTime": "2025-05-30T21:36:03Z"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
다음은 **구매 계약 종료 - 제안자에** 대한 이벤트 본문의 예입니다.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Ended - Proposer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"status": "CANCELLED"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
다음은 **구매 계약 종료 - 제조업체**에 대한 이벤트 본문의 예입니다.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Ended - Manufacturer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"status": "CANCELLED"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
## 라이선스 이벤트
라이선스 이벤트가 발생하면 판매자는 고객 권한 변경에 대한 알림을 받을 수 있습니다.
EventBridge 규칙 생성에 대한 자세한 내용은 **Amazon EventBridge 사용 설명서의 [Amazon EventBridge 규칙](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)을 참조하세요.
다음은 **라이선스 업데이트 - 제조업체**에 대한 이벤트 본문의 예입니다.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "License Updated - Manufacturer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs"
},
"product": {
"code": "aw4fgf5tyo5w2ap6fEXAMPLE",
"id": "prod-qtwveEXAMPLE"
},
"license": {
"arn": "aws:license-manager:us-east-1:123456789012:l-e52ca6f38bf84d0fafb8802ca15ac11x"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "8kkr91jo647j3qxlcjhlqce7y"
}
}
}
```
다음은 **라이선스 프로비저닝 해제 - 제조업체**에 대한 이벤트 본문의 예입니다.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "License Deprovisioned - Manufacturer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs"
},
"product": {
"code": "aw4fgf5tyo5w2ap6fEXAMPLE",
"id": "prod-qtwveEXAMPLE"
},
"license": {
"arn": "aws:license-manager:us-east-1:123456789012:l-e52ca6f38bf84d0fafb8802ca15ac11x"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "8kkr91jo647j3qxlcjhlqce7y"
}
}
}
```
## 취소 이벤트
취소 요청 상태가 변경되면 판매자, 구매자 및 ISVs(CPPO용)가 이벤트를 수신합니다. 각 이벤트는 역할별 세부 정보 유형(판매자 제안자, 구매자 수락자, ISVs 제조업체)으로 관련 당사자에게 전송됩니다. 이러한 이벤트의 소스는 입니다`aws.agreement-marketplace`.
EventBridge 규칙 생성에 대한 자세한 내용은 **Amazon EventBridge 사용 설명서의 [Amazon EventBridge 규칙](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)을 참조하세요.
다음은 **승인 보류 중인 계약 취소 요청 - 제안자에** 대한 이벤트 본문의 예입니다. 이 이벤트는 취소 요청을 제출하고 구매자 승인을 기다리고 있을 때 전송됩니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Agreement Cancellation Request Pending Approval - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-01T13:12:22Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid",
"acceptorId": "123465789012",
"productId": "prod-exampleid",
"offerId": "offer-exampleid"
},
"agreementCancellationRequest": {
"id": "acr-abcdexampleid",
"reasonCode": "INCORRECT_TERMS_ACCEPTED",
"reasonMessage": "",
"statusCode": "PENDING_APPROVAL",
"statusMessage": "",
"createdAt": "2025-01-01T13:12:22Z",
"updatedAt": "2025-01-01T13:12:22Z"
}
}
}
```
다음은 **계약 취소 요청 승인됨 - 제안자에** 대한 이벤트 본문의 예입니다. 이 이벤트는 구매자가 취소 요청을 승인하거나 7일 후에 자동 승인될 때 전송됩니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Agreement Cancellation Request Approved - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-01T13:16:07Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid",
"acceptorId": "123465789012",
"productId": "prod-exampleid",
"offerId": "offer-exampleid"
},
"agreementCancellationRequest": {
"id": "acr-abcdexampleid",
"reasonCode": "INCORRECT_TERMS_ACCEPTED",
"reasonMessage": "The terms accepted in agreement had wrong rate",
"statusCode": "APPROVED",
"statusMessage": "",
"createdAt": "2025-01-03T16:16:22Z",
"updatedAt": "2025-01-03T16:20:08Z"
}
}
}
```
다음은 **계약 취소 요청 거부 - 제안자에** 대한 이벤트 본문의 예입니다. 이 이벤트는 구매자가 취소 요청을 거부할 때 전송됩니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Agreement Cancellation Request Rejected - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-02T10:30:00Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid",
"acceptorId": "123465789012",
"productId": "prod-exampleid",
"offerId": "offer-exampleid"
},
"agreementCancellationRequest": {
"id": "acr-abcdexampleid",
"reasonCode": "INCORRECT_TERMS_ACCEPTED",
"reasonMessage": "",
"statusCode": "REJECTED",
"statusMessage": "We still need this product",
"createdAt": "2025-01-01T13:12:22Z",
"updatedAt": "2025-01-02T10:30:00Z"
}
}
}
```
다음은 **계약 취소 요청 취소 - 제안자에** 대한 이벤트 본문의 예입니다. 이 이벤트는 취소 요청을 취소할 때 전송됩니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Agreement Cancellation Request Cancelled - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-02T08:00:00Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid",
"acceptorId": "123465789012",
"productId": "prod-exampleid",
"offerId": "offer-exampleid"
},
"agreementCancellationRequest": {
"id": "acr-abcdexampleid",
"reasonCode": "INCORRECT_TERMS_ACCEPTED",
"reasonMessage": "",
"statusCode": "CANCELLED",
"statusMessage": "Seller withdrew the request",
"createdAt": "2025-01-01T13:12:22Z",
"updatedAt": "2025-01-02T08:00:00Z"
}
}
}
```
다음은 **계약 취소 요청 검증 실패 - 제안자에** 대한 이벤트 본문의 예입니다. 이 이벤트는 제출 후 비동기 검증이 실패할 때만 판매자에게 전송됩니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Agreement Cancellation Request Validation Failed - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-01T13:15:00Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid",
"acceptorId": "123465789012",
"productId": "prod-exampleid",
"offerId": "offer-exampleid"
},
"agreementCancellationRequest": {
"id": "acr-abcdexampleid",
"reasonCode": "INCORRECT_TERMS_ACCEPTED",
"reasonMessage": "The terms accepted in agreement had wrong rate",
"statusCode": "VALIDATION_FAILED",
"statusMessage": "Agreement has a renewal agreement that must be canceled first",
"createdAt": "2025-01-01T13:12:22Z",
"updatedAt": "2025-01-01T13:15:00Z"
}
}
}
```
## 결제 조정 이벤트
결제 조정 상태가 변경되면 판매자, 구매자 및 ISVs(CPPO용)가 이벤트를 수신합니다. 각 이벤트는 역할별 세부 정보 유형(판매자 제안자, 구매자 수락자, ISVs 제조업체)으로 관련 당사자에게 전송됩니다. 이러한 이벤트의 소스는 입니다`aws.agreement-marketplace`.
다음은 **구매 계약 결제 조정 완료 - 제안자에** 대한 이벤트 본문의 예입니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Purchase Agreement Billing Adjustment Completed - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-01T13:12:22Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid"
},
"billingAdjustmentRequest": {
"id": "ba-abcdexampleid",
"adjustmentAmount": "-100.00",
"currencyCode": "USD",
"adjustmentReasonCode": "INCORRECT_TERMS_ACCEPTED"
},
"invoice": {
"originalInvoiceId": "2028746221"
}
}
}
```
다음은 **구매 계약 결제 조정 실패 - 제안자에** 대한 이벤트 본문의 예입니다. 이 이벤트는 결제 조정이 비동기 검증에 실패할 때만 판매자에게 전송됩니다.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Purchase Agreement Billing Adjustment Failed - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-01T13:15:00Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid"
},
"billingAdjustmentRequest": {
"id": "ba-abcdexampleid",
"adjustmentAmount": "-1000.00",
"currencyCode": "USD",
"adjustmentReasonCode": "INCORRECT_TERMS_ACCEPTED"
},
"invoice": {
"originalInvoiceId": "2028746221"
}
}
}
```