View a markdown version of this page

Benachrichtigungen für AWS API für Vorteile von Partner Central - AWS Partner Central
Erfüllen Sie die Voraussetzungen für die Überwachung von EreignissenAmazon für EventBridge die Überwachung von Ereignissen konfigurierenErfahren Sie mehr über API-Veranstaltungen zu den Vorteilen

Die AWS Partner Central API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Partner Central API-Referenz.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Benachrichtigungen für AWS API für Vorteile von Partner Central

Der Benefits Service bietet EventBridge Veranstaltungen BenefitApplications sowohl für als auch BenefitAllocations. Diese Veranstaltungen ermöglichen es Kunden, umfassende, ereignisgesteuerte Architekturen aufzubauen, die auf Änderungen während des gesamten Ressourcenlebenszyklus reagieren — von der ersten Anwendung über die Zuweisung bis hin zur endgültigen Ausführung.

Erfüllen Sie die Voraussetzungen für die Überwachung von Ereignissen

Benutzer benötigen die entsprechenden IAM-Berechtigungen, um auf Ereignisse zuzugreifen und diese zu verwalten, die von der Benefits API veröffentlicht wurden. Weitere Informationen zu den verfügbaren Aktionen, Ressourcen und Bedingungsschlüsseln für EventBridge finden Sie unter Verwenden von IAM-Richtlinienbedingungen in Amazon EventBridge im EventBridge Amazon-Benutzerhandbuch. Einer der Bedingungsschlüssel istevents:detail-type, der verwendet werden kann, um Berechtigungen auf bestimmte Ereignistypen zu beschränken.

Die folgende Beispielrichtlinie zeigt, wie Sie die Berechtigungen für die vorgeschlagenen Ereignisse anpassen und einschränken können. Die AllowPutRuleForPartnercentralBenefitsEvents Anweisung ermöglicht die Erstellung von Regeln, jedoch nur für Ereignisse aus der aws.partnercentral-benefits Quelle.

Ausführliche Beispiele für IAM-Richtlinien finden Sie in der AWS-Dokumentation zu EventBridge Berechtigungen.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowPutRuleForPartnerCentralBenefitsEvents",
      "Effect": "Allow",
      "Action": "events:PutRule",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "events:source": "aws.partnercentral-benefits"
        }
      }
    }
  ]
}

Amazon für EventBridge die Überwachung von Ereignissen konfigurieren

Um API-Ereignisse für Leistungen zu überwachen, erstellen Sie eine EventBridge Regel, die den Ereignissen entspricht, die Sie erfassen möchten. Sie können die AWS-Managementkonsole oder die AWS SDKs verwenden, um Regeln zu erstellen und zu verwalten. In den folgenden Abschnitten wird erklärt, wie Regeln mit beiden Methoden erstellt werden. Unabhängig von der verwendeten Methode müssen Sie die Regel in der us-east-1 Region USA Ost (Nord-Virginia) erstellen.

AWS-Managementkonsole Einrichten

Um eine EventBridge Regel mit dem einzurichten AWS-Managementkonsole, folgen Sie den Schritten unter Erstellen von Regeln, die auf Ereignisse EventBridge in Amazon reagieren im EventBridge Amazon-Benutzerhandbuch. Bei der Erstellung der Regel müssen Sie den Event-Bus auf die Standardeinstellung setzen und die Regel in der us-east-1 Region USA Ost (Nord-Virginia) erstellen.

Im Folgenden finden Sie ein Beispiel für eine Ereignisregel:

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

AWS SDK-Setup

Sie können die AWS SDKs verwenden, um EventBridge Regeln programmgesteuert zu erstellen und zu verwalten. Weitere Informationen finden Sie PutRulein der Amazon EventBridge API-Referenz.

Das folgende Beispiel verwendet das 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'])

Erfahren Sie mehr über API-Veranstaltungen zu den Vorteilen

In den folgenden Abschnitten werden die Vorteile von API-Ereignistypen, Szenarien, die sie auslösen, und Beispiele für Ereignisse beschrieben.

Event types (Ereignistypen)

Im Folgenden sind die Ereignistypen und ihre Auslöser aufgeführt.

