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

# Collabora con il marketplace privato utilizzando Marketplace AWS "Hello, World\!"
<a name="work-with-private-marketplace"></a>

Puoi utilizzarlo AWS Marketplace Catalog API per gestire un *marketplace privato* per la tua Account AWS [organizzazione](https://docs.aws.amazon.com/organizations/latest/userguide/).

Tutti i tipi di modifica possono essere richiamati solo dall'account di gestione dell'organizzazione o da un account membro che funge da amministratore delegato per il marketplace privato. Se attualmente sei un cliente di Private Marketplace e non AWS Organizations disponi dell'integrazione per Private Marketplace, puoi creare e gestire un marketplace privato da qualsiasi account della tua organizzazione che disponga della policy `AWSPrivateMarketplaceAdminFullAccess` IAM.

 Per ulteriori informazioni sui marketplace privati, consulta [Private Marketplaces](https://docs.aws.amazon.com/marketplace/latest/buyerguide/private-marketplace.html) nella Guida all'*Marketplace AWS acquisto*. 

 La tabella seguente descrive in dettaglio una serie di attività per la gestione dei marketplace privati e i tipi di modifica applicabili a ciascuna attività. 


| Operazione | Azione | Tipi di modifica | 
| --- | --- | --- | 
| [Creazione di un marketplace privato](#creating-a-private-marketplace) | `StartChangeSet` | `CreateExperience`<br />`CreateProcurementPolicy` | 
| [Modificare il branding di un'esperienza di marketplace privato](#private-marketplace-branding) | `StartChangeSet` | `CreateBrandingSettings`<br />`UpdateBrandingSettings` | 
| [Attivazione o disabilitazione di un'esperienza di marketplace privata](#enable-private-marketplace) | `StartChangeSet` | `UpdateExperience` | 
| [Abilitazione o disabilitazione delle richieste degli utenti](#private-marketplace-user-requests) | `StartChangeSet` | `UpdateProcurementPolicy` | 
| [Ottenere un elenco di prodotti in un'esperienza di marketplace privata](#private-marketplace-policy-details) | `DescribeEntity` | Non applicabile | 
| [Aggiungere o rimuovere prodotti da un marketplace privato](#private-marketplace-add-products) | `StartChangeSet` | `AllowProductProcurement`<br />`DenyProductProcurement` | 
| [Ricerca di prodotti](#finding-product-ids) | Non applicabile | Non applicabile | 
| [Collaborazione con marketplace privati per AWS Organizations](#private-marketplace-organizations) | Non applicabile | Non applicabile | 
| [Associare i principi alle esperienze](#private-marketplace-associate-accounts) | `StartChangeSet` | `AssociateAudience`<br />`DisassociateAudience` | 
| [Archiviazione e riattivazione di un'esperienza di marketplace privata](#archiving-and-reactivating-a-private-marketplace-experience-capi) | `StartChangeSet` | `RestrictExperience`<br />`ReviveExperience` | 

## Creazione di un marketplace privato
<a name="creating-a-private-marketplace"></a>

Un marketplace privato per un utente Account AWS può essere considerato come un elenco di prodotti che gli utenti possono acquistare tramite quell'account e il marchio per il marketplace. In un'organizzazione con più account, puoi utilizzare il raggruppamento AWS Organizations chiamato [unità organizzativa (OU)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#organizationalunit) per associarlo a un'esperienza. Ad esempio, potresti avere un set di prodotti che tutti gli account dell'organizzazione sono autorizzati ad acquistare oppure potresti avere un elenco di prodotti diverso per ogni unità organizzativa dell'organizzazione. È inoltre possibile disporre di un elenco diverso di prodotti per i singoli account dell'organizzazione. *Ogni elenco di prodotti e marchi approvati viene definito esperienza di approvvigionamento.* 

In AWS Marketplace Catalog API, quattro entità rappresentano un'esperienza:
+ `Experience`entità: questa entità è al livello più alto dell'esperienza e contiene due entità figlie.
+ `ProcurementPolicy`entità: questa entità rappresenta i prodotti che sono stati consentiti e rifiutati nel tuo marketplace privato.
+ `BrandingSettings`entità: puoi anche creare un'`BrandingSettings`entità per definire l'aspetto del tuo marketplace privato per i tuoi utenti. 
+ `Audience`entità: devi anche associare una o più `Audience` entità, che definiscono l'insieme di Account AWS unità organizzative o l'organizzazione a cui si applica l'esperienza.

I passaggi per creare un'esperienza di approvvigionamento sono i seguenti:

1. Crea l'`Experience`entità.

1. Crea un'`ProcurementPolicy`entità per archiviare l'elenco dei prodotti consentiti o rifiutati per l'esperienza.

1. (Facoltativo) Crea un'`BrandingSettings`entità per personalizzare l'aspetto della tua esperienza sul marketplace.

1. Associa i principi alla tua esperienza. Un preside può essere un' Account AWS unità organizzativa o l'organizzazione.

1. Abilita l'esperienza.

**Nota**  
Se il tuo account fa parte di un'organizzazione in AWS Organizations, consulta[Collaborazione con marketplace privati per AWS Organizations](#private-marketplace-organizations).

**Crea l'`Experience`entità**

Per creare l'`Experience`entità, utilizza l'`StartChangeSet`azione con il `CreateExperience` valore del `ChangeType` parametro da cui richiedere la creazione dell'esperienza Marketplace AWS. Vedere l'esempio di codice seguente.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateExperience",
      "DetailsDocument":
      {
        "Name": "ExamplePrivateMarketplace"
      },
      "Entity":
      {
        "Type": "Experience@1.0"
      }
    }
  ],
  "ChangeSetName": "Create Private Marketplace Example"
}
```

In questa azione, `Entity` è un modello per l'entità che desideri creare. Gli viene assegnato un al `EntityId` momento della creazione. `ChangeSetName`identifica la modifica per aiutarti a trovarla in un secondo momento.

La risposta avrà il seguente aspetto.

```
{
   "ChangeSetArn": "arn:...:AWSMarketplace/ChangeSet/abcd1234example5678frjzkz",
   "ChangeSetId": "abcd1234example5678frjzkz"
}
```

La risposta include un messaggio `ChangeSetId` che è possibile utilizzare per conoscere lo stato della richiesta di modifica man mano che viene elaborata`DescribeChangeSet`. Puoi anche usarla `ListEntities` per trovare la tua `Experience` entità senza il`ChangeSetId`. Per ulteriori informazioni sui set di modifiche, consulta [Utilizzo dei set di modifiche](catalog-apis.md#working-with-change-sets).

Per impostazione predefinita, `Experience` un'entità appena creata non dispone di una politica di approvvigionamento. Viene inoltre creata con impostazioni predefinite per il branding. Per ulteriori informazioni sulle impostazioni di branding e su come personalizzarle, consulta. [Modificare il branding di un'esperienza di marketplace privato](#private-marketplace-branding)

**Crea un'entità `ProcurementPolicy`**

È necessario creare un'`ProcurementPolicy`entità. Per impostazione predefinita, una nuova `Experience` entità è disabilitata, quindi è possibile creare la politica di approvvigionamento prima di abilitarla.

**Nota**  
Un'`Experience`entità *senza* una politica di approvvigionamento (null) consente l'approvvigionamento di tutti i prodotti nel proprio marketplace privato. Un'`Experience`entità con una politica di approvvigionamento *vuota* non dispone di prodotti che gli utenti possano acquistare.

Per consentire o rifiutare i prodotti nel tuo marketplace privato, devi creare la politica di approvvigionamento. Per farlo, chiamate di nuovo`StartChangeSet`, ma questa volta con il `ChangeType` consenso di. `CreateProcurementPolicy` Il seguente esempio di codice crea una politica di approvvigionamento vuota.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateProcurementPolicy",
      "DetailsDocument":
      {
        "Name": "ExampleProcurementPolicy"
      },
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example@1"
      }
    }
  ]
}
```

L'`Entity`entità fornita in questa azione è l'`Experience`entità all'interno della quale si desidera creare la politica di approvvigionamento, quindi è necessario includere l'identificatore dell'entità creata in precedenza. Usa `ListEntities` per trovare l'entità. `Experience` È inoltre possibile restituire l'identificatore utilizzando l'`DescribeChangeSet`identificatore del set di modifiche dell'azione `CreateExperience`

**Nota**  
Questo esempio mostra l'identificatore con una revisione di. `1` Per ulteriori informazioni sulle revisioni degli identificatori, vedere. [Identificatore](catalog-apis.md#identifier)

Puoi nuovamente utilizzare `DescribeChangeSet` il tipo di `CreateProcurementPolicy` modifica per seguire l'elaborazione della tua richiesta.

**Nota**  
I nomi che dai `Experience` e in cui `ProcurementPolicy` gli oggetti non vengono visualizzati Marketplace AWS. I nomi servono solo per facilitare la ricerca delle entità nell'API.

Dopo aver creato la politica di approvvigionamento, il tuo marketplace privato viene visualizzato in. Console di gestione AWS(Puoi andare alla [pagina Private Marketplace](https://aws.amazon.com/marketplace/privatemarketplace) per vederlo.) Dopo aver completato questi passaggi, il tuo marketplace privato verrà disabilitato, avrà un marchio predefinito, avrà una politica di approvvigionamento vuota e non sarà associato a nessun responsabile della tua organizzazione. Puoi aggiornare il marchio e aggiungere tutti i prodotti che desideri, associare l'esperienza a uno o più account e quindi abilitare il tuo marketplace privato.

Le sezioni seguenti descrivono la gestione del tuo marketplace privato con. AWS Marketplace Catalog API

## Modificare il branding di un'esperienza di marketplace privato
<a name="private-marketplace-branding"></a>

Puoi personalizzare l'aspetto del tuo marketplace privato per i tuoi utenti. Senza personalizzazione, il tuo marketplace privato avrà le impostazioni di branding predefinite, descritte di seguito. Gli aspetti del branding che puoi modificare in un marketplace privato includono quanto segue:
+ `Title`— Il nome visualizzato per il tuo marketplace privato. È lo stesso del campo **Nome** nella schermata **delle impostazioni del profilo del** marketplace privato. Se imposti su**Example**, `Title` il testo visualizzato è **Example Private Marketplace**. L'impostazione predefinita è **Private Marketplace**.
+ `Information`— Il paragrafo visualizzato sotto il nome nel tuo marketplace privato. È lo stesso del campo **Descrizione** nelle **impostazioni del profilo**. L'impostazione predefinita è nessuna informazione, nel qual caso viene visualizzata una descrizione generale dei marketplace privati.
+ `ThemeColor`— Il colore visualizzato nel banner del tuo marketplace privato. Si tratta di un colore in formato esadecimale RGB. **Questo valore è lo stesso del campo **Colore del tema** nelle impostazioni del profilo.** Il valore predefinito è `#232F3E`.
+ `LogoUrl`— L'URL che rimanda a un file di immagine da utilizzare come logo sul tuo marketplace privato. L'URL deve essere disponibile pubblicamente (ad esempio, un URL Amazon S3 firmato). Il file deve essere un file.png o .svg e avere una dimensione inferiore a 500 kb. Se necessario, il file di immagine verrà ridimensionato a un'altezza massima di 30 pixel e una larghezza massima di 100 pixel. È lo stesso valore di **Logo** **Select** nelle **impostazioni del profilo**. L'impostazione predefinita è quella di non mostrare un logo.

Per impostare questi valori, devi prima creare un'`BrandingSettings`entità con il tipo di `CreateBrandingSettings` modifica. Puoi quindi richiedere una `UpdateBrandingSettings` modifica per impostare o modificare il marchio. Devi creare un `BrandingSettings` oggetto solo una volta. Per creare questo oggetto, chiamate `StartChangeSet` con il tipo di `CreateBrandingSettings` modifica, come mostrato nel seguente esempio di codice.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateBrandingSettings",
      "DetailsDocument":
      {
        "Name": "ExampleBrandingSettingsName"
      },
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example@2"
      }
    }
  ]
}
```

Questo esempio modifica l'`Experience`entità aggiungendovi l'`BrandingSettings`oggetto. La revisione dell'identificatore di entità è stata incrementata a. `2` Per ulteriori informazioni sulle revisioni degli identificatori, vedere. [Identificatore](catalog-apis.md#identifier)

**Nota**  
Puoi specificare tutti i dettagli delle impostazioni di branding nella chiamata per creare l'entità delle impostazioni di branding. L'aspetto dei dettagli è lo stesso per e. `CreateBrandingSettings` `UpdateBrandingSettings`

È possibile modificare le impostazioni chiamando `StartChangeSet` con il tipo di `UpdateBrandingSettings` modifica. Le impostazioni fanno parte `Configuration` dell'`DetailsDocument`oggetto.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateBrandingSettings",
      "DetailsDocument":
      {
        "Name": "ExampleBrandingSettingsName",
        "Description": "Example description",
        "Configuration":
        {
          "Title": "ExampleName",
          "Information": "Example description.",
          "ThemeColor": "#0e7f74",
          "LogoUrl": "https://example.com/path/mylogo.png"
        }
      },
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example@3"
      }
    }
  ]
}
```

**Nota**  
L'URL del logo viene utilizzato per crearne una copia durante la modifica dell'aggiornamento. Una volta completata la modifica, se rimuovi o modifichi l'URL in quel percorso, ciò non influirà sul tuo marketplace privato, a meno che tu non lo richieda nuovamente`UpdateBrandingSettings`.

## Attivazione o disabilitazione di un'esperienza di marketplace privata
<a name="enable-private-marketplace"></a>

Quando un marketplace privato è abilitato (e dispone di una politica di approvvigionamento), gli utenti degli account associati possono acquistare solo i prodotti che hai approvato. Quando non è abilitata un'esperienza di marketplace privato per un account, gli utenti possono acquistare prodotti nell'intero Marketplace AWS catalogo.

Per abilitare un marketplace privato, utilizza l'`StartChangeRequest`azione con il tipo di `UpdateExperience` modifica.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateExperience",
      "DetailsDocument":
      {
        "Status": "Enabled"
      },
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example@4"
      }
    }
  ]
}
```

Allo stesso modo, puoi utilizzare la stessa azione e`ChangeType`, tuttavia, modificarla `Status` in `DetailsDocument` `Disabled` per disabilitare un marketplace privato.

**Nota**  
La disattivazione di un marketplace privato mantiene l'elenco dei prodotti consentiti e rifiutati, nonché le personalizzazioni, come il branding. Quando un marketplace privato è disabilitato, gli utenti non vedono più il marketplace privato (sebbene possano comunque essere regolati dall'esperienza predefinita dell'organizzazione). Se non ci sono esperienze di marketplace private abilitate per un account, tutte le restrizioni vengono rimosse e gli utenti possono acquistare qualsiasi prodotto al pubblico Marketplace AWS.

## Abilitazione o disabilitazione delle richieste degli utenti
<a name="private-marketplace-user-requests"></a>

Gli utenti della tua organizzazione possono visualizzare il pubblico completo Marketplace AWS, ma possono abbonarsi solo ai prodotti che hai consentito. Per impostazione predefinita, possono richiedere l'aggiunta di un prodotto che non si trova nel marketplace privato. Queste richieste vengono visualizzate nella pagina dell'amministratore del marketplace [privato (Private Marketplace](https://aws.amazon.com/marketplace/privatemarketplace/admin/)), dove puoi decidere se accettare o rifiutare la richiesta (e se bloccare ulteriori richieste per lo stesso prodotto). Non puoi visualizzare o rispondere alle richieste utilizzando l'API Catalog.

Puoi abilitare o disabilitare la possibilità per gli utenti di creare richieste per la tua esperienza di marketplace privata. Da utilizzare `StartChangeSet` con il tipo di `UpdateProcurementPolicy` modifica. La possibilità di effettuare richieste è disabilitata nel seguente esempio di codice.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateProcurementPolicy",
      "DetailsDocument":
      {
        "Configuration":
        {
          "PolicyResourceRequests": "Deny"
        }
      },
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example@5"
      }
    }
  ]
}
```

Per abilitare la funzionalità di richiesta di modifica per gli utenti, usa `Allow` invece di `Deny` in`PolicyResourceRequests`.

Per informazioni su come ottenere lo stato corrente di questa impostazione, consulta la sezione successiva,[Ottenere un elenco di prodotti in un'esperienza di marketplace privata](#private-marketplace-policy-details).

## Ottenere un elenco di prodotti in un'esperienza di marketplace privata
<a name="private-marketplace-policy-details"></a>

I prodotti consentiti (e rifiutati) in un marketplace privato fanno parte della politica di approvvigionamento dell'`Experience`entità. Per ottenere i dettagli sulle politiche di approvvigionamento in un marketplace privato, devi prima ottenere l'identificatore della politica di approvvigionamento dall'`Experience`entità, quindi chiamare `DescribeEntity` con quell'identificatore.

Per ottenere l'identificatore della politica di approvvigionamento, utilizzalo `DescribeEntity` sull'`Experience`entità che ti interessa, come mostrato nel comando seguente.

```
GET /DescribeEntity?catalog=AWSMarketplace&entityId={{exp-example01}}
```

Di seguito è riportata una risposta di esempio:

```
{
  "Details": "{\"Name\":\"New Private Marketplace\", \"Status\":\"Enabled\", \"ProcurementPolicies\":[\"procpolicy-123example456\"], \"BrandingSettings\":[\"brandsettings-456example123\"]}",
  "DetailsDocument":
  {
    "Name": "New Private Marketplace",
    "Status": "Enabled",
    "ProcurementPolicies":
    [
      "procpolicy-123example456"
    ],
    "BrandingSettings":
    [
      "brandsettings-456example123"
    ]
  },
  "EntityArn": "arn:<...>:AWSMarketplace/Experience/exp-example-01",
  "EntityIdentifier": "exp-example01@6",
  "EntityType": "Experience@1.0",
  "LastModifiedDate": "2021-01-13T20:31:36Z"
}
```

**Nota**  
L'`DetailsDocument`attributo contiene i dettagli dell'entità come oggetto JSON. L'`Details`attributo legacy contiene lo stesso oggetto JSON di una stringa. 

È possibile utilizzare il comando restituito `EntityId` per la politica di approvvigionamento per ottenere i dettagli, come illustrato nel comando seguente.

```
GET /DescribeEntity?catalog=AWSMarketplace&entityId={{procpolicy-123example456}}
```

Ciò restituisce i dettagli completi della politica, inclusi i prodotti consentiti e quelli rifiutati. Di seguito è riportata una risposta di esempio:

```
{
  "Details": "{\"Name\":\"ExampleProcurementPolicy\", \"Statements\":[{\"Effect\":\"Allow\",\"Resources\":[{\"Type\":\"Product\",\"Ids\":[\"example1-1234-abcd-5678-90abcdef1234\"]},{\"Type\":\"Product\",\"Ids\":[\"example2-2345-bcde-6789-01bcdea2345\"]}]},{\"Effect\":\"Deny\",\"Resources\":[{\"Type\":\"Product\",\"Ids\":[\"example3-3456-cdef-7890-12defabc5678\"]}]}],\"Configuration\":{\"PolicyResourceRequests\":\"Allow\"}}",
  "DetailsDocument":
  {
    "Name": "ExampleProcurementPolicy",
    "Statements":
    [
      {
        "Effect": "Allow",
        "Resources":
        [
          {
            "Type": "Product",
            "Ids":
            [
              "example1-1234-abcd-5678-90abcdef1234"
            ]
          },
          {
            "Type": "Product",
            "Ids":
            [
              "example2-2345-bcde-6789-01bcdea2345"
            ]
          }
        ]
      },
      {
        "Effect": "Deny",
        "Resources":
        [
          {
            "Type": "Product",
            "Ids":
            [
              "example3-3456-cdef-7890-12defabc5678"
            ]
          }
        ]
      }
    ],
    "Configuration":
    {
      "PolicyResourceRequests": "Allow"
    }
  },
  "EntityArn": "arn:<...>AWSMarketplace/ProcurementPolicy/procpolicy-123example456",
  "EntityIdentifier": "procpolicy-123example456@4",
  "EntityType": "ProcurementPolicy@1.0",
  "LastModifiedDate": "2020-10-01T12:00:00Z"
}
```

In questo esempio, la politica di approvvigionamento prevede due prodotti consentiti e un prodotto negato. La politica consente le richieste di risorse degli utenti.

## Aggiungere o rimuovere prodotti da un marketplace privato
<a name="private-marketplace-add-products"></a>

Per impostazione predefinita, un marketplace privato non contiene prodotti approvati. Utilizza le richieste di modifica per aggiungere o rimuovere un prodotto. Per aggiungere un prodotto, usa il tipo di `AllowProductProcurement` modifica. Per rimuovere un prodotto, usa il tipo di `DenyProductProcurement` modifica. 

Il seguente esempio di codice mostra il tipo di `AllowProductProcurement` modifica con l'`StartChangeSet`azione per aggiungere un prodotto a un marketplace privato.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "AllowProductProcurement",
      "DetailsDocument":
      {
        "Products":
        [
          {
            "Ids":
            [
              "example-1234-abcd-5678-90abcded1234"
            ],
            "Notes": "Useful product"
          }
        ]
      },
      "Entity":
      {
        "Identifier": "exp-1234example@6",
        "Type": "Experience@1.0"
      }
    }
  ]
}
```

Aggiungi il prodotto all'`Experience`entità per un marketplace privato utilizzando`AllowProductProcurement`. La sintassi per rimuovere un prodotto da un marketplace privato è identica, con l'eccezione che utilizzi `DenyProductProcurement` `ChangeType` invece di`AllowProductProcurement`. I prodotti vengono aggiunti all'elenco consentito (o negato) dell'`ProcurementPolicy`entità contenuta dall'entità. `Experience`

**Nota**  
L'elenco dei prodotti oggetto `DetailsDocument` della modifica è composto da una serie di prodotti`Ids`, quindi puoi aggiungere (o rimuovere) più prodotti con una sola chiamata includendo un elenco di identificatori del prodotto. Il limite è di 50 prodotti per singola richiesta.  
Il `Notes` campo per l'elenco di non `Ids` è obbligatorio. Tuttavia, è possibile utilizzarlo per registrare il motivo per cui è stata presa la decisione di consentire o rifiutare una serie di prodotti.

## Ricerca di prodotti
<a name="finding-product-ids"></a>

Consultando i dettagli della tua politica di approvvigionamento, puoi trovare gli ID dei prodotti che sono già presenti su un marketplace privato. Tuttavia, AWS Marketplace Catalog API non fornisce un modo per trovare gli ID di prodotto di altri prodotti. Esistono due modi per ottenere gli ID dei prodotti da utilizzare con il servizio Catalog API:
+ **Marketplace pubblico**: dopo aver trovato un prodotto nel marketplace pubblico, scegli **Continua con l'iscrizione per** visualizzare una pagina dei dettagli sul prodotto (non ti abbonerà al prodotto). L'URL includerà l'ID del prodotto come parametro. Ad esempio, nell'URL `https://aws.amazon.com/marketplace/fulfillment?productId=ab1234cd-1234-abcd-5678-90abcdef1234&ref_=dtl_psb_continue` {{ab1234cd-1234-abcd-5678-90abcdef1234}} c'è l'ID del prodotto.
+ **Marketplace AWS Discovery API**: a livello di codice, puoi accedere all'elenco completo dei prodotti Marketplace AWS utilizzando l'API Discovery. L'API Discovery è un'API privata. È necessario richiedere l'accesso per poterla utilizzare. Per ulteriori informazioni, consulta [Controllo degli accessi per Marketplace AWS API Discovery](discovery-api-access-control.md). 

## Collaborazione con marketplace privati per AWS Organizations
<a name="private-marketplace-organizations"></a>

Sia che lavori con un marketplace privato per il tuo account o per la tua organizzazione, utilizzi la stessa API. Tuttavia, ci sono delle differenze quando si lavora all'interno della propria organizzazione:
+ Prima di poter utilizzare la funzionalità del marketplace privato in un'organizzazione, devi [abilitare l'accesso affidabile](https://docs.aws.amazon.com/organizations/latest/APIReference/API_EnableAWSServiceAccess.html) per fornire al servizio di marketplace privato (`private-marketplace.marketplace.amazonaws.com`) l'accesso ai tuoi AWS Organizations dati. È inoltre necessario [creare il ruolo collegato al servizio di marketplace privato](https://docs.aws.amazon.com/organizations/latest/APIReference/API_EnableAWSServiceAccess.html) nell'account di gestione. Questo ruolo include tutte le autorizzazioni richieste da Private Marketplace per descrivere AWS Organizations e aggiornare le risorse del marketplace privato per tuo conto. Queste azioni possono essere eseguite solo dall'account di gestione. Si consiglia di eseguire questa abilitazione utilizzando la pagina di amministratore del marketplace privata. *Se sei un nuovo cliente, consulta la sezione [Mercati privati nella Guida](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-using-service-linked-roles.html) all'Marketplace AWS acquisto.* Se sei già cliente, consulta la sezione [Creazione e gestione di un marketplace privato](https://docs.aws.amazon.com/marketplace/latest/buyerguide/private-catalog-administration.html) nella *Guida all'Marketplace AWS acquisto*. 
+ Le risorse del marketplace privato di un'organizzazione vengono create nell'account di gestione e condivise con l'account membro che funge da amministratore delegato per il marketplace privato.
+ Quando pubblichi oggetti in un marketplace privato da un account membro che è amministratore delegato del marketplace privato, devi richiederli specificamente con il `SharedWithMe` filtro. Questo vale per entrambe le `ListEntities` `ListChangeSets` azioni.

Per elencare `Experience` gli oggetti nel tuo account, chiama `ListEntities` come mostrato nel seguente esempio di codice.

```
POST /ListEntities HTTP/1.1
Content-Type: application/json

{
    "Catalog":"AWSMarketplace", 
    "EntityType":"Experience"
}
```

Tuttavia, per elencare le entità che sono state condivise con te, devi aggiungere un `FilterList` con a `Scope` of`SharedWithMe`, come illustrato nel seguente esempio di codice. Di conseguenza, Marketplace AWS cerca al di fuori del tuo account per trovare le entità condivise con te.

```
POST /ListEntities HTTP/1.1
Content-Type: application/json

{"Catalog":"AWSMarketplace", 
"EntityType":"Experience",
 "FilterList": 
  [{
     "Name": "Scope",
     "ValueList":
      ["SharedWithMe"]
      }]}
```

In questo caso, vengono restituite solo le entità esterne al tuo account (quelle della tua organizzazione).

Analogamente, per chiamare`ListChangeSets`, è necessario impostare l'ambito, come illustrato nel seguente esempio di codice.

```
POST /ListChangeSets HTTP/1.1
Content-Type: application/json

{"Catalog":"AWSMarketplace", 
 "FilterList": 
  [{
     "Name": "Scope",
     "ValueList":
      ["SharedWithMe"]
      }]}
```

Ciò restituisce i set di modifiche che si applicano a un marketplace privato condiviso per l'organizzazione.

## Associare i principi alle esperienze
<a name="private-marketplace-associate-accounts"></a>

Un'esperienza di mercato privato deve essere associata a uno o più principi per avere effetti sull'organizzazione. Per una singola Account AWS persona, devi associare l'account all'esperienza per utilizzare il marketplace privato. In un'organizzazione, puoi avere più esperienze applicate a diversi dirigenti. 

**Nota**  
L'esperienza associata all'organizzazione è l'impostazione predefinita per tutti gli altri account dell'organizzazione. L'associazione di un account membro o di un'unità organizzativa a un'esperienza diversa imposta direttamente un'esperienza diversa per l'account membro o gli account figlio dell'unità organizzativa.
Se sei attualmente cliente di Private Marketplace senza l' AWS Organizations integrazione per Private Marketplace, l'esperienza associata all'account di gestione è l'impostazione predefinita per tutti gli altri account dell'organizzazione.

Per associare un responsabile a un'esperienza, utilizza il tipo di `AssociateAudience` modifica all'`StartChangeSet`azione, come illustrato nel seguente esempio di codice.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-example01@1"
      },
      "ChangeType": "AssociateAudience",
      "DetailsDocument":
      {
        "Name": "AudienceName",
        "Description": "Audience example.",
        "Principals":
        [
          "012345678901",
          "ou-abcd-01234567",
          "o-0123456789"
        ]
      }
    }
  ],
  "ChangeSetName": "Set Audience for experience 01"
}
```

Il *pubblico* è l'elenco *dei principali* associati a. `Experience` Un principale è un' Account AWS unità organizzativa o un'organizzazione definita dal relativo ID. `Principals`è un elenco, quindi puoi includere più presidi da associare all'esperienza. Dopo la prima chiamata, le chiamate successive al tipo di `AssociateAudience` modifica aggiungeranno i principali all'associazione per l'esperienza.

Puoi anche rimuovere account da un'esperienza. A tale scopo, utilizzate il tipo di `DisassociateAudience` modifica, come illustrato nel seguente esempio di codice.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-example01@02"
      },
      "ChangeType": "DisassociateAudience",
      "DetailsDocument":
      {
        "Principals":
        [
          "012345678901",
          "ou-abcd-01234567",
          "o-0123456789"
        ]
      }
    }
  ],
  "ChangeSetName": "Disassociate audience example"
}
```

