API-интерфейсы рекомендаций по покупке зарезервированных экземпляров для клиентов с Соглашением Enterprise

Статья
02/28/2024

Примечание

1 мая 2024 г. api-интерфейсы azure Enterprise Reporting API будут прекращены. Все оставшиеся API отчетов enterprise перестанут отвечать на запросы. До этого клиентам необходимо перейти на использование API управления затратами Майкрософт. Дополнительные сведения см. в статье Переход с интерфейсов API для корпоративной отчетности на API Управления затратами Майкрософт.

API рекомендаций по резервированию экземпляров оценивает сведения об использовании клиентом виртуальных машин за 7, 30 или 60 дней и предлагает на их основе рекомендации по отдельному и общему резервированию.

Запрашивание рекомендаций по общим зарезервированным экземплярам

Сведения о стандартных обязательных свойствах заголовков см. в статье Обзор API отчетов для корпоративных клиентов .

Метод	Универсальный код ресурса (URI) запроса
GET	`https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/SharedReservationRecommendations?lookBackPeriod=7`

Ответ на общие рекомендации

[{
    "lookBackPeriod": "Last7Days",
    "meterId": "2e3c2132-1398-43d2-ad45-1d77f6574933",
    "skuName": "Standard_DS1_v2",
    "term": "P1Y",
    "region": "westus",
    "costWithNoRI": 186.27634908960002,
    "recommendedQuantity": 9,
    "totalCostWithRI": 143.12931642978083,
    "netSavings": 43.147032659819189,
    "firstUsageDate": "2018-02-19T00:00:00"
}
]

Определения свойств ответа

Имя свойства	Тип	Описание
lookBackPeriod	строка	Строка, представляющая число последних дней использования. Это может быть last7days, last30days или last60days
meterId	строка	Идентификатор единицы измерения ресурса, который необходимо приобрести
skuName	строка	Это номер SKU Resource Manager Azure, который необходимо приобрести.
Слово	строка	P1Y для 1 года и P3Y в течение 3 лет
region	строка	Регион, в котором необходимо приобрести зарезервированный экземпляр
costWithNoRI	строка	Общая текущая стоимость
recommendedQuantity	Decimal	Общее количество зарезервированных экземпляров, которое необходимо приобрести
totalCostWithRI	Decimal	Общая стоимость, если было приобретено рекомендуемое количество
netSavings	Decimal	Чистая экономия в течение 7, 30 или 60 дней
firstUsageDate	Decimal	При первом запуске рекомендуемой виртуальной машины.

Запрашивание рекомендаций по одному зарезервированному экземпляру

Метод	Универсальный код ресурса (URI) запроса
GET	`https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/SingleReservationRecommendations?lookBackPeriod=7`

Ответ с одной рекомендацией

[{
    "subscriptionId": "d143f4db-5a12-46b9-ba15-9bff298b8f45",
    "lookBackPeriod": "Last7Days",
    "meterId": "2e3c2132-1398-43d2-ad45-1d77f6574933",
    "skuName": "Standard_DS1_v2",
    "term": "P1Y",
    "region": "westus",
    "costWithNoRI": 186.27634908960002,
    "recommendedQuantity": 9,
    "totalCostWithRI": 143.12931642978083,
    "netSavings": 43.147032659819189,
    "firstUsageDate": "2018-02-19T00:00:00"
}
]