Partilhar via


New-AzCostManagementDetailReport

Esta API é a substituição de todas as APIs de Detalhes de Uso lançadas anteriormente. Solicite a geração de um relatório de detalhes de custo para o intervalo de datas fornecido, período de faturamento (Somente clientes corporativos) ou 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 'Local' e 'Repetir-Depois'. O cabeçalho 'Local' fornecerá o ponto de extremidade a ser pesquisado para obter o resultado da geração do relatório. O 'Retry-After' fornece a duração para aguardar antes da sondagem para o relatório gerado. Uma chamada para sondar a operação de relatório fornecerá uma resposta 202 com um cabeçalho 'Local' se a operação ainda estiver em andamento. Quando a operação de geração de relatório for concluída, o ponto de extremidade de sondagem fornecerá uma resposta 200, juntamente com detalhes sobre o(s) blob(s) de relatório que estão disponíveis para download. Os detalhes sobre o(s) ficheiro(s) disponível(is) para download estarão disponíveis no corpo da resposta à votação.

Sintaxe

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

Description

Esta API é a substituição de todas as APIs de Detalhes de Uso lançadas anteriormente. Solicite a geração de um relatório de detalhes de custo para o intervalo de datas fornecido, período de faturamento (Somente clientes corporativos) ou 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 'Local' e 'Repetir-Depois'. O cabeçalho 'Local' fornecerá o ponto de extremidade a ser pesquisado para obter o resultado da geração do relatório. O 'Retry-After' fornece a duração para aguardar antes da sondagem para o relatório gerado. Uma chamada para sondar a operação de relatório fornecerá uma resposta 202 com um cabeçalho 'Local' se a operação ainda estiver em andamento. Quando a operação de geração de relatório for concluída, o ponto de extremidade de sondagem fornecerá uma resposta 200, juntamente com detalhes sobre o(s) blob(s) de relatório que estão disponíveis para download. Os detalhes sobre o(s) ficheiro(s) disponível(is) para download estarão disponíveis no corpo da resposta à votação.

Exemplos

Exemplo 1: Solicitação para gerar um relatório de detalhes de custo para o intervalo de datas fornecido, período de faturamento (Somente clientes corporativos) ou 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"

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

Parâmetros

-AsJob

Executar o comando como um trabalho

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BillingPeriod

Este parâmetro só pode ser utilizado por clientes do Enterprise Agreement. Use o formato YearMonth(por exemplo, 202008). Este 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InvoiceId

Este parâmetro só pode ser usado por clientes do Contrato de Cliente da Microsoft. Além disso, ele só pode ser usado no escopo Perfil de Faturamento ou Cliente. Este 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Metric

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

Tipo:CostDetailsMetricType
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NoWait

Execute o comando de forma assíncrona

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Scope

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TimePeriodEnd

A data final para a qual extrair dados. Exemplo de formato 2020-03-15

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TimePeriodStart

A data de início a partir da qual extrair dados. Exemplo de formato 2020-03-15

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

ICostDetailsOperationResults