**Nota**  
Un preside può essere associato direttamente a una sola esperienza. Per far passare un preside dall'essere direttamente associato a un'esperienza a un'altra, è necessario dissociarlo dall'esperienza iniziale e quindi associarlo alla seconda.

## Archiviazione e riattivazione di un'esperienza di marketplace privata
<a name="archiving-and-reactivating-a-private-marketplace-experience-capi"></a>

Puoi rimuovere un'esperienza di marketplace privata archiviandola. Le esperienze archiviate non possono essere aggiornate o utilizzate per gestire gli account della tua organizzazione. Se hai dei segmenti di pubblico associati a un'esperienza archiviata, puoi associarli a un'esperienza diversa. Se decidi di utilizzare l'esperienza in un secondo momento, puoi sempre riattivarla. Gli amministratori dell'account di gestione o di un account membro che è amministratore delegato di Private Marketplace dispongono delle autorizzazioni per archiviare e riattivare le esperienze. Se sei attualmente cliente di Private Marketplace e non disponi dell' AWS Organizations integrazione per Private Marketplace, gli amministratori dell'account che ha creato l'esperienza dispongono delle autorizzazioni per archiviare e riattivare le esperienze.

**Nota**  
Prima di archiviare un'esperienza, devi disabilitarla. *Per informazioni sulla disabilitazione di un'esperienza, consulta [Configurazione del marketplace privato nella Guida](https://docs.aws.amazon.com/marketplace/latest/buyerguide/private-catalog-administration.html#configure-your-private-marketplace) all'Marketplace AWS acquisto.*

Per archiviare un'esperienza, utilizza il tipo di `RestrictExperience` modifica con l'`StartChangeSet`azione, come mostrato nel seguente esempio di codice.

```
POST /StartChangeSet HTTP/1.1 
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "RestrictExperience",
      "DetailsDocument":
      {},
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example"
      }
    }
  ]
}
```

Per riattivare un'esperienza, usa il tipo di `ReviveExperience` modifica con l'`StartChangeSet`azione, come mostrato nel seguente esempio di codice.

```
POST /StartChangeSet HTTP/1.1 
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "ReviveExperience",
      "DetailsDocument":
      {},
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example"
      }
    }
  ]
}
```

## Errori nell'API del marketplace privato
<a name="private-marketplace-error-codes"></a>

I seguenti errori sono specifici delle azioni del marketplace privato nell'API Marketplace AWS Catalog.


<table>
<thead>
  <tr><th>Tipo di modifica</th><th>Codice di errore</th><th>Messaggio di errore</th><th>Description</th></tr>
</thead>
<tbody>
  <tr><td colspan="4">Errors returned directly by the StartChangeSet action</td></tr>
  <tr><td>Tutti</td><td>422</td><td>Documento in formato JSON non valido</td><td>È stato utilizzato un input JSON non valido. Controlla la sintassi.</td></tr>
  <tr><td>AllowProductProcurement, DenyProductProcurement</td><td>422</td><td>I valori nell'array Ids devono essere univoci</td><td>Non è possibile includere lo stesso prodotto più volte in una singola richiesta di modifica.</td></tr>
  <tr><td>AllowProductProcurement, DenyProductProcurement</td><td>422</td><td>Il numero cumulativo di valori nella matrice Ids deve essere inferiore o uguale a 50</td><td>Puoi consentire o rifiutare fino a 50 prodotti in una singola richiesta di modifica.</td></tr>
  <tr><td colspan="4">Errors found by calling the DescribeChangeSet action</td></tr>
  <tr><td>CreateBrandingSettings, UpdateBrandingSettings</td><td>URL NON VALIDO</td><td>Impossibile recuperare l'immagine dall'URL di input</td><td>È necessario specificare un URL valido e raggiungibile per il campo logo in. `BrandingSettings`</td></tr>
  <tr><td>CreateBrandingSettings, UpdateBrandingSettings</td><td>IMMAGINE\_INVALIDA</td><td>La verifica dell'immagine per tipo, contenuto o dimensione del file non è riuscita. Sono supportati solo i tipi di file.png e.svg con dimensioni inferiori o uguali a 500 KB.</td><td>Il file di immagine deve soddisfare i requisiti del logo per le impostazioni di branding.</td></tr>
  <tr><td>AllowProductProcurement, DenyProductProcurement</td><td>ENTITY\_NOT\_FOUND</td><td>La politica di approvvigionamento non compare in Experience</td><td>È necessario creare un file `ProcurementPolicy` prima di consentire o rifiutare i prodotti.</td></tr>
  <tr><td>CreateProcurementPolicy</td><td>ENTITY\_ALREADY\_EXISTS</td><td>Esiste una politica di approvvigionamento per Experience</td><td>Puoi avere una sola politica di approvvigionamento per un marketplace privato.</td></tr>
  <tr><td>UpdateProcurementPolicy</td><td>ENTITÀ\_NON TROVATA</td><td>La politica di approvvigionamento non compare in Experience</td><td>È necessario creare una politica `ProcurementPolicy` di approvvigionamento prima di aggiornare.</td></tr>
  <tr><td>CreateBrandingSettings</td><td>ENTITY\_ALREADY\_EXISTS</td><td>Esistono impostazioni di branding per Experience</td><td>Puoi avere una sola impostazione di branding per un marketplace privato.</td></tr>
  <tr><td>UpdateBrandingSettings</td><td>ENTITÀ\_NON TROVATA</td><td>Impostazioni di branding mancanti in Experience</td><td>Devi creare un'`BrandingSettings`entità prima di aggiornare le impostazioni di branding.</td></tr>
  <tr><td>AssociateAudience</td><td>CALLER\_NOT\_AUTHORIZED</td><td>Chiamante non autorizzato a eseguire l'azione</td><td>È necessario disporre delle autorizzazioni per avviare l'azione. Gli account aggiunti devono appartenere alla stessa organizzazione.</td></tr>
  <tr><td>CreateExperience</td><td>CALLER\_NOT\_AUTHORIZED</td><td>Chiamante non autorizzato a creare esperienza. </td><td>È necessario disporre delle autorizzazioni per creare un'esperienza.</td></tr>
  <tr><td>AssociateAudience</td><td>ENTITY\_ALREADY\_EXISTS</td><td>Un'esperienza è già associata all'account {accountId}. Annulla l'esperienza precedente prima dell'aggiornamento</td><td>Puoi associare una sola esperienza a un account. Dissocia l'esperienza corrente prima di associarne una nuova. </td></tr>
  <tr><td>AssociateAudience, DisassociateAudience</td><td>ENTITÀ\_IN\_USO</td><td>È già in corso una modifica in conflitto per l'account selezionato. Riprova più tardi</td><td>Non puoi modificare l'associazione con un account mentre è già in corso un'altra richiesta di modifica per modificare l'associazione.</td></tr>
</tbody>
</table>


## Tipi di entità definiti dal marketplace privato
<a name="entity-types-defined-by-private-marketplace"></a>

La tabella seguente elenca i tipi di entità del marketplace privato, lo scopo e le azioni su cui è possibile specificare ciascuno di essi. Ogni tipo di entità può essere utilizzato per specificare una risorsa Amazon Resource Name (ARN) che può essere utilizzata nella policy AWS Identity and Access Management (IAM). Per ulteriori dettagli sui formati ARN, vedere. [Entità API del catalogo](catalog-apis.md#catalog-api-entities)


| Entità | Scopo | Azioni | 
| --- | --- | --- | 
| `Experience` | Memorizza le impostazioni di primo livello per un marketplace privato | `StartChangeSet`<br />`DescribeEntity` | 
| `BrandingSettings` | Memorizza le impostazioni di branding per un marketplace privato | `DescribeEntity` | 
| `ProcurementPolicy` | Memorizza le impostazioni di approvvigionamento e gli elenchi di prodotti in un marketplace privato | `DescribeEntity` | 
| `Audience` | Memorizza i dettagli dei principali associati a un marketplace privato | `DescribeEntity` |