Erfüllen Sie die Voraussetzungen für die Überwachung von Ereignissen Amazon für EventBridge die Überwachung von Ereignissen konfigurieren Erfahren Sie mehr über API-Ereignisse für Kontoverbindungen

Benachrichtigungen für AWS Konto-API für Partner Central

Mithilfe von Verbindungsbenachrichtigungen für Partnerkonten können Partner über Ereignisse im Verbindungslebenszyklus auf dem Laufenden bleiben, die sich direkt auf ihre Geschäftsbeziehungen und betrieblichen Arbeitsabläufe auswirken. Diese Ereignisse sind für Partner von entscheidender Bedeutung, um:

Reagieren Sie umgehend auf neue Kollaborationen
Behalten Sie den Status ihres Verbindungsportfolios im Blick
Ergreifen Sie geeignete Maßnahmen, wenn Verbindungen hergestellt oder beendet werden
Stellen Sie die Geschäftskontinuität sicher, indem Sie wissen, wann sich Beziehungen ändern

Themen

Erfüllen Sie die Voraussetzungen für die Überwachung von Ereignissen
Amazon für EventBridge die Überwachung von Ereignissen konfigurieren
Erfahren Sie mehr über API-Ereignisse für Kontoverbindungen

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 Kontoverbindungs-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 AllowPutRuleForPartnercentralAccountEvents Anweisung ermöglicht die Erstellung von Regeln, jedoch nur für Ereignisse aus der aws.partnercentral-account Quelle.

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


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

Amazon für EventBridge die Überwachung von Ereignissen konfigurieren

Um API-Ereignisse für Kontoverbindungen zu überwachen, erstellen Sie eine EventBridge Regel, die den Ereignissen entspricht, die Sie erfassen möchten. Sie können die SDKs 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-account"],
    "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='MyConnectionInvitationReceivedRule',
    EventPattern=
    '{
        "source": ["aws.partnercentral-account"], 
        "detail-type": ["Partner Connection Invitation Received"], 
        "detail": {"catalog": ["AWS"]}
    }',
    State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])

Erfahren Sie mehr über API-Ereignisse für Kontoverbindungen

In den folgenden Abschnitten werden die API-Ereignistypen für Kontoverbindungen, 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.

Einladung zur Partnerverbindung erhalten: Informiert den Empfänger, dass ein anderer Partner eine Verbindung herstellen möchte
Einladung zur Partnerverbindung akzeptiert: Informiert den Absender, dass seine Einladung angenommen wurde und nun eine Verbindung aktiv ist
Einladung zur Partnerverbindung abgelehnt: Informiert den Absender, dass seine Einladung abgelehnt wurde
Partnerverbindung abgebrochen: Benachrichtigt den anderen verbundenen Teilnehmer, wenn eine aktive Verbindung beendet wird
Einladung zur Partnerverbindung storniert: Informiert den Empfänger, dass der Absender seine Einladung zurückgezogen hat, bevor Maßnahmen ergriffen wurden
Einladung zur Partnerverbindung abgelaufen: Sowohl der Absender als auch der Empfänger werden darüber informiert, dass die Einladung abgelaufen ist

Beispielereignisse

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

Themen

Einladung zur Partnerverbindung erhalten
Einladung zur Partnerverbindung akzeptiert
Einladung zur Partnerverbindung abgelehnt
Partnerverbindung wurde abgebrochen
Einladung zur Partnerverbindung storniert
Die Einladung zur Partnerverbindung ist abgelaufen

Einladung zur Partnerverbindung erhalten

Auslösender Kontext

Dieses Ereignis wird generiert, wenn eine Verbindungseinladung erfolgreich erstellt und über die API im Datenspeicher von PAC gespeichert wurde. CreateConnectionInvitation Das Ereignis wird unmittelbar nach dem erfolgreichen Abschluss der Einladungserstellung gesendet und im Datenspeicher von PAC gespeichert, nicht erst, wenn der API-Aufruf erfolgt.

