View a markdown version of this page

Notifiche per AWS API dell'account Partner Central - AWS Centrale Partner
Completa il prerequisito per monitorare gli eventiConfigura Amazon EventBridge per monitorare gli eventiScopri di più sugli eventi dell'API per le connessioni degli account

L' Centrale Partner AWS API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'Centrale Partner AWS API Reference.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Notifiche per AWS API dell'account Partner Central

Le notifiche di Partner Account Connection consentono ai partner di rimanere informati sugli eventi del ciclo di vita della connessione che influiscono direttamente sulle relazioni commerciali e sui flussi di lavoro operativi. Questi eventi sono fondamentali per i partner per:

  • Reagire prontamente a nuove collaborazioni

  • Mantieni la conoscenza dello stato del loro portafoglio di connessioni

  • Adottate le misure appropriate quando le connessioni vengono stabilite o terminate

  • Garantisci la continuità aziendale sapendo quando le relazioni cambiano

Completa il prerequisito per monitorare gli eventi

Gli utenti richiedono le autorizzazioni IAM appropriate per accedere e gestire gli eventi pubblicati dall'API di connessione dell'account. Per ulteriori informazioni sulle azioni, le risorse e le chiavi di condizione disponibili per EventBridge, consulta Using IAM policy conditions in Amazon EventBridge nella Amazon EventBridge User Guide. Una delle chiavi di condizione èevents:detail-type, che può essere utilizzata per definire le autorizzazioni per tipi di eventi specifici.

La seguente politica di esempio mostra come personalizzare e definire l'ambito delle autorizzazioni per gli eventi proposti. L'AllowPutRuleForPartnercentralAccountEventsistruzione consente la creazione di regole, ma solo per gli eventi dall'aws.partnercentral-accountorigine.

Per esempi dettagliati di policy IAM, consulta la documentazione AWS sulle EventBridge autorizzazioni.

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

Configura Amazon EventBridge per monitorare gli eventi

Per monitorare gli eventi API delle connessioni degli account, crei una EventBridge regola che corrisponda agli eventi che desideri acquisire. Puoi utilizzare AWS Management Console o gli AWS SDK per creare e gestire le regole. Le sezioni seguenti spiegano come creare regole utilizzando entrambi i metodi. Indipendentemente dal metodo utilizzato, è necessario creare la regola nella us-east-1 regione Stati Uniti orientali (Virginia settentrionale).

AWS Management Console setup

Per configurare una EventBridge regola utilizzando il AWS Management Console, segui i passaggi in Creazione di regole che reagiscono agli eventi in Amazon EventBridge nella Amazon EventBridge User Guide. Quando crei la regola, devi impostare il bus degli eventi come predefinito e creare la regola nella us-east-1 regione Stati Uniti orientali (Virginia settentrionale).

Di seguito è riportato un esempio di regola relativa agli eventi:

{
    "source": ["aws.partnercentral-account"],
    "detail": {
        "catalog": ["AWS"]
    }
}

AWS Configurazione SDK

Puoi utilizzare gli AWS SDK per creare e gestire EventBridge regole a livello di codice. Per ulteriori informazioni, PutRuleconsulta Amazon EventBridge API Reference.

L'esempio seguente utilizza l'AWS SDK per 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'])

Scopri di più sugli eventi dell'API per le connessioni degli account

Le sezioni seguenti descrivono i tipi di eventi dell'API Account Connections, gli scenari che li attivano e gli esempi di eventi.

Event types (Tipi di evento)

Di seguito sono riportati i tipi di eventi e i relativi fattori scatenanti.

Eventi di esempio

Le sezioni seguenti forniscono esempi degli eventi elencati in precedenza nella sezione precedente.

Invito a Partner Connection ricevuto

Contesto di attivazione

Questo evento viene generato quando un invito alla connessione viene creato con successo e mantenuto nell'archivio dati di PAC tramite l'API. CreateConnectionInvitation L'evento viene inviato immediatamente dopo il completamento della creazione dell'invito e viene mantenuto nell'archivio dati di PAC, non solo quando viene effettuata la chiamata API.

L'evento verrà inviato automaticamente quando viene creato un nuovo invito alla connessione. Un evento per invito creato senza eventi duplicati per lo stesso invito.

Recipients

L'AWS account del destinatario nell'invito alla connessione.

Gestione prevista

