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:
-
Per convalidare la chiamata API senza creare una versione, imposta su
Intent.VALIDATE -
Per la creazione effettiva della versione, imposta su
Intent.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): obbligatorioContiene informazioni sul prodotto ML.
-
Identifier(stringa): obbligatorioL'ID del prodotto. Per ulteriori informazioni, consulta Identifier.
-
Type(stringa): obbligatorioSpecifica il metodo di consegna (tipo di prodotto). Deve esserlo.
MachineLearningProduct@1.0
-
-
DetailsDocument(oggetto): obbligatorioContiene tutti i dettagli sulla nuova versione del prodotto.
-
Version(oggetto): obbligatorioDettagli sulla versione da aggiungere.
-
VersionTitle(stringa): obbligatorioIl titolo della versione, ad esempio «Versione 1.1" o «1.1". Gli acquirenti selezionano le versioni tra questi titoli.
-
ReleaseNotes(stringa): obbligatorioNote dettagliate su questa versione. Deve contenere meno di 30.000 caratteri.
-
-
DeliveryOptions(array): obbligatorioGamma di metodi di consegna per la versione del prodotto. Limitato a un'opzione di consegna per versione.
-
Details(oggetto): obbligatorio-
SagemakerModelPackageDeliveryOptionDetailsoSageMakerAlgorithmDeliveryOptionDetails(oggetto)-
SageMakerModelPackageArnorSageMakerAlgorithmArn(stringa) —obbligatorioAmazon Resource Name (ARN) del pacchetto modello o dell'algoritmo.
-
AccessRoleArn(stringa): obbligatorioRuolo IAM ARN per AWS Marketplace per accedere alla SageMaker risorsa.
-
SampleNotebookUrl(stringa) —obbligatorioLink a un esempio di notebook Jupyter con codice di utilizzo. Per ulteriori informazioni, consulta un modello di notebook di esempio
su. GitHub -
RepositoryUrl(stringa): obbligatorioURL 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) —obbligatorioInformazioni di addestramento per gli algoritmi o dettagli sull'utilizzo per i modelli.
-
InputProperties(oggetto): obbligatorio-
Description(stringa) —obbligatorioDescrizione degli input model/algorithm
-
Limitations(Stringa)Limitazioni di input
-
SampleInput(oggetto): obbligatorioRealtimeInferenceUrl (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>): obbligatorioRealtimeInferenceUrl (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:
-
Convalida: il sistema verifica che tutte le informazioni soddisfino 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.
-
-
Monitoraggio dello stato: puoi controllare lo stato della richiesta in due modi.
-
Tramite il portale di gestione di AWS Marketplace
-
Utilizzo dell'operazione
DescribeChangeSet
-
-
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. |