Share via

Ottenere un elenco prezzi

  • Articolo

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 utente dell'applicazione. L'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: Global Amministrazione, Amministrazione Agent o Sales Agent.

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 chiamata 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, marketplace o software.

Nota

updatedlicensebased PriceSheetView è attualmente disponibile solo per i partner che fanno parte di Microsoft 365/Microsoft Dynamics 365 new commerce experience Technical Preview.

Nota

Il listino prezzi software sarà disponibile tramite l'API a partire dal 1° aprile 2022.

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.
Mese 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 Sgonfiare 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 new commerce experience 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 new commerce experience 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.

Passaggi successivi