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.

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

  • 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 paraUsageBasedPricingTerm) - 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.cpara 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.cpara 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.

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

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

Código de erro	Mensagem de erro
STATUS DE PRODUTO_INCOMPATÍVEL	Use um produto público ou limitado existente.