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 Vertriebs-API von Partner Central

Ereignisse für die Verkaufs-API bieten Benachrichtigungen in Echtzeit über Statusänderungen oder Einzelheiten von Verkaufschancen. Diese Ereignisse tragen dazu bei, dass Ihre Systeme mit AWS Partner Central synchron bleiben und dass zeitnahe Antworten und Aktualisierungen gewährleistet sind.

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 Partner Central-Vertriebs-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 AllowPutRuleForPartnercentralSellingEvents Anweisung ermöglicht die Erstellung von Regeln, jedoch nur für Ereignisse aus der aws.partnercentral-selling Quelle.

JSON

{
  "Version":"2012-10-17",
  "Statement": {
    "Sid": "AllowPutRuleForPartnercentralSellingEvents",
    "Effect": "Allow",
    "Action": "events:PutRule",
    "Resource": "*",
    "Condition": {
      "ForAllValues:StringEquals": {
        "events:source": "aws.partnercentral-selling"
      }
    }
  }
}

Amazon für EventBridge die Überwachung von Ereignissen konfigurieren

Um API-Verkaufsereignisse zu überwachen, erstellen Sie eine EventBridge Regel, die den Ereignissen entspricht, die Sie erfassen möchten. Sie können die AWS Management Console 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 Management Console Einrichten

Um eine EventBridge Regel mit dem einzurichten AWS Management Console, 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-selling"],
    "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='MyOpportunityCreatedRule',
    EventPattern=
    '{
        "source": ["aws.partnercentral-selling"], 
        "detail-type": ["Opportunity Created"], 
        "detail": {"catalog": ["AWS"]}
    }',
    State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])

Erfahren Sie mehr über den Verkauf von API-Events

In den folgenden Abschnitten werden die Verkaufs-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.

Event-Szenarien

In der folgenden Tabelle wird beschrieben, wie Ereignisse in verschiedenen Szenarien funktionieren. Für diese Szenarien werden die folgenden Annahmen getroffen:

Beispielereignisse

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

Gelegenheit geschaffen

Partner nutzen diese Veranstaltung, um:

Das folgende Beispiel zeigt ein typisches Ereignis vom Typ Opportunity Created.

{
    "version": "1",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "source": "aws.partnercentral-selling",
    "detail-type": "Opportunity Created",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "account": "123456789012",
    "detail": {
        "schemaVersion": "<version number>",
        "catalog": "<Sandbox | AWS>",
        "opportunity": {
            "identifier": "String"
        }
    }
}

Opportunity aktualisiert

Partner nutzen diese Veranstaltung, um:

Das folgende Beispiel zeigt ein typisches Opportunity Updated-Ereignis.

{
    "version": "1",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "source": "aws.partnercentral-selling",
    "detail-type": "Opportunity Updated",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "account": "123456789012",
    "detail": {
        "schemaVersion": "<version number>",
        "catalog": "<Sandbox | AWS>",
        "opportunity": {
             "identifier": "String"
        }
    }
}

Einladung zur Verlobung erstellt

Partner nutzen diese Veranstaltung, um:

Das folgende Beispiel zeigt ein typisches Ereignis, bei dem eine Einladung erstellt wurde.

{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Created",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-15T12:34:56Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"
    ],
    "detail": {
      "catalog": "AWS",
      "engagementInvitation": {
        "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
        "id": "engi-v7p8z56whnauo",
        "engagementId": "eng-12345678901234",      
        "senderAccountId": "string",
        "receiverAccountId": "string",      
        "senderCompanyName": "string",
        "expirationDate": "string",
        "participantType": "Enum", //Sender/Receiver
		"payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation
      }
    }
}

Einladung zur Verlobung akzeptiert

Partner nutzen diese Veranstaltung, um:

Das folgende Beispiel zeigt ein typisches Ereignis, bei dem eine Einladung zur Teilnahme angenommen wurde.

{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Accepted",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "resources": ["arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"],
    "detail": {
        "catalog": "AWS",
        "engagementInvitation": {
            "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
            "id": "engi-v7p8z56whnauo",
            "engagementId": "eng-12356whnauo",       
            "participantType": "Enum", //Sender/Receiver
            "senderAccountId": "string",
            "receiverAccountId": "string",
            "payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation
        }
    }
}

