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

# Aggiorna le informazioni sulla versione
<a name="ml-update-version"></a>

 Puoi utilizzare l'API Catalog per aggiornare i dettagli di una versione esistente del tuo prodotto di machine learning in Marketplace AWS. 

**Importante**  
 Non è possibile aggiornare l'ARN per una versione. Se devi modificare l'ARN, devi invece creare una nuova versione. 

**Utilizzo `StartChangeSet`per aggiungere una versione:**
+  Per aggiornare le informazioni sulla versione, chiamate l'`StartChangeSet`operazione con il tipo di `UpdateDeliveryOptions` modifica. 

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

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateDeliveryOptions",
      "Entity":
      {
        "Identifier": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
        "Type": "MachineLearningProduct@1.0"
      },
      "DetailsDocument":
      {
        "Version":
        {
          "ReleaseNotes": "{{Adding support for new parameters}}"
        },
        "DeliveryOptions":
        [
          {
            "Id": "{{example1-2222-cccc-2222-cccccccccccc}}",
            "Details":
            {
              "SagemakerModelPackageDeliveryOptionDetails":
              {
                "SampleNotebookUrl": "{{https://www.amazon.com}}",
                "RepositoryUrl":"{{https://www,amazon.com}}",
                "InputProperties": 
                { 
                    "SampleInput": {
                        "RealtimeInferenceUrl": "{{https://www.sampleData.com}}",
                        "BatchTranformUrl": "{{https://www.sampleData.com}}",
                     },
                 },
                 "RecommendedInstanceTypes": {
                        "BatchTransform": "{{ml.m4.large}}",
                        "RealtimeInference": "{{ml.m4.large}}"
                  }
            }
          }
        ]
      }
    }
  ]
}
```

## Campi obbligatori
<a name="ml-update-version-required-fields"></a>
+  `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. 
  + `Version`(oggetto): obbligatorio

    Definisce le informazioni specifiche della versione.
    + `VersionTitle`(stringa): obbligatorio

      L'identificatore della versione visualizzato dagli acquirenti, ad esempio «Versione 1.1" o «1.1". Gli acquirenti utilizzano questo titolo per selezionare le versioni da distribuire.
    + `ReleaseNotes`(stringa): obbligatorio 

      Note dettagliate su questa versione, limitata a 30.000 caratteri.
  + `DeliveryOptions`(array): obbligatorio 

    Specifica i metodi di consegna per la versione del prodotto. Limitato a un'opzione di consegna per versione.
    + `Id`(stringa): obbligatorio 

      Identificatore univoco per. DeliveryOption Recuperalo utilizzando l' DescribeEntity azione sul tuo prodotto.
    + `Details`(oggetto): obbligatorio 

      Contiene le specifiche dell'opzione di consegna.
      + `SageMakerModelPackageSubscriptionDetails`o `SageMakerAlgorithmSubscriptionDetails` (oggetto): obbligatorio 

        Dettagli dell'opzione di consegna.
        + `SampleNotebookUrl`(stringa): obbligatorio 

          Esempio di link al notebook Jupyter che fornisce il codice per l'utilizzo da parte dell'acquirente.
        + `RepositoryUrl`(stringa): obbligatorio 

          URL del repository Git per la clonazione di notebook e dati di esempio.
        + `UsageInstructions`(stringa): obbligatorio 

          Per gli algoritmi: informazioni sull'addestramento. Per i modelli: informazioni aggiuntive sull'utilizzo.
        + `InputProperties`(oggetto): obbligatorio 

          Dettagli dei requisiti model/algorithm di input.
          + `Description`(stringa): obbligatorio 

            Descrizione degli input richiesti.
          + `Limitations` (Stringa) 

            Eventuali limitazioni di input.
          + `SampleInput`(oggetto): obbligatorio 

            Dati di input di esempio per diverse operazioni.
            + `RealtimeInferenceUrl` (Stringa) 

              URL di input di esempio per inferenze in tempo reale.
            + `RealtimeInferenceText` (Stringa) 

              Esempio di testo di input per l'inferenza in tempo reale.
            + `BatchTransformUrl` (Stringa) 

              URL di input di esempio per i lavori di trasformazione in batch.
            + `BatchTransformText` (Stringa) 

              Esempio di testo di input per i lavori di trasformazione in batch.
          + `Parameters`(Array<Object>) 

            Dettagli per ogni parametro di input.
            + `Name`(stringa): obbligatorio 

              Nome del parametro di input.
            + `Description`(stringa): obbligatorio 

              Descrizione del parametro di input.
            + `Constraints` (Stringa) 

              Vincoli dei parametri (MinValue,, MaxValue,, AllowedValues MinLength, Pattern MaxLength, ecc.).
            + `Required`(booleano) 

              Indica se il parametro è obbligatorio. Il valore predefinito è false.
          + `SageMakerCustomAttributes`(Array<Object>) 

            Dettagli della scheda supportata CustomAttributes.
            + `Name`(stringa): obbligatorio 

              Nome dell'attributo personalizzato.
            + `Description`(stringa): obbligatorio 

              Descrizione dell'attributo personalizzato.
            + `Constraints` (Stringa) 

              Vincoli degli attributi (MinValue,, MaxValue, AllowedValues MinLength, Pattern MaxLength, ecc.).
            + `Required`(booleano) 

              Indica se l'attributo è obbligatorio. Il valore predefinito è false.
        + `OutputProperties`(oggetto): obbligatorio 

          Dettagli dell'output model/algorithm di.
          + `Description`(stringa): obbligatorio 

            Descrizione degli model/algorithm output.
          + `SampleOutput`(Array<Object>): obbligatorio 

            Dati di output di esempio per diverse operazioni.
            + `RealtimeInferenceUrl` (Stringa) 

              URL di output di esempio per l'inferenza in tempo reale.
            + `RealtimeInferenceText` (Stringa) 

              Testo di output di esempio per l'inferenza in tempo reale.
            + `BatchTransformUrl` (Stringa) 

              URL di output di esempio per i lavori di trasformazione in batch.
            + `BatchTransformText` (Stringa) 

              Testo di output di esempio per i lavori di trasformazione in batch.
          + `Parameters`(Array) 

            Dettagli per ogni parametro di output.
            + `Name`(stringa): obbligatorio 

              Nome del parametro di output.
            + `Description`(stringa): obbligatorio 

              Descrizione del parametro di output.
            + `AlwaysReturned`(booleano) 

              Indica se il parametro viene sempre restituito. Il valore predefinito è false.
        + `RecommendedInstanceTypes`(oggetto): obbligatorio 

          Tipi di istanze consigliati per prestazioni ottimali.
          + `BatchTransform`(stringa): obbligatorio 

            Tipo di istanza consigliato per le operazioni di trasformazione in batch.
          + `RealtimeInference`(stringa): obbligatorio 

            Tipo di istanza consigliato per le operazioni di inferenza in tempo reale.
          + `Training`(stringa): obbligatorio 

            Tipo di istanza consigliato per le operazioni di addestramento degli algoritmi. Richiesto solo per SageMaker gli algoritmi.

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

