Recuperar el resumen de uso de una suscripción
Se aplica a: Windows Azure Pack
Llamado por service Management API para recuperar un resumen de los datos de uso de la suscripción generados por un proveedor de recursos. Un adaptador de facturación puede usar esta información para calcular los costos de facturación. Para más información, consulte Windows Servicio de uso de Azure Pack.
Solicitud
Reemplace <NotificationEndpoint> por la dirección del punto de conexión de la API rest de notificación del proveedor de recursos personalizado de Azure Pack Windows. Reemplace <Id> por el identificador del resumen de uso que se va a recuperar.
Método |
URI de solicitud |
Versión de HTTP |
|---|---|---|
GET |
<http:// NotificationEndpoint>/subscriptions/<Id>/usagesummary |
HTTP/1.1 |
Parámetros de identificador URI
Ninguno.
Encabezados de solicitud
En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.
Encabezado de solicitud |
Descripción |
|---|---|
Autorización: Básico |
Obligatorio. Token de autorización básico. |
x-ms-principal-id |
Obligatorio. El identificador de la entidad de seguridad. |
x-ms-client-request-id |
Opcional. Identificador de solicitud de cliente. |
x-ms-client-session-id |
Opcional. Identificador de sesión de cliente. |
x-ms-principal-liveid |
Opcional. Identificador activo principal. |
Cuerpo de la solicitud
Ninguno.
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
Una operación correcta devuelve el código de estado 200 Correcto.
Para obtener información sobre los códigos de estado, consulte Códigos de estado y error (Windows Administración de servicios de Azure Pack).
Encabezados de respuesta
La respuesta de esta operación incluye encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
Cuerpo de la respuesta
La tabla siguiente describe los elementos clave del cuerpo de la respuesta:
Nombre del elemento |
Descripción |
|---|---|
ServiceUsageSummary |
Resumen de uso recuperado. Para obtener más información, vea ServiceUsageSummary (Objeto de punto de conexión de notificación) . |
Ejemplo
En el ejemplo de código siguiente se muestra una solicitud Obtener resumen de uso de la suscripción .
GET https://<NotificationEndpoint>/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f/usagesummary HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f/usagesummaries
Accept: application/json
Accept-Language: en-US
x-ms-client-request-id: 82610bdb-14d6-4e2a-99a0-9930d879b300-2013-07-25 06:14:56Z
x-ms-client-session-id: be02e255-38de-4e86-9690-b3a3e3037e4c
x-ms-principal-id: <COMPUTER>\Administrator
x-ms-principal-liveid: <COMPUTER>\Administrator
x-ms-request-id: 37739ad5c7ab4654b6bb5d5e211f974e.2013-07-25T06:14:57.7649169Z
Authorization: Basic <encoded username and password>
Host: <Computer>:30010
En el ejemplo de código siguiente se muestra una respuesta JSON Obtener resumen de uso de suscripción .
{
"ServiceName": "SqlServer",
"ServiceDisplayName": "Sql Server",
"RetrievedSuccessfully": false,
"ErrorMessage": null,
"Usages": [
]
}
Comentarios
Al llamar a TBD, service Management API espera un minuto para una respuesta. Si no se recibe ninguna respuesta, la suscripción se marca como fuera de sincronización.