View a markdown version of this page

Aggiorna i termini di prezzo - Marketplace AWS
Sintassi della richiestaCampi obbligatoriSintassi della rispostaElaborazione del set di modificheErrori

L'AWS Marketplace API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Marketplace API Reference.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiorna i termini di prezzo

Puoi utilizzare l'API Catalog per aggiornare i prezzi dei tuoi prodotti di machine learning in Marketplace AWS.

Nota

Devi stabilire il prezzo di tutti i tipi di istanze supportati dei tuoi prodotti di machine learning. Quando crei la tua prima versione, imposta UpdatePricingTerms e AddDeliveryOptions modifica i tipi con i prezzi per tutti i tipi di istanze supportati per pubblicare il prodotto. Quando si aggiunge una nuova versione a un prodotto esistente con nuovi tipi di istanze che non erano supportati in precedenza, è necessario includere tali tipi di istanza nei tipi UpdatePricingTerms e AddDeliveryOptions modificare.

Per aggiornare le condizioni di prezzo, chiama l'StartChangeSetoperazione con il tipo di UpdatePricingTerms modifica.

Sintassi della richiesta

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"
                              }
                        ]
                    }
                ]
            }
        },
    ]
}

Campi obbligatori

  • Entity(oggetto) (obbligatorio): contiene informazioni sull'offerta del prodotto ML.

    • Identifier(stringa) (obbligatorio): l'ID dell'offerta per cui desideri aggiornare i termini di prezzo. Per ulteriori informazioni, consulta Identifier.

    • Type(string) (obbligatorio): Type deve essere utilizzato Offer@1.0 per aggiornare i prezzi.

  • DetailsDocument(oggetto) (obbligatorio): dettagli sui termini di prezzo del prodotto di machine learning.

    • PricingModel(stringa) (obbligatorio) - Il modello di prezzo del prodotto: puoi scegliere tra Utilizzo, Gratuito e Contratto (per le offerte private). Per ulteriori informazioni, consulta la pagina dei prezzi dei prodotti Machine Learning.

    • Terms(serie di oggetti): una serie di termini di prezzo che definiscono collettivamente il prezzo complessivo del prodotto.

      • Type(stringa) (obbligatorio): il tipo di termine tariffario. Le opzioni valide sono UsageBasedPricingTerm FreeTrialPricingTerm o o FixedUpfrontPricingTerm (per le offerte private).

      • CurrencyCode(stringa) (obbligatorio per UsageBasedPricingTerm o FixedUpfrontPricingTerm - la valuta del termine di determinazione del prezzo. I valori validi sono USD.

      • RateCards(serie di oggetti) (obbligatorio perUsageBasedPricingTerm): le schede tariffarie che definiscono i prezzi del prodotto di machine learning. È necessario includerne uno RateCard solo all'interno di questo array.

        • RateCard(matrice di oggetti): la gamma di dimensioni e tariffe per il tuo prodotto di apprendimento automatico. Tutti i tipi di istanze supportati devono avere un prezzo per poter pubblicare il prodotto.

          • DimensionKey- La dimensione a cui stai assegnando il prezzo. Le chiavi dimensionali valide sono:

            • Tipo di istanza seguito dall'operazione per le tariffe orarie:

              • Il tipo di istanza inizierà con ml seguito dal nome e dalla dimensione dell'istanza. Ad esempio, ml.m4.xlarge

              • Il funzionamento riguarderà m.i.b la trasformazione in batch, m.i.r l'inferenza oraria in tempo reale e a.t l'addestramento degli algoritmi.

              • Esempi: ml.m4.4xlarge.m.i.b per la trasformazione in batch, per l'inferenza in tempo reale o ml.m4.xlarge.m.i.r ml.m4.16xlarge.a.t per l'addestramento degli algoritmi

            • m.i.cper prezzi per inferenza in tempo reale.

          • Price- La velocità della dimensione. La velocità è oraria o per inferenza, a seconda di DimensionKey.

      • Duration(stringa) (obbligatorio per FreeTrialPricingTerm o FixedUpfrontPricingTerm - La durata della prova gratuita o del contratto. Per la prova gratuita i valori validi sono compresi tra X e Y. Per il contratto, i valori validi sono compresi tra X e Y.

      • Sovvenzioni (serie di oggetti) - Dettagli su quali DimensionKeys sono idonei alla prova gratuita. Devono essere fornite tutte le DimensionKey supportate.

        • DimensionKey - La dimensione da includere nell'offerta di prova gratuita.

          • Tipo di istanza seguito dall'operazione per le tariffe orarie:

            • Il tipo di istanza inizia con ml seguito dal nome e dalla dimensione dell'istanza, ad es. ml.m4.xlarge

            • L'operazione è m.i.b per la trasformazione in batch, m.i.r per l'inferenza oraria in tempo reale o a.t per l'addestramento degli algoritmi.

            • Esempi: ml.m4.4xlarge.m.i.b per la trasformazione in batch, per l'inferenza in tempo reale o ml.m4.xlarge.m.i.r ml.m4.16xlarge.a.t per l'addestramento degli algoritmi

          • m.i.cper prezzi per inferenza in tempo reale.

Sintassi della risposta

Una richiesta riuscita restituisce:

{
    "ChangeSetId": "example123456789012abcdef",
    "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Elaborazione del set di modifiche

La richiesta di modifica entra in una coda di elaborazione, dove viene sottoposta a diversi passaggi:

  1. Convalida: il sistema verifica che tutte le informazioni soddisfino le linee guida. Marketplace AWS

  2. Monitoraggio dello stato: puoi controllare lo stato della richiesta in due modi.

    • Tramite il portale Marketplace AWS di gestione

    • Utilizzo dell'operazione DescribeChangeSet

  3. Completamento: una volta approvate, le condizioni tariffarie vengono aggiornate.

Errori

Errori asincroni

Gli errori specifici relativi alle UpdatePricingTerms azioni possono essere recuperati utilizzando l'DescribeChangeSetoperazione dopo l'inizio dell'elaborazione del set di modifiche. Per i dettagli sugli errori e la risoluzione dei problemi, vedere Modificare lo stato e gli errori del set.

Codice di errore Messaggio di errore
INCOMPATIBLE_PRODUCT_STATUS Utilizza un prodotto pubblico o limitato esistente.