New-AzCostManagementDetailReport

Referência

Módulo:: Az.CostManagement

Essa API é a substituição de todas as APIs de Detalhes de Uso da versão anterior. Solicite a geração de um relatório de detalhes de custo para o intervalo de datas fornecido, o período de cobrança (somente clientes empresariais) ou a ID da Fatura de forma assíncrona em um determinado escopo. A chamada inicial para solicitar um relatório retornará um 202 com um cabeçalho 'Location' e 'Retry-After'. O cabeçalho 'Location' fornecerá o ponto de extremidade a ser sondado para obter o resultado da geração do relatório. O 'Retry-After' fornece a duração para aguardar antes da sondagem do relatório gerado. Uma chamada para sondar a operação de relatório fornecerá uma resposta 202 com um cabeçalho 'Location' se a operação ainda estiver em andamento. Depois que a operação de geração de relatório for concluída, o ponto de extremidade de sondagem fornecerá uma resposta de 200, juntamente com detalhes sobre os blobs de relatório que estão disponíveis para download. Os detalhes sobre os arquivos disponíveis para download estarão disponíveis no corpo da resposta da sondagem.

Sintaxe

New-AzCostManagementDetailReport
   -Scope <String>
   [-BillingPeriod <String>]
   [-InvoiceId <String>]
   [-Metric <CostDetailsMetricType>]
   [-TimePeriodEnd <String>]
   [-TimePeriodStart <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Exemplos

Exemplo 1: Solicitar a geração de um relatório de detalhes de custo para o intervalo de datas fornecido, o período de cobrança (somente clientes corporativos) ou a ID da Fatura de forma assíncrona em um determinado escopo

New-AzCostManagementDetailReport -Scope "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f" -Metric 'ActualCost' -TimePeriodStart "2022-10-01" -TimePeriodEnd "2022-10-20"

Esse comando solicita a geração de um relatório de detalhes de custo para o intervalo de datas fornecido, o período de cobrança (somente clientes corporativos) ou a ID da Fatura de forma assíncrona em um determinado escopo.

Parâmetros

-AsJob

Executar o comando como um trabalho

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BillingPeriod

Esse parâmetro só pode ser usado pelos clientes do Contrato Enterprise. Use o formato YearMonth(por exemplo, 202008). Esse parâmetro não pode ser usado junto com os parâmetros invoiceId ou timePeriod. Se um parâmetro timePeriod, invoiceId ou billingPeriod não for fornecido no corpo da solicitação, a API retornará o custo do mês atual.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Tipo:	PSObject
Aliases:	AzureRMContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InvoiceId

Esse parâmetro só pode ser usado pelos clientes do Contrato de Cliente da Microsoft. Além disso, ele só pode ser usado no perfil de cobrança ou no escopo do cliente. Esse parâmetro não pode ser usado junto com os parâmetros billingPeriod ou timePeriod. Se um parâmetro timePeriod, invoiceId ou billingPeriod não for fornecido no corpo da solicitação, a API retornará o custo do mês atual.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Metric

O tipo do relatório detalhado. Por padrão, ActualCost é fornecido

Tipo:	CostDetailsMetricType
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-NoWait

Executar o comando de forma assíncrona

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Scope

O escopo associado às operações de detalhes de uso. Isso inclui '/subscriptions/{subscriptionId}/' para escopo de assinatura, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' para escopo da Conta de Cobrança, '/providers/Microsoft.Billing/departments/{departmentId}' para escopo do Departamento, '/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId}' para o escopo EnrollmentAccount. Além disso, os escopos da Conta de Comércio Moderno são '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' para o escopo billingAccount, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' para o escopo billingProfile, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' para o escopo invoiceSection e 'providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' específico para parceiros.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TimePeriodEnd

A data de término para a qual efetuar pull de dados. formato de exemplo 2020-03-15

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TimePeriodStart

A data de início da qual os dados serão extraídos. formato de exemplo 2020-03-15

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Saídas

ICostDetailsOperationResults

Compartilhar via