Udostępnij za pośrednictwem


Migrowanie z interfejsu API Rekomendacje wystąpienia zarezerwowanego EA

Klienci z umową EA, którzy wcześniej korzystali z interfejsu API consumption.azure.com raportowania przedsiębiorstwa w celu uzyskania zaleceń dotyczących wystąpień zarezerwowanych, muszą przeprowadzić migrację do interfejsu API usługi Azure Resource Manager z parzystością. Poniższe instrukcje ułatwiają migrowanie i opisywanie wszelkich różnic kontraktów między starym interfejsem API a nowym interfejsem API.

Uwaga

Wszystkie interfejsy API raportowania przedsiębiorstwa platformy Azure są wycofane. Jak najszybciej należy przeprowadzić migrację do interfejsów API usługi Microsoft Cost Management.

Przypisywanie uprawnień do jednostki usługi w celu wywołania interfejsu API

Przed wywołaniem interfejsu API należy skonfigurować jednostkę usługi przy użyciu odpowiednich uprawnień. Jednostka usługi służy do wywoływania interfejsu API. Aby uzyskać więcej informacji, zobacz Przypisywanie uprawnień do interfejsów API usługi Cost Management.

Wywoływanie interfejsu API zaleceń dotyczących wystąpień zarezerwowanych

Użyj następujących identyfikatorów URI żądania, aby wywołać nowy interfejs API rekomendacji dotyczących rezerwacji.

Obsługiwane żądania

Wywołaj interfejs API z następującymi zakresami:

  • Rejestracja: providers/Microsoft.Billing/billingAccounts/{billingAccountId}
  • Subskrypcje: subscriptions/{subscriptionId}
  • Grupy zasobów: subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}

Uzyskaj rekomendacje

W tym interfejsie API dostępne są rekomendacje dotyczące zarówno udostępnionego, jak i pojedynczego zakresu. Filtrowanie zakresu jako opcjonalny parametr interfejsu API również jest możliwe.

https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/reservationRecommendations?api-version=2023-05-01 

Zmiany treści odpowiedzi

W nowym interfejsie API rekomendacje dotyczące zakresów udostępnionych i pojedynczych są łączone w jeden interfejs API.

Stara odpowiedź dla zakresu udostępnionego:

{
        "lookBackPeriod": "Last60Days",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "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"
          }
        ]
    },

Stara odpowiedź dla pojedynczego zakresu:

{
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "lookBackPeriod": "Last60Days",
      "meterId": "00000000-0000-0000-0000-000000000000",
      "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"
        }
      ]
}

Nowa odpowiedź:

{
  "value": [
    {
      "id": "billingAccount/123456/providers/Microsoft.Consumption/reservationRecommendations/00000000-0000-0000-0000-000000000000",
      "name": "00000000-0000-0000-0000-000000000000",
      "type": "Microsoft.Consumption/reservationRecommendations",
      "location": "westus",
      "sku": "Standard_DS1_v2",
      "kind": "legacy",
      "properties": {
        "meterId": "00000000-0000-0000-0000-000000000000",
        "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"
          }
        ]
      }
    },
   ]
}