View a markdown version of this page

Aggiungi una nuova versione - Marketplace AWS

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

Aggiungi una nuova versione

Puoi utilizzare l'API Catalog o il Marketplace AWS Management Portal per aggiungere una nuova versione a un prodotto di machine learning. Per ulteriori informazioni sull'utilizzo del portale, consulta la sezione Aggiungere una nuova versione nella AWS Marketplace Seller Guide.

Nota

Per i prodotti ML, una versione consiste in un'unica opzione di consegna, che rappresenta il prodotto che stai rendendo disponibile. Nell'API Catalog, l'utilizzo delle opzioni di consegna per i prodotti ML modifica efficacemente le versioni del prodotto.

Quando aggiungi nuovi tipi di istanze, includi un tipo di UpdatePricingTerms modifica nel set di modifiche per specificare i prezzi per i nuovi tipi di istanze. Per i nuovi prodotti, UpdatePricingTerms deve coprire tutti i tipi di istanze supportati. UpdatePricingDimensionsnon è richiesto o supportato per i prodotti ML, poiché le dimensioni vengono generate automaticamente per tutti i tipi di istanze supportati. Per ulteriori informazioni, vedi Aggiorna le dimensioni dei prezzi.

Utilizzo StartChangeSetper aggiungere una versione

Per aggiungere una nuova versione, chiamate l'StartChangeSetoperazione con il tipo di AddDeliveryOptions modifica:

  1. Per convalidare la chiamata API senza creare una versione, imposta suIntent. VALIDATE

  2. Per la creazione effettiva della versione, imposta suIntent. APPLY

Sintassi della richiesta

POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [{ "ChangeType": "AddDeliveryOptions", "Entity": { "Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1", "Type": "MachineLearningProduct@1.0" }, "DetailsDocument": { "Version": { "VersionTitle": "version 1.1", "ReleaseNotes": "Patch update for small bugfix in version 1.0" }, "DeliveryOptions": [{ "Details": { "SageMakerAlgorithmDeliveryOptionDetails": { "SageMakerAlgorithmArn": "arn:aws:sagemaker:us-east-2:605142612156:algorithm/scikit-decision-trees-1552343220", "AccessRoleArn": "arn:aws:iam::12345678901:role/AwsMarketplaceSageMakerIngestion", "UsageInstructions":"This is how you use your algorithm", "SampleNotebookUrl": "https://www.amazon.com", "RepositoryUrl": "https://www,amazon.com", "InputProperties": { "Description": "Input should have all columns in the train/test file except for 'is_fraud' column.", "Limitations": "Can predict on 1 input in the CSV only at a time", "SampleInput": { "RealtimeInferenceText": "{\"prompt\":\"Write summary\", \"maxTokens\": 1 }", "BatchTransformUrl": "https://www.sampleData.com", }, "Parameters": [{ "Name": "prompt", "Description": "Represents the instruct-style prompt for the model. DataType is String", "Constraints": "Minimum length should be 1", "Required": true }, { "Name": "maxTokens", "Description": "Denotes the number of tokens to predict per generation. See BPE Tokens for more details.", "Constraints": "Minvalue: 1, MaxValue: 30" } ], "SageMakerCustomAttributes": [{ "Name": "threshold", "Description": "Threshold of the confidence score of the detected object", "Constraints": "Should be an Integer" }] }, "OutputProperties": { "Description": "The output is a JSON object that has the generated text along with likelihoods of tokens, if requested. See example json.", "SampleOutput": { "RealtimeInferenceUrl": "https://www.sampledata.com", "BatchTransformUrl": "https://www.sampleData.com", }, "Parameters": [{ "Name": "id", "Description": "An identifier for response" "AlwaysReturned": true }, { "Name": "generations", "Description": "The generated text along with the likelihoods for tokens requested.", } ], }, "RecommendedInstanceTypes": { "BatchTransform": "ml.m4.large", "RealtimeInference": "ml.m4.large", "Training": "ml.m4.large" } } }] } }], "Intent": "APPLY" }

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 tutti i dettagli sulla nuova versione del prodotto.

    • Version(oggetto): obbligatorio

      Dettagli sulla versione da aggiungere.

      • VersionTitle(stringa): obbligatorio

        Il titolo della versione, ad esempio «Versione 1.1" o «1.1". Gli acquirenti selezionano le versioni tra questi titoli.

      • ReleaseNotes(stringa): obbligatorio

        Note dettagliate su questa versione. Deve contenere meno di 30.000 caratteri.

    • DeliveryOptions(array): obbligatorio

      Gamma di metodi di consegna per la versione del prodotto. Limitato a un'opzione di consegna per versione.

      • Details(oggetto): obbligatorio

        • SagemakerModelPackageDeliveryOptionDetailso SageMakerAlgorithmDeliveryOptionDetails (oggetto)

          • SageMakerModelPackageArnor SageMakerAlgorithmArn (stringa) —obbligatorio

            Amazon Resource Name (ARN) del pacchetto modello o dell'algoritmo.

          • AccessRoleArn(stringa): obbligatorio

            Ruolo IAM ARN per AWS Marketplace per accedere alla SageMaker risorsa.

          • SampleNotebookUrl(stringa) —obbligatorio

            Link a un esempio di notebook Jupyter con codice di utilizzo. Per ulteriori informazioni, consulta un modello di notebook di esempio su. GitHub

          • RepositoryUrl(stringa): obbligatorio

            URL del repository Git per l'accesso a notebook e dati di esempio. Per ulteriori informazioni, consulta un esempio di repository Git su GitHub.

          • UsageInstructions(stringa) —obbligatorio

            Informazioni di addestramento per gli algoritmi o dettagli sull'utilizzo per i modelli.

          • InputProperties(oggetto): obbligatorio

            • Description(stringa) —obbligatorio

              Descrizione degli input model/algorithm

            • Limitations (Stringa)

              Limitazioni di input

            • SampleInput(oggetto): obbligatorio

              RealtimeInferenceUrl (stringa) | RealtimeInferenceText (stringa) | BatchTransformUrl (stringa) | BatchTransformText (stringa)

            • Parameters(Matrice<Object>)

              Nome (stringa) —obbligatorio | Descrizione (stringa) —Obbligatorio | Vincoli (stringa) | Obbligatorio (booleano)

            • SageMakerCustomAttributes<Object>(Array)

              Descrive tutte le opzioni CustomAttributessupportate dal modello.

              Name(string) —required | Description (string) —Obbligatorio | Constraints (string) | Required (booleano)

          • OutputProperties(oggetto) —obbligatorio

            • Description(stringa) —obbligatorio

            • SampleOutput(Array<Object>): obbligatorio

              RealtimeInferenceUrl (stringa) | RealtimeInferenceText (stringa) | BatchTransformUrl (stringa) | BatchTransformText (stringa)

            • Parameters(Matrice)

              Nome (stringa) —richiesto | Descrizione (stringa) —obbligatorio | AlwaysReturned (booleano)

          • RecommendedInstanceTypes(oggetto) —obbligatorio

            • BatchTransform(string) —Obbligatorio

            • RealtimeInference(string) —Obbligatorio

            • Training(string) —Obbligatorio solo per gli algoritmi SageMaker

Sintassi della risposta

Quando si invia la richiesta, viene creato un set di modifiche e l'API 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 che tutte le informazioni soddisfino le linee guida. Marketplace AWS

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

    • Tramite il portale di gestione di AWS Marketplace

    • Utilizzo dell'operazione DescribeChangeSet

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

Errori

Errori asincroni

I seguenti errori sono specifici AddDeliveryOptions delle azioni nell'API Catalog. Marketplace AWS Questi errori vengono visualizzati quando si chiama DescribeChangeSet mentre è in corso l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo per DescribeChangeSet verificare lo stato di una richiesta di modifica, consulta Lavorare con i set di modifiche.

Codice di errore Messaggio di errore
INCOMPATIBLE_PRODUCT_STATUS Non siamo riusciti a trovare il prodotto fornito. Fornisci un prodotto valido.
DUPLICATE_VERSION_TITLE Il titolo della versione fornito è già in uso. Crea un titolo di versione univoco.
INVALID_RECOMMENDED_INSTANCE_TYPE Non hai fornito un tipo di istanza valido per [x]. Inserisci un tipo di istanza valido e riprova. I tipi validi sono: [valids]
OPZIONI_DI_CONSEGNA INCOMPATIBILI L'opzione di consegna che hai fornito non corrisponde alla selezione precedente: [selezione precedente]. Aggiorna l'opzione di spedizione e riprova.
INVALID_ASSET_ARN Non hai fornito un ARN valido per. SageMakerAlgorithmDeliveryOption Inserisci un ARN valido e riprova.
DUPLICATE_ASSET Non hai fornito un ARN univoco per questo prodotto. Inserisci un ARN univoco e riprova.
ASSET_NOT_FOUND Non siamo riusciti a trovare l'ARN che hai fornito. Verifica che l'ARN sia corretto e disponga delle autorizzazioni richieste.
ASSET_VALIDATION_EXCEPTION Impossibile importare SagemakerModelArn/SagemakerAlgorithmArn [x] nell'account AWS Sagemaker
INVALID_ACCESS_ROLE Non siamo riusciti a individuare l'ARN del ruolo IAM che hai fornito. Verifica che l'ARN sia corretto e riprova.
UPDATE_PRICING_REQUIRED UpdatePricingTerms è obbligatorio.