View a markdown version of this page

Actualización de las condiciones de precios - AWS Marketplace
Sintaxis de la solicitudCampos obligatoriosSintaxis de la respuestaProcesamiento del conjunto de cambiosErrores

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.

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.

    • 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.

    • 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 oFixedUpfrontPricingTerm: la moneda del plazo de fijación de precios). Los valores válidos son USD.

      • RateCards(conjunto de objetos) (obligatorio paraUsageBasedPricingTerm): 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.cpara 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 oFixedUpfrontPricingTerm: 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.cpara 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.

  2. 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

  3. 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.

Código de error Mensaje de error
INCOMPATIBLE_PRODUCT_STATUS Usa un producto público o limitado existente.