Compartir a través de


Control de solicitudes de aprobación de facturación

 

Se aplica a: Windows Azure Pack

Cuando un inquilino de Azure Pack de Windows crea o elimina una suscripción o un complemento de suscripción, puede ser necesario aprobar o denegar la solicitud en función de las prácticas empresariales de facturación del host. Windows Azure Pack define interfaces REST para aprobar la suscripción y la creación y eliminación de complementos de suscripción. Estos se implementan mediante un adaptador de facturación y, una vez registrados, se llaman cada vez que un inquilino crea o elimina una suscripción o un complemento de suscripción. El código de respuesta HTTP indica si la operación solicitada está aprobada o no. Se deniega un número mayor o igual a 400; Se acepta un número inferior a 400. Se omite el contenido del cuerpo de la respuesta.

Punto de conexión de la API REST de aprobación de facturación

A continuación se muestra la API REST de aprobación de facturación que debe implementar un adaptador de facturación:

Si se registra como obligatorio o facturación, las llamadas REST se bloquean y se enviarán como notificaciones de solicitud en tiempo real a los registradores de la configuración NotificationSubscribers en el servicio de uso. El estado del evento de notificación estará pendiente de aprobación. Dependiendo de las respuestas de los suscriptores de bloqueo, la operación se aprobará o rechazará. Si no se registran suscriptores de bloqueo, el evento se aprobará automáticamente y se establecerá en el estado confirmado y se expondrá a través de la API REST del servicio de uso. Para más información sobre los tipos de suscripción obligatoria y facturación, Configureing the Windows Azure Pack Usage Service.

La señal real para confirmar estas operaciones en el sistema de facturación será eventos expuestos en la API REST, ya sea registrado como suscriptor de notificación o no; no se debe realizar ninguna acción en las solicitudes enviadas a través de esta API, ya que solo son solicitudes.

Importante

El Windows versión de Azure Pack RTM expone eventos de actualización de suscripciones en la API de aprobación de facturación en tiempo real y los registradores de ese servicio deberán aprobar esos eventos automáticamente.

Para más información sobre cómo registrar el punto de conexión de la API REST de aprobación de facturación, consulte Configuración del servicio de uso de Azure Pack de Windows.

Autenticación de una solicitud de aprobación

La API REST de aprobación de facturación debe requerir al menos autenticación básica.

Procesamiento de una solicitud de aprobación

A continuación se muestra un ejemplo de una solicitud de creación de suscripción enviada a un adaptador de facturación. El código de respuesta HTTP que envía el adaptador de facturación debe ser 204 para representar la aprobación o 403 para representar la denegación de la solicitud.

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"
}

Si el adaptador de facturación recibe un evento y devuelve un mensaje de error, el evento no se completará correctamente en service Management API. Si no es el comportamiento esperado, el adaptador de facturación debe devolver un código de estado de 200 para cada notificación de evento y registrar los errores para su posterior procesamiento. Los eventos desconocidos recibidos deben dar lugar a que se devuelva un código de estado 200.

Consulte también

Configuración del servicio de uso de Azure Pack de Windows
Implementación de un adaptador de facturación