

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 di vendita
<a name="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, incluse le autorizzazioni necessarie per elencare le entità.Marketplace AWS

## Prerequisiti
<a name="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="using-aws-managed-policies"></a>

AWS fornisce politiche gestite che concedono le autorizzazioni necessarie per interagire con l'API. Per fornire l'accesso necessario per gestire le opportunità, collega la `AWSPartnerCentralOpportunityManagement` 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).

### AWSPartnerCentralOpportunityManagement politica
<a name="partnercentral-selling-full-access-policy"></a>

Questa politica garantisce l'accesso completo alle azioni di gestione delle opportunità di Partner Central.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "OpportunityManagement",
            "Effect": "Allow",
            "Action": [
                "partnercentral:AcceptEngagementInvitation",
                "partnercentral:AssignOpportunity",
                "partnercentral:AssociateOpportunity",
                "partnercentral:CreateEngagement",
                "partnercentral:CreateEngagementInvitation",
                "partnercentral:CreateOpportunity",
                "partnercentral:CreateResourceSnapshot",
                "partnercentral:CreateResourceSnapshotJob",
                "partnercentral:DeleteResourceSnapshotJob",
                "partnercentral:DisassociateOpportunity",
                "partnercentral:GetAwsOpportunitySummary",
                "partnercentral:GetEngagement",
                "partnercentral:GetEngagementInvitation",
                "partnercentral:GetOpportunity",
                "partnercentral:GetResourceSnapshot",
                "partnercentral:GetResourceSnapshotJob",
                "partnercentral:ListEngagementByAcceptingInvitationTasks",
                "partnercentral:ListEngagementFromOpportunityTasks",
                "partnercentral:ListEngagementInvitations",
                "partnercentral:ListEngagementMembers",
                "partnercentral:ListEngagementResourceAssociations",
                "partnercentral:ListEngagements",
                "partnercentral:ListOpportunities",
                "partnercentral:ListResourceSnapshotJobs",
                "partnercentral:ListResourceSnapshots",
                "partnercentral:ListSolutions",
                "partnercentral:RejectEngagementInvitation",
                "partnercentral:StartEngagementByAcceptingInvitationTask",
                "partnercentral:StartEngagementFromOpportunityTask",
                "partnercentral:StartResourceSnapshotJob",
                "partnercentral:StopResourceSnapshotJob",
                "partnercentral:SubmitOpportunity",
                "partnercentral:UpdateOpportunity"
            ],
            "Resource": "*"
        },
        {
            "Sid": "ListingAWSMarketplaceEntities",
            "Effect": "Allow",
            "Action": ["aws-marketplace:ListEntities"],
            "Resource": "*"
        },
        {
            "Sid": "AWSMarketplaceOffersAccess",
            "Effect": "Allow",
            "Action": ["aws-marketplace:DescribeEntity"],
            "Resource": [
            		"arn:aws:aws-marketplace:*:*:AWSMarketplace/Offer/*",
            		"arn:aws:aws-marketplace:*:*:AWSMarketplace/OfferSet/*"
            ]
        }
    ]
}
```

------

## Policy personalizzate
<a name="custom-policies"></a>

Se le policy gestite non soddisfano le tue esigenze, crea policy IAM personalizzate che concedano le autorizzazioni necessarie per il tuo caso d'uso. L'esempio seguente è una politica personalizzata che concede le autorizzazioni per elencare le entità:Marketplace AWS

**Example Esempio di policy personalizzata**    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "partnercentral:ListOpportunities",
                "aws-marketplace:ListEntities"
            ],
            "Resource": "*"
        }
    ]
}
```

**Politica permissiva personalizzata**

Questa politica fornisce un ampio accesso alle azioni di vendita di Partner Central, comprese le funzionalità che potrebbero essere aggiunte in futuro senza richiedere aggiornamenti delle politiche. Utilizzando l'azione wild card`partnercentral:*`, questa politica concede automaticamente l'accesso alle nuove funzionalità di vendita di Partner Central non appena diventano disponibili, riducendo la necessità di aggiornamenti manuali. Questa politica include anche le autorizzazioni per l'interazione con le Marketplace AWS entità, il che aiuta a garantire il mantenimento dell'accesso sia per le azioni di vendita che per quelle del Marketplace.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement":
    [
        {
            "Effect": "Allow",
            "Action":
            [
                "partnercentral:*"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action":
            [
                "aws-marketplace:ListEntities",
                "aws-marketplace:DescribeEntity"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action":
            [
                "aws-marketplace:SearchAgreements",
                "aws-marketplace:DescribeAgreement"
            ],
            "Resource": "*",
            "Condition":
            {
                "StringEquals":
                {
                    "aws-marketplace:PartyType": "Proposer"
                }
            }
        }
    ]
}
```

------

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

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

1. Accedi alla Console di gestione AWS.

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 `AWSPartnerCentralOpportunityManagement` policy o la tua policy personalizzata 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 tramite chiavi condizionali
<a name="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 azioni | AWS, sandbox | 
| aws-marketplace: PartyType | filtra l'accesso in base al tipo di soggetto (ad esempio, proponente) | SearchAgreements, DescribeAgreement | proporre | 

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


**Riepilogo delle autorizzazioni richieste**  

| Azione | Description | 
| --- | --- | 
| partnercentral: CreateOpportunity | consente di creare opportunità | 
| partner central: UpdateOpportunity | consente di aggiornare le opportunità | 
| partner central: ListOpportunities | consente di elencare opportunità | 
| partnercentral: GetOpportunity | consente di recuperare i dettagli delle opportunità | 
| partnercentral: ListSolutions | consente di elencare soluzioni | 
| partnercentral: AssociateOpportunity | consente di associare opportunità ad altre entità | 
| partnercentral: DisassociateOpportunity | consente di dissociare le opportunità da altre entità | 
| partnercentral: AcceptEngagementInvitation | consente di accettare inviti di fidanzamento | 
| partnercentral: RejectEngagementInvitation | consente di rifiutare gli inviti di fidanzamento | 
| partner central: GetEngagementInvitation | consente di recuperare i dettagli dell'invito al fidanzamento | 
| partnercentral: ListEngagementInvitations | consente di pubblicare inviti di fidanzamento | 
| partnercentral: SubmitOpportunity | consente di presentare opportunità | 
| partnercentral: GetAwsOpportunitySummary | consente di recuperare il riepilogo AWS delle opportunità | 
| partnercentral: StartProspectingFromEngagementTask | Crea un'attività di prospezione a partire dagli impegni | 
| partnercentral: GetProspectingFromEngagementTask | Restituisce i dettagli dell'attività di prospezione | 
| partnercentral: ListProspectingFromEngagementTasks | Restituisce un elenco di attività di prospezione | 
| aws-marketplace: ListEntities | consente di elencare le entitàMarketplace AWS | 
| aws-marketplace: DescribeEntity | consente di descrivere le entitàMarketplace AWS | 
| aws-marketplace: SearchAgreements | consente di cercare accordi in Marketplace AWS | 
| aws-marketplace: DescribeAgreement | consente di descrivere gli accordi in Marketplace AWS | 