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 consumption.azure.com raportowania przedsiębiorstwa, aby uzyskać arkusz cen, 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 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 (SPN) z poprawnym uprawnieniem. 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 arkusza cen

Interfejs API arkusza cen generuje arkusz cen asynchronicznie i tworzy pobrany plik.

Podczas wywoływania nowego interfejsu API arkusza cen użyj następujących identyfikatorów URI żądań:

Obsługiwane żądania

Interfejs API można wywołać przy użyciu 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/00000000-0000-0000-0000-000000000000?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 dotyczące stanu generowania raportu sondowania

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?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/nazwisko Typ Opis
basePrice string Cena jednostkowa w momencie logowania klienta lub cena jednostkowa w momencie uruchomienia ga miernika usług, jeśli jest po zalogowaniu.

Dotyczy Umowa Enterprise użytkowników
currencyCode string Waluta, w której podpisano Umowa Enterprise
effectiveEndDate string Data zakończenia obowiązującego okresu rozliczeniowego arkusza cen
effectiveStartDate string Data rozpoczęcia obowiązywania okresu rozliczeniowego arkusza cen
enrollmentNumber string Unikatowy identyfikator konta rozliczeniowego umowy EA.
includedQuantity string Ilości określonej usługi, do której klient z umową EA ma prawo korzystać bez naliczania opłat przyrostowych.
marketPrice string 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 obszarze PriceType Consumption cena rynkowa jest odzwierciedlana jako cena płatności zgodnie z rzeczywistym użyciem.

W przypadku planu oszczędności PriceType cena rynkowa odzwierciedla korzyści z planu oszczędności na podstawie ceny 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 z umową EA bez negocjacji cena rynkowa może wydawać się zaokrąglona do innej dokładności dziesiętnej niż cena jednostkowa.
meterCategory string Nazwa kategorii klasyfikacji dla miernika. Na przykład Usługi w chmurze, Sieć itp.
meterId string Unikatowy identyfikator miernika
meterName string Nazwa miernika. Miernik reprezentuje możliwy do wdrożenia zasób usługi platformy Azure.
meterRegion string Nazwa regionu platformy Azure, w którym dostępny jest miernik usługi.
meterSubCategory string Nazwa kategorii klasyfikacji podrzędnej miernika.
meterType string Nazwa typu miernika
partNumber string Numer części skojarzony z miernikiem
priceType string 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ą ReservedInstance i Plan oszczędności.
product string Nazwa produktu naliczającego opłaty.
productId string Unikatowy identyfikator produktu, którego miernik jest wykorzystywany.
serviceFamily Liczba Typ usługi platformy Azure. Na przykład obliczenia, analiza i zabezpieczenia.
skuId string Unikatowy identyfikator jednostki SKU
Termin string Długość okresu dla planu oszczędności platformy Azure lub okresu rezerwacji — jeden rok lub trzy lata (P1Y lub P3Y)
unitOfMeasure string Jak jest mierzone użycie usługi
unitPrice string 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 uśredniona lub cena obowiązująca to cena netto wykorzystanej ilości dla wielu warstw (gdzie każda warstwa ma konkretną cenę jednostkową).