Das Ereignis wird automatisch gesendet, wenn eine neue Verbindungseinladung erstellt wird. Pro erstellter Einladung wird eine Veranstaltung ohne doppelte Ereignisse für dieselbe Einladung erstellt.

Empfänger

Das AWS Konto des Empfängers in der Verbindungseinladung.

Voraussichtlicher Umgang

Typische Kundenaktionen:

Sofortige Benachrichtigung: Lassen Sie Geschäftsteams über neue Partnerschaftsmöglichkeiten benachrichtigen
Workflow-Automatisierung: Automatische Aktualisierung der Partnerverwaltungssysteme mit ausstehenden Einladungen
Entscheidungsunterstützung: Leitet Einladungen je nach Verbindungstyp an geeignete Entscheidungsträger weiter
Auditprotokollierung: Notieren Sie den Eingang der Einladung, um die Einhaltung der Vorschriften einzuhalten und die Partnerschaft nachzuverfolgen
Antwortautomatisierung: Für vertrauenswürdige Partner können bestimmte Einladungstypen möglicherweise automatisch akzeptiert werden

Allgemeine Integrationsmuster:

Lambda-Funktion → Partnerportal-Dashboard aktualisieren
SQS-Warteschlange → Einladungen zur Überprüfung Batch verarbeiten
SNS-Thema → Email/Slack Benachrichtigungen an Geschäftsteams
API-Ziel → Webhook zu externen Managementsystemen CRM/partner

Beispiel


{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Received",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderCompanyName": "<<Sender Partner Account Name>>",
        "senderProfileId": "pprofile-****",
        "expiresAt": "<ISO 8601 date time>"
    }
  }
}

Einladung zur Partnerverbindung akzeptiert

Auslösender Kontext

Dieses Ereignis wird generiert, wenn eine Verbindungseinladung erfolgreich angenommen wurde und eine Verbindung erstellt und über die API im Datenspeicher von PAC gespeichert wird. AcceptConnectionInvitation Das Ereignis wird unmittelbar nach dem erfolgreichen Abschluss der Annahme der Einladung und dem Verbindungsaufbau gesendet.

Die Veranstaltung wird automatisch gesendet, wenn eine Verbindungseinladung angenommen wird. Pro Einladung wird eine Veranstaltung akzeptiert, ohne dass es zu doppelten Veranstaltungen für dieselbe Annahme kommt.

Empfänger

Beide AWS Konten waren an der Verbindungseinladung beteiligt: das Absenderkonto, das die Einladung ursprünglich gesendet hat, und das Empfängerkonto, das die Einladung angenommen hat.

Erwartete Bearbeitung

Typische Kundenaktionen:

Aktivierung der Partnerschaft: Auslösen von Workflows zur Aktivierung von Layer-2-Geschäftsaktivitäten
Statusaktualisierungen: Aktualisieren Sie die Partnerverwaltungssysteme mit dem aktiven Verbindungsstatus
Benachrichtigung: Informieren Sie die Geschäftsteams über den erfolgreichen Aufbau einer Partnerschaft
Zugriffsbereitstellung: Erteilen Sie automatisch die entsprechenden Berechtigungen für die Zusammenarbeit
Analytik: Verfolgen Sie die Konversionsraten und Erfolgsmetriken von Partnerschaften

Allgemeine Integrationsmuster:

Lambda-Funktion → Berechtigungen für die gemeinsame Nutzung von Daten aktivieren und das Partnerportal aktualisieren
SQS-Warteschlange → Verbindungsaktivierungen für die Geschäftseinrichtung Batch verarbeiten
SNS-Thema → Email/Slack Benachrichtigungen an Geschäfts- und Technikteams
API-Ziel → Webhook zu CRM-Systemen zur Aktualisierung des Partnerschaftsstatus

Beispiel


{
  "version": "1",
  "id": "<event id>",
  "detail-type":  "Partner Connection Invitation Accepted",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" , "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration"
    },
    "connection": {
        "arn": "<<Connection ARN>>",
         "id": "pac-*****",
         "Participant1AccountId": "<<Sender AWS AccountId>>", 
         "Participant2AccountId": "<<Receiver AWS AccountId>>",
         "status": "ACTIVE"
     }
  }
}

