A referência da API do AWS Marketplace foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a [Referência de API do AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Adicionar uma nova versão
Você pode usar a API do Catálogo ou o Portal AWS Marketplace de Gerenciamento para adicionar uma nova versão a um produto de aprendizado de máquina. Para obter mais informações sobre o uso do portal, consulte [Adicionar uma nova versão](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-products.html) no *Guia do vendedor do AWS Marketplace*.
**nota**
Para produtos de ML, uma versão consiste em uma única opção de entrega, que representa o produto que você está disponibilizando. Na API de catálogo, trabalhar com opções de entrega para produtos de ML modifica efetivamente as versões do seu produto.
Ao adicionar novos tipos de instância, inclua um tipo de `UpdatePricingTerms` alteração em seu conjunto de alterações para especificar os preços dos novos tipos de instância. Para novos produtos, `UpdatePricingTerms` deve abranger todos os tipos de instância compatíveis. `UpdatePricingDimensions`não é obrigatório nem compatível com produtos de ML, pois as dimensões são geradas automaticamente para todos os tipos de instância compatíveis. Para obter mais informações, consulte [Atualizar dimensões de preços](work-with-seller-products.md#update-dimensions).
**Usando `StartChangeSet`para adicionar uma versão**
Para adicionar uma nova versão, chame a `StartChangeSet` operação com o tipo de `AddDeliveryOptions` alteração:
1. Para validar sua chamada de API sem criar uma versão, `Intent` defina `VALIDATE` como.
1. Para criar a versão real, `Intent` defina como`APPLY`.
## Sintaxe da solicitação
```
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"
}
```
## Campos obrigatórios
+ `Entity`(objeto) — obrigatório
Contém informações sobre seu produto de ML.
+ `Identifier`(string) — obrigatório
O ID do seu produto. Para obter mais informações, consulte [Identificador](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
+ `Type`(string) — obrigatório
Especifica o método de entrega (tipo de produto). Deve ser `MachineLearningProduct@1.0`.
+ `DetailsDocument`(objeto) — obrigatório
Contém todos os detalhes sobre a nova versão do seu produto.
+ `Version`(objeto) — obrigatório
Detalhes sobre a versão que está sendo adicionada.
+ `VersionTitle`(string) — obrigatório
O título da versão, como “Versão 1.1" ou “1.1". Os compradores selecionam versões desses títulos.
+ `ReleaseNotes`(string) — obrigatório
Notas detalhadas sobre esta versão. Deve ter menos de 30.000 caracteres.
+ `DeliveryOptions`(matriz) — obrigatório
Variedade de métodos de entrega para a versão do seu produto. Limitado a uma opção de entrega por versão.
+ `Details`(objeto) — obrigatório
+ `SagemakerModelPackageDeliveryOptionDetails`ou `SageMakerAlgorithmDeliveryOptionDetails` (objeto)
+ `SageMakerModelPackageArn`ou `SageMakerAlgorithmArn` (string) — obrigatório
Nome de recurso da Amazon (ARN) do seu pacote de modelo ou algoritmo.
+ `AccessRoleArn`(string) — obrigatório
ARN da função do IAM para o AWS Marketplace acessar o SageMaker recurso.
+ `SampleNotebookUrl`(string) — obrigatório
Link para um exemplo de caderno Jupyter com código de uso. Para obter mais informações, consulte um [exemplo de modelo de caderno](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) em GitHub.
+ `RepositoryUrl`(string) — obrigatório
URL do repositório Git para acesso a notebooks e dados de amostra. Para obter mais informações, consulte um [exemplo de repositório Git](https://github.com/aws/amazon-sagemaker-examples/tree/master/aws_marketplace/curating_aws_marketplace_listing_and_sample_notebook/ModelPackage/Sample_Notebook_Template) em. GitHub
+ `UsageInstructions`(string) — obrigatório
Informações de treinamento para algoritmos ou detalhes de uso de modelos.
+ `InputProperties`(objeto) — obrigatório
+ `Description`(string) — obrigatório
Descrição das model/algorithm entradas
+ `Limitations` (string)
Limitações de entrada
+ `SampleInput`(objeto) — obrigatório
RealtimeInferenceUrl (string) \| RealtimeInferenceText (string) \| BatchTransformUrl (string) \| BatchTransformText (string)
+ `Parameters`(Matriz