Azioni tipiche del cliente:

  • Notifica immediata: attiva avvisi ai team aziendali sulle nuove opportunità di partnership

  • Automazione del flusso di lavoro: aggiorna automaticamente i sistemi di gestione dei partner con inviti in sospeso

  • Decision Support: indirizza gli inviti ai decisori appropriati in base al tipo di connessione

  • Registrazione di audit: registra la ricevuta dell'invito per il monitoraggio della conformità e della partnership

  • Automazione della risposta: per i partner fidati, è possibile accettare automaticamente determinati tipi di invito

Modelli di integrazione comuni:

  • Funzione Lambda → Aggiorna la dashboard del portale per i partner

  • SQS queue → Elabora in batch gli inviti per la revisione

  • Argomento SNS → Email/Slack notifiche ai team aziendali

  • Destinazione API → Webhook per sistemi di gestione esterni CRM/partner

Esempio
{
  "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>"
    }
  }
}

Invito alla connessione con il partner accettato

Contesto di attivazione

Questo evento viene generato quando un invito alla connessione viene accettato con successo e una connessione viene creata e mantenuta nell'archivio dati di PAC tramite l'API. AcceptConnectionInvitation L'evento viene inviato immediatamente dopo che l'accettazione dell'invito è stata completata con successo e la connessione è stata stabilita.

L'evento verrà inviato automaticamente quando viene accettato un invito alla connessione. Un evento per invito accettato senza eventi duplicati per la stessa accettazione.

Recipients

Entrambi AWS gli account coinvolti nell'invito alla connessione: l'account mittente che ha originariamente inviato l'invito e l'account del destinatario che ha accettato l'invito.

Gestione prevista

Azioni tipiche del cliente:

  • Attivazione della partnership: attiva i flussi di lavoro per abilitare le attività aziendali di livello 2

  • Aggiornamenti di stato: aggiorna i sistemi di gestione dei partner con lo stato di connessione attivo

  • Notifica: avvisa i team aziendali della riuscita creazione di una partnership

  • Fornitura degli accessi: concedi automaticamente le autorizzazioni appropriate per la collaborazione

  • Analisi: monitora i tassi di conversione e le metriche di successo delle partnership

Modelli di integrazione comuni:

  • Funzione Lambda → Abilita le autorizzazioni di condivisione dei dati e aggiorna il portale per i partner

  • SQS queue → Attivazioni di connessioni con processo in batch per la configurazione aziendale

  • Argomento SNS → Email/Slack notifiche ai team aziendali e tecnici

  • Destinazione API → Webhook ai sistemi CRM per aggiornare lo stato della partnership

Esempio
{
  "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"
     }
  }
}

Invito alla connessione partner rifiutato

Contesto di attivazione

Questo evento viene generato quando un invito alla connessione viene rifiutato con successo tramite l' RejectConnectionInvitation API. L'evento viene inviato immediatamente dopo che il rifiuto dell'invito è stato elaborato e mantenuto nell'archivio dati di PAC.

L'evento verrà inviato automaticamente quando un invito alla connessione viene rifiutato. Un evento per invito rifiutato senza eventi duplicati per lo stesso rifiuto.

Recipients

L'AWS account che originariamente ha inviato l'invito alla connessione (l'account mittente).

Gestione prevista

Azioni tipiche del cliente:

  • Aggiornamenti sullo stato: aggiorna i sistemi di gestione dei partner con lo stato di rifiuto

  • Follow-up Azioni: attiva flussi di lavoro per approcci di partenariato alternativi

  • Notifica: avvisa i team aziendali in merito alla decisione relativa alla partnership

  • Pulizia: rimuovi i riferimenti agli inviti in sospeso dai sistemi interni

Modelli di integrazione comuni:

  • Funzione Lambda → Aggiorna il portale per i partner e attiva i flussi di lavoro di follow-up

  • SQS queue → Rifiuti dei processi Batch per l'analisi aziendale

  • Argomento SNS → Email/Slack notifiche ai team di sviluppo aziendale

  • Destinazione API → Webhook ai sistemi CRM per aggiornare lo stato delle opportunità

Esempio
{
  "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-****"
    }
  }
}

Connessione partner annullata

Contesto di attivazione

Questo evento viene generato quando una connessione attiva viene annullata con successo e lo stato attivo viene aggiornato e terminato nell'archivio dati di PAC tramite l'API. CancelConnection L'evento viene inviato immediatamente dopo l'elaborazione dell'annullamento della connessione e l'aggiornamento dello stato della connessione.

