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à.
# Utilizzo di Marketplace AWS API per condividere risorse
AWS Marketplace Catalog API si integra con AWS Resource Access Manager (AWS RAM) per abilitare la condivisione delle risorse. Una *risorsa* è un'entità con cui gli utenti possono lavorare Marketplace AWS, ad esempio un prodotto, un'offerta o un'autorizzazione alla rivendita. Con AWS RAM, puoi condividere alcune AWS Marketplace Catalog API risorse con altri Account AWS. Puoi condividere le risorse di tua proprietà creando una *condivisione di risorse*. Una condivisione di risorse specifica le risorse che desideri condividere e i consumatori con cui condividerle.
**Topics**
+ [Prerequisiti per la condivisione Marketplace AWS Entità](#sharing-prereqs)
+ [Condividi un Marketplace AWS entity](#share-marketplace-entity)
## Prerequisiti per la condivisione Marketplace AWS Entità
Prima di condividere le entità AWS Marketplace Catalog API, è necessario soddisfare i seguenti prerequisiti:
+ È possibile allegare una sola politica delle risorse all' Marketplace AWS entità.
+ Per condividere un' Marketplace AWS entità, devi possederla nel tuo Account AWS. Questo requisito significa che l'entità deve essere allocata o fornita nel tuo account. Non puoi condividere un' Marketplace AWS entità che è stata condivisa con te.
## Condividi un Marketplace AWS entity
Con la condivisione Marketplace AWS delle risorse, i proprietari delle entità possono condividere le proprie entità con altri Account AWS utenti Marketplace AWS. Entity-owners possono essere ISV e partner di canale. Le entità che possono essere condivise sono prodotti, offerte e autorizzazioni di rivendita.
**Nota**
Al momento, puoi condividere solo entità. Le entità in Marketplace AWS includono `AmiProduct` `Audience``BrandingSettings`,`ContainerProduct`,`Experience`, e`ProcurementPolicy`.
Per ulteriori informazioni in merito AWS RAM, consulta la [Guida AWS RAM per l'utente](https://docs.aws.amazon.com/ram/latest/userguide/). Per ulteriori informazioni sulla gestione delle risorse condivise, vedere [Utilizzo AWS delle risorse condivise](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-shared.html) nella *Guida per l'AWS RAM utente*.
Come *account di condivisione*, puoi impostare la sola lettura o read/write entrambe le risorse che desideri condividere. Queste autorizzazioni determinano le operazioni che *un account utente* può eseguire sulle risorse condivise con lui.
+ **Account di condivisione**: la risorsa condivisa e in cui l' AWS RAM amministratore crea la condivisione di AWS risorse utilizzando AWS RAM.
+ **Account di consumo**: Account AWS la risorsa con cui viene condivisa una risorsa. La condivisione delle risorse può specificare un intero account come principale o, per alcuni tipi di risorse, singoli ruoli o utenti dell'account.
Per condividere un' Marketplace AWS entità, è necessario aggiungerla a una condivisione di risorse. Una condivisione di risorse è una risorsa AWS RAM che consente di condividere le risorse tra Account AWS. Una condivisione di risorse specifica le risorse da condividere e i consumatori con cui sono condivise. Quando condividi un'entità utilizzando la Marketplace AWS console, la aggiungi a una condivisione di risorse esistente. Per aggiungere l' Marketplace AWS entità a una nuova condivisione di risorse, devi prima creare la condivisione di risorse utilizzando la [AWS RAM console](https://console.aws.amazon.com/ram).
Puoi condividere un' Marketplace AWS entità di tua proprietà utilizzando la Marketplace AWS console, la AWS RAM console o AWS Command Line Interface (AWS CLI).
**Per condividere un Marketplace AWS entità che possiedi utilizzando il AWS RAM console**
Consulta [Creazione di una condivisione di risorse](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) in *Guida per l'utente di AWS RAM *.
**Per condividere un Marketplace AWS entità che possiedi utilizzando il AWS CLI**
Utilizza il comando [https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).
**Nota**
Per i tipi di risorse, ad esempio le entità che supportano le politiche basate sulle risorse, è possibile utilizzare AWS RAM per condividere le risorse per utilizzare funzionalità aggiuntive. AWS RAM *Per ulteriori informazioni, consulta la [Resource-based policy nella Guida](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-terms-and-concepts.html#term-resource-based-policy) per l'AWS RAM utente.* AWS RAM utilizza il AWS Marketplace Catalog API per costruire automaticamente la politica delle risorse in base alle autorizzazioni in una condivisione di risorse e gestisce tale politica per conto dell'utente.
*Per informazioni su come impostare, visualizzare o eliminare le politiche AWS basate sulle risorse sulla tua Marketplace AWS entità tramite AWS RAM, consulta [Consentire azioni su tutte le risorse](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/api-access-control.html#allowing-actions-on-all-resources) nella Guida per l'utente. *AWS RAM**
### Differenze tra la condivisione di un'entità tramite AWS RAM e il AWS Marketplace Catalog API
Oltre a condividere la tua entità tramite AWS RAM, puoi anche impostare, visualizzare o eliminare le politiche AWS basate sulle risorse relative alle tue entità tramite. AWS Marketplace Catalog API Tuttavia, ci sono alcune differenze tra la condivisione dell'entità tramite AWS RAM e tramite. AWS Marketplace Catalog API
Quando condividi un'entità tramite AWS RAM:
+ Se condividi la tua entità con account esterni AWS Organizations, l'account consumatore deve prima accettare la tua richiesta di condivisione prima che l'entità venga condivisa.
+ L'account consumatore può scoprire l'entità condivisa `ListEntities` tramite `OwnershipType` set to`SHARED`.
+ È necessario rispettare diverse quote di risorse. Per maggiori informazioni, consulta [Service Quotas di AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/service-quotas.html) nella *Guida per l’utente di AWS RAM *.
Quando condividi un'entità tramite: AWS Marketplace Catalog API
+ La tua entità verrà condivisa non appena la `PutResourcePolicy` richiesta avrà esito positivo senza alcun input da parte dell'account consumatore.
+ L'account utente non può scoprire l'entità condivisa `ListEntities` tramite `OwnershipType` set to`SHARED`. Il proprietario dell'account di condivisione deve invece comunicare all'account consumatore l'ID dell'entità condivisa.
**Nota**
Se il tuo caso d'uso richiede la condivisione di risorse che potrebbero superare le quote di AWS RAM servizio o se desideri condividere risorse senza l'input diretto dell'account utente, valuta la possibilità di condividerle tramite. AWS Marketplace Catalog API Per tutti gli altri casi d'uso, prendi in considerazione l'utilizzo AWS RAM per condividere Marketplace AWS le risorse.
Le seguenti sezioni descrivono in dettaglio come impostare, visualizzare o eliminare le politiche AWS basate sulle risorse sulle entità tramite. AWS Marketplace Catalog API
**Topics**
+ [Differenze tra la condivisione di un'entità tramite AWS RAM e il AWS Marketplace Catalog API](#differences-ram-capi)
+ [Allega una politica di sola lettura alla tua risorsa](#read-only-policy-resource)
+ [Allega la politica di lettura e scrittura delle risorse alla tua risorsa](#read-and-write-resource-policy)
+ [Visualizza la politica delle risorse impostata sulla tua risorsa](#view-resource-policy-set)
+ [Elimina la politica relativa alle risorse sulla tua risorsa](#delete-resource-policy)
+ [Visualizza tutte le risorse di tua proprietà e condivise con te](#view-entities-owned)
### Allega una politica di sola lettura alla tua risorsa
Puoi creare una politica basata su risorse di sola lettura sulla tua risorsa condivisa utilizzando un account di condivisione. Con questa politica, il responsabile può solo visualizzare i dettagli della risorsa condivisa con lui.
Richiesta
```
POST /PutResourcePolicy HTTP/1.1
Content-type: application/json
{
"ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
"Policy": {
"Version": "2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::222233334444:root"
},
"Action": [
"aws-marketplace:DescribeEntity"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
]
}
}
}
```
Risposta
```
HTTP/1.1 200
Content-type: application/json
{}
```
### Allega la politica di lettura e scrittura delle risorse alla tua risorsa
Come account di condivisione, puoi creare una politica di lettura e scrittura basata sulle risorse sulla tua risorsa condivisa. Grazie a questa politica, il responsabile può visualizzare i dettagli ed eseguire operazioni di scrittura sulla risorsa condivisa con lui.
Richiesta
```
POST /PutResourcePolicy HTTP/1.1
Content-type: application/json
{
"ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
"Policy": {
"Version": "2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::222233334444:root"
},
"Action": [
"aws-marketplace:DescribeEntity",
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
]
}
}
}
```
Risposta
```
HTTP/1.1 200
Content-type: application/json
{}
```
### Visualizza la politica delle risorse impostata sulla tua risorsa
Come account di condivisione, puoi visualizzare la politica delle risorse impostata sulla tua risorsa condivisa.
Richiesta
```
POST /GetResourcePolicy HTTP/1.1
Content-type: application/json
{
"ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}
```
Risposta
```
HTTP/1.1 200
Content-type: application/json
{
"Policy": {
"Version": "2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::222233334444:root"
},
"Action": [
"aws-marketplace:DescribeEntity",
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
]
}
}
}
```
### Elimina la politica relativa alle risorse sulla tua risorsa
Come account di condivisione, puoi eliminare la politica delle risorse impostata sulla risorsa condivisa.
Richiesta
```
POST /DeleteResourcePolicy HTTP/1.1
Content-type: application/json
{
"ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}
```
Risposta
```
HTTP/1.1 200
Content-type: application/json
{}
```
### Visualizza tutte le risorse di tua proprietà e condivise con te
In qualità di account utente, puoi visualizzare le risorse condivise con te.
**Nota**
Puoi visualizzare le risorse condivise con te solo se le risorse sono state condivise tramite AWS RAM.
Richiesta
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "AmiProduct",
"FilterList": [
{
"Name": "EntityId",
"ValueList": [ "example2-abcd-1234-5ef6" ]
}
],
"OwnershipType": "SHARED"
}
```
Risposta
```
HTTP/1.1 200
Content-type: application/json
{
"EntitySummaryList": [
{
"EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
"EntityId": "example2-abcd-1234-5ef6",
"EntityType": "AmiProduct",
"LastModifiedDate": "2018-02-27T13:45:22Z",
"Name": "TestProduct",
"Visibility": "public"
}
],
"NextToken": ""
}
```