View a markdown version of this page

Mit Partnerkontoverbindungen arbeiten - AWS Partner Central
Eine Verbindungseinladung erstellen und sendenEmpfangen und Beantworten von VerbindungseinladungenAktive Verbindungen verwaltenÜberwachung von VerbindungsereignissenGrundlegendes zum VerbindungsstatusBewährte MethodenVerbindungstypen und ihre Zwecke

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.

Mit Partnerkontoverbindungen arbeiten

Partner können mithilfe der Partner Connection-API Verbindungen zwischen ihren eigenen Konten oder Verbindungen mit AWS Konten anderer AWS Partner verwalten. Der Prozess umfasst zwei Phasen:

  1. Phase der Verbindungseinladung: Initiieren und Beantworten von Verbindungsanfragen

  2. Aktive Verbindungsphase: Verwaltung bestehender Verbindungen und der damit verbundenen Geschäftsaktivitäten

Eine Verbindungseinladung erstellen und senden

Schritt 1: Erstellen Sie eine Verbindungseinladung

Der erste Schritt beim Herstellen einer Partnerverbindung besteht darin, mithilfe der CreateConnectionInvitation Aktion eine Verbindungseinladung zu erstellen und zu senden. Beim Erstellen einer Einladung müssen Sie Folgendes angeben:

  • Katalog: Der AWS Katalog (AWS oder die Sandbox), in dem die Verbindung verwaltet wird

  • ConnectionType: Die Art der Beziehung, die Sie herstellen möchten. Wählen Sie eine der folgenden Optionen:

    • OPPORTUNITY_COLLABORATION: Verwenden Sie diesen Typ, wenn Sie eine Verbindungsanfrage an das Konto eines anderen Partners senden möchten, damit Sie ihm Einladungen zur Opportunity-Zusammenarbeit senden können

    • SUBSIDIARY: Verwenden Sie diesen Typ, wenn Sie mehrere AWS Marketplace-Verkäuferkonten, die Sie besitzen, mit Ihrem „primären“ Konto verbinden möchten, das Sie mit APN verknüpft haben oder bei dem Sie als Partner registriert sind

  • ReceiverIdentifier: Die öffentliche Partnerprofil-ID (für den Verbindungstyp Opportunity Collaboration) oder die AWS Konto-ID (für den Verbindungstyp Subsidiarität) des Empfängers

  • E-Mail: Ihre Kontakt-E-Mail-Adresse für die Kommunikation

  • Name: Ihr Name als Absender

  • Nachricht: Eine Beschreibung, die den Zweck der Verbindungsanfrage erklärt

Nach der Erstellung wechselt die Einladung in den Status Ausstehend und wartet auf eine Aktion des Empfängers.

Wichtig

Durch das Senden einer Verbindungseinladung erklären Sie sich damit einverstanden, dass Ihre AWS Konto-ID an den Empfänger weitergegeben wird, falls dieser die Einladung annimmt. Diese Offenlegung ist erforderlich, um die Verbindung auf Kontoebene herzustellen.

Schritt 2: Überwachen Sie Ihre gesendeten Einladungen

Sie können den Status der von Ihnen gesendeten Einladungen mithilfe der ListConnectionInvitations Aktion verfolgen, bei der der ParticipantType Parameter auf eingestellt istSENDER. Das ermöglicht Ihnen Folgendes:

  • Alle ausgehenden Einladungen anzeigen

  • Nach Status filtern (PENDINGACCEPTED,REJECTED,EXPIRED)

  • Nach Verbindungstyp filtern

  • Schauen Sie sich bestimmte Einladungen an andere Partner an

Schritt 3: Eine Einladung stornieren (optional)

Wenn du eine ausstehende Einladung zurückziehen musst, bevor sie angenommen wurde, kannst du die CancelConnectionInvitation Aktion verwenden. Beachten Sie Folgendes:

  • Du kannst nur Einladungen stornieren, die sich im Status Ausstehend befinden

  • Sobald eine Einladung angenommen und eine Verbindung hergestellt wurde, kann sie nicht mehr storniert werden

  • Um eine hergestellte Verbindung zu beenden, müssen Sie stattdessen die CancelConnection Aktion verwenden

Empfangen und Beantworten von Verbindungseinladungen

Schritt 1: Eingehende Einladungen auflisten

Um Verbindungseinladungen anzuzeigen, die Sie erhalten haben, verwenden Sie die ListConnectionInvitations Aktion, bei der der ParticipantType Parameter auf gesetzt istRECEIVER. Sie können filtern nach:

  • Verbindungstyp

  • Status (PENDING,ACCEPTED,REJECTED)

  • ID des Absenders

Schritt 2: Überprüfen Sie die Einladungsdetails

Verwenden Sie die GetConnectionInvitation Aktion, um vollständige Informationen zu einer bestimmten Einladung anzuzeigen, darunter:

  • Name und Kontakt-E-Mail des Absenders

  • Einladungsnachricht, in der der Zweck erklärt wird

  • Der Verbindungstyp wird angefordert

  • Ablaufdatum

  • Öffentliche Profilinformationen des Absenders