Nutzenanwendungen

  • Leistungsantrag erstellt: Wenn ein Leistungsantrag erstellt wird

  • Leistungsantrag wird geprüft: Dieses Ereignis wird ausgelöst, wenn ein Leistungsantrag eingereicht wird oder wenn der Antrag von „Maßnahme erforderlich“ zurück zu „Wird geprüft“ wechselt.

  • Maßnahme im Leistungsantrag erforderlich: Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status des Antrags aktualisiert, um darauf hinzuweisen, dass der Partner zusätzliche Informationen, Klarstellungen oder Änderungen vorlegen muss, bevor die Prüfung fortgesetzt werden kann.

  • Antrag auf Leistung abgelehnt: Dieses Ereignis tritt auf, wenn ein interner Prüfer den Status des Antrags aktualisiert, um anzuzeigen, dass der Antrag die Leistungskriterien oder -anforderungen nicht erfüllt und abgelehnt wurde

  • Leistungsantrag genehmigt: Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status des Antrags aktualisiert, um anzuzeigen, dass der Antrag für die Leistungszuweisung genehmigt wurde.

  • Phase der Beantragung von Leistungen geändert: Dieses Ereignis tritt auf, wenn ein interner Prüfer den Status des Antrags im Rahmen von Prüfverfahren wie Geschäftsprüfung,AWS Prüfung, Finanzprüfung usw. aktualisiert.

Zuweisung von Leistungen

  • Leistungszuweisung aktiviert: Wenn eine Leistungszuweisung erstellt oder durch einen internen Dienst wieder auf Aktiviert aktualisiert wird.

  • Leistungszuweisung inaktiviert: Dieses Ereignis tritt auf, wenn ein interner Prüfer den Status der Zuweisung aktualisiert oder wenn eine Leistungszuweisung automatisch abläuft.

  • Leistungszuweisung erfüllt: Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status der Allokation aktualisiert, um anzuzeigen, dass die Allokation vollständig ausgeschöpft wurde.

Beispielereignisse

Die folgenden Abschnitte enthalten Beispiele für die zuvor im vorherigen Abschnitt aufgeführten Ereignisse.

Der Antrag auf Leistung wurde erstellt

Auslösender Kontext

Das Ereignis „Benefit Application Created“ wird auf Amazon veröffentlicht EventBridge , wenn ein neuer Leistungsantrag erfolgreich über den Benefits Service erstellt wurde. Dieses Ereignis tritt ein, wenn der CreateBenefitApplication API-Aufruf erfolgreich abgeschlossen wurde, was darauf hinweist, dass ein Partner eine Anfrage für eine bestimmte Leistung gestellt hat.

Dieses Ereignis stellt den Beginn des Lebenszyklus der Leistungsanträge dar und informiert Kunden sofort, wenn neue Anträge auf ihrem Konto eingehen.

Empfänger

Das Konto, für das der Eigentümer zuständig ist, erhält die Veranstaltung für die Gewährung von Leistungen.

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

Der Antrag auf Leistungen wird geprüft

Auslösender Kontext

Das Ereignis „Antrag auf Leistungen wird geprüft“ wird auf Amazon veröffentlicht, EventBridge wenn ein Leistungsantrag über den Benefits Service in den Status IN_REVIEW übergeht. Dieses Ereignis tritt ein, wenn:

  • Ein Partner reicht seine Bewerbung über den SubmitBenefitApplication API-Aufruf ein

  • Eine Anwendung wechselt von ACTION_REQUIRED zurück zu IN_REVIEW, nachdem der Partner auf Feedback reagiert hat

  • Eine Bewerbung wird zurückgerufen und dann erneut eingereicht

Dieses Ereignis weist darauf hin, dass der Antrag in das formelle Prüfverfahren eingetreten ist und von AWS internen Teams geprüft wird.

Empfänger

Der Eigentümer erhält die Veranstaltung für die Benefit Allocation.

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

Maßnahme zur Beantragung von Leistungen erforderlich

Auslösender Kontext

Das Ereignis „Maßnahme für Leistungsantrag erforderlich“ wird auf Amazon veröffentlicht, EventBridge wenn ein Leistungsantrag über den Benefits Service in den Status ACTION_REQUIRED übergeht. Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status des Antrags über die UpdateBenefitApplicationInternal API aktualisiert, um darauf hinzuweisen, dass der Partner zusätzliche Informationen, Klarstellungen oder Änderungen bereitstellen muss, bevor die Prüfung fortgesetzt werden kann.

Dieses Ereignis stellt einen kritischen Punkt im Anwendungslebenszyklus dar, an dem ein Eingreifen des Partners erforderlich ist, um den Antrag im Überprüfungsprozess voranzubringen.

Empfänger

Das Konto, für das der Eigentümer verantwortlich ist, erhält die Veranstaltung im Rahmen der Benefit-Allokation

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

Antrag auf Leistung abgelehnt

Auslösender Kontext

Das Ereignis „Antrag auf Leistung abgelehnt“ wird auf Amazon veröffentlicht, EventBridge wenn ein Leistungsantrag über den Benefits Service in den Status ABGELEHNT übergeht. Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status des Antrags über die UpdateBenefitApplicationInternal API aktualisiert, um anzuzeigen, dass der Antrag die Leistungskriterien oder Anforderungen nicht erfüllt und abgelehnt wurde.