Einladung zur Partnerverbindung abgelehnt

Auslösender Kontext

Dieses Ereignis wird generiert, wenn eine Verbindungseinladung über die RejectConnectionInvitation API erfolgreich abgelehnt wurde. Das Ereignis wird unmittelbar nach der Verarbeitung der Ablehnung der Einladung gesendet und im Datenspeicher von PAC gespeichert.

Das Ereignis wird automatisch gesendet, wenn eine Verbindungseinladung abgelehnt wird. Ein Ereignis pro Einladung wurde abgelehnt, ohne dass es zu doppelten Ereignissen für dieselbe Ablehnung kam.

Empfänger

Das AWS Konto, das ursprünglich die Verbindungseinladung gesendet hat (das Absenderkonto).

Erwartete Bearbeitung

Typische Kundenaktionen:

Statusaktualisierungen: Aktualisieren Sie die Partnerverwaltungssysteme mit dem Ablehnungsstatus
Follow-up Aktionen: Initiieren Sie Workflows für alternative Partnerschaftsansätze
Benachrichtigung: Informieren Sie die Geschäftsteams über die Entscheidung über eine Partnerschaft
Säuberung: Entfernen Sie ausstehende Einladungsverweise aus internen Systemen

Allgemeine Integrationsmuster:

Lambda-Funktion → Partnerportal aktualisieren und Folgeworkflows auslösen
SQS-Warteschlange → Ablehnungen von Batch-Prozessen für Geschäftsanalysen
SNS-Thema → Email/Slack Benachrichtigungen an Geschäftsentwicklungsteams
API-Ziel → Webhook zu CRM-Systemen, um den Opportunity-Status zu aktualisieren

Beispiel


{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Rejected",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "receiverProfileId": "pprofile-****"
    }
  }
}

Partnerverbindung wurde abgebrochen

Auslösender Kontext

Dieses Ereignis wird generiert, wenn eine aktive Verbindung erfolgreich abgebrochen wurde und der aktive Status im Datenspeicher von PAC über die CancelConnection API auf „Beendet“ aktualisiert wird. Das Ereignis wird unmittelbar nach der Verarbeitung des Verbindungsabbruchs und der Aktualisierung des Verbindungsstatus gesendet.

Das Ereignis wird automatisch gesendet, wenn eine Verbindung beendet wird. Ein Ereignis pro Verbindung wurde abgesagt, ohne dass es zu doppelten Ereignissen für dieselbe Stornierung kam.

Empfänger

Das AWS Konto des anderen Teilnehmers an der Verbindung (nicht des Teilnehmers, der die Stornierung veranlasst hat).

Voraussichtlicher Umgang

Typische Kundenaktionen:

Widerruf des Zugriffs: Widerrufen Sie sofort Berechtigungen und deaktivieren Sie die gemeinsame Nutzung von Daten
Statusaktualisierungen: Aktualisieren Sie die Partnerverwaltungssysteme mit dem Status „Verbindung beendet“
Benachrichtigung: Informieren Sie Geschäfts- und Technikteams über die Kündigung der Partnerschaft
Säuberung: Entfernen Sie Verbindungsreferenzen und bereinigen Sie gemeinsam genutzte Ressourcen
Analytik: Verfolgen Sie die Verbindungsdauer und die Kündigungsmuster

Allgemeine Integrationsmuster:

Lambda-Funktion → Berechtigungen widerrufen und Partnerportalstatus aktualisieren
SQS-Warteschlange → Verbindungsabbrüche im Batch-Prozess für Bereinigungsworkflows
SNS-Thema → Email/Slack Benachrichtigungen an Geschäfts- und Technikteams
API-Ziel → Webhook zu CRM-Systemen zur Aktualisierung des Partnerschaftsstatus

Beispiel


{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connection" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pac-****",
        "connectionType": "OpportunityCollaboration",
        "canceledBy": "<<AWS account ID>>"
    }
  }
}

