Generate Reservation Details Report - By Billing Account Id
Создает отчет сведений о резервировании для предоставленного диапазона дат асинхронно на основе идентификатора регистрации. Сведения об использовании резервирования можно просматривать только определенными корпоративными ролями. Дополнительные сведения о ролях см. в 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?api-version=2026-06-01&startDate={startDate}&endDate={endDate}
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
billing
|
path | True |
string |
Идентификатор BillingAccount |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
|
end
|
query | True |
string |
Дата окончания |
|
start
|
query | True |
string |
Дата начала |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Операция Azure успешно завершена. |
|
| 202 Accepted |
Операция ресурса принята. Заголовки Location: string |
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
| Имя | Описание |
|---|---|
| user_impersonation | выдать себя за учетную запись пользователя |
Примеры
ReservationDetails
Образец запроса
POST https://management.azure.com/providers/microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/generateReservationDetailsReport?api-version=2026-06-01&startDate=2020-01-01&endDate=2020-01-30
Пример ответа
{
"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"
},
"status": "Completed"
}
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
Определения
| Имя | Описание |
|---|---|
|
Error |
Сведения об ошибке. |
|
Error |
Ответ на ошибку указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке. \n\nНекоторые ответы на ошибку: \n\n * 429 TooManyRequests — Запрос ограничен. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after. \n\n * 503 СервисНедоступно - Связь временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After. |
|
Operation |
Состояние длительной операции. |
|
Operation |
Enum, представляющий статус асинхронной операции. |
|
Reservation |
CSV-файл из ссылки reportUrl blob состоит из данных о резервировании с следующей схемой с ежедневной детализацией |
ErrorDetails
Сведения об ошибке.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Код ошибки. |
| message |
string |
Сообщение об ошибке, указывающее, почему операция завершилась ошибкой. |
ErrorResponse
Ответ на ошибку указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке. \n\nНекоторые ответы на ошибку: \n\n * 429 TooManyRequests — Запрос ограничен. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after. \n\n * 503 СервисНедоступно - Связь временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After.
| Имя | Тип | Описание |
|---|---|---|
| error |
Сведения об ошибке. |
OperationStatus
Состояние длительной операции.
| Имя | Тип | Описание |
|---|---|---|
| properties.reportUrl |
CSV-файл из ссылки reportUrl blob состоит из данных о резервировании с следующей схемой с ежедневной детализацией |
|
| properties.validUntil |
string (date-time) |
Время, когда URL отчёта становится недействительным. |
| status |
Состояние длительной операции. |
OperationStatusType
Enum, представляющий статус асинхронной операции.
| Значение | Описание |
|---|---|
| Running | |
| Completed | |
| Failed |
ReservationReportSchema
CSV-файл из ссылки reportUrl blob состоит из данных о резервировании с следующей схемой с ежедневной детализацией
| Значение | Описание |
|---|---|
| InstanceFlexibilityGroup | |
| InstanceFlexibilityRatio | |
| InstanceId | |
| Kind | |
| ReservationId | |
| ReservationOrderId | |
| ReservedHours | |
| SkuName | |
| TotalReservedQuantity | |
| UsageDate | |
| UsedHours |