APIs für getaktete Abrechnung im Marketplace – Häufig gestellte Fragen

Sobald ein Kunde einen SaaS-Dienst abonniert hat, Azure-App lizenzierung mit einem Plan für verwaltete Apps oder Kubernetes-App mit getakteter Abrechnung bietet, verfolgen Sie den Verbrauch für jede verwendete Abrechnungsdimension. Wenn der Verbrauch die eingeschlossenen Mengen für den vom Benutzer ausgewählten Abrechnungszeitraum überschreitet, gibt der Dienst Nutzungsereignisse aus.

Für SaaS-Angebote, verwaltete Apps und Kubernetes-App-Angebote

Wie oft wird die Ausgabe der Nutzung erwartet?

Im Idealfall wird davon ausgegangen, dass die Nutzung für die letzte Stunde stündlich ausgegeben wird, jedoch nur, wenn in der letzten Stunde Nutzung stattgefunden hat.

Gibt es einen maximalen Zeitraum zwischen einer Ausgabe und der nächsten?

Es gibt keine solche Beschränkung. Eine Nutzung wird lediglich bei Auftreten ausgegeben. Wenn Sie beispielsweise nur eine Nutzungseinheit pro Abonnementlebensdauer übermitteln müssen, ist auch dies möglich.

Wie groß ist die maximale Verzögerung zwischen dem Zeitpunkt, zu dem ein Ereignis eingetreten ist, und dem Zeitpunkt der Ausgabe des Nutzungsereignisses an Microsoft?

Idealerweise werden Nutzungsereignisse stündlich für Ereignisse ausgegeben, die in der letzten Stunde eingetreten sind. Es werden jedoch Verzögerungen erwartet. Die maximal zulässige Verzögerung beträgt 24 Stunden. Danach werden Nutzungsereignisse nicht mehr akzeptiert. Die bewährte Methode ist, die stündliche Nutzung zu erfassen und als ein Ereignis am Ende der Stunde auszugeben.

Wenn ein Nutzungsereignis beispielsweise um 1 Uhr auftritt, kann ein entsprechendes Nutzungsereignis bis 1 Uhr am Folgetag ausgegeben werden. Wenn das System, von dem die Nutzung ausgegeben wird, ausfällt, kann es nach der Wiederherstellung das Nutzungsereignis für das Stundenintervall, in dem die Nutzung erfolgt ist, ohne Genauigkeitseinbußen senden.

Wenn 24 Stunden nach der tatsächlichen Nutzung vergangen sind, können die verbrauchten Einheiten immer noch mit späteren Nutzungsereignissen ausgegeben werden. Diese Praxis kann jedoch die Glaubwürdigkeit der Abrechnungsereignisberichte für den Endkunden beeinträchtigen. Es wird empfohlen, ein Senden der Ausgabe von Verbrauchseinheiten einmal pro Tag/Woche/Monat zu vermeiden. Dadurch wird es schwieriger, die tatsächliche Nutzung durch einen Kunden zu verstehen und Probleme oder Fragen zu lösen, die sich möglicherweise in Bezug auf Nutzungsereignisse ergeben.

Durch ein stündliches Senden der Nutzung werden außerdem Situationen vermieden, in denen der Benutzer das Abonnement kündigt, bevor der Herausgeber das tägliche/wöchentliche/monatliche Ausgabeereignis sendet.

Was geschieht, wenn in derselben Stunde mehrere Nutzungsereignisse gesendet werden?

Für das einstündige Intervall wird nur ein Nutzungsereignis akzeptiert. Das Stundenintervall beginnt in Minute 0 und endet mit Minute 59. Wenn für die gleiche Stunde mehrere Nutzungsereignisse ausgegeben werden, werden alle Nutzungsereignisse nach dem ersten Ereignis als Duplikate gelöscht.

Was geschieht, wenn der Kunde den Kauf innerhalb der für die Kündigung zulässigen Zeit kündigt?

Der Pauschalbetrag wird nicht in Rechnung gestellt, jedoch die Überschreitungsnutzung.

Können Pläne für benutzerdefinierte Verbrauchseinheiten für einmalige Zahlungen verwendet werden?

Ja, Sie können eine benutzerdefinierte Dimension als eine Einheit für die einmalige Zahlung definieren und für jeden Kunden nur einmal ausgeben.

Können Pläne für benutzerdefinierte Verbrauchseinheiten für ein Modell mit gestaffelten Preisen verwendet werden?

Ja, es kann mit jeder benutzerdefinierten Dimension implementiert werden, die eine einzelne Preisstufe darstellt.

