View a markdown version of this page

Benachrichtigungen für die AWS API für Vorteile von Partner Central - AWS Partner Central
Erfüllen Sie die Voraussetzungen für die Überwachung von EreignissenKonfigurieren Sie Amazon EventBridge für die Überwachung von EreignissenErfahren Sie mehr über API-Veranstaltungen mit 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 die AWS API für Vorteile von Partner Central

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

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 im EventBridge Amazon-Benutzerhandbuch unter Using IAM Policy EventBridge Conditions in Amazon. Einer der Bedingungsschlüssel istevents:detail-type, mit dem Berechtigungen auf bestimmte Ereignistypen beschränkt werden können.

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

Detaillierte 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"
        }
      }
    }
  ]
}

Konfigurieren Sie Amazon EventBridge für die Überwachung von Ereignissen

Um API-Ereignisse 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 erläutert, wie Sie mit beiden Methoden Regeln erstellen. 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 mithilfe von einzurichten AWS-Managementkonsole, folgen Sie den Schritten unter Erstellen von Regeln, die auf Ereignisse in Amazon reagieren, EventBridge im EventBridge Amazon-Benutzerhandbuch. Bei der Erstellung der Regel müssen Sie den Event-Bus auf Standard 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 PutRule in der EventBridge Amazon-API-Referenz.

Das folgende Beispiel verwendet das AWS SDK für 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'])

Erfahren Sie mehr über API-Veranstaltungen mit Vorteilen

In den folgenden Abschnitten werden die Ereignistypen der Benefits API, die Szenarien, die sie auslösen, und die Eventbeispiele beschrieben.

Event types (Ereignistypen)

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

Vorteile: Anwendungen

  • Leistungsantrag erstellt: Wenn ein Leistungsantrag erstellt wird

  • Leistungsantrag wird geprüft: Wenn ein Leistungsantrag eingereicht wird oder wenn der Leistungsantrag von „Aktion erforderlich“ wieder in „Prüfung“ übergeht, wird dieses Ereignis ausgelöst.

  • Aktion für den Leistungsantrag erforderlich: Dieses Ereignis tritt ein, wenn ein interner Prüfer den Antragsstatus aktualisiert und darauf hinweist, dass der Partner zusätzliche Informationen, Klarstellungen oder Änderungen bereitstellen muss, bevor die Prüfung fortgesetzt werden kann.

  • Antrag auf Leistung abgelehnt: Dieses Ereignis tritt ein, wenn ein interner Prüfer den Antragsstatus aktualisiert und darauf hinweist, 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 Antragsstatus aktualisiert, um anzuzeigen, dass der Antrag für die Leistungszuweisung genehmigt wurde.

  • Phase des Leistungsantrags geändert: Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status des Antrags im Rahmen von Prüfprozessen wie z. B. der AWS Geschäftsüberprüfung, der Überprüfung der Finanzlage usw. aktualisiert.

Zuweisung von Leistungen

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

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

  • Leistungszuweisung erfüllt: Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status der Leistungszuweisung aktualisiert, um anzuzeigen, dass die Zuweisung vollständig in Anspruch genommen wurde.

Beispielereignisse

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

Benefit-Anwendung 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 ihr Konto eingehen.

Empfänger

Das Ereignis für die Leistungszuweisung wird dem Konto des Inhabers zugeteilt.

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

Antrag auf Leistung wird geprüft

Auslösender Kontext

Das Ereignis „Leistungsantrag wird geprüft“ wird bei 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 das Feedback beantwortet hat

  • Eine Bewerbung wird zurückgerufen und dann erneut eingereicht

Dieses Ereignis weist darauf hin, dass der Antrag das formelle Überprüfungsverfahren durchlaufen hat und von AWS internen Teams geprüft wird.

Empfänger

Das Ereignis für die Leistungszuweisung wird dem Konto des Eigentümers zugeteilt.

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

Aktion zur Beantragung der Leistung erforderlich

Auslösender Kontext

