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

Salidas

ICostDetailsOperationResults