L'AWS Marketplace API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'[AWS Marketplace API Reference](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
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'`StartChangeSet`operazione 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#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](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-pricing.html).
+ `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 per`UsageBasedPricingTerm`): 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.c`per 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.c`per 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
+ Tempo di elaborazione: da pochi minuti a diverse ore
+ Per gli errori di convalida, vedi [Modificare lo stato e gli errori del set](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors).
1. Monitoraggio dello stato: puoi controllare lo stato della richiesta in due modi.
+ Tramite il portale Marketplace AWS di gestione
+ Utilizzo dell'operazione `DescribeChangeSet`
1. Completamento: una volta approvate, le condizioni tariffarie vengono aggiornate.
## Errori
**Errori asincroni**
Gli errori specifici relativi alle `UpdatePricingTerms` azioni possono essere recuperati utilizzando l'`DescribeChangeSet`operazione 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INCOMPATIBLE\_PRODUCT\_STATUS | Utilizza un prodotto pubblico o limitato esistente. |