Sdílet prostřednictvím


Rozhraní API fakturace účtované podle měrného 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 aplikace Kubernetes s fakturací s měřením dat, může 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, služba do Microsoftu vysílá události využití.

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 ale zpoždění. Maximální povolené zpoždění je 24 hodin, po kterých se události využití nepřijímají. Osvědčeným postupem je shromáždit hodinové využití a generovat ho jako 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. Pokud je systém generující využití nižší, může se obnovit a pak odeslat událost využití pro hodinový interval, ve kterém došlo k využití, aniž by došlo ke ztrátě přesnosti. Pokud po skutečném využití projde 24 hodin, můžete spotřebované jednotky vygenerovat s událostmi pozdějšího 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. Je 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ší odběr, než vydavatel odešle událost denních,týdenních/měsíčních emisí.

Poznámka

24hodinové zpoždění odesílání událostí využití platí i pro převedené nebo upgradované plány. Pokud zákazník plán upgraduje na nový plán, musí být využití předchozího plánu hlášeno do 24 hodin od převodu plánu.

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í je.

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ň.

Společnost 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 5 000 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ů mezi 1 000 a 5 000 a nakonec jednotky třetí dimenze pro více než 5 000 e-mailů.

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

Pokud nezávislý dodavatel softwaru (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í byla přijata dříve bez chyby), měl by nezávislý výrobce softwaru 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 neobdržíte odpověď, která není chybná.

Pouze pro nabídky SaaS

Co se stane, když vygenerujete využití pro předplatné SaaS, které je už 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 stavu).

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 GET Subscriptions List, 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í předplatné 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ích plochých sazbách, každý e-mail nad 1 000 se fakturuje 1 USD prostřednictvím vlastní dimenze.

Když si zákazník koupí a aktivuje předplatné 6. ledna, počítá se od tohoto dne 1 000 e-mailů zahrnutých v paušální sazbě. Takže pokud do 5. února (konec prvního měsíce předplatného), odešle se mu pouze 900 e-mailů, platí zákazník pevnou sazbu pouze 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 prodlouží a počet se znovu spustí. Pokud 15. února zákazník dosáhl 1 000 odeslaných e-mailů, zbývající e-maily odeslané do 5. března se účtují jako nadlimitní využití (1 USD na e-mail) na základě událostí využití nadlimitního využití generované vydavatelem.