Árlista lekérése

  • Cikk

Ez a cikk azt ismerteti, hogyan kaphat árlistát egy adott piachoz és nézethez. Ez a módszer támogatja a szűrőket, hogy hónap szerint lekérje az előzményeket.

Előfeltételek

  • Hitelesítő adatok a Partner API-hitelesítésben leírtak szerint. Ez a forgatókönyv csak az alkalmazásfelhasználói hitelesítést támogatja. A csak alkalmazás még nem támogatott. A http-hibát:400 hibát tapasztaló partnereknek a Partner API hitelesítési dokumentációjában kell tájékozódnia.
  • Ez az API jelenleg csak olyan felhasználói hozzáférést támogat, ahol a partnereknek a következő szerepkörök egyikében kell lenniük: globális Rendszergazda, Rendszergazda ügynök vagy értékesítési ügynök.

Részletek

  • Az aktuális adatok csak az Azure-csomaghasználat és -foglalások, a licencelt alapú (új kereskedelmi felület) és a Marketplace-termékek esetében ad vissza adatokat.
  • A jelenlegi díjszabás az aktuális hónapban elérhető összes mérőt és terméket tartalmazza az API meghívásának időpontjáig. Az előző hónapok tartalmazzák az adott hónaphoz elérhető összes mérőt és terméket.
  • A fogyasztásmérő árai csak USD-ben vannak, a partnereknek a devizaárfolyam-API-t kell használniuk a helyi pénznemköltségek kiszámításához.
  • A fogyasztásmérők ára a kiskereskedelmi árak becsült értéke. A partneri kedvezmények partneri jóváíráson keresztül érhetők el.
  • A foglalások forgalmi díjai tartalmazzák a CSP-partnerek kedvezményeit. A foglalások becsült kiskereskedelmi árai a Partnerközpont "Díjszabás és ajánlatok" oldaláról letölthető megosztott foglalási szolgáltatásokban találhatók.
  • Az Azure-csomagok díjszabásával kapcsolatos további információk az Azure-csomag díjszabási dokumentációjában találhatók.
  • A partner díjszabása és a devizaárfolyam API-k nem részei a Partnerközpont SDK-nak.
  • Ez a metódus fájlstreamként adja vissza az árlistát. A fájlstream egy .csv fájl, vagy a .csv tömörített zip-verziója. A tömörített fájlok kérésének részletei az alábbiakban találhatók.

REST-kérés

Kérés szintaxisa

Metódus Kérés URI-ja
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value

URI szükséges paraméterek

Az alábbi elérésiút-paraméterekkel kérheti le a kívánt piac- és árlistatípust.

Név Típus Kötelező Leírás
Piac sztring Igen Kétbetűs ország-/régiókód a kért piachoz
PricesheetView sztring Igen A kért árlista típusa, amely lehet azure_consumption, azure_reservations, frissítettlicensebased, piactér vagy szoftver.

Feljegyzés

Az updatedlicensebased PriceSheetView jelenleg csak a Microsoft 365/Microsoft Dynamics 365 új kereskedelmi felület technikai előzetes verziójának részét képező partnerek számára érhető el.

Feljegyzés

A szoftverárak listája 2022. április 1-től lesz elérhető az API-val.

URI-szűrőparaméterek

Használja a következő szűrőparamétereket.

Név Típus Kötelező Leírás
Idősor húr Nem Alapértelmezett érték az aktuális értékre, ha nem ad át. Lehetséges értékek a történelem, az aktuális és a jövő.
Month húr Nem Csak előzménykérés esetén kötelező megadni az YYYYMM-et a kért árlistához.

Feljegyzés

A jövőbeli díjszabás nem támogatott a Marketplace-en. 2022. április 1-től a partnerek 2022. márciusi előzményekkel tekinthetik meg a szoftverárlista előzményeit az API-val.

Kérésfejlécek

A fenti fejléceken kívül a díjszabási fájlok tömörítettként is lekérhetők, csökkentve a sávszélességet és a letöltési időt. Alapértelmezés szerint a fájlok nem lesznek tömörítve. A fájlok tömörített verzióinak lekéréséhez az alábbi fejlécértéket is megadhatja. Tudja meg, hogy a tömörített lapok csak 2020 áprilisától érhetők el, a 2020 áprilisa előtti lapok csak nem tömörítettként érhetők el.

Fejléc Érték típusa Érték Leírás
Accept-Encoding húr Deflate Opcionális. Ha a kihagyott fájlstream nincs tömörítve.

Példa kérése

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

Példa kérése új kereskedelemhez

Feljegyzés

Az updatedlicensebased PriceSheetView jelenleg csak a Microsoft 365/Microsoft Dynamics 365 új kereskedelmi felület technikai előzetes verziójának részét képező partnerek számára érhető el.

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

REST-válasz

Ha sikeres, ez a metódus fájlstreamként adja vissza az árlistát. A fájlstream egy .csv fájl, vagy a .csv tömörített zip-verziója.

Válasz példa új kereskedelemhez

Feljegyzés

Az updatedlicensebased PriceSheetView jelenleg csak a Microsoft 365/Microsoft Dynamics 365 új kereskedelmi felület technikai előzetes verziójának részét képező partnerek számára érhető el.

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 ==============

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint egyéb hibakeresési információkat. A kód, hibatípus és egyéb paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Hibakódok című témakörben találja.

Ha nem várható változás az új kereskedelmi licencalapú jövőbeli árlistán, nem lesz visszaadott jövőbeli árlista. Ha a jövőben a frissített PriceSheetView-hoz kért ütemtervbe kerül, a partnerek a következő API-válaszkódot fogják látni: 404 Nem található.

Következő lépések