Share via

Migrera från EA Price Sheet API

  • Artikel

EA-kunder som tidigare använde Enterprise Reporting consumption.azure.com-API:et för att få prisdokumentet måste migrera till ett ersättnings-Azure Resource Manager-API. Följande instruktioner hjälper dig att migrera och de beskriver även eventuella kontraktsskillnader mellan det gamla API:et och det nya API:et.

Kommentar

Alla Azure Enterprise Reporting-API:er har dragits tillbaka. Du bör migrera till Microsoft Cost Management-API:er så snart som möjligt.

Tilldela behörigheter till ett huvudnamn för tjänsten för att anropa API:et

Innan du anropar API:et måste du konfigurera ett tjänsthuvudnamn (SPN) med rätt behörighet. Du använder tjänstens huvudnamn för att anropa API:et. Mer information finns i Tilldela behörigheter till Cost Management-API:er.

Anropa API för prisdokument

API:et Price Sheet genererar prisdokumentet asynkront och skapar en fil som du laddar ned.

Använd följande URI:er för begäran när du anropar det nya API:et för prisdokument:

Begäranden som stöds

Du kan anropa API:et med följande omfång:

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

Ladda ned efter faktureringskonto för den angivna faktureringsperioden

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

POST-begäran returnerar en plats för att avsöka rapportens genereringsstatus enligt beskrivningen i följande svar:

Exempelsvar

Statuskod: 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

Statuskod: 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"
  }
}

Exempelbegäran för att kontrollera status för rapportgenerering

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01

Ändringar i svarstext

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

Nya svarsändringar

Egenskaperna för prisdokumentet är följande:

Namn Typ Beskrivning
basePrice sträng Enhetspriset vid den tidpunkt då kunden loggar in eller enhetspriset vid tidpunkten för servicemätarens GA-start om det är efter inloggning.

Det gäller för företagsavtal användare
currencyCode sträng Valuta där företagsavtal signerades
effectiveEndDate sträng Gällande slutdatum för faktureringsperioden för prisdokumentet
effectiveStartDate sträng Gällande startdatum för faktureringsperioden för prisdokumentet
enrollmentNumber sträng Unik identifierare för EA-faktureringskontot.
includedQuantity sträng Kvantiteter av en specifik tjänst som en EA-kund har rätt att använda utan inkrementella avgifter.
marketPrice sträng Det aktuella listpriset för en viss produkt eller tjänst. Det här priset är utan förhandlingar och baseras på din Microsoft-avtalstyp.

För PriceType-förbrukning återspeglas marknadspriset som betala per användning-pris.

För PriceType Savings Plan återspeglar marknadspriset förmånen för sparplanen utöver betala per användning-priset för motsvarande åtagandeperiod.

För PriceType ReservedInstance återspeglar marknadspriset det totala priset för ett eller tre års åtagande.

Obs! För EA-kunder utan förhandlingar kan marknadspriset avrundas till en annan decimalprecision än enhetspriset.
meterCategory sträng Namnet på mätarens klassificeringskategori. Det här kan till exempel vara Molntjänster eller Nätverk.
meterId sträng Unik identifierare för mätaren
meterName sträng Namnet på mätaren. Mätaren representerar den distribuerbara resursen för en Azure-tjänst.
meterRegion sträng Namnet på den Azure-region där mätaren för tjänsten är tillgänglig.
meterSubCategory sträng Namn på kategorin för mätarens underklassificering.
meterType sträng Namnet på mätartypen
partNumber sträng Delnummer som är associerat med mätaren
priceType sträng Pristyp för en produkt. Till exempel en Azure-resurs med ett betala per användning-pris med priceType som förbrukning. Andra pristyper är ReservedInstance och Sparplan.
produkt sträng Namnet på den produkt som ackumulerar avgifterna.
productId sträng Unik identifierare för produkten vars mätare förbrukas.
serviceFamily Nummer Typ av Azure-tjänst. Till exempel Compute, Analytics och Security.
skuId sträng Unik identifierare för SKU:n
Benämna sträng Tidslängd för Azure Savings Plan eller Reservation term – ett år eller tre år (P1Y eller P3Y)
unitOfMeasure sträng Hur användningen mäts för tjänsten
unitPrice sträng Priset per enhet vid tidpunkten för faktureringen för en viss produkt eller tjänst, inklusive eventuella förhandlade rabatter utöver marknadspriset.

För PriceType ReservedInstance återspeglar enhetspriset den totala kostnaden för ett eller tre års åtagande, inklusive rabatter.

Obs! Enhetspriset är inte detsamma som det effektiva priset i nedladdningar av användningsinformation när tjänsterna har olika priser på olika nivåer.

Om tjänsterna är priser med flera nivåer är det effektiva priset en blandad ränta mellan nivåerna och visar inte ett nivåspecifikt enhetspris. Det blandade priset eller det effektiva priset är nettopriset för den förbrukade kvantiteten och sträcker sig över flera nivåer (där varje nivå har ett visst enhetspris).

Relaterat innehåll

  • Läs översiktsartikeln Migrera från EA-rapportering till ARM-API:er.