Partilhar via


Tratamento de Pedidos de Aprovação de Faturação

 

Aplica-se a: Windows Azure Pack

Quando um inquilino Windows Azure Pack cria ou elimina um complemento de subscrição ou subscrição, pode ser necessário aprovar ou negar o pedido dependendo das práticas comerciais de faturação do anfitrião. Windows Azure Pack define interfaces REST para aprovação de subscrição e subscrição de criação e eliminação. Estes são implementados por um adaptador de faturação e uma vez registados são chamados sempre que um inquilino cria ou elimina um complemento de subscrição ou subscrição. O código resposta HTTP indica se a operação solicitada é ou não aprovada. Um número superior ou igual a 400 é negado; Um número inferior a 400 é aceite. O conteúdo do corpo de resposta é ignorado.

Aprovação de faturação REST API Endpoint

Segue-se a API DE APROVAÇÃO de Faturação que um adaptador de faturação precisa de implementar:

Se registadas como Obrigatórias ou Como Faturação, as chamadas REST estão a bloquear e serão enviadas como notificações de pedido em tempo real a qualquer registo da definição de Subscrições de Notificações no Serviço de Utilização. O estado do evento de notificação estará pendente de aprovação. Dependendo da resposta(s) de quaisquer assinantes que bloqueiem, a operação será aprovada ou rejeitada. Se não houver assinantes que bloqueiem, o evento será aprovado automaticamente e será definido para o estado reconhecido e exposto através da API do Serviço de Utilização. Para obter mais informações sobre os tipos de subscrição obrigatória e de faturação, configurar o serviço de utilização do pacote Windows Azure.

O sinal real para a entrega destas operações ao Sistema de Faturação serão os eventos expostos na API REST, registados ou não como assinante de notificação; não devem ser tomadas medidas em cima dos pedidos enviados através desta API, uma vez que são apenas pedidos.

Importante

O Windows versão Azure Pack RTM expõe eventos de atualização de subscrição na API de aprovação de faturação em tempo real e quaisquer registradores desse serviço terão de aprovar esses eventos automaticamente.

Para obter mais informações sobre o registo do ponto final da API de aprovação de faturação, consulte configurar o serviço de utilização do pacote Windows Azure.

Autenticação de um Pedido de Aprovação

A API de Aprovação de Faturação deve exigir pelo menos a autenticação básica.

Processamento de um Pedido de Aprovação

Segue-se um exemplo de um pedido de subscrição de criação enviado a um adaptador de faturação. O código de resposta HTTP que o adaptador de faturação envia deve ser 204 para representar a aprovação ou 403 para representar a negação do pedido.

POST /usage/subscriptions HTTP/1.1
Content-Type: application/json; charset=utf-8
Host: 10.121.217.127:8888
Content-Length: 564
Expect: 100-continue
{
  "EventId": 6530,
  "State": 2,
  "Method": "POST",
  "Entity": {
    "SubscriptionID": "0a53e53d-1334-424e-8c63-ade05c361be2",
    "SubscriptionName": "ExamplePlan",
    "AccountAdminLiveEmailId": "user@example.com",
    "ServiceAdminLiveEmailId": null,
    "CoAdminNames": [

    ],
    "AddOnReferences": [

    ],
    "AddOns": [

    ],
    "State": 0,
    "QuotaSyncState": 0,
    "ActivationSyncState": 0,
    "PlanId": "Examphlztfpgi",
    "Services": [

    ],
    "LastErrorMessage": null,
    "Features": null,
    "OfferFriendlyName": null,
    "OfferCategory": null,
    "Created": "0001-01-01T00:00:00Z"
  },
  "EntityParentId": null,
  "NotificationEventTimeCreated": "2013-09-25T00:32:08.8724845Z"
}

Se o adaptador de faturação receber um evento e devolver uma mensagem de erro, o evento não será concluído com sucesso na API de Gestão de Serviços. Se este não for o comportamento esperado, o Adaptador de Faturação deve enviar de volta um código de estado de 200 para cada notificação do evento e deve registar quaisquer falhas para posterior processamento. Quaisquer eventos desconhecidos que sejam recebidos devem resultar na devolvição de um código de estado de 200.

Consulte também

Configurar o serviço de utilização do pacote Windows Azure Pack
Implementação de um adaptador de faturação