기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 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"
}
}
}
```