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à.

# Accesso all'API Revenue Measurement
<a name="prm-access-control"></a>

Il controllo degli accessi e le autorizzazioni sono gestiti da AWS Identity and Access Management(IAM). Questa sezione fornisce indicazioni per configurare le autorizzazioni necessarie per interagire con l'API Revenue Measurement, incluse le autorizzazioni necessarie per elencare le entità.AWS Marketplace

## Prerequisiti
<a name="prm-prerequisites"></a>

Prima di configurare le autorizzazioni, assicurati di essere collegato a Partner Central e di aver creato i ruoli e gli utenti IAM necessari.Account AWS Per ulteriori informazioni, consulta [Configurazione e autenticazione](https://docs.aws.amazon.com/partner-central/latest/APIReference/setup-authentication.html).

## Utilizzo AWS policy gestite
<a name="prm-using-aws-managed-policies"></a>

AWS fornisce politiche gestite che concedono le autorizzazioni necessarie per interagire con l'API Revenue Measurement. Sono disponibili due policy gestite a seconda del tipo di persona:
+ **Partner**: collega la `AWSPartnerCentralRevenueAttributionManagement` policy alle tue identità IAM.
+ **Clienti**: collega la `AWSRevenueAttributionManagement` policy alle tue identità IAM.

Per ulteriori informazioni, consulta le [politiche AWS gestite per gli utenti di AWS Partner Central](https://docs.aws.amazon.com/partner-central/latest/getting-started/managed-policies.html).

### AWSPartnerCentralRevenueAttributionManagement politica
<a name="prm-partner-facing-policy"></a>

Questa politica fornisce l'accesso necessario per le attività di gestione dell'attribuzione dei ricavi per AWS gli account registrati con AWS Partner Central.

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "RevenueMeasurementCreation",
            "Effect": "Allow",
            "Action": [
                "partnercentral:CreateRevenueAttribution",
                "partnercentral:CreateMarketplaceRevenueShare",
                "partnercentral:CreateMarketplaceRevenueShareAllocation"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "RevenueMeasurementListing",
            "Effect": "Allow",
            "Action": [
                "partnercentral:ListRevenueAttributions",
                "partnercentral:ListRevenueAttributionAllocations",
                "partnercentral:ListMarketplaceRevenueShares",
                "partnercentral:ListMarketplaceRevenueShareAllocations"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "RevenueAttributionManagement",
            "Effect": "Allow",
            "Action": [
                "partnercentral:GetRevenueAttribution",
                "partnercentral:UpdateRevenueAttribution",
                "partnercentral:GetRevenueAttributionAllocation",
                "partnercentral:StartRevenueAttributionAllocationsTask",
                "partnercentral:GetRevenueAttributionAllocationsTask"
            ],
            "Resource": "arn:aws:partnercentral:*:*:catalog/*/revenue-attribution/*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "MarketplaceRevenueShareManagement",
            "Effect": "Allow",
            "Action": [
                "partnercentral:GetMarketplaceRevenueShare",
                "partnercentral:GetMarketplaceRevenueShareAllocation",
                "partnercentral:UpdateMarketplaceRevenueShareAllocation"
            ],
            "Resource": "arn:aws:partnercentral:*:*:catalog/*/marketplace-revenue-share/*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "TaggingAccess",
            "Effect": "Allow",
            "Action": [
                "partnercentral:TagResource",
                "partnercentral:UntagResource",
                "partnercentral:ListTagsForResource"
            ],
            "Resource": [
                "arn:aws:partnercentral:*:*:catalog/*/revenue-attribution/*",
                "arn:aws:partnercentral:*:*:catalog/*/marketplace-revenue-share/*"
            ],
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "OpportunityAccess",
            "Effect": "Allow",
            "Action": [
                "partnercentral:ListOpportunities",
                "partnercentral:GetOpportunity"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "PartnerResourceAccess",
            "Effect": "Allow",
            "Action": [
                "partnercentral:ListPartners",
                "partnercentral:GetPartner"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "ListingAWSMarketplaceEntities",
            "Effect": "Allow",
            "Action": [
                "aws-marketplace:ListEntities"
            ],
            "Resource": "*"
        },
        {
            "Sid": "AWSMarketplaceEntityAccess",
            "Effect": "Allow",
            "Action": [
                "aws-marketplace:DescribeEntity"
            ],
            "Resource": [
                "arn:aws:aws-marketplace:*:*:AWSMarketplace*/Offer/*"
            ]
        },
        {
            "Sid": "AmazonQPartnerAssistantAccess",
            "Effect": "Allow",
            "Action": [
                "q:StartConversation",
                "q:SendMessage",
                "q:GetConversation",
                "q:ListConversations",
                "q:PassRequest"
            ],
            "Resource": "*"
        }
    ]
}
```

### AWSRevenueAttributionManagement politica
<a name="prm-customer-facing-policy"></a>

Questa politica fornisce l'accesso necessario alle attività di gestione dell'attribuzione delle entrate per AWS gli account che non sono registrati presso AWS Partner Central.

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "RevenueAttributionCreation",
            "Effect": "Allow",
            "Action": [
                "partnercentral:CreateRevenueAttribution"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "RevenueAttributionListing",
            "Effect": "Allow",
            "Action": [
                "partnercentral:ListRevenueAttributions"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "RevenueAttributionManagement",
            "Effect": "Allow",
            "Action": [
                "partnercentral:GetRevenueAttribution",
                "partnercentral:UpdateRevenueAttribution"
            ],
            "Resource": "arn:aws:partnercentral:*:*:catalog/*/revenue-attribution/*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "TaggingAccess",
            "Effect": "Allow",
            "Action": [
                "partnercentral:TagResource",
                "partnercentral:UntagResource",
                "partnercentral:ListTagsForResource"
            ],
            "Resource": [
                "arn:aws:partnercentral:*:*:catalog/*/revenue-attribution/*"
            ],
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        }
    ]
}
```

## Assegnazione di policy a ruoli e utenti IAM
<a name="prm-assigning-policies"></a>

Segui questi passaggi per assegnare le policy ai ruoli e agli utenti IAM:

1. Accedi alla AWS Management Console.

1. Accedi al servizio IAM.

1. Seleziona ruoli o utenti e scegli il ruolo o l'utente IAM a cui desideri allegare una policy.

1. Allega la `AWSPartnerCentralRevenueAttributionManagement` policy (per i partner) o la `AWSRevenueAttributionManagement` policy (per i clienti) al ruolo o all'utente IAM selezionato.

Per ulteriori informazioni, consulta [Aggiunta e rimozione di autorizzazioni per identità IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html).

## Gestione delle autorizzazioni utilizzando i tasti condizionali
<a name="prm-managing-permissions-with-condition-keys"></a>

Le chiavi di condizione nelle policy IAM forniscono autorizzazioni a livello di risorsa su quando applicare le policy relative alle dichiarazioni. Puoi utilizzare le chiavi condizionali per specificare le condizioni che determinano quando determinate autorizzazioni sono consentite o negate.

Per ulteriori informazioni, consulta [Elementi della policy JSON IAM: operatori di condizione](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html).


**Panoramica dei tasti condizionali**  

| Chiave di condizione | Description | Azioni applicabili | Valori validi | 
| --- | --- | --- | --- | 
| Partner Central: catalogo | Filtra l'accesso in base al tipo di entità di catalogo associata | Tutte le operazioni | AWS, Sandbox | 

## Riepilogo delle autorizzazioni richieste
<a name="prm-summary-of-required-permissions"></a>


**Riepilogo delle autorizzazioni richieste**  

| Azione | Description | 
| --- | --- | 
| partnercentral: CreateRevenueAttribution | Consente di creare un nuovo record di attribuzione dei ricavi | 
| partnercentral: UpdateRevenueAttribution | Consente di aggiornare un record di attribuzione dei ricavi esistente | 
| partnercentral: GetRevenueAttribution | Consente di recuperare i dettagli di una specifica attribuzione dei ricavi | 
| partner central: ListRevenueAttributions | Consente di elencare le attribuzioni dei ricavi con filtri opzionali | 
| partnercentral: GetRevenueAttributionAllocation | Consente di recuperare una singola allocazione in base al relativo ID | 
| partnercentral: ListRevenueAttributionAllocations | Consente di elencare le allocazioni impegnate con supporto di filtraggio | 
| partnercentral: StartRevenueAttributionAllocationsTask | Consente di inviare un batch di un massimo di 250 modifiche all'allocazione per l'elaborazione asincrona | 
| partnercentral: GetRevenueAttributionAllocationsTask | Consente di recuperare lo stato di un'attività di allocazione inviata in precedenza | 
| partnercentral: CreateMarketplaceRevenueShare | Consente di creare una nuova risorsa di compartecipazione alle entrate del marketplace | 
| partnercentral: GetMarketplaceRevenueShare | Consente di recuperare i dettagli della quota di compartecipazione alle entrate di uno specifico marketplace | 
| partnercentral: ListMarketplaceRevenueShares | Consente di elencare le quote di ripartizione delle entrate del marketplace con filtri opzionali | 
| partnercentral: CreateMarketplaceRevenueShareAllocation | Consente di creare una nuova allocazione delle quote di fatturato sul marketplace | 
| partnercentral: GetMarketplaceRevenueShareAllocation | Consente di recuperare i dettagli dell'allocazione delle quote di fatturato di uno specifico marketplace | 
| partnercentral: UpdateMarketplaceRevenueShareAllocation | Consente di aggiornare l'allocazione delle quote di compartecipazione alle entrate del marketplace esistente | 
| partnercentral: ListMarketplaceRevenueShareAllocations | Consente l'allocazione delle inserzioni nell'ambito di una quota delle entrate del marketplace | 
| partner central: TagResource | Consente di aggiungere o sovrascrivere tag per una risorsa | 
| partnercentral: UntagResource | Consente di rimuovere i tag da una risorsa | 
| partnercentral: ListTagsForResource | Consente di elencare i tag associati a una risorsa |