Schritt 3: Nehmen Sie die Einladung an oder lehnen Sie sie ab

Nachdem Sie die Einladungsdetails überprüft haben, haben Sie zwei Möglichkeiten:

Option A: Nehmen Sie die Einladung an

Verwenden Sie die AcceptConnectionInvitation Aktion, um die Verbindung herzustellen. Wenn du akzeptierst:

  • Eine neue Verbindung wird im Status Aktiv erstellt

  • Der Status der Einladung ändert sich in Angenommen

  • Ihre AWS Konto-ID wird dem Absender angezeigt

  • Sie können mit der Durchführung von Geschäftsaktivitäten beginnen, die durch den Verbindungstyp ermöglicht werden

Wichtig

Wichtige Zustimmung: Indem Sie eine Verbindungseinladung annehmen, erklären Sie sich damit einverstanden, dass Ihre AWS Konto-ID an den Absender weitergegeben wird. Diese Offenlegung ist erforderlich, um die Verbindung auf Kontoebene herzustellen.

Option B: Lehnen Sie die Einladung ab

Verwenden Sie die RejectConnectionInvitation Aktion, wenn Sie die Verbindung nicht herstellen möchten. Sie können optional einen Grund für die Ablehnung angeben. Nach der Ablehnung:

  • Der Status der Einladung ändert sich in Abgelehnt

  • Es wurde keine Verbindung hergestellt

  • Die Einladung erscheint nicht mehr in Ihrer Liste der ausstehenden Einladungen

Automatischer Ablauf

Wenn innerhalb des Ablaufzeitraums keine Maßnahmen ergriffen werden, wechselt das System die Einladung automatisch in den Status Abgelaufen. Abgelaufene Einladungen können nicht angenommen oder abgelehnt werden.

Aktive Verbindungen verwalten

Ihre Verbindungen anzeigen

Sobald eine Verbindung hergestellt ist, können beide Parteien sie mithilfe der folgenden Aktionen einsehen und verwalten:

ListConnections: Rufen Sie eine Liste Ihrer Verbindungen mit Filteroptionen ab:

  • Filtern Sie nach Verbindungstyp und Status (z. B.OPPORTUNITY_COLLABORATION:ACTIVE)

  • Filtern Sie nach der Kennung einer anderen Partei

  • Übersichtsinformationen für jede Verbindung anzeigen

GetConnection: Ruft vollständige Informationen zu einer bestimmten Verbindung ab, einschließlich:

  • Alle Verbindungstypen, die mit dieser Partnerbeziehung verknüpft sind

  • Status jedes Verbindungstyps (Aktiv oder Beendet)

  • Kontaktinformationen aus der ursprünglichen Einladung

  • AWS Konto-IDs und öffentliche Profil-IDs beider Parteien

  • Zeitstempel für Erstellung und Kündigung für jeden Verbindungstyp

Hinzufügen von Verbindungstypen zu einer vorhandenen Verbindung

Wenn Sie bereits eine aktive Verbindung mit einem Partner haben und eine neue Art von Beziehung aufbauen möchten, können Sie eine neue Verbindungseinladung mit einem anderen Verbindungstyp senden. Bei Annahme:

  • Der neue Verbindungstyp wird zur bestehenden Verbindung hinzugefügt

  • Beide Verbindungstypen bleiben unabhängig voneinander verwaltbar

  • Für die Beziehung wird dieselbe Verbindungs-ID beibehalten

Anmerkung

Es kann immer nur eine aktive Verbindung eines bestimmten Typs zwischen zwei Konten in einem bestimmten Katalog geben.

Verbindungstypen werden beendet

Jede Partei kann einen bestimmten Verbindungstyp mithilfe der CancelConnection Aktion beenden. Beim Beenden:

  • Geben Sie die Verbindungs-ID und den Verbindungstyp an, der beendet werden soll

  • Geben Sie einen Grund für die Kündigung an

  • Der Status des Verbindungstyps ändert sich zu CANCELED

  • Andere Verbindungstypen innerhalb derselben Verbindung bleiben davon unberührt

Vollständige Verbindungsunterbrechung

Wenn alle Verbindungstypen innerhalb einer Verbindung beendet sind, geht die Verbindung selbst in den Status Beendet über. Eine vollständig beendete Verbindung:

  • Kann nicht reaktiviert werden, aber Sie können eine neue Verbindungsanfrage senden, um das Geschäft mit diesem Konto fortzusetzen

  • Bleibt im System, um historische Aufzeichnungen zu führen

  • Kann mit der GetConnection API eingesehen werden

  • Erfordert eine neue Einladung, um die Beziehung wiederherzustellen

Überwachung von Verbindungsereignissen

Partner sollten verbindungsbezogene Ereignisse mithilfe von Amazon überwachen, um über Folgendes auf dem Laufenden EventBridge zu bleiben:

  • Neue eingehende Verbindungseinladungen

  • Statusänderungen der gesendeten Einladungen (ACCEPTED,REJECTED,EXPIRED)

  • Verbindungsabbrüche, die von der anderen Partei initiiert wurden

