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
Azure PowerShell