Das Ereignis „Benefit Application Action Required“ 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 Antragsstatus über die UpdateBenefitApplicationInternal API aktualisiert, um darauf hinzuweisen, dass der Partner zusätzliche Informationen, Erläuterungen oder Änderungen bereitstellen muss, bevor die Prüfung fortgesetzt werden kann.

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

Empfänger

Das Ereignis für die Leistungszuweisung wird dem Konto des Inhabers zugeteilt

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 „Leistungsantrag abgelehnt“ wird bei 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 Antragsstatus ü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 des Antrags dar, in dem der Antrag formell abgelehnt wurde und die Leistungszuweisung nicht erfolgt.

Empfänger

Das Ereignis für die Leistungszuweisung wird dem Konto des Inhabers zugeteilt.

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 Leistung genehmigt

Auslösender Kontext

Das Ereignis „Leistungsantrag genehmigt“ wird bei 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 Antragsstatus über die UpdateBenefitApplicationInternal API aktualisiert, um anzuzeigen, dass der Antrag alle Leistungskriterien und Anforderungen erfüllt und für die Leistungszuweisung genehmigt wurde.

Dieses Ereignis steht für den erfolgreichen Abschluss der Antragsprüfung und löst in der Regel die Erstellung einer entsprechenden Leistungszuweisung aus.

Empfänger

Die Veranstaltung für die Leistungszuweisung wird dem Konto des Inhabers zugeteilt.

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 der Leistung wurde geändert

Auslösender Kontext

Das Ereignis „Leistungsantrag wurde in der Phase geändert“ wird auf Amazon veröffentlicht EventBridge , wenn die Phase der Überprüfung 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 (FINANCE_REVIEW, BUSINESS_REVIEW, TECH_REVIEW und _REVIEW) aktualisiert. AWS

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

Empfänger

Die Veranstaltung für die Leistungszuweisung wird dem Konto des Eigentümers zugeteilt.

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

Leistungszuweisung aktiviert

Auslösender Kontext

Das Ereignis „Leistungszuweisung aktiviert“ wird bei Amazon veröffentlicht, EventBridge wenn eine Leistungszuweisung über den Benefits Service in den Status AKTIV übergeht. Dieses Ereignis tritt ein, wenn ein interner Prüfer den Zuweisungsstatus über die UpdateBenefitAllocationInternal API aktualisiert, um eine zuvor inaktive Zuweisung zu reaktivieren.

Dieses Ereignis tritt in der Regel ein, wenn eine Allokation, die vorübergehend inaktiviert wurde (aufgrund von Ablauf, Richtlinienänderungen oder administrativen Gründen), wieder in den Status „Aktiv“ zurückversetzt wird, sodass die Vorteile wieder von Partnern genutzt 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": "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"]
    }
  }
}

Leistungszuweisung inaktiviert

Auslösender Kontext

Das Ereignis „Leistungszuweisung inaktiviert“ wird bei 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 Leistungszuweisung über die UpdateBenefitAllocationInternal API aktualisiert oder wenn eine Leistungszuweisung automatisch abläuft.

Dieses Ereignis tritt in der Regel ein, wenn eine Zuweisung vorübergehend ausgesetzt wird (aufgrund von Ablauf, Richtlinienänderungen, Problemen mit der Einhaltung der Vorschriften oder administrativen Gründen), sodass die Leistungen für Partner nicht in Anspruch genommen werden können, bis sie erneut aktiviert werden.

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 Leistungszuweisung wurde erfüllt

Auslösender Kontext

Das Ereignis „Leistungszuweisung erfüllt“ wird bei Amazon veröffentlicht EventBridge , wenn eine Leistungszuweisung über den Leistungsservice in den Status ERFÜLLT übergeht. Dieses Ereignis tritt ein, wenn ein interner Prüfer den Status der Leistungszuweisung ü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 Leistungszyklus dar und zeigt an, 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 wird die Nachricht erhalten. 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"]
    }
  }
}