Verwenden Sie nach Erhalt eines Ereignisses die entsprechende Get API-Aktion, um die neuesten Details abzurufen:

  • GetConnectionInvitationfür Aktualisierungen von Einladungen

  • GetConnectionfür Verbindungsaktualisierungen

Mögliche Ereignisse

  • Verbindungseinladung erstellt: Benachrichtigt das Empfängerkonto über eingehende Verbindungseinladungen.

  • Verbindungseinladung storniert: Benachrichtigt das Empfängerkonto, wenn ein Absender eine eingehende Verbindungseinladung storniert.

  • Verbindungseinladung abgelaufen: Benachrichtigt sowohl das Absender- als auch das Empfängerkonto, wenn eine Verbindungseinladung ohne Aktion abläuft.

  • Verbindungseinladung abgelehnt: Benachrichtigt das Absenderkonto, wenn die Verbindungseinladung vom Empfänger abgelehnt wird.

  • Verbindungseinladung akzeptiert: Benachrichtigt das Absenderkonto, wenn die Verbindungseinladung akzeptiert und eine Verbindung hergestellt wird.

  • Verbindung abgebrochen: Benachrichtigt beide verbundenen Parteien, wenn die gesamte Verbindung vollständig beendet ist.

Grundlegendes zum Verbindungsstatus

Status von Einladungen zur Verbindung

Status Description Kann übergehen zu
PENDING Ausgangszustand bei der Erstellung; wartet auf eine Aktion des Empfängers ACCEPTED, REJECTED, EXPIRED, CANCELED
ACCEPTED Empfänger akzeptiert; Verbindung hergestellt Keine (Terminalstatus)
REJECTED Der Empfänger hat abgelehnt; enthält einen optionalen Ablehnungsgrund Keiner (Endzustand)
EXPIRED System-expired weil innerhalb des Ablaufzeitraums keine Maßnahmen ergriffen wurden Keine (Endzustand)
CANCELED Der Absender hat die Einladung vor der Annahme zurückgezogen Keine (Endzustand)

Verbindungstyp: Staaten

Status Description
ACCEPTED Der Verbindungstyp ist betriebsbereit; zugehörige Geschäftsaktivitäten sind aktiviert
CANCELED Der Verbindungstyp wurde von einer der Parteien beendet

Bewährte Methoden

  1. Klare Kommunikation: Geben Sie in Ihren Verbindungseinladungen detaillierte, klare Botschaften an, in denen Sie den Zweck und die erwartete Zusammenarbeit erläutern.

  2. Rechtzeitige Antworten: Überwachen Sie Verbindungseinladungen und antworten Sie umgehend darauf, um ein automatisches Ablaufen zu vermeiden.

  3. Regelmäßige Überprüfung: Überprüfe regelmäßig deine aktiven Verbindungen, um sicherzustellen, dass sie für deine aktuellen Geschäftsanforderungen relevant bleiben.

  4. Ordnungsgemäße Kündigung: Wenn Sie eine Geschäftsbeziehung beenden, verwenden Sie die CancelConnection Aktion mit einem klaren Grund, um die professionelle Kommunikation aufrechtzuerhalten.

  5. Eventüberwachung: Richten Sie EventBridge Regeln ein, um automatisch Benachrichtigungen über Änderungen des Verbindungsstatus zu erhalten, damit Sie über wichtige Updates auf dem Laufenden bleiben.

  6. Verwaltung der Verbindungstypen: Überlegen Sie, welche Verbindungstypen benötigt werden, bevor Sie Verbindungen herstellen, da jeder Typ unterschiedliche Geschäftsfunktionen ermöglicht.

  7. Sicherheitsbewusstsein: Denken Sie daran, dass beim Herstellen einer Verbindung die AWS Konto-IDs zwischen den Parteien preisgegeben werden. Stellen Sie nur eine Verbindung zu vertrauenswürdigen Partnern her.

Verbindungstypen und ihre Zwecke

Art der Verbindung Zweck Anwendungsfall
OPPORTUNITY_COLLABORATION Ermöglicht die Zusammenarbeit bei Co-Selling-Möglichkeiten mit anderen Partnern Wenn Sie möchten, dass andere Partner Zugriff auf Ihre Verkaufschance haben oder umgekehrt, verwenden Sie diesen Verbindungstyp. Diese Verbindung ermöglicht es Ihnen, Einladungen zum Opportunity-Engagement an verbundene Partner zu senden.
SUBSIDIARY Stellt Verbindungen zwischen Ihren mehreren AWS Marketplace-Verkäuferkonten und Ihrem primären Partnerkonto her Verwenden Sie diese Option, wenn Sie mehrere AWS Marketplace-Verkäuferkonten haben und eine Verbindung zu Ihrem Hauptkonto herstellen möchten, bei dem Sie als Partner und Verkäufer registriert sind.