Condividi tramite


New-AzCostManagementDetailReport

Questa API è la sostituzione di tutte le API dettagli utilizzo precedentemente rilasciate. Richiedere di generare un report dei dettagli sui costi per l'intervallo di date, il periodo di fatturazione (solo i clienti aziendali) o l'ID fattura in modo asincrono in un determinato ambito. La chiamata iniziale per richiedere un report restituirà un valore 202 con un'intestazione "Location" e "Retry-After". L'intestazione 'Location' fornirà l'endpoint di cui eseguire il polling per ottenere il risultato della generazione del report. "Retry-After" fornisce la durata di attesa prima del polling per il report generato. Una chiamata per eseguire il polling dell'operazione di report fornirà una risposta 202 con un'intestazione "Location" se l'operazione è ancora in corso. Al termine dell'operazione di generazione del report, l'endpoint di polling fornirà una risposta 200 insieme ai dettagli sui BLOB di report disponibili per il download. I dettagli sui file disponibili per il download saranno disponibili nel corpo della risposta di polling.

Sintassi

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

Descrizione

Questa API è la sostituzione di tutte le API dettagli utilizzo precedentemente rilasciate. Richiedere di generare un report dei dettagli sui costi per l'intervallo di date, il periodo di fatturazione (solo i clienti aziendali) o l'ID fattura in modo asincrono in un determinato ambito. La chiamata iniziale per richiedere un report restituirà un valore 202 con un'intestazione "Location" e "Retry-After". L'intestazione 'Location' fornirà l'endpoint di cui eseguire il polling per ottenere il risultato della generazione del report. "Retry-After" fornisce la durata di attesa prima del polling per il report generato. Una chiamata per eseguire il polling dell'operazione di report fornirà una risposta 202 con un'intestazione "Location" se l'operazione è ancora in corso. Al termine dell'operazione di generazione del report, l'endpoint di polling fornirà una risposta 200 insieme ai dettagli sui BLOB di report disponibili per il download. I dettagli sui file disponibili per il download saranno disponibili nel corpo della risposta di polling.

Esempio

Esempio 1: Richiedere di generare un report dei dettagli dei costi per l'intervallo di date specificato, il periodo di fatturazione (solo i clienti aziendali) o l'ID fattura in modo asincrono in un determinato ambito

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

Questo comando richiede di generare un report dei dettagli sui costi per l'intervallo di date specificato, il periodo di fatturazione (solo i clienti aziendali) o l'ID fattura in modo asincrono in un determinato ambito.

Parametri

-AsJob

Eseguire il comando come processo

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BillingPeriod

Questo parametro può essere usato solo dai clienti con Contratto Enterprise. Usa il formato YearMonth(ad esempio 202008). Questo parametro non può essere usato insieme ai parametri invoiceId o timePeriod. Se un parametro timePeriod, invoiceId o billingPeriod non viene specificato nel corpo della richiesta, l'API restituirà il costo del mese corrente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

Tipo:PSObject
Alias:AzureRMContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InvoiceId

Questo parametro può essere usato solo dai clienti del Contratto del cliente Microsoft. Inoltre, può essere usato solo nell'ambito del profilo di fatturazione o del cliente. Questo parametro non può essere usato insieme ai parametri billingPeriod o timePeriod. Se un parametro timePeriod, invoiceId o billingPeriod non viene specificato nel corpo della richiesta, l'API restituirà il costo del mese corrente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Metric

Tipo del report dettagliato. Per impostazione predefinita viene fornito ActualCost

Tipo:CostDetailsMetricType
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NoWait

Eseguire il comando in modo asincrono

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Scope

Ambito associato alle operazioni sui dettagli di utilizzo. Sono inclusi '/subscriptions/{subscriptionId}/' per l'ambito della sottoscrizione, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' per ambito account di fatturazione, '/providers/Microsoft.Billing/departments/{departmentId}' per ambito reparto, '/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId}' per l'ambito EnrollmentAccount. Inoltre, gli ambiti dell'account commerciale moderno sono "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}" per l'ambito billingAccount, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' per ambito billingProfile, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' per l'ambito invoiceSection e 'providers/Microsoft. Fatturazione/billingAccounts/{billingAccountId}/customers/{customerId}' specifici per i partner.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimePeriodEnd

Data di fine in cui eseguire il pull dei dati. formato di esempio 2020-03-15

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimePeriodStart

Data di inizio da cui estrarre i dati. formato di esempio 2020-03-15

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output