Tratamento de dados de eventos de utilização
Aplica-se a: Windows Azure Pack
Num Windows Azure Pack for Windows Server, espera-se que os dados de eventos de utilização sobre a gestão de subscrições, planos e assim por diante sejam utilizados para calcular a informação de faturação do inquilino. Para tal, o adaptador de faturação do sistema de faturação utiliza a API de utilização REST para recolher dados de eventos de utilização e construir uma base de dados de dados de utilização aplicáveis às necessidades de faturação.
Obtenção de Eventos de Utilização
O ponto final do Serviço de Utilização expõe a API REST a devolver dados de faturação para planos, planos adicionais, serviço de plano, addons e subscrições. Por exemplo, para recuperar os eventos do plano, é feita a chamada API do Plano de Recuperação :
https://<Computer>:30022/billing/plans?startId=0&batchSize=1 HTTP/1.1
Accept: application/json
Authorization: basic <Token>
Host: <Computer>:30022
Connection: Keep-Alive
O corpo de resposta devolve uma lista de objetos UsageEvent (Use Metering Object) que contêm os eventos recentes do plano. Por exemplo:
[
{
"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"
}
]
Para obter mais informações sobre a API de utilização disponível, consulte Windows Referência DE UTILIZAÇÃO DO Serviço de Utilização do Pacote Azure.
Eventos de Processamento de Utilização
Para aceder aos dados do evento de utilização, utilize o objeto UsageEvent (Use Metering Object) devolvido pela API do Serviço de Utilização. As notificações do evento enviadas ao adaptador de faturação aderem ao tipo - UsageEvent (Use Metering Object)<T> tipo onde T é substituído por um dos seguintes objetos.
Planear
PlanAddon
AdminSubscrição
Referência de RecursosProviderReference
PlanAddonReference
O objeto UsageEvent contém informações sobre a entidade de eventos como Plano e Subscrição, o tipo de operação como criação ou eliminação, e o estado atual da operação. A tabela a seguir descreve as ações a tomar num adaptador de faturação para cada estado de combinação:
Evento/Operação |
Criar (POST) |
Atualização (PUT) |
Eliminar |
|---|---|---|---|
Planos |
Processar todos os eventos |
Ignorar |
Ignorar (manual) |
Plan Add-ons |
Processar todos os eventos |
Ignorar |
Ignorar (manual) |
Serviços de Plano |
Processar todos os eventos |
Ignorar |
Ignorar (manual) |
Suplementos |
Processar todos os eventos |
Ignorar |
Ignorar (manual) |
Serviços adicionais |
Processar todos os eventos |
Ignorar |
Ignorar (manual) |
Subscrições |
processo eventos "reconhecidos" |
Processo "Aprovação Pendente" e Eventos "Reconhecidos" |
Processo eventos "reconhecidos" |
Add-ons de subscrição |
processo eventos "reconhecidos", incluindo eventos "duplicados" * |
Ignorar |
Processo eventos "reconhecidos" |
As propriedades significativas do UsageEvent para o processamento da tabela acima são:
Propriedade |
Descrição |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Entidade |
Contém o objeto que está a ser operado. Por exemplo, AdminSubscription (objeto administrador) para uma subscrição. |
||||||||||
Método |
O tipo de operação como POST, PUT ou DELETE. |
||||||||||
Estado |
O estado atual da operação.
|
Podem ocorrer eventos duplicados para algumas das operações acima referidas. Por exemplo, um evento de "excluir um plano" pode ocorrer duas vezes seguidas com os mesmos dados, porque a operação pode falhar. Para o evento "criar addon de subscrição", um inquilino tem a capacidade de comprar o mesmo addon várias vezes (se estiver configurado dessa forma) pelo que cada evento de criação deve ser processado de forma a que resulte numa nova criação de entidade no Sistema de Faturação. Para todas as outras operações de criação, as criações duplicadas não devem ser criadas no Sistema de Faturação (ou seja, se a entidade já existe, não criar outra) e podem ser ignoradas com segurança.
Mapeamento de entidade entre Windows pacote Azure e um sistema de faturação
O adaptador de faturação deve criar entidades no Sistema de Faturação com nomes que correspondam ao identificador enviado de Windows Azure Pack. Desta forma, um administrador pode correlacionar quais as entidades Windows Azure Pack correspondem às entidades do Sistema de Faturação. Se o Sistema de Faturação não o apoiar, o adaptador de faturação terá de manter as informações de mapeamento para traduzir os identificadores utilizados pelo Windows Azure Pack nos identificadores utilizados pelo sistema de faturação. Por esta razão, um adaptador de faturação deve ter algum mecanismo que exponha esta informação de mapeamento a um administrador de forma segura, de modo a que quaisquer discrepâncias ou incertezas possam ser resolvidas.
Gestão de assinaturas
Os eventos de subscrição são criados nas seguintes circunstâncias:
Quando uma subscrição é ativada ou suspensa.
Ao migrar uma subscrição.
Suspensão de assinatura
Importante
A Suspensão de Subscrição, tal como descrita aqui, não estará disponível até ao lançamento da próxima atualização do Windows Azure Pack. Na atual construção de RTM, a suspensão e ativação de subscrição não são detetáveis através desta interface. Haverá eventos de atualização de subscrição que não são accuíveis do ponto de vista do sistema de faturação e devem ser ignorados.
Se uma subscrição for suspensa no Windows Azure Pack, permitindo assim que um inquilino provisa novos recursos ou aceda aos existentes utilizando a subscrição suspensa, esta alteração irá propagar-se ao Sistema de Faturação através de um evento de atualização de subscrição. O objeto de subscrição, AdminSubscription (objeto administrador), tem uma propriedade do Estado que indica se a subscrição é Ativa ou Suspensa. Se um administrador suspender a subscrição de um utilizador, deve tomar as disposições adequadas no seu Sistema de Faturação para evitar encargos inadequados para o utilizador. Note-se que os recursos existentes de um utilizador, tais como bases de dados, websites e VMs, não são eliminados; apenas o acesso do inquilino a eles é removido. Além disso, como os utilizadores podem ter várias subscrições, é possível que uma das subscrições de um utilizador possa ser suspensa enquanto as restantes permanecem ativas. Uma suspensão ao nível do utilizador não deve ocorrer no Sistema de Faturação a menos que todas as subscrições em Windows Azure Pack associadas a esse utilizador tenham sido suspensas.
Migração de Assinaturas
Quando uma migração por subscrição for iniciada no Windows Azure Pack, um evento será exposto na API do Serviço de Utilização como um evento de atualização de subscrição que contém o identificador de plano do novo plano as referências de subscrição. Para detetar isto, um adaptador de faturação terá de acompanhar o identificador do plano WAP de cada subscrição para que possa detetar esta alteração e tomar as medidas adequadas no Sistema de Faturação. Além disso, quaisquer addons de subscrição anteriormente associados à subscrição migrada devem ser eliminados no Sistema de Faturação; estes complementos são removidos em Windows Azure Pack e os seus aumentos de quota são integrados nas quotas do novo plano.