Piactéri számlázási API-k - GYIK

Miután egy ügyfél előfizet egy SaaS-szolgáltatásra, Azure-alkalmazás egy Felügyelt alkalmazások csomaggal vagy a Kubernetes-alkalmazásajánlatot forgalmi díjas számlázással, nyomon fogja követni az egyes használt számlázási dimenziók fogyasztását. Ha a felhasználás meghaladja az ügyfél által kiválasztott kifejezéshez beállított mennyiséget, a szolgáltatás használati eseményeket bocsát ki a Microsoftnak.

SaaS-ajánlatok, felügyelt alkalmazások és Kubernetes-alkalmazásajánlatok esetén

Milyen gyakran kell használatot kibocsátani?

Ideális esetben az elmúlt órában óránkénti használatot kell kibocsátani, csak akkor, ha az előző órában van használat.

Van-e maximális időszak az egyik kibocsátás és a következő között?

Nincs ilyen korlátozás. Csak a használat során bocsát ki használatot. Ha például előfizetésenként csak egy használati egységet kell elküldenie, megteheti.

Mennyi a maximális késés az esemény bekövetkezése és a Használati esemény a Microsoft számára történő kibocsátása között?

Ideális esetben a használati esemény óránként lesz kibocsátva az elmúlt órában történt eseményekhez. Késések azonban várhatók. A maximális késleltetés 24 óra, amely után a használati események nem lesznek elfogadva. Az ajánlott eljárás az óránkénti használat összegyűjtése, és a kibocsátás egy esemény az óra végén.

Ha például egy használati esemény egy napon 13:00-kor történik, a következő napon 13:00 óráig kell kibocsátania az eseményhez társított használati eseményt. Ha a használatot kibocsátó rendszer leáll, helyreállíthatja, majd elküldheti a használati eseményt arra az óraintervallumra, amelyben a használat történt, a hűség elvesztése nélkül.

Ha a tényleges használat után 24 óra telt el, akkor is kibocsáthatja a felhasznált egységeket későbbi használati eseményekkel. Ez a gyakorlat azonban ronthatja a végfelhasználó számlázási eseményjelentéseinek hitelességét. Javasoljuk, hogy ne küldjön fogyasztásmérő-kibocsátást naponta/hetente/havonta egyszer. Nehezebb lesz megérteni az ügyfél tényleges használatát, és megoldani a használati eseményekkel kapcsolatban felmerülő problémákat vagy kérdéseket.

A használat óránkénti küldésének másik oka, hogy elkerüljük azokat az eseteket, amikor a felhasználó lemondja az előfizetést, mielőtt a közzétevő elküldi a napi/heti/havi kibocsátási eseményt.

Mi történik, ha egy órán belül több használati eseményt küld?

Az egyórás időköz csak egy használati eseményt fogad el. Az óraintervallum a 0. percben kezdődik, és az 59. percben ér véget. Ha egy órán keresztül több használati eseményt bocsát ki, az azt követő használati események ismétlődésekként lesznek elvetve.

Mi történik, ha az ügyfél a lemondási szabályzat által megengedett időn belül lemondja a vásárlást?

Az átalányösszeget nem számítjuk fel, de a túlhasználat lesz.

Használhatók egyéni fogyasztásmérő-csomagok egyszeri kifizetésekhez?

Igen, megadhat egy egyéni dimenziót az egyszeri fizetés egy egységeként, és minden ügyfél számára csak egyszer bocsáthatja ki.

Használhatók egyéni fogyasztásmérő-csomagok a rétegzett díjszabási modellhez?

Igen, mindegyik egyéni dimenzióval implementálható, amely egyetlen árszintet képvisel.

