Recuperar datos de uso de un proveedor de recursos
Se aplica a: Windows Azure Pack
Recupera los datos de uso de un proveedor de recursos.
Solicitud
Reemplace <UsageEndpoint> por la dirección del punto de conexión de la API REST de uso del proveedor de recursos personalizado de Azure Pack Windows.
Método |
URI de solicitud |
Versión de HTTP |
|---|---|---|
GET |
<https:// UsageEndpoint>/usage |
HTTP/1.1 |
Parámetros de identificador URI
En la tabla siguiente se describen los parámetros de URI.
Parámetro de URI |
Descripción |
|---|---|
lastID |
Identificador del último registro recibido por el recopilador de uso. El parámetro lastID está vacío para la primera solicitud. Se trata de una confirmación de que el recopilador de uso reconoce los registros anteriores y, por tanto, puede eliminarlos. |
BatchSize |
Número de registros nuevos que se van a enviar al recopilador de uso. Los nuevos registros son los que siguen el registro identificado por el parámetro lastID . El proveedor de recursos puede enviar un lote más pequeño que solicitado, pero no uno mayor. |
Encabezados de solicitud
En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.
Encabezado de solicitud |
Descripción |
|---|---|
Autorización: Portador |
Obligatorio. Token de portador de autorización. |
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 |
|---|---|
EventId |
Obligatorio. Identificador único que representa cada registro de uso. Este valor coincidirá con el del parámetro URI lastID . |
ResourceId |
Opcional. Si el proveedor de recursos tiene varios recursos para una sola suscripción y el uso se agrega a un recurso, este campo se puede usar para especificar el nombre del recurso. Si el identificador de suscripción agrega el uso, este elemento no se usa. |
StartTime |
Obligatorio. Indica cuándo se inició la recopilación de datos de uso. |
EndTime |
Obligatorio. Indica cuándo finalizó la recopilación de datos de uso. |
ServiceType |
Obligatorio. Nivel de servicio consumido. |
SubscriptionId |
Obligatorio. Identificador de suscripción para el que se recopilaron los datos de uso. (GUID). |
Propiedades |
Opcional. Diccionario de pares nombre-valor que se usan para pasar información adicional sobre el uso. |
Recursos |
Obligatorio. Diccionario de pares nombre-valor que representa los recursos asignados o consumidos. Por ejemplo, un proveedor de recursos SQL puede tener espacio total y recuento de bases de datos como métricas. |
Comentarios
El recopilador de uso llama periódicamente a los datos de uso de un proveedor de recursos para recopilar la información de uso del proveedor de recursos. Esta información se puede usar para generar costos de facturación para el uso del proveedor de recursos. Para más información, Puntos de conexión del proveedor de recursos personalizados. Para más información sobre la Windows Servicio de uso de Azure Pack, consulte Windows Servicio de uso de Azure Pack.
Consulte también
Referencia de la API REST de uso del proveedor de recursos personalizado de Azure Pack Windows