Obsługa danych zdarzeń użycia
Dotyczy: Windows Azure Pack
W pakiecie Windows Azure Pack dla systemu rozliczeniowego Windows Server dane zdarzenia użycia dotyczące zarządzania subskrypcjami, planami i tak dalej mają być używane do obliczania informacji dotyczących rozliczeń dzierżawy. W tym celu karta rozliczeniowa systemu rozliczeniowego używa interfejsu API REST użycia do zbierania danych zdarzeń użycia i tworzenia bazy danych danych użycia mających zastosowanie do potrzeb rozliczeniowych.
Pobieranie zdarzeń użycia
Punkt końcowy usługi Użycia uwidacznia interfejs API REST w celu zwrócenia danych rozliczeniowych dla planów, dodatków do planowania, usługi planowania, dodatków i subskrypcji. Na przykład w celu pobrania zdarzeń planu jest wykonywane wywołanie interfejsu API REST pobieranie zdarzeń planu :
https://<Computer>:30022/billing/plans?startId=0&batchSize=1 HTTP/1.1
Accept: application/json
Authorization: basic <Token>
Host: <Computer>:30022
Connection: Keep-Alive
Treść odpowiedzi zwraca listę obiektów UsageEvent (Obiekt pomiaru użycia) zawierających ostatnie zdarzenia planu. Przykład:
[
{
"EventId": 1,
"State": 0,
"Method": "0",
"Entity": {
"Id": "Idjt711xf",
"DisplayName": "TheDisplayName",
"State": 0,
"ConfigState": 0,
"QuotaSyncState": 2,
"LastErrorMessage": null,
"Advertisements": [
{
"LanguageCode": "en-us",
"DisplayName": "TheDisplayName",
"Description": null
}
],
"ServiceQuotas": [
{
"ServiceName": "webspaces",
"ServiceInstanceId": "4576E3B4-881D-4B9F-87F4-E72206FB11D6",
"ServiceDisplayName": "Web Site Cloud",
"ServiceInstanceDisplayName": null,
"ConfigState": 0,
"QuotaSyncState": 2,
"Settings": [
]
},
{
"ServiceName": "sqlservers",
"ServiceInstanceId": "2FBED6DE-5195-4F95-98DC-B67829621025",
"ServiceDisplayName": "SQL Servers",
"ServiceInstanceDisplayName": null,
"ConfigState": 0,
"QuotaSyncState": 2,
"Settings": [
]
},
{
"ServiceName": "mysqlservers",
"ServiceInstanceId": "0C18772C-3596-4E2A-BD60-21230C186D17",
"ServiceDisplayName": "MySQL Servers",
"ServiceInstanceDisplayName": null,
"ConfigState": 0,
"QuotaSyncState": 2,
"Settings": [
]
},
{
"ServiceName": "servicebus",
"ServiceInstanceId": "B40CC649-1ACE-4134-ADC9-1E610B64F400",
"ServiceDisplayName": "Service Bus",
"ServiceInstanceDisplayName": null,
"ConfigState": 0,
"QuotaSyncState": 2,
"Settings": [
]
}
],
"SubscriptionCount": 0,
"MaxSubscriptionsPerAccount": 1,
"AddOnReferences": [
],
"AddOns": [
],
"InvitationCode": null,
"Price": null
},
"EntityParentId": null,
"NotificationEventTimeCreated": "2013-07-31T23:56:20.05"
}
]
Aby uzyskać więcej informacji na temat dostępnego interfejsu API REST użycia, zobacz Windows Dokumentacja interfejsu API REST użycia usługi Użycia usługi Azure Pack.
Przetwarzanie zdarzeń użycia
Aby uzyskać dostęp do danych zdarzeń użycia, użyj obiektu UsageEvent (Obiekt pomiaru użycia) zwróconego przez interfejs API REST usługi Użycia. Powiadomienia o zdarzeniach wysyłane do karty rozliczeniowej są zgodne z typem — UsageEvent (Obiekt pomiaru użycia)<T> , gdzie T jest zastępowany przez jeden z następujących obiektów.
Planowanie
PlanAddon
AdminSubscription
ResourceProviderReference
PlanAddonReference
Obiekt UsageEvent zawiera informacje o jednostce zdarzeń, takiej jak Plan i Subskrypcja, typ operacji, takich jak tworzenie lub usuwanie, oraz bieżący stan operacji. W poniższej tabeli opisano akcje, które należy wykonać w karcie rozliczeniowej dla każdego stanu kombinacji:
Zdarzenie/operacja |
Tworzenie (POST) |
Aktualizacja (PUT) |
Usuń |
|---|---|---|---|
Plany |
Przetwarzanie wszystkich zdarzeń |
Zignoruj |
Ignoruj (ręcznie) |
Planowanie dodatków |
Przetwarzanie wszystkich zdarzeń |
Zignoruj |
Ignoruj (ręcznie) |
Planowanie usług |
Przetwarzanie wszystkich zdarzeń |
Zignoruj |
Ignoruj (ręcznie) |
Dodatki |
Przetwarzanie wszystkich zdarzeń |
Zignoruj |
Ignoruj (ręcznie) |
Usługi dodatków |
Przetwarzanie wszystkich zdarzeń |
Zignoruj |
Ignoruj (ręcznie) |
Subskrypcje |
przetwarzanie zdarzeń "Potwierdzono" |
Przetwarzanie zdarzeń "Oczekiwanie na zatwierdzenie" i "Potwierdzono" |
Przetwarzanie zdarzeń "Potwierdzono" |
Dodatki subskrypcji |
przetwarzanie zdarzeń "Potwierdzono", w tym zduplikowanych zdarzeń* |
Zignoruj |
Przetwarzanie zdarzeń "Potwierdzono" |
Istotne właściwości UsageEvent do przetwarzania powyższej tabeli są następujące:
Właściwość |
Opis |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Jednostka |
Zawiera obiekt, na którym działa. Na przykład AdminSubscription (obiekt administratora) dla subskrypcji. |
||||||||||
Metoda |
Typ operacji, takich jak POST, PUT lub DELETE. |
||||||||||
Stan |
Bieżący stan operacji.
|
W przypadku niektórych z powyższych operacji mogą wystąpić zduplikowane zdarzenia. Na przykład zdarzenie "usuń plan" może wystąpić dwa razy z rzędu z tymi samymi danymi, ponieważ operacja może zakończyć się niepowodzeniem. W przypadku zdarzenia "create subscription addon" dzierżawa ma możliwość wielokrotnego zakupu tego samego dodatku (jeśli jest on skonfigurowany w ten sposób), aby każde zdarzenie tworzenia było przetwarzane tak, aby powoduje utworzenie nowej jednostki w systemie rozliczeniowym. W przypadku wszystkich innych operacji tworzenia nie należy tworzyć zduplikowanych operacji w systemie rozliczeniowym (tj. jeśli jednostka już istnieje, nie twórz innej) i można je bezpiecznie zignorować.
Mapowanie jednostek między pakietem azure Windows a systemem rozliczeniowym
Karta rozliczeniowa powinna utworzyć jednostki w systemie rozliczeniowym z nazwami zgodnymi z identyfikatorem wysłanym z Windows Azure Pack. W ten sposób administrator może skorelować jednostki w pakiecie Windows Azure Pack odpowiadającym jednostkom w systemie rozliczeniowym. Jeśli system rozliczeniowy nie obsługuje tego, karta rozliczeniowa będzie musiała zachować informacje dotyczące mapowania, aby przetłumaczyć identyfikatory używane przez Windows Azure Pack na identyfikatory używane przez system rozliczeniowy. Z tego powodu karta rozliczeniowa powinna mieć pewien mechanizm, który uwidacznia te informacje mapowania administratorowi w bezpieczny sposób, aby można było rozwiązać wszelkie rozbieżności lub niepewność.
Obsługa subskrypcji
Zdarzenia subskrypcji są tworzone w następujących okolicznościach:
Po aktywowaniu lub zawieszeniu subskrypcji.
Podczas migracji subskrypcji.
Zawieszenie subskrypcji
Ważne
Zawieszenie subskrypcji zgodnie z opisem w tym miejscu nie będzie dostępne do czasu następnego wydania aktualizacji Windows Azure Pack. W bieżącej kompilacji RTM zawieszenie subskrypcji i aktywacja nie są wykrywalne za pośrednictwem tego interfejsu. Będą dostępne zdarzenia aktualizacji subskrypcji, które nie są możliwe do działania z perspektywy systemu rozliczeniowego i powinny być ignorowane.
Jeśli subskrypcja zostanie zawieszona w Windows pakiecie Azure Pack, co uniemożliwi dzierżawie aprowizację nowych zasobów lub dostęp do istniejących przy użyciu zawieszonej subskrypcji, ta zmiana zostanie rozpropagowana do systemu rozliczeniowego za pośrednictwem zdarzenia aktualizacji subskrypcji. Obiekt subskrypcji , AdminSubscription (obiekt administratora), ma właściwość stanu, która wskazuje, czy subskrypcja jest Aktywna lub Zawieszona. Jeśli administrator zawiesi subskrypcję użytkownika, powinien dokonać odpowiednich ustaleń w systemie rozliczeniowym, aby zapobiec nieodpowiednim opłatom wobec użytkownika. Należy pamiętać, że istniejące zasoby użytkownika, takie jak bazy danych, witryny internetowe i maszyny wirtualne, nie są usuwane; tylko dostęp dzierżawy do nich jest usuwany. Ponadto, ponieważ użytkownicy mogą mieć wiele subskrypcji, możliwe, że jedna z subskrypcji użytkownika może zostać zawieszona, podczas gdy reszta pozostaje aktywna. Zawieszenie na poziomie użytkownika nie powinno wystąpić w systemie rozliczeniowym, chyba że wszystkie subskrypcje w Windows azure Pack skojarzone z tym użytkownikiem zostały zawieszone.
Migracja subskrypcji
Po zainicjowaniu migracji subskrypcji w Windows Azure Pack zdarzenie zostanie uwidocznione w interfejsie API REST usługi Użycia jako zdarzenie aktualizacji subskrypcji, które zawiera identyfikator planu nowego planu odwołania do subskrypcji. Aby to wykryć, karta rozliczeniowa będzie musiała śledzić identyfikator planu WAP każdej subskrypcji, aby mogła wykryć tę zmianę i podjąć odpowiednie działania w systemie rozliczeniowym. Ponadto wszystkie dodatki subskrypcji, które zostały wcześniej skojarzone z migrowanymi subskrypcjami, muszą zostać usunięte w systemie rozliczeniowym; te dodatki są usuwane w usłudze Windows Azure Pack, a ich limity przydziału są zintegrowane z limitami przydziału nowego planu.
Zobacz też
dokumentacja interfejsu API REST użycia usługi Windows Azure Pack