Einladung zur Partnerverbindung storniert

Auslösender Kontext

Dieses Ereignis wird generiert, wenn eine ausstehende Verbindungseinladung erfolgreich über die CancelConnectionInvitation API storniert wurde. Die Veranstaltung wird unmittelbar nach der Bearbeitung der Stornierung der Einladung gesendet und der Einladungsstatus auf STORNIERT aktualisiert.

Die Veranstaltung wird automatisch gesendet, wenn eine Verbindungseinladung storniert wird. Eine Veranstaltung pro Verbindungseinladung wurde storniert, ohne dass es zu doppelten Terminen für dieselbe Stornierung kam.

Empfänger

Das AWS Konto, das die Verbindungseinladung erhalten sollte (das Empfängerkonto).

Voraussichtlicher Umgang

Typische Kundenaktionen:

Statusaktualisierungen: Aktualisieren Sie die Partnerverwaltungssysteme, um ausstehende Einladungsverweise zu entfernen
Benachrichtigung: Machen Sie die Geschäftsteams darauf aufmerksam, dass ein potenzielles Partnerschaftsangebot zurückgezogen wurde
Säuberung: Entfernen Sie Einladungsverweise aus den internen Nachverfolgungssystemen
Analytik: Verfolge die Stornierungsmuster von Einladungen, um Einblicke in deine Partnerschaft zu gewinnen

Allgemeine Integrationsmuster:

Lambda-Funktion → Partnerportal aktualisieren und ausstehende Einladungsbenachrichtigungen entfernen
SQS-Warteschlange → Stornierungen von Batch-Prozessen für Geschäftsanalysen
SNS-Thema → Email/Slack Benachrichtigungen an Geschäftsentwicklungsteams
API-Ziel → Webhook zu CRM-Systemen, um den Opportunity-Status zu aktualisieren

Beispiel


{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****"
    }
  }
}

Die Einladung zur Partnerverbindung ist abgelaufen

Auslösender Kontext

Dieses Ereignis wird generiert, wenn eine ausstehende Verbindungseinladung nach Erreichen ihres ExpiresAt Zeitstempels automatisch abläuft, ohne vom Empfänger akzeptiert oder abgelehnt zu werden. Das Ereignis wird automatisch vom System ausgelöst, wenn die Ablaufzeit der Einladung erreicht ist.

Das Ereignis wird automatisch gesendet, wenn eine Verbindungseinladung abläuft. Ein Ereignis pro Einladung ist abgelaufen, und es gab keine doppelten Ereignisse für denselben Ablauf.

Empfänger

Beide AWS Konten waren an der Verbindungseinladung beteiligt: das Absenderkonto, das die Einladung ursprünglich gesendet hat, und das Empfängerkonto, das die Einladung erhalten hat.

Voraussichtlicher Umgang

Typische Kundenaktionen:

Statusaktualisierungen: Aktualisieren Sie die Partnerverwaltungssysteme, sodass die Einladung als abgelaufen markiert wird
Follow-up Aktionen: Initiieren Sie Workflows für eine erneute Zusammenarbeit oder alternative Partnerschaftsansätze
Benachrichtigung: Informieren Sie Geschäftsteams über verpasste Partnerschaftsmöglichkeiten
Säuberung: Entfernen Sie abgelaufene Einladungsreferenzen aus den internen Nachverfolgungssystemen

Allgemeine Integrationsmuster:

Lambda-Funktion → Partnerportal aktualisieren und Folgeworkflows auslösen
SQS-Warteschlange → Ablaufdaten von Batch-Prozessen für Geschäftsanalysen
SNS-Thema → Email/Slack Benachrichtigungen an Geschäftsentwicklungsteams
API-Ziel → Webhook zu CRM-Systemen, um den Opportunity-Status zu aktualisieren

Beispiel


{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Expired",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation": {
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****",
        "receiverProfileId": "pprofile-****"
    }
  }
}

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Benachrichtigungen

Benachrichtigungen für die AWS Vertriebs-API von Partner Central