L'evento verrà inviato automaticamente quando una connessione viene interrotta. Un evento per connessione è stato annullato senza eventi duplicati per la stessa cancellazione.

Recipients

L'AWS account dell'altro partecipante alla connessione (non quello che ha avviato la cancellazione).

Gestione prevista

Azioni tipiche del cliente:

  • Revoca dell'accesso: revoca immediatamente le autorizzazioni e disabilita la condivisione dei dati

  • Aggiornamenti di stato: aggiorna i sistemi di gestione dei partner con lo stato della connessione interrotta

  • Notifica: avvisa i team aziendali e tecnici della cessazione della partnership

  • Pulizia: rimuovi i riferimenti di connessione e pulisci le risorse condivise

  • Analisi: monitora la durata della connessione e i modelli di terminazione

Modelli di integrazione comuni:

  • Funzione Lambda → Revoca le autorizzazioni e aggiorna lo stato del portale partner

  • SQS queue → Elabora in batch le terminazioni delle connessioni per i flussi di lavoro di pulizia

  • Argomento SNS → Email/Slack notifiche ai team aziendali e tecnici

  • Destinazione API → Webhook ai sistemi CRM per aggiornare lo stato della partnership

Esempio
{
  "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>>"
    }
  }
}

Invito alla connessione partner annullato

Contesto di attivazione

Questo evento viene generato quando un invito di connessione in sospeso viene annullato con successo tramite l'API. CancelConnectionInvitation L'evento viene inviato immediatamente dopo l'elaborazione dell'annullamento dell'invito e lo stato dell'invito viene aggiornato su ANNULLATO.

L'evento verrà inviato automaticamente quando un invito alla connessione viene annullato. Un evento per invito alla connessione è stato annullato senza eventi duplicati per la stessa cancellazione.

Recipients

L'AWS account che avrebbe dovuto ricevere l'invito alla connessione (l'account del destinatario).

Gestione prevista

Azioni tipiche del cliente:

  • Aggiornamenti di stato: aggiorna i sistemi di gestione dei partner per rimuovere i riferimenti agli inviti in sospeso

  • Notifica: avvisa i team aziendali che una potenziale opportunità di partnership è stata ritirata

  • Pulizia: rimuovi i riferimenti agli inviti dai sistemi di tracciamento interni

  • Analisi: monitora i modelli di annullamento degli inviti per informazioni dettagliate sulla partnership

Modelli di integrazione comuni:

  • Funzione Lambda → Aggiorna il portale per i partner e rimuovi le notifiche di invito in sospeso

  • Coda SQS → Annullamenti del processo Batch per l'analisi aziendale

  • Argomento SNS → Email/Slack notifiche ai team di sviluppo aziendale

  • Destinazione API → Webhook ai sistemi CRM per aggiornare lo stato delle opportunità

Esempio
{
  "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-****"
    }
  }
}

Invito alla connessione partner scaduto

Contesto di attivazione

Questo evento viene generato quando un invito di connessione in sospeso scade automaticamente dopo aver raggiunto il relativo ExpiresAt timestamp senza essere accettato o rifiutato dal destinatario. L'evento viene attivato automaticamente dal sistema quando viene raggiunta la scadenza dell'invito.

L'evento verrà inviato automaticamente alla scadenza di un invito alla connessione. Un evento per invito è scaduto senza eventi duplicati per la stessa scadenza.

Recipients

Entrambi AWS gli account coinvolti nell'invito alla connessione: l'account mittente che ha originariamente inviato l'invito e l'account del destinatario che ha ricevuto l'invito.

Gestione prevista

Azioni tipiche del cliente:

  • Aggiornamenti di stato: aggiorna i sistemi di gestione dei partner per contrassegnare l'invito come scaduto

  • Follow-up Azioni: attiva flussi di lavoro per il recoinvolgimento o approcci di partnership alternativi

  • Notifica: avvisa i team aziendali delle opportunità di partnership mancate

  • Pulizia: rimuovi i riferimenti agli inviti scaduti dai sistemi di tracciamento interni

Modelli di integrazione comuni:

  • Funzione Lambda → Aggiorna il portale per i partner e attiva i flussi di lavoro di follow-up

  • SQS queue → Scadenze dei processi Batch per l'analisi aziendale

  • Argomento SNS → Email/Slack notifiche ai team di sviluppo aziendale

  • Destinazione API → Webhook ai sistemi CRM per aggiornare lo stato delle opportunità

Esempio
{
  "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-****"
    }
  }
}