Beispielsweise möchte Contoso 0,5 US-Dollar pro E-Mail für die ersten 1000 E-Mails, 0,4 US-Dollar pro E-Mail zwischen 1000 und 5000 E-Mails und 0,2 US-Dollar pro E-Mail bei mehr als 5000 E-Mails berechnen. Es können hierfür drei benutzerdefinierte Dimensionen definiert werden, die den drei Tarifen für E-Mails entsprechen. In diesem Fall werden Einheiten der ersten Dimension ausgegeben, solange die Anzahl der E-Mails unter 1000 bleibt. Einheiten der zweiten Dimension werden ausgegeben, wenn die Anzahl der E-Mails zwischen 1000 und 5000 liegt. Bei mehr als 5000 E-Mails werden schließlich Einheiten der dritten Dimension ausgegeben.

Was geschieht, wenn der Marketplace-Messungsdienst ausfällt?

Wenn der ISV einen benutzerdefinierten Zähler sendet und einen Fehler empfängt, der möglicherweise durch ein Problem auf Microsoft-Seite verursacht wurde (in der Regel wurden ähnliche Ereignisse vor einem Fehler akzeptiert), sollte der ISV warten und die Emission wiederholen.

Wenn der Fehler weiterhin auftritt, sollte diese benutzerdefinierte Verbrauchseinheit in der nächsten Stunde erneut übermittelt werden (Menge kumulieren). Dieser Vorgang sollte dann fortgesetzt werden, bis eine fehlerfreie Antwort empfangen wird.

Nur für SaaS-Angebote

Was geschieht, wenn die Nutzung für ein SaaS-Abonnement ausgegeben wird, das bereits gekündigt wurde?

An die Marketplace-Plattform ausgegebene Nutzungsereignisse werden nicht akzeptiert, nachdem ein SaaS-Abonnement gelöscht wurde.

Die Nutzung kann nur für Abonnements im Status „Subscribed“(Abonniert) ausgegeben werden (nicht für Abonnements im Status PendingFulfillmentStart, Suspended oder Unsubscribed).

Die einzige Ausnahme ist die Meldung der Nutzung für den Zeitraum vor Kündigung des SaaS-Abonnements.

Beispielsweise hat der Kunde das SaaS-Abonnement heute um 15 Uhr gekündigt. Es ist jetzt 17 Uhr, und der Herausgeber kann immer noch die Nutzung für den Zeitraum zwischen gestern 18 Uhr und heute 15 Uhr für dieses SaaS-Abonnement ausgeben.

Kann ich eine Liste aller SaaS-Abonnements, einschließlich aktiver und gekündigter Abonnements, abrufen?

Ja, durch Aufruf der API zum Abrufen der Abonnementliste, da sie eine Liste aller SaaS-Abonnements enthält. Im Statusfeld in der Antwort für das jeweilige SaaS-Abonnement wird angegeben, ob das Abonnement aktiv oder gekündigt ist.

Sind das Start- und Enddatum der SaaS-Abonnementlaufzeit und die Ausgabe der Überschreitungsnutzung miteinander verbunden?

Überschreitungsereignisse können jederzeit für ein vorhandenes SaaS-Abonnement im Status Subscribed (Abonniert) ausgegeben werden. Es ist Aufgabe des Herausgebers, Nutzungsereignisse auf Grundlage der im Abrechnungsplan definierten Richtlinie auszugeben. Die Überschreitung muss basierend auf den Datumsangaben berechnet werden, die für den Abrechnungszeitraum des SaaS-Abonnements definiert sind.

Wenn der Herausgeber z. B. einen SaaS-Plan definiert, bei dem 1000 E-Mails für 100 US-Dollar im monatlichen Pauschalpreis enthalten sind, wird für jede E-Mail über der Anzahl von 1000 eine benutzerdefinierte Dimension von 1 US-Dollar berechnet.

Wenn der Kunde das Abonnement am 6. Januar kauft und aktiviert, werden die im Pauschalpreis enthaltenen 1000 E-Mails ab diesem Tag gezählt. Wenn also bis zum 5. Februar (Ende des ersten Abonnementmonats) nur 900 E-Mails gesendet werden, zahlt der Kunde nur den Pauschalbetrag für den ersten Monat dieses Abonnements, und es werden zwischen dem 6. Januar und dem 5. Februar keine Überschreitungsereignisse vom Herausgeber ausgegeben. Am 6. Februar wird das Abonnement automatisch verlängert, und die Zählung wird erneut gestartet. Wenn der Kunde am 15. Februar bereits 1000 E-Mails gesendet hat, werden die restlichen E-Mails, die bis zum 5. März gesendet werden, als Überschreitung (1 US-Dollar pro E-Mail) basierend auf den vom Herausgeber ausgegebenen Überschreitungsereignissen in Rechnung gestellt.

Nächste Schritte