AWS Partner Central API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Partner Central API 참조](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS Partner Central Benefits API에 대한 알림
Benefits Service는 BenefitApplications 및 BenefitAllocations 모두에 대한 EventBridge 이벤트를 제공합니다. 이러한 이벤트를 통해 고객은 초기 애플리케이션부터 할당 및 최종 이행까지 전체 리소스 수명 주기 동안 변경 사항에 대응하는 포괄적인 이벤트 기반 아키텍처를 구축할 수 있습니다.
**Topics**
+ [이벤트를 모니터링하기 위한 사전 조건 완료](#events-prerequites)
+ [이벤트를 모니터링하도록 Amazon EventBridge 구성](#eventbridge-setup)
+ [혜택 API 이벤트에 대해 자세히 알아보기](#learn-about-events)
## 이벤트를 모니터링하기 위한 사전 조건 완료
사용자는 혜택 API에서 게시한 이벤트에 액세스하고 관리하려면 적절한 IAM 권한이 필요합니다. EventBridge에 사용할 수 있는 작업, 리소스 및 조건 키에 대한 자세한 내용은 [Amazon EventBridge 사용 설명서의 Amazon EventBridge에서 IAM 정책 조건 사용을](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-use-conditions.html#events-pattern-detail-type) 참조하세요. * EventBridge * 조건 키 중 하나는 특정 이벤트 유형에 대한 권한 범위를 지정하는 데 사용할 수 `events:detail-type`있는 입니다.
다음 예제 정책은 제안된 이벤트에 대한 권한을 사용자 지정하고 범위를 지정하는 방법을 보여줍니다. `AllowPutRuleForPartnercentralBenefitsEvents` 문은 규칙 생성을 허용하지만 `aws.partnercentral-benefits` 소스의 이벤트에 대해서만 가능합니다.
자세한 IAM 정책 예제는 EventBridge 권한에 대한 AWS 설명서를 참조하세요.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowPutRuleForPartnerCentralBenefitsEvents",
"Effect": "Allow",
"Action": "events:PutRule",
"Resource": "*",
"Condition": {
"StringEquals": {
"events:source": "aws.partnercentral-benefits"
}
}
}
]
}
```
## 이벤트를 모니터링하도록 Amazon EventBridge 구성
혜택 API 이벤트를 모니터링하려면 캡처하려는 이벤트와 일치하는 EventBridge 규칙을 생성합니다.AWS Management Console또는AWS SDKs를 사용하여 규칙을 생성하고 관리할 수 있습니다. 다음 섹션에서는 두 방법을 모두 사용하여 규칙을 생성하는 방법을 설명합니다. 사용하는 방법에 관계없이 미국 동부(버지니아 북부) `us-east-1` 리전에서 규칙을 생성해야 합니다.
### AWS Management Console설정
를 사용하여 EventBridge 규칙을 설정하려면 [Amazon EventBridge 사용 설명서의 Amazon EventBridge의 이벤트에 대응하는 규칙 생성](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)의 단계를AWS Management Console따릅니다. * EventBridge * 규칙을 생성할 때 이벤트 버스를 **기본**값으로 설정하고 미국 동부(버지니아 북부) `us-east-1` 리전에서 규칙을 생성해야 합니다.
다음은 이벤트 규칙의 예입니다.
```
{
"source": ["aws.partnercentral-benefits"],
"detail": {
"catalog": ["AWS"]
}
}
```
### AWS SDK 설정
AWS SDKs를 사용하여 프로그래밍 방식으로 EventBridge 규칙을 생성하고 관리할 수 있습니다. 자세한 내용은 *Amazon EventBridge API 참조*의 [PutRule](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutRule.html)을 참조하세요.
다음 예제에서는AWS SDK for Python(Boto3)을 사용합니다.
```
import boto3
client = boto3.client('events', region_name='us-east-1')
response = client.put_rule(
Name='MyBenefitApplicationCreatedRule',
EventPattern=
'{
"source": ["aws.partnercentral-benefits"],
"detail-type": ["Benefit Application Created"],
"detail": {"catalog": ["AWS"]}
}',
State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])
```
## 혜택 API 이벤트에 대해 자세히 알아보기
다음 섹션에서는 이점 API 이벤트 유형, 이를 트리거하는 시나리오 및 이벤트 예제를 설명합니다.
### 이벤트 유형
다음은 이벤트 유형과 트리거입니다.
#### 혜택 애플리케이션
+ [혜택 애플리케이션이 생성된](#benefit-application-created) 경우: 혜택 애플리케이션이 생성된 경우
+ [혜택 애플리케이션 검토 중](#benefit-application-in-review): 혜택 애플리케이션이 제출되거나 애플리케이션이 작업 필요에서 다시 검토 중으로 전환되면이 이벤트가 트리거됩니다.
+ [혜택 애플리케이션 작업 필요](#benefit-application-action-required):이 이벤트는 내부 검토자가 애플리케이션 상태를 업데이트하여 파트너가 검토를 계속하기 전에 추가 정보, 설명 또는 수정 사항을 제공해야 함을 나타낼 때 발생합니다.
+ [혜택 애플리케이션 거부됨](#benefit-application-rejected):이 이벤트는 내부 검토자가 애플리케이션 상태를 업데이트하여 애플리케이션이 혜택 기준 또는 요구 사항을 충족하지 않고 거부되었음을 나타낼 때 발생합니다.
+ [혜택 애플리케이션 승인](#benefit-application-approved)됨:이 이벤트는 내부 검토자가 애플리케이션 상태를 업데이트하여 애플리케이션이 혜택 할당 승인을 받았음을 나타낼 때 발생합니다.
+ [혜택 애플리케이션 단계 변경됨](#benefit-application-stage-changed):이 이벤트는 내부 검토자가 비즈니스 검토, 검토, 재무AWS검토 등과 같은 검토 프로세스 중에 애플리케이션의 단계를 업데이트할 때 발생합니다.
#### 혜택 할당
+ [혜택 할당 활성화됨](#benefit-allocation-activated): 혜택 할당이 생성되거나 내부 서비스에 의해 다시 활성화됨으로 업데이트되는 경우.
+ [혜택 할당 비활성화](#benefit-allocation-inactivated):이 이벤트는 내부 검토자가 할당 상태를 업데이트하거나 혜택 할당이 자동으로 만료될 때 발생합니다.
+ [혜택 할당 이행](#benefit-allocation-fulfilled):이 이벤트는 내부 검토자가 할당 상태를 업데이트하여 할당이 완전히 활용되었음을 나타낼 때 발생합니다.
### 이벤트 예제
다음 섹션에서는 이전 섹션의 앞부분에 나열된 이벤트의 예를 제공합니다.
**Topics**
+ [혜택 애플리케이션 생성됨](#benefit-application-created)
+ [검토 중인 혜택 애플리케이션](#benefit-application-in-review)
+ [혜택 애플리케이션 작업 필요](#benefit-application-action-required)
+ [혜택 애플리케이션 거부됨](#benefit-application-rejected)
+ [혜택 애플리케이션 승인됨](#benefit-application-approved)
+ [혜택 애플리케이션 단계 변경됨](#benefit-application-stage-changed)
+ [혜택 할당 활성화됨](#benefit-allocation-activated)
+ [혜택 할당 비활성화됨](#benefit-allocation-inactivated)
+ [혜택 할당 이행됨](#benefit-allocation-fulfilled)
#### 혜택 애플리케이션 생성됨
##### 트리거 컨텍스트
혜택 애플리케이션을 통해 새 혜택 애플리케이션이 성공적으로 생성되면 혜택 애플리케이션 생성 이벤트가 Amazon EventBridge에 게시됩니다. 이 이벤트는 CreateBenefitApplication API 호출이 성공적으로 완료될 때 발생하며, 이는 파트너가 특정 혜택에 대한 요청을 시작했음을 나타냅니다.
이 이벤트는 혜택 애플리케이션 수명 주기의 시작을 나타내며 새 애플리케이션이 계정에 제출되면 고객에게 즉시 알림을 제공합니다.
##### 수신자
소유 계정은 혜택 할당에 대한 이벤트를 수신합니다.
##### 예제
```
{
"id": "7gh88765-k0jh-d08g-i292-2ff1796m030n",
"detail-type": "Benefit Application Created",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-10T15:45:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "PENDING_SUBMISSION",
"revision": "hh7e8400-e29b-41d4-a716-446655440012"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### 검토 중인 혜택 애플리케이션
##### 트리거 컨텍스트
혜택 애플리케이션이 혜택 서비스를 통해 IN\_REVIEW 상태로 전환되면 혜택 애플리케이션 검토 중 이벤트가 Amazon EventBridge에 게시됩니다. 이 이벤트는 다음과 같은 경우에 발생합니다.
+ 파트너가 SubmitBenefitApplication API 직접 호출을 통해 애플리케이션을 제출합니다.
+ 파트너가 피드백을 해결한 후 애플리케이션이 ACTION\_REQUIRED에서 IN\_REVIEW로 다시 전환됩니다.
+ 애플리케이션이 리콜된 다음 다시 제출됨
이 이벤트는 애플리케이션이 공식 검토 프로세스에 들어갔으며AWS내부 팀에서 평가 중임을 나타냅니다.
##### 수신자
소유 계정은 혜택 할당에 대한 이벤트를 수신합니다.
##### 예제
```
{
"id": "8hi99876-l1ki-e19h-j303-3gg2807n141o",
"detail-type": "Benefit Application In Review",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-10T16:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "IN_REVIEW",
"stage": "BUSINESS_REVIEW",
"revision": "ii8f9511-f30c-52e5-b827-557766551123"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### 혜택 애플리케이션 작업 필요
##### 트리거 컨텍스트
혜택 애플리케이션이 혜택 서비스를 통해 ACTION\_REQUIRED 상태로 전환되면 혜택 애플리케이션 작업 필요 이벤트가 Amazon EventBridge에 게시됩니다. 이 이벤트는 내부 검토자가 UpdateBenefitApplicationInternal API를 통해 애플리케이션 상태를 업데이트하여 파트너가 추가 정보, 설명 또는 수정 사항을 제공해야 검토를 계속할 수 있음을 나타낼 때 발생합니다.
이 이벤트는 검토 프로세스에서 애플리케이션을 앞으로 이동하기 위해 파트너 개입이 필요한 애플리케이션 수명 주기의 중요 지점을 나타냅니다.
##### 수신자
소유 계정은 혜택 할당에 대한 이벤트를 수신합니다.
##### 예제
```
{
"id": "9ij00987-m2lj-f20i-k414-4hh3918o252p",
"detail-type": "Benefit Application Action Required",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-12T10:30:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "ACTION_REQUIRED",
"stage": "BUSINESS_REVIEW",
"revision": "jj9g0622-g41d-63f6-c938-668877662234"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### 혜택 애플리케이션 거부됨
##### 트리거 컨텍스트
혜택 애플리케이션이 혜택 서비스를 통해 거부됨 상태로 전환되면 혜택 애플리케이션 거부됨 이벤트가 Amazon EventBridge에 게시됩니다. 이 이벤트는 내부 검토자가 UpdateBenefitApplicationInternal API를 통해 애플리케이션 상태를 업데이트하여 애플리케이션이 혜택 기준 또는 요구 사항을 충족하지 않고 거부되었음을 나타낼 때 발생합니다.
이 이벤트는 애플리케이션이 공식적으로 거부되어 혜택 할당을 진행하지 않는 애플리케이션 수명 주기의 터미널 상태를 나타냅니다.
##### 수신자
소유 계정은 혜택 할당에 대한 이벤트를 수신합니다.
##### 예제
```
{
"id": "0kl11098-n3mk-g31j-l525-5ii4029p363q",
"detail-type": "Benefit Application Rejected",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-15T14:20:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "REJECTED",
"revision": "kk0h1733-h52e-74g7-d049-779988773345"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### 혜택 애플리케이션 승인됨
##### 트리거 컨텍스트
혜택 애플리케이션이 혜택 서비스를 통해 APPROVED 상태로 전환되면 혜택 애플리케이션 승인 이벤트가 Amazon EventBridge에 게시됩니다. 이 이벤트는 내부 검토자가 UpdateBenefitApplicationInternal API를 통해 애플리케이션 상태를 업데이트하여 애플리케이션이 모든 혜택 기준 및 요구 사항을 충족하고 혜택 할당이 승인되었음을 나타낼 때 발생합니다.
이 이벤트는 애플리케이션 검토 프로세스를 성공적으로 완료했음을 나타내며 일반적으로 해당 혜택 할당 생성을 트리거합니다.
##### 수신자
소유 계정은 혜택 할당에 대한 이벤트를 수신합니다.
##### 예제
```
{
"id": "1lm22109-o4nl-h42k-m636-6jj5130q474r",
"detail-type": "Benefit Application Approved",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-14T16:45:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "APPROVED",
"revision": "ll1i2844-i63f-85h8-e150-880099884456"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### 혜택 애플리케이션 단계 변경됨
##### 트리거 컨텍스트
혜택 애플리케이션의 검토 단계가 혜택 서비스를 통해 업데이트되면 혜택 애플리케이션 단계 변경됨 이벤트가 Amazon EventBridge에 게시됩니다. 이 이벤트는 내부 검토자가 애플리케이션의 단계를 가능한 열거형 값(FINANCE\_REVIEW, BUSINESS\_REVIEW, TECH\_REVIEW 및AWS\_REVIEW) 중 하나로 업데이트할 때 발생합니다.
상태 변경과 달리 단계 변경은 파트너 작업 없이 내부 검토 워크플로 진행 상황을 파악할 수 있는 읽기 전용 정보 업데이트입니다.
##### 수신자
소유 계정은 혜택 할당에 대한 이벤트를 수신합니다.
##### 예제
```
{
"id": "2mn33210-p5om-i53l-n747-7kk6241r585s",
"detail-type": "Benefit Application Stage Changed",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-02-13T11:15:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
],
"detail": {
"catalog": "AWS",
"benefitApplication": {
"id": "benappl-12345abcdef123",
"fulfillmentTypes": ["CREDITS"],
"status": "IN_REVIEW",
"stage": "FINANCIAL_REVIEW",
"revision": "mm2j3955-j74g-96i9-f261-991100995567"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### 혜택 할당 활성화됨
##### 트리거 컨텍스트
혜택 할당 활성화 이벤트는 혜택 서비스를 통해 혜택 할당이 ACTIVE 상태로 전환되면 Amazon EventBridge에 게시됩니다. 이 이벤트는 내부 검토자가 UpdateBenefitAllocationInternal API를 통해 할당 상태를 업데이트하여 이전에 비활성 상태였던 할당을 다시 활성화할 때 발생합니다.
이 이벤트는 일반적으로 일시적으로 비활성화된 할당(만료, 정책 변경 또는 관리상의 이유로)이 활성 상태로 복원되어 파트너 사용률이 다시 높아질 때 발생합니다.
##### 수신자
파트너에 속한AWS계정이 메시지를 수신합니다. 즉, 리소스를 소유한AWS계정입니다.
##### 샘플 이벤트
```
{
"id": "3no44321-q6pn-j64m-o858-8ll7352s696t",
"detail-type": "Benefit Allocation Activated",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-03-01T08:15:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
],
"detail": {
"catalog": "AWS",
"benefitAllocation": {
"id": "benalloc-abc123def456",
"fulfillmentType": "CREDITS",
"status": "ACTIVE"
},
"benefitApplication": {
"id": "benappl-12345abcdef123"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### 혜택 할당 비활성화됨
##### 트리거 컨텍스트
혜택 할당 비활성화 이벤트는 혜택 서비스를 통해 혜택 할당이 비활성 상태로 전환되면 Amazon EventBridge에 게시됩니다. 이 이벤트는 내부 검토자가 UpdateBenefitAllocationInternal API를 통해 할당 상태를 업데이트하거나 혜택 할당이 자동으로 만료될 때 발생합니다.
이 이벤트는 일반적으로 할당이 일시 중지될 때(만료, 정책 변경, 규정 준수 문제 또는 관리상의 이유로) 다시 활성화될 때까지 파트너 사용률이 혜택을 사용할 수 없게 됩니다.
##### 수신자
파트너에 속한AWS계정이 메시지를 수신합니다. 즉, 리소스를 소유한AWS계정입니다.
##### 샘플 이벤트
```
{
"id": "4op55432-r7qo-k75n-p969-9mm8463t707u",
"detail-type": "Benefit Allocation Inactivated",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-06-30T23:59:59Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
],
"detail": {
"catalog": "AWS",
"benefitAllocation": {
"id": "benalloc-abc123def456",
"fulfillmentType": "CREDITS",
"status": "INACTIVE"
},
"benefitApplication": {
"id": "benappl-12345abcdef123"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```
#### 혜택 할당 이행됨
##### 트리거 컨텍스트
혜택 할당 이행 이벤트는 혜택 서비스를 통해 혜택 할당이 FULFILLED 상태로 전환되면 Amazon EventBridge에 게시됩니다. 이 이벤트는 내부 검토자가 UpdateBenefitAllocationInternal API를 통해 할당 상태를 업데이트하여 할당이 완전히 활용되었거나 혜택 조건이 충족되었음을 나타낼 때 발생합니다.
이 이벤트는 혜택 수명 주기의 완료를 나타내며, 파트너가 할당된 혜택을 성공적으로 활용했거나 할당이 자연스러운 결론에 도달했음을 나타냅니다.
##### 수신자
파트너에 속한AWS계정이 메시지를 수신합니다. 즉, 리소스를 소유한AWS계정입니다.
##### 샘플 이벤트
```
{
"id": "5pq66543-s8rp-l86o-q070-0nn9574u818v",
"detail-type": "Benefit Allocation Fulfilled",
"source": "aws.partnercentral-benefits",
"account": "123456789012",
"time": "2025-12-15T17:30:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
],
"detail": {
"catalog": "AWS",
"benefitAllocation": {
"id": "benalloc-abc123def456",
"fulfillmentType": "CREDITS",
"status": "FULFILLED"
},
"benefitApplication": {
"id": "benappl-12345abcdef123"
},
"benefit": {
"id": "ben-xyz789uvw012",
"name": "AWS Partner Credits",
"program": ["AWS Partner Network"]
}
}
}
```