Visualización y recuperación de datos de utilización

  • 10 minutos

El proveedor de condiciones se aplica al administrador de servicios y a los proveedores delegados. Los operadores y proveedores delegados de Azure Stack Hub pueden usar la Interfaz de programación de aplicaciones (API) de utilización del proveedor para ver la utilización de sus inquilinos directos. Por ejemplo, como se muestra en el diagrama siguiente, P0 puede llamar a la API de proveedor para obtener información del uso directo de P1 y P2, y P1 puede llamar para obtener información de uso sobre P3 y P4.

Diagram showing normalized relational tables.

Referencia de llamadas de Interfaz de programación de aplicaciones (API)

Solicitud

La solicitud obtiene detalles de consumo para las suscripciones y el período de tiempo solicitados. No hay ningún cuerpo de solicitud.

Esta interfaz de programación de aplicaciones de utilización es una interfaz de programación de aplicaciones del proveedor, por lo que al autor de la llamada se le debe asignar un rol Propietario, Colaborador o Lector en la suscripción del proveedor.

Método: GET

https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={reportedStartTime}&reportedEndTime={reportedEndTime}&aggregationGranularity={granularity}&subscriberId={sub1.1}&api-version=2015-06-01-preview&continuationToken={token-value}

Argumentos

Argument Descripción
armendpoint Punto de conexión de Azure Resource Manager del entorno de Azure Stack Hub. La norma en Azure Stack Hub es que el nombre del punto de conexión de Azure Resource Manager esté en el formato https://adminmanagement.{domain-name}.
subId Identificador de suscripción del usuario que realiza la llamada.
reportedStartTime Hora de inicio de la consulta. El valor de DateTime debe estar en formato Hora universal coordinada (UTC) y al principio de la hora, por ejemplo, 13:00. Para la agregación diaria, establezca este valor en la medianoche de la hora UTC.
reportedEndTime Hora de finalización de la consulta. Las restricciones que se aplican a reportedStartTime también se aplican a este argumento. El valor de reportedEndTime no puede ser una fecha futura ni la actual. Si es así, el resultado se establece en "el procesamiento no está completo".
aggregationGranularity Parámetro opcional con dos valores posibles discretos: daily y hourly. Como sugieren los valores, uno devuelve los datos con una especificidad diaria y el otro es una resolución por horas.
subscriberId Id. de suscripción. Para obtener los datos filtrados, es necesario el identificador de suscripción de un inquilino directo del proveedor. Si no se especifica ningún parámetro de identificador de suscripción, la llamada devuelve los datos de uso para todos los inquilinos directos del proveedor.
api-version Versión del protocolo que se usa para realizar esta solicitud. Este valor se establece en 2015-06-01-preview.
continuationToken Token recuperado en la última llamada al proveedor de la API de uso. Este token es necesario cuando una respuesta supera las 1000 líneas. Actúa como un marcador para el progreso. Si el token no está presente, los datos se recuperan desde el principio del día o de la hora, según la especificidad pasada.

Response

GET

/subscriptions/sub1/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&subscriberId=sub1.1&api-version=1.0
Argument Descripción
id Identificador único del agregado de uso.
name Nombre del agregado de uso.
type Definición de recursos.
subscriptionId Identificador de la suscripción del usuario de Azure Stack Hub.
usageStartTime Hora de inicio UTC del depósito de uso al que pertenece este agregado de uso.
usageEndTime Hora de finalización UTC del depósito de uso al que pertenece este agregado de uso.
instanceData Pares clave-valor de detalles de instancia (en un formato nuevo): resourceUri: identificador de recurso completo, que incluye los grupos de recursos y el nombre de instancia. location: región en la que se ejecutó este servicio. tags: etiquetas del recurso especificadas por el usuario. additionalInfo: más detalles sobre el recurso que se consumió; por ejemplo, el tipo de imagen o versión de sistema operativo.
quantity Cantidad de consumo de recursos que se produjo en este período de tiempo.
meterId Identificador único del recurso que se ha consumido (también denominado ResourceID).

Recuperar información de utilización

PowerShell

Para generar los datos de utilización, se deben tener recursos que se ejecuten y usen activamente el sistema. Por ejemplo, una máquina virtual activa o una cuenta de almacenamiento que contiene datos.

Use los siguientes cmdlets de PowerShell para ver los datos de utilización:

  1. Instale PowerShell para Azure Stack Hub.
  2. Configure el entorno de PowerShell del usuario de Azure Stack Hub o del operador de Azure Stack Hub.
  3. Para recuperar los datos de uso, llame al cmdlet Get-AzsSubscriberUsage de PowerShell:
Get-AzsSubscriberUsage -ReportedStartTime