View a markdown version of this page

Aggiorna le informazioni sulla versione - Marketplace AWS
Sintassi della richiestaCampi obbligatoriSintassi della rispostaErrori

L'AWS Marketplace API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Marketplace API Reference.

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

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 StartChangeSetper aggiungere una versione:

  • Per aggiornare le informazioni sulla versione, chiamate l'StartChangeSetoperazione con il tipo di UpdateDeliveryOptions modifica.

Sintassi della richiesta

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

  • Entity(oggetto): obbligatorio

    Contiene informazioni sul prodotto ML.

    • Identifier(stringa): obbligatorio

      L'ID del prodotto. Per ulteriori informazioni, consulta 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.

        • SageMakerModelPackageSubscriptionDetailso 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

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

  2. Monitoraggio dello stato: puoi controllare lo stato della richiesta in due modi.

    • Tramite il portale Marketplace AWS di gestione

    • Utilizzo dell'operazione DescribeChangeSet

  3. Completamento: una volta approvata, la nuova versione viene aggiornata.

Errori

Errori asincroni

Gli errori specifici relativi alle UpdateDeliveryOptions azioni possono essere recuperati utilizzando l'DescribeChangeSetoperazione 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.

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.