A Contoso például e-mailbenként 0,5 dollárt szeretne fizetni az első 1000 e-mailért, 1000 és 5000 közötti e-mailenként 0,4 dollárt, 5000 e-mail felett pedig 0,2 dollárt. Három egyéni dimenziót határozhatnak meg, amelyek megfelelnek a három e-mail tarifacsomagnak. Az első dimenzió egységeinek kibocsátása mindaddig, amíg az e-mailek száma 1000 alatt marad, majd a második dimenzió egységei, amikor az e-mailek száma 1000 és 5000 között van, végül pedig a harmadik dimenzió egységei 5000 e-mail felett.

Mi történik, ha a Marketplace forgalmi díjas szolgáltatás leáll?

Ha az ISV küld egy egyéni mérőt, és hibaüzenetet kap, amelyet a Microsoft oldalán fellépő probléma okozhatott (általában abban az esetben, ha korábban hiba nélkül hasonló eseményeket fogadtak el), akkor az ISV-nek várnia kell, és újra meg kell próbálkoznia a kibocsátással.

Ha a hiba továbbra is fennáll, a következő órában küldje újra az egyéni mérőt (halmozódja fel a mennyiséget). Folytassa ezt a folyamatot, amíg nem érkezik hibamentes válasz.

Csak SaaS-ajánlatok esetén

Mi történik, ha olyan SaaS-előfizetés használatát bocsátja ki, amelyet már leiratkozott?

A piactéri platformon kibocsátott használati események nem lesznek elfogadva egy SaaS-előfizetés törlése után.

A használat csak a Feliratkozott állapotú előfizetések esetében adható ki (és nem a ( vagy Unsubscribed állapotúPendingFulfillmentStart) Suspendedelőfizetésekhez.

Az egyetlen kivétel a használat jelentése az SaaS-előfizetés lemondása előtti időpontra vonatkozóan.

Az ügyfél például ma 15:00-kor lemondta az SaaS-előfizetést. Most 17:00 van, a kiadó továbbra is kibocsáthatja a használatot a tegnap 18:00 és ma 15:00 között az SaaS-előfizetéshez.

Lekérheti az összes SaaS-előfizetés listáját, beleértve az aktív és leiratkozott előfizetéseket is?

Igen, amikor meghívja a GET Subscriptions List API-t , mivel az tartalmazza az összes SaaS-előfizetés listáját. Az egyes SaaS-előfizetések válaszában szereplő állapotmező rögzíti, hogy az előfizetés aktív vagy leiratkozott-e.

Csatlakoznak az SaaS-előfizetési időszak és a túlhasználati felhasználás kibocsátásának kezdő és záró dátumai?

A túlhasználati események bármikor kibocsáthatók a meglévő, előfizetéses állapotú SaaS-előfizetések esetében. A közzétevő felelőssége, hogy használati eseményeket bocsát ki a számlázási tervben meghatározott szabályzat alapján. A túlhasználatot az SaaS-előfizetés időtartamában meghatározott dátumok alapján kell kiszámítani.

Ha például a közzétevő egy Olyan SaaS-csomagot határoz meg, amely havi átalánydíjban 1000 ft-ért 1000 e-mailt tartalmaz, az 1000 feletti e-mailek számlázása 1 usd egyéni dimenzión keresztül történik.

Amikor az ügyfél január 6-án megvásárolja és aktiválja az előfizetést, az átalánydíjban szereplő 1000 e-mail ezen a napon kezdődik. Tehát ha február 5-ig (az előfizetés első hónapjának végéig) csak 900 e-mailt küldenek, az ügyfél csak az előfizetés első hónapjára fizeti ki a rögzített díjat, és a közzétevő nem bocsát ki túlhasználati használati eseményeket január 6. és február 5. között. Február 6-án az előfizetés automatikusan megújul, és a darabszám újra megkezdődik. Ha február 15-én az ügyfél elérte az 1000 elküldött e-mailt, a március 5-ig küldött többi e-mailt túlhasználatként (e-mailenként 1 USD) számítjuk fel a közzétevő által kibocsátott túlhasználati használati események alapján.

További lépések