Compartir a través de

Get-AzUsageAggregate

Módulo:
Az.Billing Module

Obtiene los detalles de uso de la suscripción de Azure notificados.

Sintaxis

Default (valor predeterminado) 

Get-AzUsageAggregate
    -ReportedStartTime <DateTime>
    -ReportedEndTime <DateTime>
    [-AggregationGranularity <AggregationGranularity>]
    [-ShowDetail <Boolean>]
    [-ContinuationToken <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

El cmdlet Get-AzUsageAggregate obtiene datos agregados de uso de la suscripción de Azure mediante las siguientes propiedades:

  • Horas de inicio y finalización de cuándo se notificó el uso.
  • Precisión de agregación, ya sea diaria o por hora.
  • Detalle del nivel de instancia para varias instancias del mismo recurso. Para obtener resultados coherentes, los datos devueltos se basan en el momento en que el recurso de Azure notificó los detalles de uso. Para más información, consulte Referenciahttps://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c de la API REST de facturación de Azure (https://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c) en la biblioteca microsoft Developer Network.

Ejemplos

Ejemplo 1: Recuperación de datos de suscripción

Get-AzUsageAggregate -ReportedStartTime "5/2/2015" -ReportedEndTime "5/5/2015"

Este comando recupera los datos de uso notificados para la suscripción entre el 2/5/5/2015 y el 5/5/2015.

Parámetros

-AggregationGranularity

Especifica la precisión de agregación de los datos. Los valores válidos son: Daily y Hourly. El valor predeterminado es Daily.

Propiedades de parámetro

Tipo:Microsoft.Azure.Commerce.UsageAggregates.Models.AggregationGranularity
Valor predeterminado:None
Valores aceptados:Daily, Hourly
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ContinuationToken

Especifica el token de continuación que se recuperó del cuerpo de la respuesta en la llamada anterior. Para un conjunto de resultados grande, las respuestas se paginan mediante tokens de continuación. El token de continuación actúa como marcador para el progreso. Si no especifica este parámetro, los datos se recuperan desde el principio del día o la hora especificados en ReportedStartTime. Se recomienda seguir el vínculo siguiente en la respuesta a la página a través de los datos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ReportedEndTime

Especifica la hora de finalización notificada para cuándo se registró el uso de recursos en el sistema de facturación de Azure. Azure es un sistema distribuido, que abarca varios centros de datos de todo el mundo, por lo que hay un retraso entre el momento en que el recurso se consumió realmente, que es el tiempo de uso de recursos y el momento en que el evento de uso alcanzó el sistema de facturación, que es el tiempo notificado del uso de recursos. Para obtener todos los eventos de uso de una suscripción que se notifican durante un período de tiempo, se consulta por hora notificada. Aunque consulte por hora notificada, el cmdlet agrega los datos de respuesta por el tiempo de uso del recurso. Los datos de uso de recursos son la tabla dinámica útil para analizar los datos.

Propiedades de parámetro

Tipo:DateTime
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ReportedStartTime

Especifica la hora de inicio notificada para cuándo se registró el uso de recursos en el sistema de facturación de Azure.

Propiedades de parámetro

Tipo:DateTime
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ShowDetail

Indica si este cmdlet devuelve detalles de nivel de instancia con los datos de uso. El valor predeterminado es $True. Si $False, el servicio agrega los resultados en el servidor y, por tanto, devuelve menos grupos agregados. Por ejemplo, si ejecuta tres sitios web, de forma predeterminada obtendrá tres elementos de línea para el consumo del sitio web. Sin embargo, cuando el valor es $False, todos los datos del mismo subscriptionId, meterId, usageStartTime y usageEndTime se contraen en un solo elemento de línea.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ShowDetails

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

Microsoft.Azure.Commerce.UsageAggregates.Models.UsageAggregationGetResponse