View a markdown version of this page

的通知 AWS 合作伙伴中心权益 API - AWS 合作伙伴中心
完成监控事件的先决条件将亚马逊配置 EventBridge 为监控事件了解有关福利 API 事件的更多信息

对 AWS 合作伙伴中心 API 参考进行了重组。有关支持的 API 操作的更多信息，请参阅 AWS 合作伙伴中心 API 参考。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

的通知 AWS 合作伙伴中心权益 API

福利服务为 BenefitApplications 和提供 EventBridge 活动 BenefitAllocations. 这些事件使客户能够构建全面的事件驱动架构，以响应整个资源生命周期（从初始申请到分配再到最终完成）中的变化。

完成监控事件的先决条件

用户需要相应的 IAM 权限才能访问和管理权益 API 发布的事件。有关可用操作、资源和条件密钥的更多信息 EventBridge，请参阅亚马逊 EventBridge 用户指南中的在亚马逊 EventBridge中使用 IAM 政策条件。条件键之一是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"
        }
      }
    }
  ]
}

将亚马逊配置 EventBridge 为监控事件

要监控福利 API 事件，您可以创建与要捕获的事件相匹配的 EventBridge 规则。您可以使用 AWS 管理控制台 或 S AWS DK 来创建和管理规则。以下各节说明如何使用这两种方法创建规则。无论使用哪种方法，都必须在美国东部（弗吉尼亚北部）us-east-1区域创建规则。

AWS 管理控制台 设置

要使用设置 EventBridge 规则 AWS 管理控制台，请按照亚马逊 EventBridge 用户指南中创建应对亚马逊事件的规则 EventBridge中的步骤进行操作。创建规则时，必须将事件总线设置为默认值，并在美国东部（弗吉尼亚北部）us-east-1区域创建规则。

以下是事件规则的示例：

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

AWS SDK 设置

您可以使用 AWS 软件开发工具包以编程方式创建和管理 EventBridge 规则。有关更多信息，请参阅PutRule《亚马逊 EventBridge API 参考》。

以下示例使用 AWS 适用于 Python 的软件开发工具包 (Boto3)：

# Requires the 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 就会发生此事件。

福利分配

  • 福利分配已激活：当福利分配创建或更新回由内部服务激活时。

  • 福利分配已停用：当内部审核员更新分配状态或福利分配自动到期时，就会发生此事件。

  • 福利分配已完成：当内部审核员更新分配状态以表明分配已完全使用时，就会发生此事件。

示例事件

以下各节提供了前面部分中列出的事件的示例。

福利申请已创建

触发上下文

通过福利服务成功创建新的福利申请 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 状态 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 状态 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"]
    }
  }
}

福利申请被拒绝

触发上下文

当福利申请通过福利服务转换为 “已拒绝” 状态 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"]
    }
  }
}

福利申请已获批准

触发上下文

当福利申请通过福利服务过渡到已批准状态 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"]
    }
  }
}

福利申请阶段已更改

触发上下文

当福利申请的审核阶段通过福利服务更新 EventBridge 时，福利申请阶段变更事件将发布给亚马逊。当内部审查员将应用程序的阶段更新为可能的枚举值之一（FINANCE_REVIEW、BUSINESS_REVIEW、TECH_REVIEW 和 _REVIEW）时，就会发生此事件。 AWS

与状态变更不同，阶段变更是只读信息更新，无需合作伙伴采取行动即可了解内部审核工作流程的进展。

收件人

拥有的账户将获得福利分配的活动。

示例
{
  "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"]
    }
  }
}

福利分配已激活

触发上下文

当福利分配通过福利服务过渡到活跃状态 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"]
    }
  }
}

福利分配已停用

触发上下文

当福利分配通过福利服务过渡到非活动状态 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"]
    }
  }
}

福利分配已完成

触发上下文

当福利分配通过福利服务过渡到已配送状态 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"]
    }
  }
}