이벤트를 모니터링하기 위한 사전 조건 완료 이벤트를 모니터링하도록 Amazon EventBridge 구성 혜택 API 이벤트에 대해 자세히 알아보기

AWS Partner Central Benefits API에 대한 알림

Benefits Service는 BenefitApplications 및 BenefitAllocations 모두에 대한 EventBridge 이벤트를 제공합니다. 이러한 이벤트를 통해 고객은 초기 애플리케이션부터 할당 및 최종 이행까지 전체 리소스 수명 주기 동안 변경 사항에 대응하는 포괄적인 이벤트 기반 아키텍처를 구축할 수 있습니다.

이벤트를 모니터링하기 위한 사전 조건 완료

사용자는 혜택 API에서 게시한 이벤트에 액세스하고 관리하려면 적절한 IAM 권한이 필요합니다. EventBridge에 사용할 수 있는 작업, 리소스 및 조건 키에 대한 자세한 내용은 Amazon EventBridge 사용 설명서의 Amazon EventBridge에서 IAM 정책 조건 사용을 참조하세요. 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의 이벤트에 대응하는 규칙 생성의 단계를AWS Management Console따릅니다. EventBridge 규칙을 생성할 때 이벤트 버스를 기본값으로 설정하고 미국 동부(버지니아 북부) us-east-1 리전에서 규칙을 생성해야 합니다.

다음은 이벤트 규칙의 예입니다.


{
    "source": ["aws.partnercentral-benefits"],
    "detail": {
        "catalog": ["AWS"]
    }
}

AWS SDK 설정

AWS SDKs를 사용하여 프로그래밍 방식으로 EventBridge 규칙을 생성하고 관리할 수 있습니다. 자세한 내용은 Amazon EventBridge API 참조의 PutRule을 참조하세요.

다음 예제에서는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 이벤트 유형, 이를 트리거하는 시나리오 및 이벤트 예제를 설명합니다.

이벤트 유형

다음은 이벤트 유형과 트리거입니다.

혜택 애플리케이션

혜택 애플리케이션이 생성된 경우: 혜택 애플리케이션이 생성된 경우
혜택 애플리케이션 검토 중: 혜택 애플리케이션이 제출되거나 애플리케이션이 작업 필요에서 다시 검토 중으로 전환되면이 이벤트가 트리거됩니다.
혜택 애플리케이션 작업 필요:이 이벤트는 내부 검토자가 애플리케이션 상태를 업데이트하여 파트너가 검토를 계속하기 전에 추가 정보, 설명 또는 수정 사항을 제공해야 함을 나타낼 때 발생합니다.
혜택 애플리케이션 거부됨:이 이벤트는 내부 검토자가 애플리케이션 상태를 업데이트하여 애플리케이션이 혜택 기준 또는 요구 사항을 충족하지 않고 거부되었음을 나타낼 때 발생합니다.
혜택 애플리케이션 승인됨:이 이벤트는 내부 검토자가 애플리케이션 상태를 업데이트하여 애플리케이션이 혜택 할당 승인을 받았음을 나타낼 때 발생합니다.
혜택 애플리케이션 단계 변경됨:이 이벤트는 내부 검토자가 비즈니스 검토, 검토, 재무AWS검토 등과 같은 검토 프로세스 중에 애플리케이션의 단계를 업데이트할 때 발생합니다.

혜택 할당

혜택 할당 활성화됨: 혜택 할당이 생성되거나 내부 서비스에 의해 다시 활성화됨으로 업데이트되는 경우.
혜택 할당 비활성화:이 이벤트는 내부 검토자가 할당 상태를 업데이트하거나 혜택 할당이 자동으로 만료될 때 발생합니다.
혜택 할당 이행:이 이벤트는 내부 검토자가 할당 상태를 업데이트하여 할당이 완전히 활용되었음을 나타낼 때 발생합니다.

이벤트 예제

다음 섹션에서는 이전 섹션의 앞부분에 나열된 이벤트의 예를 제공합니다.

주제

혜택 애플리케이션 생성됨
검토 중인 혜택 애플리케이션
혜택 애플리케이션 작업 필요
혜택 애플리케이션 거부됨
혜택 애플리케이션 승인됨
혜택 애플리케이션 단계 변경됨
혜택 할당 활성화됨
혜택 할당 비활성화됨
혜택 할당 이행됨

혜택 애플리케이션 생성됨

트리거 컨텍스트

혜택 애플리케이션을 통해 새 혜택 애플리케이션이 성공적으로 생성되면 혜택 애플리케이션 생성 이벤트가 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"]
    }
  }
}

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

AWS Partner Central Selling API에 대한 알림

AWS파트너 중앙 채널 API에 대한 알림