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

# Limita una versione
<a name="ml-restrict-version"></a>

 Puoi utilizzare l'API Catalog per limitare una versione del tuo prodotto di machine learning Marketplace AWS. Se soggetto a restrizioni, i nuovi acquirenti non possono accedere a quella versione. Gli abbonati esistenti mantengono l'accesso alle versioni con restrizioni. Marketplace AWS le linee guida richiedono l'assistenza continua per gli acquirenti esistenti per 90 giorni dopo la restrizione. 

**Importante**  
 Deve rimanere disponibile almeno una versione senza restrizioni. Non è possibile limitare l'ultima versione disponibile pubblicamente di un prodotto. 

**Per limitare una versione:**
+  Per limitare una versione, chiamate l'`StartChangeSet`operazione con il tipo di `RestrictDeliveryOptions` modifica. 

## Sintassi della richiesta
<a name="ml-restrict-version-request-syntax"></a>

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "RestrictDeliveryOptions",
      "Entity":
      {
        "Identifier": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
        "Type": "MachineLearningProduct@1.0"
      },
      "DetailsDocument":
      {
        "DeliveryOptionIds":
        [
          "{{example1-2222-cccc-2222-cccccccccccc}}"
        ]
      }
    }
  ]
}
```

## Campi obbligatori
<a name="ml-restrict-version-required-fields"></a>

**Campi obbligatori**
+  `Entity`(oggetto): obbligatorio 

  Contiene informazioni sul prodotto ML.
  +  `Identifier`(stringa): obbligatorio 

    L'ID del prodotto. Per ulteriori informazioni, consulta [Identifier](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
  +  `Type`(stringa): obbligatorio 

    Specifica il metodo di consegna (tipo di prodotto). Deve esserlo. `MachineLearningProduct@1.0`
+  `DetailsDocument`(oggetto): obbligatorio 

   Contiene le informazioni sulla versione aggiornata. 
  + `DeliveryOptionIds`(matrice di oggetti): obbligatorio

    Elenco di DeliveryOption ID per le versioni che desideri limitare. Recupera l'identificatore univoco per ognuna DeliveryOption chiamando l' DescribeEntity azione sulla versione che stai limitando.

## Sintassi della risposta
<a name="ml-restrict-version-response-syntax"></a>

Una richiesta riuscita restituisce:

```
{
    "ChangeSetId": "example123456789012abcdef",
    "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```

1. Convalida: il sistema verifica se tutte le informazioni soddisfano le Marketplace AWS linee guida.
   +  Tempo di elaborazione: da pochi minuti a diverse ore 
   +  Per gli errori di convalida, vedi [Modificare lo stato e gli errori del set](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors). 

1.  Monitoraggio dello stato: puoi controllare lo stato della richiesta in due modi. 
   + Tramite il portale Marketplace AWS di gestione
   + Utilizzo dell'operazione `DescribeChangeSet`

1.  Completamento: una volta approvata, la nuova versione è soggetta a restrizioni. 

## Errori
<a name="ml-restrict-version-errors"></a>

**Errori asincroni**  
I seguenti errori possono verificarsi durante l'elaborazione del set di modifiche e possono essere recuperati utilizzando l'operazione: `DescribeChangeSet`


| Codice di errore | Messaggio di errore | 
| --- | --- | 
| INCOMPATIBLE\_PRODUCT\_STATUS | Utilizza un prodotto pubblico o limitato esistente | 
| MISSING\_DELIVERY\_OPTION\_IDS | Fornisci l'opzione di consegna dall'elenco di ID esistente. | 
| INVALID\_DELIVERY\_OPTION\_IDS | Fornisci gli ID delle opzioni di consegna che possono essere trovati nel prodotto. ID non trovati: [x] | 
| INVALID\_DELIVERY\_OPTION\_STATUS | Gli ID delle opzioni di consegna [invalid\_ids] non sono validi. Fornisci opzioni di consegna nello stato pubblico. | 
| ALL\_DELIVERY\_OPTIONS\_RESTRICTED | Fornisci un minor numero di opzioni di consegna da limitare poiché almeno una deve rimanere in stato pubblico. |