L'AWS Marketplace API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'[AWS Marketplace API Reference](https://docs.aws.amazon.com/marketplace/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à.

# Controllo degli accessi per Marketplace AWS API Discovery
<a name="discovery-api-access-control"></a>

L'API Discovery utilizza AWS Identity and Access Management (IAM) per l'autenticazione e l'autorizzazione. Qualsiasi AWS cliente può chiamare l'API Discovery configurando le autorizzazioni IAM appropriate.

Gli utenti devono disporre delle seguenti autorizzazioni per chiamare le operazioni dell'API Discovery:
+ `GetListing`— Concede l'autorizzazione a recuperare informazioni su un'inserzione.
+ `GetProduct`— Concede l'autorizzazione a recuperare informazioni su un prodotto.
+ `GetOffer`— Concede l'autorizzazione a recuperare informazioni su un'offerta.
+ `GetOfferTerms`— Concede l'autorizzazione a recuperare i termini di un'offerta.
+ `GetOfferSet`— Concede l'autorizzazione a recuperare informazioni su un set di offerte.
+ `ListPurchaseOptions`— Concede l'autorizzazione a elencare le opzioni di acquisto disponibili per l'acquirente.
+ `ListFulfillmentOptions`— Concede l'autorizzazione a elencare le opzioni di evasione degli ordini per un prodotto.
+ `SearchListings`— Concede l'autorizzazione alla ricerca di elenchi di prodotti.
+ `SearchFacets`— Concede l'autorizzazione a recuperare i valori delle sfaccettature per filtrare le inserzioni.

## autorizzazioni IAM
<a name="discovery-iam-permissions"></a>

Per chiamare le operazioni dell'API Discovery, il principale IAM (utente o ruolo) deve disporre delle autorizzazioni appropriate. `aws-marketplace` L'API Discovery supporta le autorizzazioni a livello di risorsa, quindi puoi definire l'accesso a tipi di risorse specifici nelle tue policy IAM.

La seguente policy IAM concede l'accesso a tutte le operazioni dell'API Discovery con un ambito a livello di risorsa:

```
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "aws-marketplace:GetListing",
                "aws-marketplace:GetProduct",
                "aws-marketplace:GetOffer",
                "aws-marketplace:GetOfferTerms",
                "aws-marketplace:GetOfferSet",
                "aws-marketplace:ListPurchaseOptions",
                "aws-marketplace:ListFulfillmentOptions",
                "aws-marketplace:SearchFacets",
                "aws-marketplace:SearchListings"
            ],
            "Resource": [
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/product/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/listing/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/offer/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/offerSet/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/purchaseOption/*"
            ]
        }
    ]
}
```

Sostituiscilo `<catalog-name>` con l'identificatore di catalogo appropriato (ad esempio,). `AWSMarketplace`

### Formati ARN delle risorse
<a name="discovery-resource-arn-formats"></a>

La tabella seguente mostra i tipi di risorse e i relativi formati ARN utilizzati dalle operazioni dell'API Discovery:


| Tipo di risorsa | Formato ARN | Utilizzato da | 
| --- | --- | --- | 
| Prodotto | arn:aws:aws-marketplace:::catalog/{{catalog-name}}/product/{{product-id}} | GetProduct, ListFulfillmentOptions | 
| Elenco | arn:aws:aws-marketplace:::catalog/{{catalog-name}}/listing/{{listing-id}} | GetListing, SearchListings, SearchFacets | 
| Offerta | arn:aws:aws-marketplace:::catalog/{{catalog-name}}/offer/{{offer-id}} | GetOffer, GetOfferTerms | 
| Set di offerte | arn:aws:aws-marketplace:::catalog/{{catalog-name}}/offerSet/{{offerSet-id}} | GetOfferSet | 
| Purchase Option (Opzioni di acquisto) | arn:aws:aws-marketplace:::catalog/{{catalog-name}}/purchaseOption/{{purchaseOption-id}} | ListPurchaseOptions | 

### Attribuzione delle operazioni a risorse specifiche
<a name="discovery-scoping-get-operations"></a>

Per le operazioni Get (GetListing GetProduct, GetOffer, GetOfferTerms,, GetOfferSet) e l' ListFulfillmentOptions operazione, puoi limitare l'accesso a ID di risorse specifici anziché utilizzare un carattere jolly. Ad esempio, per limitare l'accesso a un singolo elenco:

```
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "aws-marketplace:GetListing",
            "Resource": "arn:aws:aws-marketplace:::catalog/AWSMarketplace/listing/{{listing-id}}"
        }
    ]
}
```

Questo modello funziona per qualsiasi operazione Get e ListFulfillmentOptions. Sostituisci il tipo e l'ID della risorsa di conseguenza:
+ `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/product/{{product-id}}`
+ `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/listing/{{listing-id}}`
+ `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/offer/{{offer-id}}`
+ `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/offerSet/{{offerSet-id}}`

Le ListPurchaseOptions operazioni SearchListings SearchFacets, e non supportano l'ambito di una singola risorsa perché operano su più elementi. Utilizzate i seguenti pattern ARN con caratteri jolly per queste operazioni:
+ Per SearchListings e: SearchFacets `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/listing/*`
+ Per ListPurchaseOptions: `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/purchaseOption/*`

## Service-linked ruoli
<a name="discovery-service-linked-roles"></a>

L'API Discovery non utilizza ruoli collegati ai servizi. Tutti gli accessi sono controllati tramite policy IAM standard.

## Cross-account accesso
<a name="discovery-cross-account-access"></a>

Puoi concedere l'accesso a più account all'API Discovery utilizzando i ruoli IAM. Crea un ruolo nell'account di destinazione con le autorizzazioni dell'API Discovery appropriate, quindi assumi il ruolo dall'account di origine.