Поделиться через


New-AzCostManagementDetailReport

Этот API является заменой для всех ранее выпущенных API сведений об использовании. Запрос на создание отчета о затратах для заданного диапазона дат, периода выставления счетов (только корпоративные клиенты) или идентификатора счета асинхронно в определенной области. Первоначальный вызов запроса отчета вернет заголовок 202 с заголовком Location и Retry-After. Заголовок Location предоставит конечную точку для опроса, чтобы получить результат создания отчета. Значение Retry-After предоставляет длительность ожидания перед опросом созданного отчета. Вызов для опроса операции отчета предоставит ответ 202 с заголовком Location, если операция по-прежнему выполняется. После завершения операции создания отчета конечная точка опроса предоставит ответ 200 вместе с подробными сведениями о больших двоичных объектах отчета, доступных для скачивания. Сведения о файлах, доступных для скачивания, будут доступны в тексте ответа на опрос.

Синтаксис

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

Описание

Этот API является заменой для всех ранее выпущенных API сведений об использовании. Запрос на создание отчета о затратах для заданного диапазона дат, периода выставления счетов (только корпоративные клиенты) или идентификатора счета асинхронно в определенной области. Первоначальный вызов запроса отчета вернет заголовок 202 с заголовком Location и Retry-After. Заголовок Location предоставит конечную точку для опроса, чтобы получить результат создания отчета. Значение Retry-After предоставляет длительность ожидания перед опросом созданного отчета. Вызов для опроса операции отчета предоставит ответ 202 с заголовком Location, если операция по-прежнему выполняется. После завершения операции создания отчета конечная точка опроса предоставит ответ 200 вместе с подробными сведениями о больших двоичных объектах отчета, доступных для скачивания. Сведения о файлах, доступных для скачивания, будут доступны в тексте ответа на опрос.

Примеры

Пример 1. Запрос на создание отчета о затратах для заданного диапазона дат, периода выставления счетов (только корпоративные клиенты) или идентификатора счета асинхронно в определенной области

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

Эта команда запрашивает создание отчета о затратах для указанного диапазона дат, периода выставления счетов (только корпоративных клиентов) или идентификатора счета в определенной области.

Параметры

-AsJob

Выполнение команды в качестве задания

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-BillingPeriod

Этот параметр могут использовать только участники Соглашения Enterprise. Используйте формат YearMonth (например, 202008). Этот параметр нельзя использовать вместе с параметрами invoiceId или timePeriod. Если параметр timePeriod, invoiceId или billingPeriod не указан в тексте запроса, API вернет стоимость текущего месяца.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

Параметр DefaultProfile не работает. Используйте параметр SubscriptionId, если он доступен при выполнении командлета в другой подписке.

Тип:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InvoiceId

Этот параметр могут использовать только участники Клиентского соглашения Microsoft. Кроме того, его можно использовать только в профиле выставления счетов или в области Клиента. Этот параметр нельзя использовать вместе с параметрами billingPeriod или timePeriod. Если параметр timePeriod, invoiceId или billingPeriod не указан в тексте запроса, API вернет стоимость текущего месяца.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Metric

Тип подробного отчета. По умолчанию предоставляется ActualCost

Тип:CostDetailsMetricType
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NoWait

Асинхронное выполнение команды

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Scope

Область, связанная с операциями сведений об использовании. Это включает в себя "/subscriptions/{subscriptionId}/" для области подписки, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}" для области учетной записи выставления счетов, "/providers/Microsoft.Billing/departmentId}" для области отдела, "/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId}" для области EnrollmentAccount. Кроме того, области современной коммерческой учетной записи : "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}" для области выставления счетов, "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}" для области выставления счетов, "providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}" для области выставления счетов и "поставщики/ Майкрософт". Выставление счетов,выставление счетов/выставление счетов/{billingAccountId}/customers/{customerId}" для партнеров.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TimePeriodEnd

Дата окончания извлечения данных. пример формата 2020-03-15

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TimePeriodStart

Дата начала извлечения данных. пример формата 2020-03-15

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Выходные данные

ICostDetailsOperationResults