你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

企业客户的预留实例购买建议 API

  • 项目

注意

2024 年 5 月 1 日，Azure 企业报告 API 将停用。 任何剩余的企业报告 API 都将停止响应请求。 在此之前，客户需要过渡到使用 Microsoft 成本管理 API。 要了解详细信息，请参阅从 Azure 企业报告迁移到 Microsoft 成本管理 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 字符串 应购买的资源的计量 ID
skuName 字符串 这是需要购买的 Azure 资源管理器 SKU
关键词 字符串 P1Y 为 1 年，P3Y 为 3 年
region 字符串 应购买预留实例的区域
costWithNoRI 字符串 当前总成本
recommendedQuantity Decimal 应购买的预留实例总数
totalCostWithRI Decimal 如果已购买建议数量，则总成本
netSavings Decimal 7、30 或 60 天内的净节省
firstUsageDate Decimal 首次运行建议的 VM。

请求单个预留实例建议

请参阅 面向企业客户的报告 API 概述 一文，了解常见的必需标头属性。

方法 请求 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"
}
]

响应属性定义

属性名称 类型 说明
subscriptionId string 应为其购买预留实例的 SubscriptionId
lookBackPeriod 字符串 表示过去使用天数的字符串。 它可以有 last7days、last30days 或 last60days
meterId 字符串 应购买的资源的计量 ID
skuName 字符串 这是需要购买的 Azure 资源管理器 SKU
关键词 字符串 P1Y 为 1 年，P3Y 为 3 年
region 字符串 应购买预留实例的区域
costWithNoRI 字符串 当前总成本
recommendedQuantity Decimal 应购买的预留实例总数
totalCostWithRI Decimal 如果已购买建议数量，则总成本
netSavings Decimal 7、30 或 60 天内的净节省
firstUsageDate Decimal 首次运行建议的 VM。

另请参阅