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.
Sintaxis
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
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-BillingPeriod
Los clientes del Contrato Enterprise solo pueden usar este parámetro. 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.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | PSObject |
Alias: | AzureRMContext, AzureCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-InvoiceId
Los clientes del Contrato de cliente de Microsoft solo pueden usar este parámetro. Además, solo se puede usar en el ámbito 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.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Metric
Tipo del informe detallado. De forma predeterminada, se proporciona ActualCost
Tipo: | CostDetailsMetricType |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NoWait
Ejecutar el comando de forma asincrónica
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-TimePeriodEnd
Fecha de finalización a la que se van a extraer los datos. formato de ejemplo 2020-03-15
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-TimePeriodStart
Fecha de inicio de la que se van a extraer datos. formato de ejemplo 2020-03-15
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |