Ottenere un elenco prezzi
Questo articolo illustra come ottenere un elenco prezzi per un determinato mercato e una determinata visualizzazione. Questo metodo supporta i filtri per ottenere la cronologia per mese.
Prerequisiti
- Credenziali descritte in Autenticazione per l'API Partner. Questo scenario supporta solo l'autenticazione dell'utente dell'applicazione. La sola applicazione non è ancora supportata. I partner che riscontrano l'errore http:400 devono consultare la documentazione relativa all'autenticazione dell'API partner.
- Questa API supporta attualmente solo l'accesso utente in cui i partner devono trovarsi in uno dei ruoli seguenti: Agente amministratore o Agente di vendita.
Dettagli
- I dati correnti restituiscono solo i dati relativi all'utilizzo e alle prenotazioni del piano di Azure, basati su licenza (nuova esperienza commerciale) e ai prodotti Marketplace.
- I prezzi correnti includono tutti i contatori e i prodotti disponibili durante il mese corrente fino alla data in cui viene richiamata l'API. I mesi precedenti includono tutti i contatori e i prodotti disponibili per il mese specificato.
- I prezzi dei contatori dei consumi sono solo in USD, i partner devono usare l'API dei tassi di cambio esteri per calcolare i costi di valuta locale.
- I prezzi dei contatori di consumo sono i prezzi al dettaglio stimati. Gli sconti per i partner sono disponibili tramite il credito ottenuto dai partner.
- I prezzi del contatore delle prenotazioni includono gli sconti per i partner CSP. I prezzi al dettaglio stimati per le prenotazioni sono disponibili nella pagina "Prezzi e offerte" del Centro per i partner.
- Altre informazioni sui prezzi dei piani di Azure sono disponibili nella documentazione sui prezzi del piano di Azure.
- Le API dei prezzi dei partner e del tasso di cambio estero non fanno parte dell'SDK del Centro per i partner.
- Questo metodo restituisce il listino prezzi come flusso di file. Il flusso di file è un file .csv o una versione compressa zip del .csv. Di seguito sono riportate informazioni dettagliate su come richiedere file compressi.
Richiesta REST
Sintassi della richiesta
| metodo | URI della richiesta |
|---|---|
| GET | https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value |
Parametri obbligatori dell'URI
Utilizzare i parametri di percorso seguenti per richiedere il mercato e il tipo di elenco prezzi desiderato.
| Nome | Digita | Obbligatorio | Descrizione |
|---|---|---|---|
| Mercato | string | Sì | Codice paese/area geografica di due lettere per il mercato richiesto |
| PricesheetView | string | Sì | Tipo di elenco prezzi richiesto, che può essere azure_consumption, azure_reservations, aggiornatolicensebased, licensebasedbeta (per includere la colonna dell'indicatore di modifica), marketplace o software. |
Nota
updatedlicensebased PriceSheetView è attualmente disponibile solo per i partner che fanno parte di Microsoft 365/Microsoft Dynamics 365 nuova esperienza commerciale Technical Preview.
Nota
L'elenco prezzi basato sulla licenza di fine vendita è disponibile solo per il download tramite l'esperienza utente del Centro per i partner in questo momento.
Parametri di filtro URI
Usare i parametri di filtro seguenti.
| Nome | Digita | Obbligatorio | Descrizione |
|---|---|---|---|
| Sequenza temporale | string | No | L'impostazione predefinita è corrente se non viene passato. I valori possibili sono cronologia, corrente e futura. |
| Month | string | No | Obbligatorio solo se viene richiesta la cronologia, deve rispettare YYYYMM per il listino prezzi richiesto. |
Nota
I prezzi futuri non sono supportati per Marketplace. Dal 1° aprile 2022, i partner potranno visualizzare la cronologia del listino prezzi software tramite API, a partire dalla cronologia di marzo 2022.
Intestazioni delle richieste
- Per altre informazioni, vedere Intestazioni REST dei partner.
Oltre alle intestazioni precedenti, i file dei prezzi possono essere recuperati come compressi riducendo la larghezza di banda e i tempi di download. Per impostazione predefinita, i file non vengono compressi. Per ottenere versioni compresse dei file, è possibile includere il valore di intestazione seguente. Tenere presente che i fogli compressi sono disponibili solo da aprile 2020 in poi, tutti i fogli precedenti ad aprile 2020 sono disponibili solo come non compressi.
| Intestazione | Tipo di valore | valore | Descrizione |
|---|---|---|---|
| Accept-Encoding | string | deflate | Facoltativo. Se il flusso di file omesso non è compresso. |
Esempio di richiesta
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com
Esempio di richiesta per il nuovo commercio
Nota
updatedlicensebased PriceSheetView è attualmente disponibile solo per i partner che fanno parte di Microsoft 365/Microsoft Dynamics 365 nuova esperienza commerciale Technical Preview.
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com
Risposta REST
In caso di esito positivo, questo metodo restituisce il listino prezzi come flusso di file. Il flusso di file è un file .csv o una versione compressa zip del .csv.
Esempio di risposta per il nuovo commercio
Nota
updatedlicensebased PriceSheetView è attualmente disponibile solo per i partner che fanno parte di Microsoft 365/Microsoft Dynamics 365 nuova esperienza commerciale Technical Preview.
HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=sheets.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT
"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price"
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============
Codici di errore e di esito della risposta
Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore.
Se non sono previste modifiche per il nuovo listino prezzi futuro basato su licenza commerciale, non verrà restituito alcun listino prezzi futuro. Quando si passa il futuro nella sequenza temporale richiesta per l'aggiornamentolicensebased PriceSheetView, i partner visualizzeranno il codice di risposta API seguente: 404 Non trovato.