Udostępnij za pośrednictwem

Migrowanie z interfejsu API arkusza cen umowy EA

Klienci z umową EA, którzy wcześniej korzystali z interfejsu API o nazwie consumption.azure.com do uzyskania cennika, muszą przeprowadzić migrację do zastępczego interfejsu API usługi Azure Resource Manager. Poniższe instrukcje ułatwiają migrację, a także opisują wszelkie różnice kontraktów między starym interfejsem API a nowym interfejsem API.

Uwaga

Wszystkie interfejsy API Azure Enterprise Reporting są wycofane. Powinieneś jak najszybciej przeprowadzić migrację do interfejsów API usługi Microsoft Cost Management.

Przypisz uprawnienia jednostce usługi, aby wywołać interfejs API.

Przed użyciem interfejsu API należy skonfigurować jednostkę usługi (SPN) z właściwymi uprawnieniami. Jednostka usługi służy do wywoływania interfejsu API. Aby uzyskać więcej informacji, zobacz Przypisywanie uprawnień do interfejsów API Cost Management.

Wywołaj interfejs API arkusza cen.

API arkusza cen generuje asynchronicznie arkusz cen i tworzy plik do pobrania.

Podczas wywoływania nowego API arkusza cenowego, użyj następujących identyfikatorów URI żądań.

Obsługiwane żądania

Interfejs API można wywołać, używając następującego zakresu:

Rejestracja: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Pobieranie według konta rozliczeniowego dla określonego okresu rozliczeniowego

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

Żądanie POST zwraca lokalizację do sondowania stanu generowania raportu zgodnie z opisem w następującej odpowiedzi:

Przykładowa odpowiedź

Kod stanu: 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
Retry-After: 60

Kod stanu: 200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

Przykładowe żądanie sprawdzenia statusu tworzenia raportu

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01

Zmiany treści odpowiedzi

[
        {
              "id": "enrollments/57354989/billingperiods/201601/products/343/pricesheets",
              "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
              "meterName": "A1 VM",
              "unitOfMeasure": "100 Hours",
              "includedQuantity": 0,
              "partNumber": "N7H-00015",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        {
              "id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
              "billingPeriodId": "201404",
            "meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
              "meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
              "unitOfMeasure": "100 GB",
              "includedQuantity": 0,
              "partNumber": "N9H-00402",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        ...
]

Nowe zmiany odpowiedzi

Właściwości arkusza cen są następujące:

nazwa Typ Opis
basePrice sznurek Cena jednostkowa w momencie zapisania się klienta lub cena jednostkowa w momencie uruchomienia licznika usług GA, jeśli jest po zapisaniu się.

Dotyczy to użytkowników umowy Enterprise Agreement
kod waluty sznurek Waluta, w której podpisano umowę Enterprise Agreement
data zakończenia obowiązywania sznurek Data zakończenia obowiązującego okresu rozliczeniowego arkusza cen
data rozpoczęcia obowiązywania sznurek Data rozpoczęcia obowiązywania okresu rozliczeniowego arkusza cen
numer rejestracyjny sznurek Unikatowy identyfikator konta rozliczeniowego EA.
wliczona ilość sznurek Ilości określonej usługi, do której klient z umową EA ma prawo korzystać bez naliczania opłat przyrostowych.
cena rynkowa sznurek Bieżąca cena katalogowa dla danego produktu lub usługi. Ta cena jest bez żadnych negocjacji i jest oparta na typie umowy firmy Microsoft.

W kategorii PriceType Consumption cena rynkowa jest odzwierciedlana jako cena w modelu płatności "pay-as-you-go".

W przypadku planu oszczędnościowego typu PriceType cena rynkowa uwzględnia korzyści planu oszczędnościowego ponad cenę płatności zgodnie z rzeczywistym użyciem dla odpowiedniego okresu zobowiązania.

W przypadku klasy PriceType ReservedInstance cena rynkowa odzwierciedla łączną cenę zobowiązania jednego lub trzyletniego.

Uwaga: W przypadku klientów EA bez negocjacji, cena rynkowa może wydawać się zaokrąglona do innej dokładności dziesiętnej niż cena jednostkowa.
kategoria miernika sznurek Nazwa kategorii klasyfikacji miernika. Na przykład usługi w chmurze, sieć itp.
meterId sznurek Unikatowy identyfikator miernika
nazwa licznika sznurek Nazwa miernika. Miernik reprezentuje możliwy do wdrożenia zasób usługi platformy Azure.
Obszar pomiarowy sznurek Nazwa regionu platformy Azure, w którym dostępny jest miernik usługi.
podkategoria licznika sznurek Nazwa kategorii podklasyfikacji miernika.
typ licznika sznurek Nazwa typu miernika
numer części sznurek Numer części skojarzony z miernikiem
typ ceny sznurek Typ ceny produktu. Na przykład zasób platformy Azure z stawką płatności zgodnie z rzeczywistym użyciem z parametrem priceType jako Zużycie. Inne typy cen obejmują Reserved Instance i Plan Oszczędności.
produkt sznurek Nazwa produktu naliczającego opłaty.
ID produktu sznurek Unikalny identyfikator produktu, którego licznik jest zużywany.
serviceFamily liczba Typ usługi platformy Azure. Na przykład obliczenia, analiza i zabezpieczenia.
skuId sznurek Unikalny identyfikator SKU
termin sznurek Długość okresu dla planu oszczędności platformy Azure lub okresu rezerwacji — jeden rok lub trzy lata (P1Y lub P3Y)
jednostka miary sznurek Jak jest mierzone użycie usługi
cena jednostkowa sznurek Cena jednostkowa w momencie naliczania opłat za dany produkt lub usługę, włącznie z wszelkimi wynegocjowanych rabatami na podstawie ceny rynkowej.

W przypadku klasy PriceType ReservedInstance cena jednostkowa odzwierciedla całkowity koszt zobowiązania jednego lub trzyletniego, w tym rabatów.

Uwaga: Cena jednostkowa nie jest taka sama jak obowiązująca cena w pobieranych szczegółach użycia, gdy usługi mają różnicowe ceny w różnych warstwach.

Jeśli usługi są cenami wielowarstwowymi, efektywna cena jest stawką mieszaną w różnych warstwach i nie pokazuje ceny jednostkowej specyficznej dla warstwy. Cena mieszana lub efektywna cena to cena netto dla zużytej ilości obejmującej wiele warstw (gdzie każda warstwa ma określoną cenę jednostkową).

Powiązana zawartość