Get-AzUsageAggregate
Obtém os detalhes de uso da assinatura do Azure relatados.
Sintaxe
Get-AzUsageAggregate
-ReportedStartTime <DateTime>
-ReportedEndTime <DateTime>
[-AggregationGranularity <AggregationGranularity>]
[-ShowDetail <Boolean>]
[-ContinuationToken <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Get-AzUsageAggregate obtém dados agregados de uso da assinatura do Azure pelas seguintes propriedades:
- Horários de início e término de quando o uso foi relatado.
- Precisão de agregação, diariamente ou por hora.
- Detalhes de nível de instância para várias instâncias do mesmo recurso. Para resultados consistentes, os dados retornados são baseados em quando os detalhes de uso foram relatados pelo recurso do Azure. Para obter mais informações, consulte ohttps://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c de Referência da API REST de Cobrança do Azure (https://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c) na biblioteca da Rede de Desenvolvedores da Microsoft.
Exemplos
Exemplo 1: recuperar dados de assinatura
Get-AzUsageAggregate -ReportedStartTime "5/2/2015" -ReportedEndTime "5/5/2015"
Esse comando recupera os dados de uso relatados para a assinatura entre 2/5/2015 e 5/5/2015.
Parâmetros
-AggregationGranularity
Especifica a precisão de agregação dos dados. Os valores válidos são: diário e por hora. O valor padrão é Diário.
Tipo: | Microsoft.Azure.Commerce.UsageAggregates.Models.AggregationGranularity |
Valores aceitos: | Daily, Hourly |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ContinuationToken
Especifica o token de continuação recuperado do corpo da resposta na chamada anterior. Para um conjunto de resultados grande, as respostas são paginada usando tokens de continuação. O token de continuação serve como um indicador para o progresso. Se você não especificar esse parâmetro, os dados serão recuperados do início do dia ou da hora especificado em ReportedStartTime. Recomendamos que você siga o próximo link na resposta à página por meio dos dados.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ReportedEndTime
Especifica a hora de término relatada para quando o uso de recursos foi registrado no sistema de cobrança do Azure. O Azure é um sistema distribuído, abrangendo vários datacenters em todo o mundo, portanto, há um atraso entre quando o recurso foi realmente consumido, que é o tempo de uso do recurso e quando o evento de uso atingiu o sistema de cobrança, que é o tempo relatado de uso do recurso. Para obter todos os eventos de uso de uma assinatura que são relatados por um período de tempo, você consulta por hora relatada. Mesmo que você consulte por tempo relatado, o cmdlet agrega os dados de resposta pelo tempo de uso do recurso. Os dados de uso do recurso são o pivô útil para analisar os dados.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ReportedStartTime
Especifica a hora de início relatada para quando o uso de recursos foi registrado no sistema de cobrança do Azure.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ShowDetail
Indica se esse cmdlet retorna detalhes no nível da instância com os dados de uso. O valor padrão é $True. Se $False, o serviço agrega os resultados no lado do servidor e, portanto, retorna menos grupos agregados. Por exemplo, se você estiver executando três sites, por padrão, obterá três itens de linha para consumo de site. No entanto, quando o valor é $False, todos os dados do mesmo subscriptionId, meterId, usageStartTimee usageEndTime são recolhidos em um único item de linha.
Tipo: | Boolean |
Aliases: | ShowDetails |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
None
Saídas
Microsoft.Azure.Commerce.UsageAggregates.Models.UsageAggregationGetResponse
Azure PowerShell