Migrálás az EA Price Sheet API-ból

Azoknak az EA-ügyfeleknek, akik korábban az Enterprise Reporting consumption.azure.com API-t használták az árlista lekéréséhez, át kell költözniük egy másik Azure Resource Manager API-ba. Az alábbi utasítások segítenek a migrálásban, és ismertetik a régi API és az új API közötti szerződéses különbségeket is.

Megjegyzés

Minden Azure Enterprise Reporting API ki van állítva. A lehető leghamarabb át kell költöznie a Microsoft Cost Management API-kba .

Engedélyek hozzárendelése egy szolgáltatási főkomponenshez az API hívásához

Az API meghívása előtt konfigurálnia kell egy szolgáltatásfiókot (SPN) a megfelelő jogosultságokkal. A szolgáltatási azonosító használatával hívja meg az API-t. További információ: Engedélyek hozzárendelése a Cost Management API-khoz.

A Price Sheet API meghívása

A Price Sheet API aszinkron módon hozza létre az árlapot, és létrehoz egy letöltött fájlt.

Az új Price Sheet API meghívásához használja a következő kérés URI-jait:

Támogatott kérelmek

Az API-t az alábbi hatókörrel hívhatja meg:

Beiratkozás: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Letöltés a megadott számlázási időszakra vonatkozó számlázási fiók alapján

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

A POST-kérelem egy helyet ad vissza, ahol lekérdezhető a jelentés létrehozási állapota az alábbi válaszban leírtak szerint:

Mintaválasz

Állapotkód: 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

Állapotkód: 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"
  }
}

Mintakérés a jelentésgenerálás állapotának lekérdezéséhez

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

A válasz tartalom változásai

[
        {
              "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"
        },
        ...
]

Új válaszmódosítások

Az árlista tulajdonságai a következők:

Név Típus Leírás
basePrice karakterlánc Az egységár, amikor az ügyfél bejelentkezik, vagy az egységár a szolgáltatásmérő GA indításakor, ha az a bejelentkezés után történik.

Nagyvállalati Szerződés felhasználóira vonatkozik
valutakód karakterlánc A nagyvállalati szerződés aláírásának pénzneme
hatálybalépés vége karakterlánc Az Árlista számlázási időszakának érvényes záró dátuma
hatálybalépésDátuma karakterlánc Az Árlista számlázási időszakának érvényes kezdő dátuma
beiratkozási szám karakterlánc Az EA számlázási fiók egyedi azonosítója.
tartalmazott mennyiség karakterlánc Egy adott szolgáltatás mennyisége, amelyre az EA-ügyfél növekményes díjak nélkül jogosult.
piaci ár karakterlánc Egy adott termék vagy szolgáltatás listaárának aktuális értéke. Ez az ár nem tartalmaz semmilyen tárgyalást, és a Microsoft-Szerződés típusán alapul.

A felhasználás ár típusa esetében a piaci ár használatalapú árként jelenik meg.

A PriceType Megtakarítási terv esetében a piaci ár magában foglalja a Megtakarítási terv előnyét a szokásos használatalapú fizetésen felül, a megfelelő kötelezettségvállalási időtartamra vonatkozóan.

A PriceType ReservedInstance esetében a piaci ár az egy vagy hároméves kötelezettségvállalás teljes árát tükrözi.

Megjegyzés: Tárgyalás nélküli EA-ügyfelek esetén a piaci ár más tizedes pontossággal kerekítve jelenhet meg, mint az egységár.
mérőkategória karakterlánc A fogyasztásmérő osztályozási kategóriájának neve. Például felhőszolgáltatások, hálózatkezelés stb.
meterId karakterlánc A mérő egyedi azonosítója
mérő neve karakterlánc A fogyasztásmérő neve. A fogyasztásmérő egy Azure-szolgáltatás üzembe helyezhető erőforrását jelöli.
meterRegion karakterlánc Annak az Azure-régiónak a neve, ahol a szolgáltatás mérőeszköze elérhető.
mérő Alsó Kategória karakterlánc A fogyasztásmérő osztályozási alkategóriájának neve.
mérőeszköz típusa karakterlánc A mérőtípus neve
alkatrészszám karakterlánc A mérőhöz társított cikkszám
árTípus karakterlánc Termék ártípusa. Például egy használatalapú fizetéses Azure-erőforrás, amelynek az ártípusa fogyasztás. Egyéb ártípusok közé tartozik a ReservedInstance és a Savings Plan.
termék karakterlánc Annak a terméknek a neve, amelyre vonatkozóan a díjak keletkeznek.
Termékazonosító karakterlánc Annak a terméknek az egyedi azonosítója, amelynek fogyasztásmérője igénybe lett véve.
szolgáltatáscsalád szám Az Azure-szolgáltatás típusa. Ilyen például a Számítás, az Elemzés és a Biztonság.
SKU-kód karakterlánc A termékváltozat egyedi azonosítója
kifejezés karakterlánc Az Azure Savings Plan vagy a Reservation időtartama – egy vagy három év (P1Y vagy P3Y)
mértékegység karakterlánc A használat mérése a szolgáltatáshoz
egységár karakterlánc Egy adott termék vagy szolgáltatás számlázásának időpontjában érvényes egységár, amely magában foglalja a piaci áron felüli kialkudott kedvezményeket is.

A PriceType ReservedInstance esetében az egységár az egy vagy hároméves kötelezettségvállalás teljes költségét tükrözi, beleértve a kedvezményeket is.

Megjegyzés: Az egységár nem ugyanaz, mint a használati adatok letöltéseinek tényleges ára, ha a szolgáltatások különböző tarifacsomagokkal rendelkeznek.

Ha a szolgáltatások többrétegű díjszabást jelentenek, a tényleges ár a szintek közötti vegyes díjszabás, és nem jelenít meg rétegspecifikus egységárat. A vegyes ár vagy a tényleges ár a felhasznált mennyiség nettó ára, amely több szintre terjed ki (ahol az egyes szinteknek meghatározott egységára van).