Migrace z rozhraní API pro doporučení rezervovaných instancí EA
Zákazníci EA, kteří dříve používali rozhraní API consumption.azure.com služby Enterprise Reporting k získání doporučení rezervovaných instancí, musí migrovat na paritu rozhraní API Azure Resource Manageru. Následující pokyny vám pomůžou migrovat a popsat všechny rozdíly mezi starým rozhraním API a novým rozhraním API.
Poznámka:
Všechna rozhraní API pro podnikové vytváření sestav Azure se vyřadí z důchodu. Co nejdříve byste měli migrovat na rozhraní API služby Microsoft Cost Management.
Přiřazení oprávnění k instanci pro volání rozhraní API
Před voláním rozhraní API je potřeba nakonfigurovat instanční objekt se správným oprávněním. Instanční objekt použijete k volání rozhraní API. Další informace najdete v tématu Přiřazení oprávnění k rozhraním API služby Cost Management.
Volání rozhraní API pro doporučení rezervovaných instancí
Při volání nového rozhraní API Doporučení pro rezervace použijte následující identifikátory URI požadavků.
Podporované požadavky
Rozhraní API můžete volat s následujícími rozsahy:
- Registrace:
providers/Microsoft.Billing/billingAccounts/{billingAccountId}
- Předplatné:
subscriptions/{subscriptionId}
- Skupiny prostředků:
subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}
Prostřednictvím tohoto rozhraní API jsou dostupná doporučení pro sdílené i samostatné rozsahy. Jako volitelný parametr rozhraní API můžete také využít filtr podle rozsahu.
https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/reservationRecommendations?api-version=2023-05-01
Změny textu odpovědi
V novém rozhraní API se doporučení pro sdílené a izolované obory zkombinují do jednoho rozhraní API.
Původní odpověď pro sdílený obor:
{
"lookBackPeriod": "Last60Days",
"meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"skuName": "Standard_B1s",
"term": "P3Y",
"region": "eastus",
"costWithNoRI": 39.773316464000011,
"recommendedQuantity": 2,
"totalCostWithRI": 22.502541385887369,
"netSavings": 17.270775078112642,
"firstUsageDate": "2024-02-23T00:00:00",
"resourceType": "virtualmachines",
"instanceFlexibilityRatio": 2.0,
"instanceFlexibilityGroup": "BS Series",
"normalizedSize": "Standard_B1ls",
"recommendedQuantityNormalized": 4.0,
"skuProperties": [
{
"name": "Cores",
"value": "1"
},
{
"name": "Ram",
"value": "1"
}
]
},
Původní odpověď pro jeden obor:
{
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"lookBackPeriod": "Last60Days",
"meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"skuName": "Standard_B1s",
"term": "P3Y",
"region": "eastus",
"costWithNoRI": 19.892601567999996,
"recommendedQuantity": 1,
"totalCostWithRI": 11.252968788943683,
"netSavings": 8.6396327790563134,
"firstUsageDate": "2024-02-23T00:00:00",
"resourceType": "virtualmachines",
"instanceFlexibilityRatio": 2.0,
"instanceFlexibilityGroup": "BS Series",
"normalizedSize": "Standard_B1ls",
"recommendedQuantityNormalized": 2.0,
"skuProperties": [
{
"name": "Cores",
"value": "1"
},
{
"name": "Ram",
"value": "1"
}
]
}
Nová odpověď:
{
"value": [
{
"id": "billingAccount/123456/providers/Microsoft.Consumption/reservationRecommendations/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"name": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"type": "Microsoft.Consumption/reservationRecommendations",
"location": "westus",
"sku": "Standard_DS1_v2",
"kind": "legacy",
"properties": {
"meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"term": "P1Y",
"costWithNoReservedInstances": 12.0785105,
"recommendedQuantity": 1,
"totalCostWithReservedInstances": 11.4899644807748,
"netSavings": 0.588546019225182,
"firstUsageDate": "2019-07-07T00:00:00-07:00",
"scope": "Shared",
"lookBackPeriod": "Last7Days",
"instanceFlexibilityRatio": 1,
"instanceFlexibilityGroup": "DSv2 Series",
"normalizedSize": "Standard_DS1_v2",
"recommendedQuantityNormalized": 1,
"skuProperties": [
{
"name": "Cores",
"value": "1"
},
{
"name": "Ram",
"value": "1"
}
]
}
},
]
}