Einladung zur Verlobung abgelehnt

Partner nutzen diese Veranstaltung, um:

Das folgende Beispiel zeigt ein typisches Ereignis, bei dem eine Einladung zur Teilnahme abgelehnt wurde.

{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Rejected",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-17T09:48:27Z",
    "region": "us-east-1",
    "resources": ["arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"],
    "detail": {
        "catalog": "AWS",
        "engagementInvitation": {
            "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
            "id": "engi-v7p8z56whnauo",
            "engagementId": "eng-12356whnauo",
            "participantType": "Enum", //Sender/Receiver
            "senderAccountId": "string",
            "receiverAccountId": "string",    
            "payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation 
        } 
    }
}

Die Einladung zum Engagement ist abgelaufen

Partner nutzen diese Veranstaltung, um:

Das folgende Beispiel zeigt ein typisches Ereignis, bei dem die Einladung zur Teilnahme abgelaufen ist.

{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Expired",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"
    ],
    "detail": {
      "catalog" : "AWS",    
      "engagementInvitation": {
        "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
        "id": "engi-v7p8z56whnauo",
        "engagementId": "eng-12356whnauo",        
        "participantType": "Enum", //Sender/Receiver
        "senderAccountId": "string",
        "receiverAccountId": "string",
        "payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation
      }  
    }
}

Engagement-Mitglied hinzugefügt

Partner nutzen diese Veranstaltung, um:

Das folgende Beispiel zeigt ein typisches Ereignis, bei dem das Engagement Member Added stattfindet.

{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Member Added",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-v7p8z56whnauo"
    ],
    "detail": {
      "catalog" : "AWS",
      "engagement": {
        "id": "eng-v7p8z56whnauo"
      },
      "engagementMember": {
        "accountId": "string",
        "companyName": "string"
      }
    }
}

Snapshot der Engagement-Ressource wurde erstellt

Partner nutzen dieses Ereignis, um Änderungen an Ressourcen im Zusammenhang mit einem Engagement nachzuverfolgen und automatisierte Workflows wie die Aktualisierung von CRM-Systemen oder die Benachrichtigung von Vertriebsteams auszulösen. Die Snapshot-Vorlage bestimmt die Art der Aktualisierung:

Das folgende Beispiel zeigt ein typisches Ereignis vom Typ Engagement Resource Snapshot Created.

{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Resource Snapshot Created",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-v7p8z56whnauo"
    ],
    "detail": {
      "catalog" : "AWS",
      "resourceSnapshot": {
        "arn": "arn:aws:partnercentral-selling:us-east-1::catalog/AWS/engagement/eng-v7p8z56whnauo/resource/Opportunity/o-12312/template/temp-name/snapshot/snapshot-19232",
        "engagementId": "eng-v7p8z56whnauo",
        "resourceType": "Opportunity",      
        "resourceId" : "O123211231",
        "createdBy": "123123123123",
        "targetMemberAccounts": ["123123123123", "aws"], 
        "resourceSnapshotTemplateName": "temp-name"
      }
    }
}

Engagement wurde erstellt

Partner nutzen diese Veranstaltung, um:

Das folgende Beispiel zeigt ein typisches „Engagement Created“ -Ereignis.

{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Created",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo"
    ],
    "detail": {
        "catalog": "AWS",
        "engagement": {
            "engagementArn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo",
            "engagementId": "eng-567a1j5hxp35lo",
            "CreatedAt": "2023-04-18T18:20:15Z",
            "CreatedBy": "aws",
            "ContextTypes": ["Lead"]
            
        }
    }
}

Engagement aktualisiert

Partner nutzen diese Veranstaltung, um:

Das folgende Beispiel zeigt ein typisches Engagement Updated-Ereignis.

{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Updated",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo"
    ],
    "detail": {
        "catalog": "AWS",
        "engagement": {
            "engagementArn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo",
            "engagementId": "eng-567a1j5hxp35lo",
            "LastModifiedAt": "2023-04-18T18:20:15Z",
            "LastModifiedBy": "aws",
            "ContextTypes": ["Lead", "CustomerProject"]
        }
    }
}