L' Centrale Partner AWS API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'[Centrale Partner AWS API Reference](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).
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à.
# Utilizzo dei tuoi Revenue Attribution ID
Un Revenue Attribution ID è un identificatore a livello di offerta che associa le entrate dei prodotti AWS Marketplace a specifiche opportunità di AWS Marketplace and/or AWS Offers Partner Central. Si basa sull'implementazione del Partner Revenue Measurement (PRM) a livello di prodotto: PRM acquisisce le entrate totali attribuite per un prodotto Marketplace e un Revenue Attribution ID associa tali entrate a offerte specifiche in base alle percentuali di allocazione dei costi mensili specificate.
Il Revenue Attribution Service utilizza le API per creare, recuperare, elencare e aggiornare gli ID di attribuzione dei ricavi e per gestire le relative voci di allocazione dei costi mensili in modo asincrono.
## Che cos'è un Revenue Attribution ID?
Un Revenue Attribution ID ha due livelli:
+ **L'attribuzione** a una risorsa denominata e descritta dal partner identificata da un `ra-` prefisso ID (ad esempio) e da un ARN. `ra-aabbccddee001` Ogni attribuzione è limitata a un account (per la produzione, `Sandbox` per i test`Catalog`) e all'`AWS`account del partner.
+ **Una o più voci mensili relative all'allocazione dei costi**. Ogni voce associa una singola combinazione (ID offerta o ID opportunità, mese di fatturazione) a una percentuale di allocazione dei costi. Le voci vengono gestite in batch in modo asincrono tramite un modello di attività di allocazione.
Un Revenue Attribution ID può essere utilizzato in due modi:
+ **Come sovrapposizione a livello di offerta** sull'implementazione PRM esistente a livello di prodotto. Crea un Revenue Attribution ID, associa le tue offerte Marketplace and/or Offers ACE Opportunities applicabili e AWS associa le entrate dei prodotti già misurate a quelle offerte specifiche: non sono necessarie modifiche ai tag di risorsa o alle stringhe dello user agent esistenti.
+ **Come identificatore autonomo** utilizzato direttamente come valore del tag di risorsa (`aws-apn-id`=``) o in una stringa user-agent () per attribuire il consumo a un'offerta specifica sin dall'inizio. `APN_1.1/pc_$`AWS
## Utilizzo degli ID di attribuzione delle entrate
I partner possono gestire i Revenue Attribution ID e le relative voci di allocazione dei costi mensili tramite il Revenue Attribution Service. Il ciclo di vita procede attraverso due flussi indipendenti: il flusso di registrazione dell'attribuzione (creazione, aggiornamento, recupero, elenco) e il flusso di allocazioni (avvio di un'attività in batch, ricerca risultati, recupero singole voci, elenco voci per un'attribuzione).
### Creazione di un Revenue Attribution ID
Il primo passaggio consiste nella creazione di un Revenue Attribution ID utilizzando l'azione `CreateRevenueAttribution` API. L'`Id`e restituito `Arn` può essere utilizzato immediatamente come valore del tag di risorsa o in una stringa user-agent per attribuire il consumo.AWS
Quando creano un Revenue Attribution ID, i partner devono fornire:
+ **`Catalog`**— `AWS` per la produzione o `Sandbox` per i test.
+ **`Name`**— un nome leggibile dall'uomo per l'attribuzione. Deve essere unico all'interno del Catalogo e dell'account del partner. Massimo 128 caratteri.
I partner possono opzionalmente fornire:
+ **`Description`**— descrizione in testo libero dell'attribuzione. Massimo 1024 caratteri.
+ **`MarketplaceProduct`**— il prodotto AWS Marketplace da associare a questa attribuzione. Fornisci `ProductIdentifier` (l'ID del prodotto Marketplace di 25 caratteri) e `TenancyModel` (`MULTI_TENANT`o`SINGLE_TENANT`). Se omessa al momento della creazione, l'attribuzione si applica a tutti i consumi misurati con il Revenue Attribution ID, indipendentemente dal prodotto Marketplace acquistato dal cliente, utile quando una singola distribuzione copre più di un'inserzione del Marketplace.
+ **`Tags`**— fino a 200 coppie chiave-valore per l'organizzazione delle risorse. Le chiavi dei tag devono essere univoche all'interno della richiesta.
Procedura consigliata: fornisci informazioni `MarketplaceProduct.ProductIdentifier` ogni volta che la tua offerta è associata a una specifica inserzione nel Marketplace. In questo modo è possibile AWS verificare che il prodotto sia di proprietà dell'account del partner chiamante o di un account sussidiario collegato tramite Partner Account Connection (PAC) e nella risposta viene visualizzato il `ProductCode` messaggio e `ProductType` (ad esempio, `SaaS``AMI`,`ML`). Se il prodotto non è di proprietà di un account autorizzato, l'API viene `ValidationException` restituita motivatamente. `PRODUCT_NOT_FOUND_OR_NOT_OWNED`
La risposta restituisce il nuovo `Id` (formato`ra-[a-z0-9]{13}`)`Arn`, `MarketplaceProduct` gli attributi risolti e il `Version` numero iniziale (che inizia da 1 e aumenta a ogni aggiornamento successivo).
### Aggiungere voci mensili di allocazione dei costi
Una volta creato un Revenue Attribution ID, i partner associano AWS Marketplace and/or Offers ACE Opportunities ad esso inviando un batch di voci mensili di allocazione dei costi tramite l'`StartRevenueAttributionAllocationsTask`azione API. Si tratta di un'operazione asincrona che accetta fino a 250 modifiche di allocazione () per attività. `CREATE` and/or `UPDATE`
Ogni voce di allocazione specifica:
+ **ID offerta o ID opportunità**: l'identificatore univoco dell'offerta associata. Se un'offerta Marketplace è già collegata a un'opportunità ACE, i partner devono solo fornire l'ID dell'offerta; attribuisce AWS automaticamente le entrate all'opportunità collegata.
+ **Mese di fatturazione**: il mese di calendario a cui si riferisce l'allocazione dei costi (ad esempio,`2026-04`).
+ **% di allocazione dei costi**: la parte del AWS consumo totale del prodotto attribuibile a questa offerta in questo mese di fatturazione. Richiesto per i prodotti SaaS multi-tenant, compresi i componenti ospitati dai partner per le implementazioni ibride, in cui i clienti condividono l'infrastruttura.
+ **ID AWS account cliente**: l'AWS account del cliente che utilizza il prodotto. Richiesto per i prodotti SaaS multi-tenant.
La percentuale totale di allocazione dei costi tra tutte le voci di allocazione per un determinato ID di attribuzione dei ricavi e per lo stesso mese di fatturazione non deve superare il 100%. Se il totale supera il 100%, la voce incriminata viene rifiutata durante la convalida aziendale asincrona con un codice di errore per record.
Convalida sincrona: `StartRevenueAttributionAllocationsTask` esegue la convalida della forma di base in modo sincrono (tipi di campo, modelli, dimensioni del batch). Se la convalida di base ha esito positivo, l'API restituisce uno stato with. `TaskId` `IN_PROGRESS` La convalida aziendale (controlli dei limiti, regole di immutabilità, ricerche delle dipendenze su Marketplace e ACE) viene eseguita in modo asincrono e i risultati per record vengono rilevati tramite. `GetRevenueAttributionAllocationsTask`
Per monitorare un'attività inviata, i partner effettuano un sondaggio utilizzando `GetRevenueAttributionAllocationsTask` il Revenue Attribution Resource Id o ARN. La risposta passa da `IN_PROGRESS` a `COMPLETED` (indipendentemente dal fatto che i singoli record abbiano avuto esito positivo o negativo) e restituisce:
+ **`TaskStatus`**— `IN_PROGRESS``COMPLETED`, o `FAILED` (operazione di primo livello non riuscita).
+ **`RecordResults`**— per ogni record di input: lo stato assegnato `AllocationId` (in caso di successo), lo stato per record (`SUCCEEDED`o`FAILED`) e un codice di errore strutturato e un messaggio in caso di errore del record.
I partner devono recuperare tempestivamente i risultati delle attività. Una volta completata l'attività, è possibile riconciliare i risultati per record e le immissioni non riuscite possono essere corrette e reinviate in una nuova attività.
### Modifica delle voci mensili di allocazione dei costi
Le voci di allocazione dei costi vengono gestite per mese di fatturazione con queste regole:
+ I partner possono **aggiungere una nuova voce mensile** per il mese di fatturazione attuale o futuro in qualsiasi momento.
+ I partner possono **aggiornare una registrazione mensile** per il mese di fatturazione attuale o futuro in qualsiasi momento.
+ I partner possono **aggiornare la registrazione del mese scorso** fino al **7 del mese corrente**. Questa finestra consente ai partner di esaminare l'utilizzo effettivo in AWS Cost Explorer prima di finalizzare l'allocazione del mese precedente.
Dopo il 7 del mese corrente, l'attribuzione per il mese di fatturazione precedente non può più essere modificata. Gli aggiornamenti alla voce del mese corrente o futuro si applicano a partire dal ciclo di fatturazione mensile successivo. L'attribuzione storica per i mesi precedenti non viene ricalcolata retroattivamente.
Gli aggiornamenti alle voci di allocazione vengono inviati tramite la stessa azione `StartRevenueAttributionAllocationsTask` API, `Operation` impostata su `UPDATE` per ogni voce interessata. Il modello di attività asincrono gestisce gli aggiornamenti e le creazioni in modo uniforme.
### Aggiornamento di un ID di attribuzione dei ricavi
I partner possono aggiornare l'ID `Description` di attribuzione delle entrate esistente utilizzando l'azione `UpdateRevenueAttribution` API. Il record di attribuzione stesso è altrimenti immutabile e i valori tag-on-create non possono essere modificati dopo la creazione. `Name` `MarketplaceProduct` Per rietichettare la risorsa, utilizza le operazioni di AWS etichettatura standard sull'ARN dell'attribuzione.
Quando aggiornano un Revenue Attribution ID, i partner devono fornire:
+ **`Catalog`**— `AWS` oppure. `Sandbox`
+ **`Identifier`**— l'`ra-`ID dell'attribuzione da aggiornare.
+ **`Version`**— la versione attuale dell'attribuzione per il blocco ottimistico.
I partner possono opzionalmente fornire:
+ **`Description`**— la descrizione a testo libero aggiornata. Massimo 1024 caratteri.
+ **`ClientToken`**— un token di idempotenza per l'aggiornamento.
Blocco ottimistico: il `Version` campo garantisce che gli aggiornamenti si applichino solo se l'attribuzione non è cambiata dall'ultima volta che è stata recuperata. Se la versione inviata `Version` non corrisponde alla versione corrente della risorsa, l'aggiornamento viene rifiutato con `ConflictException` un messaggio contenente i numeri di versione inviata e corrente. È consigliabile recuperare la versione più recente `GetRevenueAttribution` prima di ogni aggiornamento.
### Visualizzazione dei dettagli del Revenue Attribution ID
I partner possono recuperare informazioni complete per un singolo Revenue Attribution ID utilizzando l'`GetRevenueAttribution`azione API. Viene restituito:
Metadati delle risorse:
+ Identificatore univoco (`Id`) e Amazon Resource Name (`Arn`).
+ Il `Catalog` in cui esiste l'attribuzione.
+ `Name` e `Description`.
+ Il recuperato `Version` e il `LatestVersion` (usa l'ultimo per gli aggiornamenti successivi).
Attributi del prodotto Marketplace (`MarketplaceProduct`se impostato al momento della creazione):
+ `ProductId`— l'ID del prodotto Marketplace fornito dal partner.
+ `ProductCode`— il codice del prodotto AWS Marketplace risolto da`ProductId`.
+ `ProductType`—`SaaS`,`AMI`, `Container``ML`,`Data`, o`Professional Services`.
+ `TenancyModel`— `MULTI_TENANT` oppure`SINGLE_TENANT`.
Informazioni sull'audit:
+ `CreatedDate` e `LastModifiedDate`.
I partner possono facoltativamente fornire informazioni specifiche `Version` nella richiesta per recuperare una versione storica dell'attribuzione. Ometti per restituire la versione più `Version` recente.
Per recuperare una voce specifica relativa all'allocazione dei costi mensili, i partner utilizzano l'azione `GetRevenueAttributionAllocation` API con la voce. `AllocationId` Ciò restituisce l'ID dell'offerta o l'ID dell'opportunità, il mese di fatturazione, la percentuale di allocazione dei costi, l'ID AWS dell'account del cliente e le informazioni sullo stato e sul controllo della voce.
### Elenco degli ID di attribuzione dei ricavi
I partner possono visualizzare tutti gli ID di attribuzione delle entrate nel proprio account utilizzando l'azione `ListRevenueAttributions` API. Ciò restituisce un elenco impaginato di riepiloghi delle attribuzioni con funzionalità di filtraggio e ordinamento.
I partner possono filtrare i risultati per:
+ **`Catalog`**— `AWS` oppure `Sandbox` (richiesto).
+ **`Identifiers`**— un elenco di un massimo di 100 `ra-` ID specifici da recuperare.
+ **`CreatedAfter`/`CreatedBefore`**— filtra per intervallo di data e ora di creazione (incluso).
I partner possono configurare l'ordinamento dei risultati utilizzando il parametro: `Sort`
+ `SortBy`— `CreatedDate` oppure. `LastModifiedDate`
+ `SortOrder`— `ASCENDING` oppure`DESCENDING`.
La risposta include un riepilogo per ogni attribuzione:`Arn`,`Id`,`Catalog`,`Name`, `MarketplaceProduct` attributi risolti,`CreatedDate`,`LastModifiedDate`, gli ultimi `Version` e `TotalRevenueAttributionAssociationCount` (il numero di voci attive di allocazione dei costi mensili collegate all'attribuzione).
Utilizza `MaxResults` (impostazione predefinita 25, massimo 100) e impagina tra set `NextToken` di risultati di grandi dimensioni. La risposta include un messaggio `NextToken` se sono disponibili pagine aggiuntive.
### Elenco delle voci di allocazione dei costi mensili
I partner possono elencare le voci mensili di allocazione dei costi per uno specifico Revenue Attribution ID utilizzando l'`ListRevenueAttributionAllocations`azione API. Ciò restituisce un elenco impaginato di riepiloghi delle allocazioni con funzionalità di filtro.
I partner possono filtrare i risultati per:
+ **`MarketplaceOfferId`**— elenca solo le voci associate a una specifica offerta del Marketplace.
+ **`AwsPartnerCentralOpportunityId`**— elenca solo le voci associate a una specifica opportunità di Partner Central.
+ **`BillingMonth`**— elenca solo le voci relative a un mese di calendario specifico.
La risposta include informazioni di riepilogo per ogni voce: l'`AllocationId`ID dell'offerta o dell'opportunità associato, l'ID dell'AWS account cliente, il mese di fatturazione, la percentuale di allocazione dei costi, il nome e lo stato della voce e gli orari di verifica.
Creazione di dashboard: la combinazione di `ListRevenueAttributions` e `ListRevenueAttributionAllocations` è progettata per supportare la creazione di dashboard per i partner. I partner possono creare visualizzazioni come:
+ Tutti gli ID di attribuzione delle entrate creati negli ultimi 30 giorni, ordinati per data di creazione.
+ Tutte le voci mensili relative all'allocazione dei costi per una specifica offerta Marketplace su più Revenue Attribution ID.
+ Tutte le voci relative all'allocazione dei costi per il mese di fatturazione corrente, per verificare che i totali non superino il 100% per attribuzione.
+ Tutti gli ID di attribuzione dei ricavi che hanno almeno una voce di allocazione attiva (). `TotalRevenueAttributionAssociationCount > 0`