Rozhraní API pro fakturaci na základě měření v Marketplace – nejčastější dotazy

Jakmile se zákazník přihlásí k odběru služby SaaS, Aplikace Azure s plánem Spravovaných aplikací nebo s nabídkou aplikace Kubernetes s účtovanou fakturací, budete sledovat spotřebu pro každou použitou dimenzi fakturace. Pokud spotřeba překročí zahrnuté množství nastavené pro termín vybraný zákazníkem, vaše služba bude generovat události využití do Microsoftu.

U nabídek SaaS, spravovaných aplikací a nabídek aplikací Kubernetes

Jak často se očekává generování využití?

V ideálním případě se očekává, že budete generovat využití každou hodinu za poslední hodinu, pouze pokud je využití v předchozí hodině.

Je mezi jednotlivými emisemi maximální období?

Neexistuje žádné takové omezení. Vygenerujte využití pouze v případě, že k němu dojde. Pokud například potřebujete odeslat jenom jednu jednotku využití za dobu životnosti předplatného, můžete to udělat.

Jaká je maximální prodleva mezi časem výskytu události a časem, kdy se microsoftu vygeneruje událost využití?

V ideálním případě se událost využití vygeneruje každou hodinu pro události, ke kterým došlo za poslední hodinu. Očekává se však zpoždění. Maximální povolená prodleva je 24 hodin, po které nebudou akceptované události využití. Osvědčeným postupem je shromáždit hodinové využití a vygenerovat jednu událost na konci hodiny.

Pokud se například událost využití vyskytuje v 13:00 dne, budete mít k dalšímu dni do 13:00, abyste vygenerovali událost využití přidruženou k této události. V případě, že systém generuje využití, může obnovit a pak odeslat událost využití po dobu hodiny, ve které došlo k využití, aniž by došlo ke ztrátě přesnosti.

Pokud po skutečném využití uplynulo 24 hodin, můžete spotřebované jednotky vygenerovat s pozdějšími událostmi využití. Tento postup ale může poškodit důvěryhodnost sestav fakturačních událostí pro koncového zákazníka. Doporučujeme, abyste se vyhnuli odesílání emisí měřičů jednou za den/týden/měsíc. Bude obtížnější porozumět skutečnému využití zákazníkem a vyřešit problémy nebo dotazy, které by mohly být vyvolány v souvislosti s událostmi využití.

Dalším důvodem, proč každou hodinu odesílat využití, je vyhnout se situacím, kdy uživatel zruší předplatné, než vydavatel odešle událost denních,týdenních/měsíčních emisí.

Co se stane, když odešlete více než jednu událost využití ve stejné hodině?

Pro jednohodinový interval je přijata pouze jedna událost použití. Interval hodin začíná minutou 0 a končí v minutě 59. Pokud se pro stejnou hodinu vygeneruje více než jedna událost využití, všechny následné události použití se zahodí jako duplicitní.

Co se stane, když zákazník zruší nákup v době povolené zásadami zrušení?

Částka s plochou sazbou se neúčtuje, ale využití nadlimitního využití bude.

Dají se vlastní plány měřičů používat pro jednorázové platby?

Ano, vlastní dimenzi můžete definovat jako jednu jednotku jednorázové platby a generovat ji pouze jednou pro každého zákazníka.

Dají se vlastní plány měřičů použít k vrstvenému cenovému modelu?

Ano, dá se implementovat s každou vlastní dimenzí představující jednu cenovou úroveň.

Contoso například chce účtovat 0,5 USD za e-maily za prvních 1 000 e-mailů, 0,4 USD za e-mail mezi 1 000 a 5000 e-maily a 0,2 USD za e-mail za více než 5 000 e-mailů. Mohou definovat tři vlastní dimenze, které odpovídají třem cenovým úrovním e-mailu. Generovat jednotky první dimenze, pokud počet e-mailů zůstává nižší než 1 000, pak jednotky druhé dimenze, pokud je počet e-mailů v rozmezí 1000 až 5000 a nakonec jednotky třetí dimenze pro více než 5000 e-mailů.

Co se stane, když má služba měření marketplace výpadek?

Pokud isV odešle vlastní měřič a obdrží chybu, která mohla být způsobena problémem na straně Microsoftu (obvykle v případě podobných událostí byly přijaty dříve bez chyby), měl by isV počkat a zkusit emise zopakovat.

Pokud chyba přetrvává, znovu odešlete vlastní měřič následující hodinu (kumulujte množství). Pokračujte v tomto procesu, dokud se nezobrazí chybová odpověď.

Pouze pro nabídky SaaS

Co se stane, když vygenerujete využití pro předplatné SaaS, které už bylo odhlášené?

Po odstranění odběru SaaS se nepřijmou žádná událost využití vygenerovaná na platformě Marketplace.

Využití je možné generovat pouze pro předplatná ve stavu Přihlášení k odběru (a ne pro předplatná v PendingFulfillmentStart, Suspendednebo Unsubscribed stav).

Jedinou výjimkou je generování sestav využití po dobu, která byla před zrušením předplatného SaaS.

Zákazník například dnes zrušil předplatné SaaS na 3:00. Nyní je 5:00, vydavatel může dál generovat využití pro období od 18:00 do 33:00 dnes pro toto předplatné SaaS.

Můžete získat seznam všech předplatných SaaS, včetně aktivních a odhlášovaných předplatných?

Ano, když zavoláte rozhraní API pro seznam předplatných GET, protože obsahuje seznam všech předplatných SaaS. Pole stavu v odpovědi pro každé předplatné SaaS zaznamenává, jestli je předplatné aktivní nebo odhlášené.

Souvisí počáteční a koncové datum období předplatného SaaS a emise využití nadlimitního využití?

Události nadlimitního využití je možné generovat v jakémkoli okamžiku pro stávající odběr SaaS ve stavu Přihlášení k odběru . Je zodpovědností vydavatele generovat události využití na základě zásad definovaných v fakturačním plánu. Nadlimitní využití se musí vypočítat na základě dat definovaných v období předplatného SaaS.

Pokud například vydavatel definuje plán SaaS, který zahrnuje 1 000 e-mailů za 100 USD v měsíční ploché sazbě, bude každý e-mail nad 1000 USD fakturován prostřednictvím vlastní dimenze.

Když si zákazník koupí a aktivuje předplatné 6. ledna, bude se od tohoto dne počítat 1000 e-mailů zahrnutých v paušální sazbě. Pokud tedy do 5. února (konec prvního měsíce předplatného) odešlete jenom 900 e-mailů, zákazník zaplatí pevnou sazbu jenom pro první měsíc tohoto předplatného a vydavatele od 6. ledna do 5. února nevygeneruje žádné události využití nadlimitního využití. 6. února se předplatné automaticky obnoví a počet se znovu spustí. Pokud zákazník dosáhl 15. února 1000 odeslaných e-mailů, budou se zbývající e-maily odeslané do 5. března účtovat jako nadlimitní využití (1 USD na e-mail) na základě událostí využití nadlimitního využití generované vydavatelem.

Další kroky

  • Další informace najdete v tématu Rozhraní API služby měření marketplace.