L' AWS Partner Central API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'[AWS Partner Central 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 delle Revenue Share del Marketplace
Un Marketplace Revenue Share è un input per un prodotto AWS Marketplace che dichiara la parte del fatturato totale del prodotto riscossa tramite AWS Marketplace.AWS utilizza questo input per correlare le Marketplace-collected entrate di un partner con altri segnali di fatturato.
Il Marketplace Revenue Share Service utilizza le API per creare, recuperare ed elencare le risorse Marketplace Revenue Share e gestirne le allocazioni (le percentuali di compartecipazione ai ricavi dichiarate dai partner e le finestre di data di validità). Le operazioni di AWS tagging standard sono supportate nella risorsa Marketplace Revenue Share.
## Cos'è il Marketplace Revenue Share?
Un Marketplace Revenue Share ha due livelli:
+ **La condivisione**: un input per un singolo prodotto AWS Marketplace, identificato dal Marketplace`ProductId`. Esiste esattamente un Marketplace Revenue Share per prodotto.
+ **Una o più allocazioni**: ogni allocazione dichiara una `RevenueSharePercent` finestra di data di validità (`EffectiveDate`facoltativamente). `ExpirationDate` Una condivisione può avere molte allocazioni nel tempo, ma in qualsiasi momento può essere applicata una sola allocazione. `ACTIVE`
Le allocazioni hanno le seguenti proprietà chiave:
+ **Stato**: `ACTIVE` o. `INACTIVE` Al momento della creazione, lo status è predefinito su. `ACTIVE` Solo `ACTIVE` le allocazioni partecipano al calcolo delle entrate e ai controlli di sovrapposizione.
+ **Invariante di sovrapposizione**: all'interno di una singola azione, non è possibile che due `ACTIVE` allocazioni abbiano intervalli sovrapposti. `[EffectiveDate, ExpirationDate]` È consentita al massimo un'`ACTIVE`allocazione a tempo indeterminato (no`ExpirationDate`) per azione in qualsiasi momento.
## Utilizzo delle Revenue Share del Marketplace
I partner gestiscono le Marketplace Revenue Share e le relative allocazioni tramite il Marketplace Revenue Share Service. Il ciclo di vita procede attraverso due flussi: il flusso di condivisione (creazione, recupero, elenco, tag) e il flusso di allocazioni (creazione, aggiornamento, eliminazione parziale, recupero, elenco).
### Creazione di una quota di fatturato del Marketplace
Il primo passaggio consiste nella creazione di un Marketplace Revenue Share per un prodotto AWS Marketplace utilizzando l'azione `CreateMarketplaceRevenueShare` API. La condivisione viene identificata dal Marketplace `ProductId` e funge da contenitore per tutte le allocazioni successive.
Quando creano un Marketplace Revenue Share, i partner devono fornire:
+ **`Catalog`**— `AWS` per la produzione o `Sandbox` per i test.
+ **`ProductId`**— l'ID del prodotto Marketplace di 25 caratteri. Modello:`[a-z0-9]{25}`.
I partner possono opzionalmente fornire:
+ **`Tags`**— fino a 50 coppie chiave-valore per l'organizzazione delle risorse al momento della creazione. `TagResource`Da utilizzare per aggiungere tag dopo la creazione.
+ **`ClientToken`**— un token di idempotenza per evitare creazioni duplicate in caso di nuovo tentativo. Massimo 64 caratteri. Gli SDK generano automaticamente questo token.
Convalida del prodotto: al momento della creazione, il servizio verifica con AWS Marketplace che il prodotto sia di proprietà dell'account del chiamante o di un account sussidiario collegato al chiamante tramite Partner Account Connection (PAC). Se il prodotto non esiste o l'account proprietario non è autorizzato per il chiamante, l'API restituisce un messaggio indicativo. `ValidationException` `PRODUCT_NOT_FOUND_OR_NOT_OWNED`
Una quota per prodotto: una seconda `CreateMarketplaceRevenueShare` chiamata per lo stesso prodotto con gli stessi `ProductId` rendimenti. `Catalog` `ConflictException`
La risposta restituisce il `Arn` (formato`arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}`) della condivisione, il `Catalog``ProductId`, il `Version` numero iniziale (che inizia da 1 e aumenta a ogni mutazione di allocazione) e tutti i tag applicati al momento della creazione.
### Aggiungere allocazioni
Una volta creato un Marketplace Revenue Share, i partner dichiarano una percentuale di compartecipazione alle entrate e una finestra di data di validità creando un'allocazione tramite l'azione API. `CreateMarketplaceRevenueShareAllocation`
Quando creano un'allocazione, i partner devono fornire:
+ **`Catalog`**— `AWS` oppure. `Sandbox`
+ **`MarketplaceRevenueShareIdentifier`**— l'identificatore della quota principale.
+ **`RevenueSharePercent`**— la percentuale delle entrate del prodotto raccolte tramite Marketplace fornita come decimale (ad esempio, `0.45` per il 45%).
+ **`EffectiveDate`**— la data di calendario in cui questa allocazione diventa effettiva. Formato:`YYYY-MM-DD`.
La risposta restituisce lo stato dell'allocazione `Id` (formato`mrsa-[A-Za-z0-9]{13}`), lo stato dell'allocazione (`ACTIVE`alla creazione) e il valore cumulato della condivisione principale `Version` (per ogni mutazione di allocazione viene visualizzato un numero intero di versione per condivisione, utilizzato per bloccare in modo ottimistico i successivi aggiornamenti dell'allocazione).
### Aggiornamento delle allocazioni
I partner possono aggiornare un'allocazione utilizzando l'azione `UpdateMarketplaceRevenueShareAllocation` API. I campi aggiornabili dipendono dal fatto che l'allocazione sia con data futura, attuale o passata.
Quando aggiornano un'allocazione, i partner devono fornire:
+ **`Catalog`**— `AWS` oppure. `Sandbox`
+ **`MarketplaceRevenueShareIdentifier`**— l'identificatore della quota principale.
+ **`AllocationId`**— l'`mrsa-`ID dell'allocazione da aggiornare.
+ **`MarketplaceRevenueShareVersion`**— la versione corrente della condivisione principale per un blocco ottimistico dell'allocazione. Ritornano i conflitti Bump. `ConflictException`
I partner possono fornire facoltativamente:
+ **`RevenueSharePercent`**— la percentuale aggiornata di compartecipazione alle entrate. Modificabile solo su allocazioni con data futura.
+ **`EffectiveDate`**— la data di validità aggiornata. Modificabile solo su allocazioni con data futura.
+ **`ExpirationDate`**— la data di scadenza aggiornata. Modificabile sulle allocazioni con data futura (qualsiasi valore`> EffectiveDate`) e sulle allocazioni attualmente in vigore o a tempo indeterminato (qualsiasi valore). `≥ today`
+ **`Status`**`INACTIVE`— oppure. `ACTIVE` L'impostazione su `INACTIVE` soft elimina l'allocazione. Modificabile solo su allocazioni con data futura.
+ **`ClientToken`**— un token di idempotenza.
### Visualizzazione dei dettagli della quota di fatturato del Marketplace
I partner possono recuperare informazioni complete per un singolo Marketplace Revenue Share utilizzando l'azione `GetMarketplaceRevenueShare` API. Ciò restituisce la condivisione `Arn``Catalog`,`ProductId`,, `Version` (la versione corrente dell'azione principale) e tutti i tag applicati alla condivisione. `CreatedDate` `LastModifiedDate`
I partner possono recuperare una singola allocazione utilizzando l'azione `GetMarketplaceRevenueShareAllocation` API con le allocazioni. `Id` Viene restituito:
+ L'allocazione `Id` e la quota principale. `MarketplaceRevenueShareArn`
+ `RevenueSharePercent`, `EffectiveDate`, `ExpirationDate`.
+ `Status`(`ACTIVE`o`INACTIVE`).
+ La quota principale `MarketplaceRevenueShareVersion` serve a bloccare con ottimismo gli aggiornamenti successivi.
+ `CreatedDate` e `LastModifiedDate`.
### Quotazione delle quote di reddito del Marketplace
I partner possono visualizzare tutte le Revenue Share del Marketplace di proprietà del proprio account utilizzando l'azione `ListMarketplaceRevenueShares` API. Ciò restituisce un elenco impaginato di riepiloghi delle azioni.
I partner possono filtrare i risultati in base a:
+ **`Catalog`**— `AWS` oppure `Sandbox` (richiesto).
+ **`ProductIds`**— un elenco di ID di prodotto specifici del Marketplace da recuperare.
La risposta include un riepilogo per ogni condivisione: `Arn``Catalog`,`ProductId`,, l'ultima `Version` e`LastModifiedDate`. `CreatedDate`
Usa `MaxResults` e `NextToken` impagina set di risultati di grandi dimensioni.
### Elencare le allocazioni
I partner possono elencare le allocazioni per uno specifico Marketplace Revenue Share utilizzando l'azione `ListMarketplaceRevenueShareAllocations` API. Ciò restituisce un elenco impaginato di riepiloghi delle allocazioni con funzionalità di filtro.
I partner possono filtrare i risultati per:
+ **`Status`**— `ACTIVE` oppure`INACTIVE`.
+ **Intervallo di date di validità** —`EffectiveDateOnOrAfter`/`EffectiveDateOnOrBefore`per recuperare le allocazioni la cui data di validità rientra in una finestra specifica.
La risposta include informazioni di riepilogo per ogni allocazione:`Id`,,,`RevenueSharePercent`, `EffectiveDate` `ExpirationDate` `Status``MarketplaceRevenueShareVersion`, e timestamp di controllo.
## Etichettatura delle quote di fatturato del Marketplace
Le operazioni di AWS tagging standard sono supportate nella risorsa Marketplace Revenue Share:
+ **`TagResource`**— aggiungere o sovrascrivere tag su un Marketplace Revenue Share. Massimo 50 tag per condivisione.
+ **`UntagResource`**— rimuovi tag specifici per chiave.
+ **`ListTagsForResource`**— recupera tutti i tag attualmente applicati a un Marketplace Revenue Share.
Le allocazioni non supportano i tag. Etichetta la condivisione principale per organizzare le allocazioni correlate.
Ogni operazione di etichettatura accetta il formato della `Arn` condivisione come `arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}` identificatore della risorsa. Il AWS tag-on-create standard è supportato anche dal campo on. `Tags` `CreateMarketplaceRevenueShare`