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à.
# 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](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-products.html) 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. `UpdatePricingDimensions`non è 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](work-with-seller-products.md#update-dimensions).
**Utilizzo `StartChangeSet`per aggiungere una versione**
Per aggiungere una nuova versione, chiamate l'`StartChangeSet`operazione con il tipo di `AddDeliveryOptions` modifica:
1. Per convalidare la chiamata API senza creare una versione, imposta su`Intent`. `VALIDATE`
1. 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): 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 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
+ `SagemakerModelPackageDeliveryOptionDetails`o `SageMakerAlgorithmDeliveryOptionDetails` (oggetto)
+ `SageMakerModelPackageArn`or `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](https://github.com/aws/amazon-sagemaker-examples/blob/master/aws_marketplace/curating_aws_marketplace_listing_and_sample_notebook/ModelPackage/Sample_Notebook_Template/title_of_your_product-Model.ipynb) 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](https://github.com/aws/amazon-sagemaker-examples/tree/master/aws_marketplace/curating_aws_marketplace_listing_and_sample_notebook/ModelPackage/Sample_Notebook_Template) 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