Reservation Transactions - List By Billing Profile

Ссылка

Служба:: Consumption

Версия API:: 2024-08-01

Список транзакций для зарезервированных экземпляров в области профиля выставления счетов. Транзакции возврата размещаются вместе с его транзакцией покупки (т. е. в месяц выставления счетов за покупку). Например, возврат средств запрашивается в мае 2021 года. Эта транзакция возврата будет иметь дату события в мае 2021 года, но месяц выставления счетов по состоянию на апрель 2020 года при покупке резервирования. Примечание. Arm имеет ограничение на полезные данные в 12 МБ, поэтому вызывающие в настоящее время получают 400, когда размер отклика превышает ограничение ARM. В таких случаях вызов API должен выполняться с меньшими диапазонами дат.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/reservationTransactions?api-version=2024-08-01

С использованием необязательных параметров:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/reservationTransactions?$filter={$filter}&api-version=2024-08-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
billingAccountId	path	True	string	Идентификатор BillingAccount
billingProfileId	path	True	string	Идентификатор профиля выставления счетов Azure.
api-version	query	True	string	Версия API для использования с клиентским запросом. Текущая версия — 2023-03-01.
$filter	query		string	Фильтрация транзакций резервирования по диапазону дат. Свойства/EventDate для даты начала и даты окончания. Фильтр поддерживает le и ge. Примечание. API возвращает данные для всего месяца выставления счетов даты начала и окончания. Например, filter properties/eventDate+ge+2020-01-01+AND+properties/eventDate+le+2020-12-29 будет включать данные для всего декабря 2020 года (т. е. будут содержать записи для дат 30 декабря и 31)

Ответы

Имя	Тип	Описание
200 OK	ModernReservationTransactionsListResult	ХОРОШО. Запрос выполнен успешно.
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции.

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

azure_auth

Поток OAuth2 Azure Active Directory.

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

Области

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

Примеры

ReservationTransactionsByBillingProfileId

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

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB/providers/Microsoft.Consumption/reservationTransactions?$filter=properties/eventDate+ge+2020-05-20+AND+properties/eventDate+le+2020-05-30&api-version=2024-08-01

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

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

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB/providers/Microsoft.Consumption/reservationTransactions",
      "name": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
      "type": "Microsoft.Consumption/reservationTransactions",
      "properties": {
        "eventDate": "2020-04-25T21:21:38Z",
        "reservationOrderId": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
        "description": "Reserved VM Instance, Standard_B1ls, US East, 3 Years",
        "eventType": "Purchase",
        "quantity": 1,
        "amount": 1.44,
        "currency": "USD",
        "reservationOrderName": "VM_RI_03-25-2020_14-18",
        "armSkuName": "Standard_B1ls",
        "billingFrequency": "Recurring",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB",
        "billingProfileName": "IT Department*",
        "invoice": "T000456437",
        "invoiceId": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB/invoices/T000456437",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/invoiceSections/QBTB-EYAK-PJA-TGB",
        "invoiceSectionName": "IT Department",
        "purchasingSubscriptionGuid": "d924ad15-4a3d-4047-971d-c8b1b300a97b",
        "purchasingSubscriptionName": "contoso",
        "region": "eastus",
        "term": "P3Y"
      }
    }
  ]
}

Определения

Имя	Описание
ErrorDetails	Сведения об ошибке.
ErrorResponse	Ответ на ошибку указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке. Некоторые ответы на ошибки: 429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable — служба временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After. Время ожидания шлюза 504— время ожидания службы при обработке запроса. Если это возможно, уменьшите диапазон дат в запросе.
ModernReservationTransaction	Современный ресурс транзакции резервирования.
ModernReservationTransactionsListResult	Результат перечисления рекомендаций по резервированию.

ErrorDetails

Object

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

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

ErrorResponse

Object

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

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

429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable — служба временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After.
Время ожидания шлюза 504— время ожидания службы при обработке запроса. Если это возможно, уменьшите диапазон дат в запросе.

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

ModernReservationTransaction

Object

Современный ресурс транзакции резервирования.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.amount	number (decimal)	Плата за транзакцию.
properties.armSkuName	string	Это имя SKU ARM. Его можно использовать для присоединения к полю serviceType в дополнительных сведениях в записях об использовании.
properties.billingFrequency	string	Частота выставления счетов, которая может быть однократной или повторяющейся.
properties.billingProfileId	string	Идентификатор профиля выставления счетов.
properties.billingProfileName	string	Имя профиля выставления счетов.
properties.currency	string	Валюта ISO, в которой взимается транзакция, например, USD.
properties.description	string	Описание транзакции.
properties.eventDate	string (date-time)	Дата транзакции
properties.eventType	string	Тип транзакции (покупка, отмена или возврат средств).
properties.invoice	string	Номер счета
properties.invoiceId	string	Идентификатор счета, как в счете, где отображается конкретная транзакция.
properties.invoiceSectionId	string	Идентификатор раздела счета
properties.invoiceSectionName	string	Имя раздела счета.
properties.purchasingSubscriptionGuid	string (uuid)	Guid подписки, который делает транзакцию.
properties.purchasingSubscriptionName	string	Имя подписки, которая делает транзакцию.
properties.quantity	number (decimal)	Количество транзакции.
properties.region	string	Область транзакции.
properties.reservationOrderId	string	Идентификатор заказа на резервирование — это идентификатор покупки резервирования. Каждый идентификатор заказа на резервирование представляет одну транзакцию покупки. Заказ на резервирование содержит резервирования. Порядок резервирования определяет размер виртуальной машины и регион резервирования.
properties.reservationOrderName	string	Имя заказа на резервирование.
properties.term	string	Это термин транзакции.
tags	string[]	Теги ресурсов.
type	string	Тип ресурса.

ModernReservationTransactionsListResult

Object

Результат перечисления рекомендаций по резервированию.

Имя	Тип	Описание
nextLink	string	Ссылка (URL-адрес) на следующую страницу результатов.
value	ModernReservationTransaction[]	Список рекомендаций по резервированию.

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

Reservation Transactions - List By Billing Profile

Параметры URI

Ответы

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

azure_auth

Области

Примеры

ReservationTransactionsByBillingProfileId

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

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

Определения

ErrorDetails

ErrorResponse

ModernReservationTransaction

ModernReservationTransactionsListResult