L' AWS Partner Central API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Partner Central 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 Partner Central Benefits
Il servizio Benefits offre EventBridge eventi per entrambi BenefitApplications e BenefitAllocations. Questi eventi consentono ai clienti di creare architetture complete basate sugli eventi che rispondono ai cambiamenti durante l'intero ciclo di vita delle risorse, dall'applicazione iniziale all'allocazione e all'adempimento finale.
Argomenti
Completa il prerequisito per monitorare gli eventi
Gli utenti richiedono le autorizzazioni IAM appropriate per accedere e gestire gli eventi pubblicati dall'API benefits. 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'AllowPutRuleForPartnercentralBenefitsEventsistruzione consente la creazione di regole, ma solo per gli eventi dall'aws.partnercentral-benefitsorigine.
Per esempi dettagliati di policy IAM, consulta la documentazione AWS sulle EventBridge autorizzazioni.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowPutRuleForPartnerCentralBenefitsEvents", "Effect": "Allow", "Action": "events:PutRule", "Resource": "*", "Condition": { "StringEquals": { "events:source": "aws.partnercentral-benefits" } } } ] }
Configura Amazon EventBridge per monitorare gli eventi
Per monitorare gli eventi API dei benefit, crei una EventBridge regola che corrisponda agli eventi che desideri acquisire. Puoi utilizzare Console di gestione AWS 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).
Console di gestione AWS setup
Per configurare una EventBridge regola utilizzando il Console di gestione AWS, 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-benefits"], "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='MyBenefitApplicationCreatedRule', EventPattern= '{ "source": ["aws.partnercentral-benefits"], "detail-type": ["Benefit Application Created"], "detail": {"catalog": ["AWS"]} }', State='ENABLED' ) print('Rule ARN:', response['RuleArn'])
Scopri di più sui vantaggi degli eventi API
Le sezioni seguenti descrivono i vantaggi, i tipi di eventi dell'API, 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.
Applicazioni Benefit
-
Domanda di benefit creata: quando viene creata una domanda di benefit
-
Domanda di benefit in fase di revisione: quando viene presentata una domanda di benefit o quando la domanda passa da Azione richiesta a In revisione, questo evento si attiva.
-
Azione richiesta per la richiesta di benefit: Questo evento si verifica quando un revisore interno aggiorna lo stato della domanda per indicare che il partner deve fornire ulteriori informazioni, chiarimenti o modifiche prima che la revisione possa continuare.
-
Richiesta di benefit rifiutata: questo evento si verifica quando un revisore interno aggiorna lo stato della domanda per indicare che la domanda non soddisfa i criteri o i requisiti relativi al benefit ed è stata rifiutata
-
Richiesta di benefit approvata: questo evento si verifica quando un revisore interno aggiorna lo stato della domanda per indicare che la domanda è stata approvata per l'assegnazione dei benefit.
-
Modifica della fase di richiesta del benefit: questo evento si verifica quando un revisore interno aggiorna la fase della domanda durante processi di revisione come Business Review, Review, Financial AWS Review, ecc.
Allocazione dei benefit
-
Allocazione di benefit attivata: quando un'allocazione di benefit viene creata o aggiornata nuovamente in Attivata da un servizio interno.
-
Allocazione dei benefit inattivata: questo evento si verifica quando un revisore interno aggiorna lo stato dell'allocazione o quando un'allocazione di benefit scade automaticamente.
-
Allocazione dei benefit soddisfatta: questo evento si verifica quando un revisore interno aggiorna lo stato dell'allocazione per indicare che l'allocazione è stata completamente utilizzata.
Eventi di esempio
Le sezioni seguenti forniscono esempi degli eventi elencati in precedenza nella sezione precedente.
Argomenti
Applicazione Benefit creata
Contesto di attivazione
L'evento Benefit Application Created viene pubblicato su Amazon EventBridge quando una nuova applicazione Benefit viene creata con successo tramite il servizio Benefit. Questo evento si verifica quando la chiamata CreateBenefitApplication API viene completata correttamente, a indicare che un partner ha avviato una richiesta per un vantaggio specifico.
Questo evento rappresenta l'inizio del ciclo di vita delle applicazioni di benefit e fornisce ai clienti una notifica immediata quando vengono inviate nuove richieste al loro account.
Recipients
L'account proprietario riceverà l'evento per l'allocazione dei benefici.
Esempio
{ "id": "7gh88765-k0jh-d08g-i292-2ff1796m030n", "detail-type": "Benefit Application Created", "source": "aws.partnercentral-benefits", "account": "123456789012", "time": "2025-02-10T15:45:00Z", "region": "us-east-1", "resources": [ "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123" ], "detail": { "catalog": "AWS", "benefitApplication": { "id": "benappl-12345abcdef123", "fulfillmentTypes": ["CREDITS"], "status": "PENDING_SUBMISSION", "revision": "hh7e8400-e29b-41d4-a716-446655440012" }, "benefit": { "id": "ben-xyz789uvw012", "name": "AWS Partner Credits", "program": ["AWS Partner Network"] } } }
Domanda di benefit in fase di revisione
Contesto di attivazione
L'evento Benefit Application In Review viene pubblicato su Amazon EventBridge quando un'applicazione Benefit passa allo stato IN_REVIEW tramite il servizio Benefits. Questo evento si verifica quando:
-
Un partner invia la propria candidatura tramite la chiamata SubmitBenefitApplication API
-
Un'applicazione passa da ACTION_REQUIRED a IN_REVIEW dopo che il partner ha risposto al feedback
-
Un'applicazione viene richiamata e quindi inviata nuovamente
Questo evento indica che la domanda è entrata nel processo di revisione formale ed è in corso di valutazione da parte AWS di team interni.
Recipients
L'account proprietario riceverà l'evento per l'allocazione dei benefici.
Esempio
{ "id": "8hi99876-l1ki-e19h-j303-3gg2807n141o", "detail-type": "Benefit Application In Review", "source": "aws.partnercentral-benefits", "account": "123456789012", "time": "2025-02-10T16:00:00Z", "region": "us-east-1", "resources": [ "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123" ], "detail": { "catalog": "AWS", "benefitApplication": { "id": "benappl-12345abcdef123", "fulfillmentTypes": ["CREDITS"], "status": "IN_REVIEW", "stage": "BUSINESS_REVIEW", "revision": "ii8f9511-f30c-52e5-b827-557766551123" }, "benefit": { "id": "ben-xyz789uvw012", "name": "AWS Partner Credits", "program": ["AWS Partner Network"] } } }
Azione richiesta per la richiesta del benefit
Contesto di attivazione
L'evento Benefit Application Action Required viene pubblicato su Amazon EventBridge quando un'applicazione Benefit passa allo stato ACTION_REQUIRED tramite il servizio Benefits. Questo evento si verifica quando un revisore interno aggiorna lo stato dell'applicazione tramite l' UpdateBenefitApplicationInternal API per indicare che il partner deve fornire ulteriori informazioni, chiarimenti o modifiche prima che la revisione possa continuare.
Questo evento rappresenta un punto critico nel ciclo di vita dell'applicazione in cui è necessario l'intervento del partner per far avanzare l'applicazione nel processo di revisione.
Recipients
L'account proprietario riceverà l'evento per l'allocazione dei benefici
Esempio
{ "id": "9ij00987-m2lj-f20i-k414-4hh3918o252p", "detail-type": "Benefit Application Action Required", "source": "aws.partnercentral-benefits", "account": "123456789012", "time": "2025-02-12T10:30:00Z", "region": "us-east-1", "resources": [ "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123" ], "detail": { "catalog": "AWS", "benefitApplication": { "id": "benappl-12345abcdef123", "fulfillmentTypes": ["CREDITS"], "status": "ACTION_REQUIRED", "stage": "BUSINESS_REVIEW", "revision": "jj9g0622-g41d-63f6-c938-668877662234" }, "benefit": { "id": "ben-xyz789uvw012", "name": "AWS Partner Credits", "program": ["AWS Partner Network"] } } }
Richiesta di benefit rifiutata
Contesto di attivazione
L'evento Benefit Application Rejected viene pubblicato su Amazon EventBridge quando una richiesta Benefit passa allo stato REJECTED tramite il Servizio Benefits. Questo evento si verifica quando un revisore interno aggiorna lo stato della domanda tramite l' UpdateBenefitApplicationInternal API per indicare che l'applicazione non soddisfa i criteri o i requisiti relativi ai vantaggi ed è stata rifiutata.
Questo evento rappresenta uno stato terminale nel ciclo di vita dell'applicazione in cui l'applicazione è stata formalmente rifiutata e non procederà all'assegnazione dei vantaggi.
Recipients
L'account proprietario riceverà l'evento per l'allocazione dei benefici.
Esempio
{ "id": "0kl11098-n3mk-g31j-l525-5ii4029p363q", "detail-type": "Benefit Application Rejected", "source": "aws.partnercentral-benefits", "account": "123456789012", "time": "2025-02-15T14:20:00Z", "region": "us-east-1", "resources": [ "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123" ], "detail": { "catalog": "AWS", "benefitApplication": { "id": "benappl-12345abcdef123", "fulfillmentTypes": ["CREDITS"], "status": "REJECTED", "revision": "kk0h1733-h52e-74g7-d049-779988773345" }, "benefit": { "id": "ben-xyz789uvw012", "name": "AWS Partner Credits", "program": ["AWS Partner Network"] } } }
Domanda di benefit approvata
Contesto di attivazione
L'evento Benefit Application Approved viene pubblicato su Amazon EventBridge quando una Benefit Application passa allo stato APPROVATO tramite il Servizio Benefits. Questo evento si verifica quando un revisore interno aggiorna lo stato della domanda tramite l' UpdateBenefitApplicationInternal API per indicare che l'applicazione soddisfa tutti i criteri e i requisiti relativi ai benefit ed è stata approvata per l'assegnazione dei benefit.
Questo evento rappresenta il completamento con successo del processo di revisione della domanda e in genere attiva la creazione di una corrispondente allocazione dei benefici.
Recipients
L'account proprietario riceverà l'evento per l'allocazione dei benefici.
Esempio
{ "id": "1lm22109-o4nl-h42k-m636-6jj5130q474r", "detail-type": "Benefit Application Approved", "source": "aws.partnercentral-benefits", "account": "123456789012", "time": "2025-02-14T16:45:00Z", "region": "us-east-1", "resources": [ "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123" ], "detail": { "catalog": "AWS", "benefitApplication": { "id": "benappl-12345abcdef123", "fulfillmentTypes": ["CREDITS"], "status": "APPROVED", "revision": "ll1i2844-i63f-85h8-e150-880099884456" }, "benefit": { "id": "ben-xyz789uvw012", "name": "AWS Partner Credits", "program": ["AWS Partner Network"] } } }
Fase di richiesta del beneficio modificata
Contesto di attivazione
L'evento Benefit Application Stage Changed viene pubblicato su Amazon EventBridge quando la fase di revisione di un'applicazione Benefit viene aggiornata tramite il servizio Benefits. Questo evento si verifica quando un revisore interno aggiorna lo stage dell'applicazione a uno dei possibili valori Enum (FINANCE_REVIEW, BUSINESS_REVIEW, TECH_REVIEW e _REVIEW).AWS
A differenza delle modifiche allo stato, le modifiche di fase sono aggiornamenti informativi di sola lettura che forniscono visibilità sulla progressione del flusso di lavoro di revisione interno senza richiedere l'intervento del partner.
Recipients
L'account proprietario riceverà l'evento per l'allocazione dei benefici.
Esempio
{ "id": "2mn33210-p5om-i53l-n747-7kk6241r585s", "detail-type": "Benefit Application Stage Changed", "source": "aws.partnercentral-benefits", "account": "123456789012", "time": "2025-02-13T11:15:00Z", "region": "us-east-1", "resources": [ "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123" ], "detail": { "catalog": "AWS", "benefitApplication": { "id": "benappl-12345abcdef123", "fulfillmentTypes": ["CREDITS"], "status": "IN_REVIEW", "stage": "FINANCIAL_REVIEW", "revision": "mm2j3955-j74g-96i9-f261-991100995567" }, "benefit": { "id": "ben-xyz789uvw012", "name": "AWS Partner Credits", "program": ["AWS Partner Network"] } } }
Allocazione dei benefici attivata
Contesto di attivazione
L'evento Benefit Allocation Activated viene pubblicato su Amazon EventBridge quando una Benefit Allocation passa allo stato ACTIVE tramite il Servizio Benefits. Questo evento si verifica quando un revisore interno aggiorna lo stato dell'allocazione tramite l' UpdateBenefitAllocationInternal API per riattivare un'allocazione precedentemente inattiva.
Questo evento si verifica in genere quando un'allocazione temporaneamente inattivata (a causa di scadenza, modifiche alle politiche o motivi amministrativi) viene ripristinata allo stato attivo, rendendo nuovamente disponibili i vantaggi per l'utilizzo da parte dei partner.
Recipients
L'AWS account appartenente al Partner riceverà il messaggio. In altre parole, l'AWS account proprietario della risorsa.
Evento di esempio
{ "id": "3no44321-q6pn-j64m-o858-8ll7352s696t", "detail-type": "Benefit Allocation Activated", "source": "aws.partnercentral-benefits", "account": "123456789012", "time": "2025-03-01T08:15:00Z", "region": "us-east-1", "resources": [ "arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456" ], "detail": { "catalog": "AWS", "benefitAllocation": { "id": "benalloc-abc123def456", "fulfillmentType": "CREDITS", "status": "ACTIVE" }, "benefitApplication": { "id": "benappl-12345abcdef123" }, "benefit": { "id": "ben-xyz789uvw012", "name": "AWS Partner Credits", "program": ["AWS Partner Network"] } } }
Allocazione dei benefici disattivata
Contesto di attivazione
L'evento Benefit Allocation Inactivated viene pubblicato su Amazon EventBridge quando una Benefit Allocation passa allo stato INACTIVE tramite il Servizio Benefits. Questo evento si verifica quando un revisore interno aggiorna lo stato dell'allocazione tramite l' UpdateBenefitAllocationInternal API o quando una Benefit Allocation scade automaticamente.
Questo evento si verifica in genere quando un'allocazione viene temporaneamente sospesa (a causa di scadenza, modifiche alle politiche, problemi di conformità o motivi amministrativi), rendendo i vantaggi non disponibili per l'utilizzo da parte dei partner fino alla riattivazione.
Recipients
L'AWS Account appartenente al Partner riceverà il messaggio. In altre parole, l'AWS account proprietario della risorsa.
Evento di esempio
{ "id": "4op55432-r7qo-k75n-p969-9mm8463t707u", "detail-type": "Benefit Allocation Inactivated", "source": "aws.partnercentral-benefits", "account": "123456789012", "time": "2025-06-30T23:59:59Z", "region": "us-east-1", "resources": [ "arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456" ], "detail": { "catalog": "AWS", "benefitAllocation": { "id": "benalloc-abc123def456", "fulfillmentType": "CREDITS", "status": "INACTIVE" }, "benefitApplication": { "id": "benappl-12345abcdef123" }, "benefit": { "id": "ben-xyz789uvw012", "name": "AWS Partner Credits", "program": ["AWS Partner Network"] } } }
Allocazione dei vantaggi soddisfatta
Contesto di attivazione
L'evento Benefit Allocation Fulfilled viene pubblicato su Amazon EventBridge quando una Benefit Allocation passa allo stato FULFILLED tramite il Servizio Benefits. Questo evento si verifica quando un revisore interno aggiorna lo stato dell'allocazione tramite l' UpdateBenefitAllocationInternal API per indicare che l'allocazione è stata completamente utilizzata o che i termini del benefit sono stati soddisfatti.
Questo evento rappresenta il completamento del ciclo di vita del benefit e indica che il partner ha utilizzato con successo il beneficio assegnato o che l'allocazione ha raggiunto la sua conclusione naturale.
Recipients
L'AWS account appartenente al Partner riceverà il messaggio. In altre parole, l'AWS account proprietario della risorsa.
Evento di esempio
{ "id": "5pq66543-s8rp-l86o-q070-0nn9574u818v", "detail-type": "Benefit Allocation Fulfilled", "source": "aws.partnercentral-benefits", "account": "123456789012", "time": "2025-12-15T17:30:00Z", "region": "us-east-1", "resources": [ "arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456" ], "detail": { "catalog": "AWS", "benefitAllocation": { "id": "benalloc-abc123def456", "fulfillmentType": "CREDITS", "status": "FULFILLED" }, "benefitApplication": { "id": "benappl-12345abcdef123" }, "benefit": { "id": "ben-xyz789uvw012", "name": "AWS Partner Credits", "program": ["AWS Partner Network"] } } }
