기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS Marketplace 계약 EventBridge 이벤트
AWS Marketplace 는 계약의 수명 주기(즉, 구매한 제안)에 특정 이벤트가 발생하면 Amazon EventBridge에 알림을 보냅니다. 이러한 이벤트를 사용하여 워크플로를 자동화하고 마켓플레이스 구매를 추적할 수 있습니다.
다음 표에는가 EventBridge로 AWS Marketplace 보내는 구매자 이벤트가 나열되어 있습니다.
| 이벤트 | 설명 |
| --- | --- |
| 구매 계약 생성됨 - 수락자 | 계정에서 새 구매 계약이 생성, 갱신 또는 교체될 때 전송됨 |
| 구매 계약 수정 - 수락자 | 기존 구매 계약을 수정할 때 전송됨 |
| 구매 계약 종료됨 - 수락자 | 구매 계약이 취소, 만료, 종료, 갱신 또는 교체될 때 전송됨 |
| 구매 계약 종료 - 수락자 | 구매 계약이 만료되기 30일, 60일 및 90일 전에 전송됨 |
## 개요
구매자는 다음 구매 계약 수명 주기 이벤트에 대한 EventBridge 알림을 받습니다.
+ 계약 생성
+ 계약 수정
+ 계약 종료(취소, 만료 또는 해지)
+ 계약 종료
모든 이벤트는 이벤트 소스를 사용하여 `us-east-1` 리전의 기본 EventBridge 이벤트 버스로 전송됩니다`aws.agreement-marketplace`.
## 이벤트 유형
### 구매 계약 생성됨 - 수락자
AWS Marketplace 는 계정에 새 구매 계약이 생성되면이 이벤트를 전송합니다.
**트리거 시나리오:**
+ `NEW` - 계약이 처음으로 생성됨
+ `REPLACE` - 계약 기반 제안(ABO)의 일부로 새 비공개 제안을 수락해야 합니다.
+ `RENEW` - 계약이 만료 시 자동 갱신됨(활성화된 경우)
**이벤트 스키마:**
```
{
"version": "0",
"id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
"detail-type": "Purchase Agreement Created - Acceptor",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::agreement:agmt-9xyz8wmklp67rt32nb1qv45ds"
],
"detail": {
"requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-9xyz8wmklp67rt32nb1qv45ds",
"intent": "NEW|RENEW|REPLACE",
"status": "ACTIVE",
"acceptanceTime": "2024-06-26T21:36:03Z",
"startTime": "2024-08-30T21:36:03Z",
"endTime": "2025-05-30T21:36:03Z"
},
"acceptor": {
"accountId": ""
},
"proposer": {
"accountId": ""
},
"offer": {
"id": "offer-abcdef123456"
}
}
}
```
### 구매 계약 수정 - 수락자
AWS Marketplace 는 조건, 요금 또는 기타 계약 파라미터 변경과 같이 기존 구매 계약을 수정할 때이 이벤트를 전송합니다.
**이벤트 스키마:**
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Amended Acceptor",
"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"
},
"acceptor": {
"accountId": ""
},
"proposer": {
"accountId": ""
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
### 구매 계약 종료됨 - 수락자
AWS Marketplace 는 구매 계약이 종료되면이 이벤트를 전송합니다.
**트리거 시나리오:**
+ `CANCELLED` - 정의된 종료 날짜 이전에 계약을 종료했습니다.
+ `EXPIRED` - 계약이 정의된 종료 날짜에 도달했습니다.
+ `TERMINATED` 계약 AWS 종료(예: 결제 실패로 인해)
+ `RENEWED` - 계약이 새 계약으로 갱신되었습니다.
+ `REPLACED` - 계약이 계약 대체 제안을 사용하여 대체되었습니다.
**이벤트 스키마:**
```
{
"version": "0",
"id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
"detail-type": "Purchase Agreement Ended - Acceptor",
"source": "aws.agreement-marketplace",
"account": "987654321098",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:aws:agreement:agmt-9xyz8wmklp67rt32nb1qv45ds"
],
"detail": {
"requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-9xyz8wmklp67rt32nb1qv45ds",
"status": "CANCELLED|EXPIRED|RENEWED|REPLACED|TERMINATED"
},
"acceptor": {
"accountId": ""
},
"proposer": {
"accountId": ""
},
"offer": {
"id": "offer-abcdef123456"
}
}
}
```
### 구매 계약 종료 - 수락자
AWS Marketplace 는 구매 계약이 만료되기 30일, 60일 및 90일 전에이 이벤트를 전송합니다.
이 이벤트에는 다른 구매자 이벤트에 없는 추가 필드가 포함됩니다.
+ `agreement.autoRenewalEnabled` - 계약에 자동 갱신이 활성화되어 있는지 여부를 나타냅니다.
+ `product.id` 및 `product.title` - 계약에 대한 제품 정보
+ `proposer.name` 및 `offer.name` - 판매자 및 제안의 사람이 읽을 수 있는 이름
**이벤트 스키마:**
```
{
"version": "0",
"id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
"detail-type": "Purchase Agreement Ending - Acceptor",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2025-03-31T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-9xyz8wmklp67rt32nb1qv45ds"
],
"detail": {
"requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-9xyz8wmklp67rt32nb1qv45ds",
"startTime": "2024-08-30T21:36:03Z",
"endTime": "2025-05-30T21:36:03Z",
"autoRenewalEnabled": true,
"status": "ACTIVE"
},
"product": {
"id": "prod-abc123xyz456",
"title": "Example Product Title"
},
"acceptor": {
"accountId": ""
},
"proposer": {
"name": "Example Seller Name",
"accountId": ""
},
"offer": {
"id": "offer-abcdef123456",
"name": "Example Offer Name"
}
}
}
```
## 공통 이벤트 필드
모든 구매자 이벤트에는 다음과 같은 공통 필드가 포함됩니다.
| 필드 | 설명 |
| --- | --- |
| requestId | 중복 이벤트를 중복 제거하는 데 사용되는 UUID |
| catalog | AWS Marketplace 카탈로그(일반적으로 "AWSMarketplace") |
| agreementId | 계약의 고유 식별자 |
| acceptor.accountId | AWS 계정 ID |
| proposer.accountId | 판매자의 AWS 계정 ID |
| offer.id | 제안 식별자 |
## EventBridge 규칙 설정
이러한 알림을 받으려면 구매자 이벤트의 이벤트 패턴과 일치하는 EventBridge 규칙을 생성합니다. 규칙 생성에 대한 자세한 내용은 [Amazon EventBridge 사용 설명서의 Amazon EventBridge 규칙 생성을](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) 참조하세요. * EventBridge *