Generate Reservation Details Report - By Billing Account Id

Служба:

Cost Management

Версия API:

2024-08-01

Создает отчет сведений о резервировании для предоставленного диапазона дат асинхронно на основе идентификатора регистрации. Сведения об использовании резервирования можно просматривать только определенными корпоративными ролями. Дополнительные сведения о ролях см. в https://docs.microsoft.com/en-us/azure/cost-management-billing/manage/understand-ea-roles#usage-and-costs-access-by-role

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2024-08-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
billingAccountId	path	True	string	Идентификатор регистрации (устаревший идентификатор BillingAccount)
api-version	query	True	string	Версия API, используемая для этой операции.
endDate	query	True	string	Дата окончания
startDate	query	True	string	Дата начала

Ответы

Имя	Тип	Описание
200 OK	OperationStatus	Обработка запроса завершена.
202 Accepted		Принятый. Запрос будет обработан. Используйте заголовок расположения для проверки состояния. Заголовки Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

ReservationDetails

Образец запроса

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate=2020-01-01&endDate=2020-01-30&api-version=2024-08-01

Пример ответа

Код состояния:

202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2019-11-01
Retry-After: 60

Код состояния:

200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Определения

Имя	Описание
ErrorDetails	Сведения об ошибке.
ErrorResponse	Ответ на ошибку указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке. Некоторые ответы на ошибки: 429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable — служба временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After.
OperationStatus	Состояние длительной операции.
OperationStatusType	Состояние длительной операции.
ReservationReportSchema	CSV-файл из ссылки blob-объекта reportUrl состоит из данных об использовании резервирования со следующей схемой при ежедневной детализации.

ErrorDetails

Сведения об ошибке.

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке, указывающее, почему операция завершилась ошибкой.

ErrorResponse

Ответ на ошибку указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке.

Некоторые ответы на ошибки:

• 429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after.

• 503 ServiceUnavailable — служба временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After.

Имя	Тип	Описание
error	ErrorDetails	Сведения об ошибке.

OperationStatus

Состояние длительной операции.

Имя	Тип	Описание
properties.reportUrl	ReservationReportSchema	CSV-файл из ссылки blob-объекта reportUrl состоит из данных об использовании резервирования со следующей схемой при ежедневной детализации.
properties.validUntil	string	Время, в течение которого URL-адрес отчета становится недопустимым.
status	OperationStatusType	Состояние длительной операции.

OperationStatusType

Состояние длительной операции.

Имя	Тип	Описание
Completed	string
Failed	string
Running	string

ReservationReportSchema

CSV-файл из ссылки blob-объекта reportUrl состоит из данных об использовании резервирования со следующей схемой при ежедневной детализации.

Имя	Тип	Описание
InstanceFlexibilityGroup	string
InstanceFlexibilityRatio	string
InstanceId	string
Kind	string
ReservationId	string
ReservationOrderId	string
ReservedHours	string
SkuName	string
TotalReservedQuantity	string
UsageDate	string
UsedHours	string