View a markdown version of this page

Mit Partnerkontoverbindungen arbeiten - AWS Partner Central
Eine Verbindungseinladung erstellen und sendenVerbindungseinladungen empfangen und beantwortenAktive Verbindungen verwaltenÜberwachung von VerbindungsereignissenVerbindungsstatus verstehenBewährte MethodenVerbindungsarten 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: Verbindungsanfragen initiieren und beantworten

  2. Phase der aktiven Verbindung: Verwaltung etablierter 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 aufbauen 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, sodass Sie ihm Einladungen zu Opportunity-Engagements zur 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 des Empfängers (für den Verbindungstyp Opportunity Collaboration) oder die AWS Konto-ID (für den Verbindungstyp Tochtergesellschaft)

  • 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 durch den Empfänger.

Wichtig

Durch das Senden einer Verbindungseinladung erklären Sie sich damit einverstanden, Ihre AWS Konto-ID an den Empfänger weiterzugeben, 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 gesetzt istSENDER. Das ermöglicht Ihnen Folgendes:

  • Alle ausgehenden Einladungen anzeigen

  • Nach Status filtern (PENDING,ACCEPTED,REJECTED,EXPIRED)

  • Nach Verbindungstyp filtern

  • Schauen Sie sich spezifische Einladungen an andere Partner an

Schritt 3: Eine Einladung stornieren (optional)

Wenn Sie eine ausstehende Einladung zurückziehen müssen, bevor sie akzeptiert wurde, können Sie die CancelConnectionInvitation Aktion verwenden. Beachten Sie Folgendes:

  • Sie können nur Einladungen stornieren, die den Status Ausstehend haben

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

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

Verbindungseinladungen empfangen und beantworten

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 nach folgenden Kriterien filtern:

  • Verbindungstyp

  • Status (PENDING,ACCEPTED,REJECTED)

  • Kennung des Absenders

Schritt 2: Überprüfen Sie die Einladungsdetails

Verwenden Sie die GetConnectionInvitation Aktion, um die vollständigen Details einer bestimmten Einladung anzuzeigen, einschließlich:

  • Name und Kontakt-E-Mail des Absenders

  • Einladungsnachricht mit Erläuterung des Zwecks

  • 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:

  • Im Status Aktiv wird eine neue Verbindung 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 aktiviert werden

Wichtig

Wichtige Zustimmung: Indem Sie eine Verbindungseinladung annehmen, erklären Sie sich damit einverstanden, dem Absender Ihre AWS Konto-ID mitzuteilen. 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 wird nicht mehr in Ihrer Liste der ausstehenden Einladungen angezeigt

Automatischer Ablauf

Wenn innerhalb des Ablaufzeitraums keine Maßnahmen ergriffen werden, versetzt 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 anzeigen 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 eines anderen Teilnehmers

  • Übersichtsinformationen für jede Verbindung anzeigen

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

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

  • Status der einzelnen Verbindungstypen (Aktiv oder Beendet)

  • Kontaktinformationen aus der ursprünglichen Einladung

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

  • Zeitstempel für Erstellung und Beendigung für jeden Verbindungstyp

Hinzufügen von Verbindungstypen zu einer bestehenden Verbindung

Wenn Sie bereits eine aktive Verbindung zu 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 der bestehenden Verbindung hinzugefügt

  • Beide Verbindungsarten 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 bestehen.

Verbindungstypen beenden

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ändiger Verbindungsabbruch

Wenn alle Verbindungstypen innerhalb einer Verbindung beendet wurden, wechselt die Verbindung selbst in den Status Beendet. Eine vollständig beendete Verbindung:

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

  • Verbleibt im System zur Aufbewahrung historischer Aufzeichnungen

  • Kann über die API eingesehen werden GetConnection

  • Erfordert eine neue Einladung, um die Beziehung wiederherzustellen

Überwachung von Verbindungsereignissen

Partner sollten Ereignisse im Zusammenhang mit Verbindungen über Amazon verfolgen, um über Folgendes auf dem Laufenden EventBridge zu bleiben:

  • Neue eingehende Verbindungseinladungen

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

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

Wenn Sie ein Ereignis empfangen, verwenden Sie die entsprechende Get API-Aktion, um die neuesten Details abzurufen:

  • GetConnectionInvitationfür Einladungsaktualisierungen

  • GetConnectionfür Verbindungsaktualisierungen

Mögliche Ereignisse

  • Verbindungseinladung erstellt: Informiert 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 untätig abläuft.

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

  • Verbindungseinladung akzeptiert: Benachrichtigt das Absenderkonto, wenn seine Verbindungseinladung angenommen und eine Verbindung hergestellt wurde.

  • Verbindung abgebrochen: Benachrichtigt beide verbundenen Parteien, wenn alle Verbindungen vollständig beendet wurden.

Verbindungsstatus verstehen

Status der Verbindungseinladungen

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

Status des Verbindungstyps

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 beantworten Sie sie umgehend, um ein automatisches Ablaufen zu vermeiden.

  3. Regelmäßige Überprüfung: Überprüfen Sie regelmäßig Ihre aktiven Verbindungen, um sicherzustellen, dass sie Ihren aktuellen Geschäftsanforderungen entsprechen.

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

  5. Ereignisü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 von Verbindungstypen: Überlegen Sie sich, welche Verbindungstypen erforderlich sind, bevor Sie Verbindungen herstellen, da jeder Typ unterschiedliche Geschäftsfunktionen ermöglicht.

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

Verbindungsarten 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 zur Teilnahme an Geschäftschancen 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, die Sie mit Ihrem Hauptkonto verbinden möchten, in dem Sie als Partner und Verkäufer registriert sind.