New-AzCostManagementDetailReport
Esta API es el reemplazo de todas las API de detalles de uso publicadas anteriormente. Solicite generar un informe de detalles de costos para el intervalo de fechas proporcionado, el período de facturación (solo clientes empresariales) o el identificador de facturación de forma asincrónica en un ámbito determinado. La llamada inicial para solicitar un informe devolverá un 202 con un encabezado "Location" y "Retry-After". El encabezado "Ubicación" proporcionará el punto de conexión para sondear para obtener el resultado de la generación de informes. "Retry-After" proporciona la duración que se debe esperar antes de sondear el informe generado. Una llamada para sondear la operación de informe proporcionará una respuesta 202 con un encabezado "Ubicación" si la operación todavía está en curso. Una vez completada la operación de generación de informes, el punto de conexión de sondeo proporcionará una respuesta 200 junto con detalles sobre los blobs de informe que están disponibles para su descarga. Los detalles sobre los archivos disponibles para su descarga estarán disponibles en el cuerpo de la respuesta de sondeo.
Syntax
New-AzCostManagementDetailReport
-Scope <String>
[-BillingPeriod <String>]
[-InvoiceId <String>]
[-Metric <CostDetailsMetricType>]
[-TimePeriodEnd <String>]
[-TimePeriodStart <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Esta API es el reemplazo de todas las API de detalles de uso publicadas anteriormente. Solicite generar un informe de detalles de costos para el intervalo de fechas proporcionado, el período de facturación (solo clientes empresariales) o el identificador de facturación de forma asincrónica en un ámbito determinado. La llamada inicial para solicitar un informe devolverá un 202 con un encabezado "Location" y "Retry-After". El encabezado "Ubicación" proporcionará el punto de conexión para sondear para obtener el resultado de la generación de informes. "Retry-After" proporciona la duración que se debe esperar antes de sondear el informe generado. Una llamada para sondear la operación de informe proporcionará una respuesta 202 con un encabezado "Ubicación" si la operación todavía está en curso. Una vez completada la operación de generación de informes, el punto de conexión de sondeo proporcionará una respuesta 200 junto con detalles sobre los blobs de informe que están disponibles para su descarga. Los detalles sobre los archivos disponibles para su descarga estarán disponibles en el cuerpo de la respuesta de sondeo.
Ejemplos
Ejemplo 1: Solicitud para generar un informe de detalles de costos para el intervalo de fechas proporcionado, el período de facturación (solo los clientes empresariales) o el identificador de facturación de forma asincrónica en un ámbito determinado
New-AzCostManagementDetailReport -Scope "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f" -Metric 'ActualCost' -TimePeriodStart "2022-10-01" -TimePeriodEnd "2022-10-20"
Este comando solicita generar un informe de detalles de costos para el intervalo de fechas proporcionado, el período de facturación (solo los clientes empresariales) o el identificador de facturación de forma asincrónica en un ámbito determinado.
Parámetros
-AsJob
Ejecución del comando como trabajo
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BillingPeriod
Este parámetro solo lo pueden usar los clientes de Enterprise Agreement. Use el formato YearMonth(por ejemplo, 202008). Este parámetro no se puede usar junto con los parámetros invoiceId o timePeriod. Si no se proporciona un parámetro timePeriod, invoiceId o billingPeriod en el cuerpo de la solicitud, la API devolverá el costo del mes actual.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InvoiceId
Este parámetro solo lo pueden usar los clientes de Contrato de cliente de Microsoft. Además, solo se puede usar en el ámbito de Perfil de facturación o Cliente. Este parámetro no se puede usar junto con los parámetros billingPeriod o timePeriod. Si no se proporciona un parámetro timePeriod, invoiceId o billingPeriod en el cuerpo de la solicitud, la API devolverá el costo del mes actual.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Metric
Tipo del informe detallado. De forma predeterminada, se proporciona ActualCost
Type: | CostDetailsMetricType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWait
Ejecutar el comando de forma asincrónica
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Ámbito asociado a las operaciones de detalles de uso. Esto incluye '/subscriptions/{subscriptionId}/' para el ámbito de la suscripción, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' para el ámbito de la cuenta de facturación, '/providers/Microsoft.Billing/departments/{departmentId}' para el ámbito department, '/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId}' para el ámbito EnrollmentAccount. Además, los ámbitos de la cuenta de comercio moderno son "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}" para el ámbito billingAccount, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' para el ámbito billingProfile, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' para el ámbito invoiceSection y 'providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' específico para los partners.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimePeriodEnd
Fecha de finalización a la que se van a extraer los datos. formato de ejemplo 2020-03-15
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimePeriodStart
Fecha de inicio de la que se van a extraer datos. formato de ejemplo 2020-03-15
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |