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á.
# Atualizar os termos de preços
Você pode usar a API de catálogo para atualizar os preços de seus produtos de aprendizado de máquina no AWS Marketplace.
**nota**
Você deve definir o preço de todos os tipos de instância compatíveis dos seus produtos de aprendizado de máquina. Ao criar sua primeira versão, `UpdatePricingTerms` `AddDeliveryOptions` altere os tipos com os preços de todos os tipos de instâncias compatíveis para publicar seu produto. Ao adicionar uma nova versão a um produto existente com novos tipos de instância que não eram compatíveis antes, você deve incluir esses tipos de instância nos tipos `UpdatePricingTerms` e `AddDeliveryOptions` change.
Para atualizar os termos de preços, ligue para a `StartChangeSet` operação com o tipo de `UpdatePricingTerms` alteração.
## Sintaxe da solicitação
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "ml.m4.4xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "ml.m5.4xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.16xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "m.i.c",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.4xlarge.a.t",
"Price": 0.1
},
{
"DimensionKey": "ml.m5.4xlarge.a.t",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.16xlarge.a.t",
"Price": 0.1
}
]
}
]
},
{
"Type": "FreeTrialPricingTerm",
"Duration": "P30D",
"Grants": [
{
"DimensionKey": "ml.m4.4xlarge.m.i.b"
},
{
"DimensionKey": "ml.m5.4xlarge.m.i.b"
},
{
"DimensionKey": "ml.m4.16xlarge.m.i.b"
},
{
"DimensionKey": "m.i.c"
},
{
"DimensionKey": "ml.m4.4xlarge.a.t"
},
{
"DimensionKey": "ml.m5.4xlarge.a.t"
},
{
"DimensionKey": "ml.m4.16xlarge.a.t"
}
]
}
]
}
},
]
}
```
## Campos obrigatórios
+ `Entity`(objeto) (obrigatório) - Contém informações sobre a oferta do seu produto de ML.
+ `Identifier`(string) (obrigatório) — O ID da oferta para o qual você gostaria de atualizar os termos de preços. Para obter mais informações, consulte [Identificador](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
+ `Type`(string) (obrigatório) — `Type` É necessário `Offer@1.0` para atualizar os preços.
+ `DetailsDocument`(objeto) (obrigatório) — Detalhes sobre os termos de preço do seu produto de aprendizado de máquina.
+ `PricingModel`(string) (obrigatório) - O modelo de preços do seu produto - você pode escolher entre Uso, Gratuito e Contrato (para ofertas privadas). Para obter mais informações, consulte [Preços de produtos de Machine Learning](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-pricing.html).
+ `Terms`(matriz de objetos) - Uma série de termos de preços que definem coletivamente o preço geral do seu produto.
+ `Type`(string) (obrigatório) - O tipo de termo de preço. As opções válidas são `UsageBasedPricingTerm` `FreeTrialPricingTerm` ou ou `FixedUpfrontPricingTerm` (para ofertas privadas).
+ `CurrencyCode`(string) (obrigatório para `UsageBasedPricingTerm` ou `FixedUpfrontPricingTerm` - a moeda do termo de preço. O valor válido é `USD`.
+ `RateCards`(matriz de objetos) (obrigatório para`UsageBasedPricingTerm`) - As tabelas de tarifas que definem o preço do seu produto de aprendizado de máquina. Você deve incluir `RateCard` somente um dentro dessa matriz.
+ `RateCard`(matriz de objetos) - A matriz de dimensões e taxas do seu produto de aprendizado de máquina. Todos os tipos de instância compatíveis devem ter um preço para publicar seu produto.
+ `DimensionKey`- A dimensão que você está precificando. As chaves de dimensão válidas são:
+ Tipo de instância seguido pela operação para taxas horárias:
+ O tipo de instância começará com `ml` seguido pelo nome e tamanho da instância. Por exemplo, `ml.m4.xlarge`
+ A operação será `m.i.b` para transformação em lote, `m.i.r` para inferência em tempo real de hora em hora e `a.t` para treinamento de algoritmos.
+ Exemplos: `ml.m4.4xlarge.m.i.b` para transformação em lote, `ml.m4.xlarge.m.i.r` para inferência em tempo real ou `ml.m4.16xlarge.a.t` para treinamento de algoritmos
+ `m.i.c`para preços por inferência em tempo real.
+ `Price`- A taxa da dimensão. A taxa é por hora ou por inferência, dependendo da DimensionKey.
+ `Duration`(string) (obrigatório para `FreeTrialPricingTerm` ou `FixedUpfrontPricingTerm` - A duração do seu teste gratuito ou contrato. Para o teste gratuito, os valores válidos estão entre X e Y. Para o contrato, os valores válidos estão entre X e Y.
+ Subsídios (matriz de objetos) - Detalhes sobre quais DimensionKeys são elegíveis para teste gratuito. Todas as DimensionKeys suportadas devem ser fornecidas.
+ DimensionKey - A dimensão a ser incluída como parte da oferta de teste gratuito.
+ Tipo de instância seguido pela operação para taxas horárias:
+ O tipo de instância começa com `ml` seguido pelo nome e tamanho da instância, por exemplo `ml.m4.xlarge`
+ A operação é `m.i.b` para transformação em lote, `m.i.r` para inferência em tempo real de hora em hora ou `a.t` para treinamento de algoritmos.
+ Exemplos: `ml.m4.4xlarge.m.i.b` para transformação em lote, `ml.m4.xlarge.m.i.r` para inferência em tempo real ou `ml.m4.16xlarge.a.t` para treinamento de algoritmos
+ `m.i.c`para preços por inferência em tempo real.
## Sintaxe da resposta
Uma solicitação bem-sucedida retorna:
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
## Processamento do conjunto de alterações
A solicitação de alteração entra em uma fila de processamento, na qual passa por várias etapas:
1. Validação: o sistema verifica se todas as informações atendem às AWS Marketplace diretrizes.
+ Tempo de processamento: alguns minutos a várias horas
+ Para erros de validação, consulte [Status e erros do conjunto de alterações](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors).
1. Monitoramento de status: você pode verificar o status da solicitação de duas maneiras.
+ Por meio do Portal AWS Marketplace de Gerenciamento
+ Como usar a operação `DescribeChangeSet`
1. Conclusão: quando aprovados, os termos de preços são atualizados.
## Erros
**Erros assíncronos**
Erros específicos de `UpdatePricingTerms` ações podem ser recuperados usando a `DescribeChangeSet` operação após o início do processamento do conjunto de alterações. Para obter detalhes e solução de problemas, consulte [Status e erros do conjunto de alterações](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Código de erro | Mensagem de erro |
| --- | --- |
| STATUS DE PRODUTO\_INCOMPATÍVEL | Use um produto público ou limitado existente. |