Dieses Ereignis stellt einen Endzustand im Lebenszyklus eines Antrags dar, in dem der Antrag formell abgelehnt wurde und nicht für die Zuweisung von Leistungen verwendet wird.

Empfänger

Das Ereignis für die Zuweisung von Leistungen erhält das Konto, für das der Eigentümer zuständig ist.

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

Antrag auf Leistungen genehmigt

Auslösender Kontext

Die Veranstaltung Leistungsantrag genehmigt wird auf Amazon veröffentlicht, EventBridge wenn ein Leistungsantrag über den Benefits Service in den Status GENEHMIGT übergeht. Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status des Antrags über die UpdateBenefitApplicationInternal API aktualisiert, um anzugeben, dass der Antrag alle Leistungskriterien und -anforderungen erfüllt und für die Zuweisung von Leistungen genehmigt wurde.

Dieses Ereignis stellt einen erfolgreichen Abschluss des Antragsprüfungsprozesses dar und löst in der Regel die Erstellung einer entsprechenden Leistungszuweisung aus.

Empfänger

Das Konto, für das der Eigentümer zuständig ist, erhält die Veranstaltung für die Leistungszuweisung.

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

Die Phase der Beantragung von Leistungen wurde geändert

Auslösender Kontext

Das Ereignis „Phase der Änderung des Leistungsantrags“ wird auf Amazon veröffentlicht EventBridge , wenn die Überprüfungsphase eines Leistungsantrags über den Benefits Service aktualisiert wird. Dieses Ereignis tritt ein, wenn ein interner Prüfer die Phase des Antrags auf einen der möglichen Enum-Werte aktualisiert (FINANCE_REVIEW, BUSINESS_REVIEW, TECH_REVIEW und _REVIEW).AWS

Im Gegensatz zu Statusänderungen handelt es sich bei Phasenänderungen um schreibgeschützte Informationsaktualisierungen, die Einblick in den Verlauf des internen Prüfungsablaufs bieten, ohne dass ein Eingreifen des Partners erforderlich ist.

Empfänger

Der Eigentümer erhält die Veranstaltung im Rahmen der Benefit Allocation.

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

Die Zuweisung von Leistungen ist aktiviert

Auslösender Kontext

Das Ereignis „Benefit Allocation Activated“ wird auf Amazon veröffentlicht EventBridge , wenn eine Benefit Allocation über den Benefits Service in den Status AKTIV übergeht. Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status der Zuteilung über die UpdateBenefitAllocationInternal API aktualisiert, um eine zuvor inaktive Zuteilung wieder zu aktivieren.

Dieses Ereignis tritt in der Regel auf, wenn eine Zuteilung, die vorübergehend inaktiviert wurde (aufgrund von Ablauf, Richtlinienänderungen oder administrativen Gründen), wieder in den aktiven Status versetzt wird, sodass die Vorteile wieder für Partner verfügbar sind.

Empfänger

Das AWS Konto des Partners erhält die Nachricht. Mit anderen Worten, das AWS Konto, dem die Ressource gehört.

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

Zuweisung von Leistungen inaktiviert

Auslösender Kontext

Das Ereignis Vorteilsallokation inaktiviert wird auf Amazon veröffentlicht, EventBridge wenn eine Leistungszuweisung über den Benefits Service in den Status INAKTIV übergeht. Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status der Zuteilung über die UpdateBenefitAllocationInternal API aktualisiert oder wenn eine Leistungszuweisung automatisch abläuft.

Dieses Ereignis tritt in der Regel auf, wenn eine Zuteilung vorübergehend ausgesetzt wird (aufgrund von Ablauf, Richtlinienänderungen, Compliance-Problemen oder administrativen Gründen), sodass die Leistungen erst nach einer erneuten Aktivierung für Partner in Anspruch genommen werden können.

Empfänger

Das AWS Konto des Partners erhält die Nachricht. Mit anderen Worten, das AWS Konto, dem die Ressource gehört.

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

Die Zuweisung der Leistungen ist abgeschlossen

Auslösender Kontext

Das Ereignis „Benefit Allocation Fulfilled“ wird auf Amazon veröffentlicht EventBridge , wenn eine Benefit Allocation über den Benefits Service in den Status FULFILLED übergeht. Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status der Zuteilung über die UpdateBenefitAllocationInternal API aktualisiert, um anzuzeigen, dass das Kontingent vollständig ausgeschöpft wurde oder dass die Leistungsbedingungen erfüllt wurden.

Dieses Ereignis stellt den Abschluss des Leistungslebenszyklus dar und weist darauf hin, dass der Partner die zugewiesene Leistung erfolgreich in Anspruch genommen hat oder dass die Zuweisung ihren natürlichen Abschluss erreicht hat.

Empfänger

Das AWS Konto des Partners erhält die Nachricht. Mit anderen Worten, das AWS Konto, dem die Ressource gehört.

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