Se reestructuró la referencia de API de AWS Marketplace. Para obtener más información sobre las operaciones de API compatibles, consulte la [referencia de API de AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Actualización de las condiciones de precios
Puedes usar la API de catálogo para actualizar los precios de tus productos de aprendizaje automático AWS Marketplace.
**nota**
Debe fijar el precio de todos los tipos de instancias compatibles de sus productos de aprendizaje automático. Al crear tu primera versión, `AddDeliveryOptions` cambia `UpdatePricingTerms` los tipos con los precios de todos los tipos de instancias compatibles para poder publicar tu producto. Al añadir una nueva versión a un producto existente con nuevos tipos de instancias que antes no se admitían, debe incluir esos tipos de instancias en los tipos de instancias `UpdatePricingTerms` y `AddDeliveryOptions` cambiar los tipos.
Para actualizar las condiciones de precios, llama a la `StartChangeSet` operación con el tipo de `UpdatePricingTerms` cambio.
## Sintaxis de la solicitud
```
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 obligatorios
+ `Entity`(objeto) (obligatorio): contiene información sobre la oferta de tu producto ML.
+ `Identifier`(cadena) (obligatorio): el identificador de la oferta para el que deseas actualizar las condiciones de precios. Para obtener más información, consulta [Identificador](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
+ `Type`(string) (obligatorio): `Type` imprescindible `Offer@1.0` para actualizar los precios.
+ `DetailsDocument`(objeto) (obligatorio): detalles sobre las condiciones de precios de su producto de aprendizaje automático.
+ `PricingModel`(string) (obligatorio): el modelo de precios de tu producto: puedes elegir entre uso, gratuito y por contrato (en el caso de ofertas privadas). Para obtener más información, consulte los [precios de los productos Machine Learning](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-pricing.html).
+ `Terms`(conjunto de objetos): conjunto de términos de precios que definen de forma conjunta el precio general del producto.
+ `Type`(string) (obligatorio): tipo de término de precio. Las opciones válidas son `UsageBasedPricingTerm` `FreeTrialPricingTerm` o o `FixedUpfrontPricingTerm` (para ofertas privadas).
+ `CurrencyCode`(cadena) (obligatorio para `UsageBasedPricingTerm` o`FixedUpfrontPricingTerm`: la moneda del plazo de fijación de precios). Los valores válidos son `USD`.
+ `RateCards`(conjunto de objetos) (obligatorio para`UsageBasedPricingTerm`): las tablas de tarifas que definen el precio de su producto de aprendizaje automático. Debe incluir uno `RateCard` solo dentro de esta matriz.
+ `RateCard`(matriz de objetos): la matriz de dimensiones y velocidades de su producto de aprendizaje automático. Todos los tipos de instancias compatibles deben tener un precio para poder publicar el producto.
+ `DimensionKey`- La dimensión a la que estás fijando el precio. Las claves de dimensión válidas son:
+ El tipo de instancia seguido de la operación para las tarifas por hora:
+ El tipo de instancia empezará por `ml` seguido del nombre y el tamaño de la instancia. Por ejemplo, `ml.m4.xlarge`
+ La operación se utilizará `m.i.b` para la transformación por lotes, `m.i.r` para la inferencia en tiempo real cada hora y `a.t` para el entrenamiento de algoritmos.
+ Ejemplos: `ml.m4.4xlarge.m.i.b` para la transformación por lotes, `ml.m4.xlarge.m.i.r` para la inferencia en tiempo real o `ml.m4.16xlarge.a.t` para el entrenamiento de algoritmos
+ `m.i.c`para fijar precios por inferencia en tiempo real.
+ `Price`- La tasa de la dimensión. La tarifa es por hora o por inferencia, según la DimensionKey.
+ `Duration`(string) (obligatorio para `FreeTrialPricingTerm` o`FixedUpfrontPricingTerm`: la duración de la prueba gratuita o del contrato. Para la prueba gratuita, los valores válidos están entre X e Y. Para el contrato, los valores válidos están entre X e Y.
+ Subvenciones (conjunto de objetos): detalles sobre las DimensionKeys que pueden optar a una prueba gratuita. Se deben proporcionar todas las DimensionKeys compatibles.
+ DimensionKey - La dimensión que se incluirá como parte de la oferta de prueba gratuita.
+ Tipo de instancia seguido de la operación para las tarifas por hora:
+ El tipo de instancia empieza por `ml` seguido del nombre y el tamaño de la instancia, p. ej. `ml.m4.xlarge`
+ La operación es `m.i.b` para la transformación por lotes, `m.i.r` para la inferencia en tiempo real cada hora o `a.t` para el entrenamiento de algoritmos.
+ Ejemplos: `ml.m4.4xlarge.m.i.b` para la transformación por lotes, `ml.m4.xlarge.m.i.r` para la inferencia en tiempo real o `ml.m4.16xlarge.a.t` para el entrenamiento de algoritmos
+ `m.i.c`para fijar precios por inferencia en tiempo real.
## Sintaxis de la respuesta
Si la solicitud se realiza correctamente, se devuelve:
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
## Procesamiento del conjunto de cambios
La solicitud de cambio entra en una cola de procesamiento, donde se somete a varios pasos:
1. Validación: el sistema comprueba que toda la información cumpla con AWS Marketplace las directrices.
+ Tiempo de procesamiento: de unos minutos a varias horas
+ Para ver los errores de validación, consulte [Cambiar el estado y los errores del conjunto](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors).
1. Supervisión del estado: puede comprobar el estado de la solicitud de dos maneras.
+ A través AWS Marketplace del portal de administración
+ Usar la operación `DescribeChangeSet`
1. Finalización: cuando se aprueban, las condiciones de precios se actualizan.
## Errores
**Errores asíncronos**
Los errores específicos de las `UpdatePricingTerms` acciones se pueden recuperar mediante la `DescribeChangeSet` operación una vez que el conjunto de cambios comience a procesarse. Para obtener información sobre los errores y solucionar problemas, consulte [Cambiar el estado y los errores del conjunto](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| INCOMPATIBLE\_PRODUCT\_STATUS | Usa un producto público o limitado existente. |