Share via

Automatisering voor partners

  • Artikel

Microsoft Cost Management is systeemeigen beschikbaar voor directe partners die hun klanten hebben toegevoegd aan een Microsoft-klantovereenkomst en een Azure-plan hebben gekocht. Partners en hun klanten kunnen algemene taken van Cost Management-API's gebruiken. Zie Cost Management for Partners voor meer informatie over niet-automatische scenario's.

Notitie

Hoewel specifieke API-versies worden weergegeven in de voorbeelden in dit artikel, raden we u aan de nieuwste BESCHIKBARE API-versie te gebruiken. Nieuwere API-versies hebben mogelijk verbeterde functionaliteit. Latere API-versies ondersteunen eerdere versies.

Microsoft Cost Management-API's - Directe en indirecte providers

Partners met toegang tot de factureringsbereiken in een partner-tenant kunnen de volgende API's gebruiken om gefactureerde kosten weer te geven.

Partners kunnen API's aanroepen in het abonnementsbereik, ongeacht het kostenbeleid, zolang ze toegang hebben tot het abonnement. Andere gebruikers met toegang tot het abonnement, zoals de klant of de wederverkoper, kunnen de API's pas aanroepen nadat de partner het kostenbeleid voor de tenant van de klant heeft ingeschakeld.

Een lijst met factureringsperioden krijgen

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview

Een lijst met klanten krijgen

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers?api-version=2019-10-01-preview

Een lijst met abonnementen krijgen

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2019-10-01-preview

Een lijst met facturen voor een specifieke periode ophalen

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices?api-version=2019-10-01-preview&periodStartDate={periodStartDate}&periodEndDate={periodEndDate}

De API-aanroep retourneert een aantal facturen met elementen die vergelijkbaar zijn met de volgende JSON-code.

   {      "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountID}/billingProfiles/{BillingProfileID}/invoices/{InvoiceID}",      "name": "{InvoiceID}",      "properties": {        "amountDue": {          "currency": "USD",          "value": x.xx        },        ...    }

Als u een query wilt uitvoeren op gebruiksgegevens, gebruikt u de bovenstaande geretourneerde id-veldwaarde en vervangt u deze in het volgende voorbeeld als het bereik.

GET https://management.azure.com/{id}/providers/Microsoft.Consumption/UsageDetails?api-version=2019-10-01

In het voorbeeld worden de gebruiksrecords geretourneerd die zijn gekoppeld aan de specifieke factuur.

Het beleid ophalen voor klanten om de kosten te bekijken

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview

Het beleid instellen voor klanten om de kosten te bekijken

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview

Azure-servicegebruik voor een factureringsrekening krijgen

U wordt aangeraden een export voor deze scenario's te configureren. Zie Grote gebruiksgegevenssets ophalen met exports voor meer informatie.

Het Azure-servicegebruik van een klant downloaden

U wordt aangeraden ook een export voor dit scenario te configureren. Als u de gegevens op aanvraag wilt downloaden, kunt u echter de API kostendetails gebruiken. Zie Gegevenssets met kleine kosten op aanvraag ophalen voor meer informatie.

Het prijzenoverzicht voor verbruikte Azure-services ophalen of downloaden

Gebruik eerst het volgende bericht.

POST https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheet/default/download?api-version=2019-10-01-preview&format=csv" -verbose

Roep vervolgens de eigenschapswaarde van de asynchrone bewerking aan. Voorbeeld:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheetDownloadOperations/{operation}?sessiontoken=0:11186&api-version=2019-10-01-preview

De voorgaande ophaal-aanroep retourneert de downloadkoppeling met het prijzenoverzicht.

Om geaggregeerde kosten te verkrijgen

POST https://management.azure.com/providers/microsoft.billing/billingAccounts/{billingAccountName}/providers/microsoft.costmanagement/query?api-version=2019-10-01

Een budget voor een partner maken

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/providers/Microsoft.CostManagement/budgets/partnerworkshopbudget?api-version=2019-10-01

Een budget voor een klant maken

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/providers/Microsoft.Consumption/budgets/{budgetName}?api-version=2019-10-01

Een budget verwijderen

DELETE https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/budgets/{budgetName}?api-version=2019-10-01

Gerelateerde inhoud