Una richiesta riuscita restituisce:

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

**Elaborazione del set di modifiche**  
La richiesta di modifica entra in una coda di elaborazione, dove viene sottoposta a diversi passaggi:

1. Convalida: il sistema verifica se tutte le informazioni soddisfano le linee guida. Marketplace AWS 
   +  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 viene aggiornata. 

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

**Errori asincroni**  
Gli errori specifici relativi alle `UpdateDeliveryOptions` azioni possono essere recuperati utilizzando l'`DescribeChangeSet`operazione dopo l'inizio dell'elaborazione del set di modifiche. Per i dettagli sugli errori e la risoluzione dei problemi, vedere [Modificare lo stato e gli errori del set](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). 


| Codice di errore | Messaggio di errore | 
| --- | --- | 
| INCOMPATIBLE\_PRODUCT\_STATUS | Utilizza un prodotto pubblico o limitato esistente. | 
| INVALID\_DELIVERY\_OPTION\_ID | Fornisci gli ID delle opzioni di consegna che possono essere trovati nel prodotto. ID non trovati: [x] | 
| INCOMPATIBLE\_DELIVERY\_OPTION\_STATUS | L'opzione di consegna non può essere aggiornata perché è in stato limitato. Prova invece ad aggiungere una nuova versione. | 
| INCOMPATIBLE\_DELIVERY\_OPTIONS | Il prodotto utilizzava in precedenza [X] come opzione di consegna, pertanto tutte le opzioni di consegna imminenti dovrebbero essere di tipo [X] | 
| TIPO\_ISTANZA\_CONSIGLIATO NON VALIDO | Fornisci un tipo di istanza esistente e disponibile per [X] (X può essere Batch Transform, Realtime Inference o Algorithm Training) | 
| TITOLO\_VERSIONE\_DUPLICATO | Il titolo della versione deve essere diverso da qualsiasi altro titolo di versione di questo prodotto. | 
| FIELD\_NOT\_ALLOWED\_TO\_CHANGE | Il campo X non può essere modificato. |