Freigeben über


Automatisierung für Partner

Microsoft Cost Management ist nativ für direkte Partner verfügbar, die ihre Kunden in eine Microsoft-Kundenvereinbarung aufgenommen und einen Azure-Plan erworben haben. Partner und ihre Kunden können Cost Management APIs für allgemeine Aufgaben nutzen. Weitere Informationen zu nicht-automatisierten Szenarien finden Sie unter Cost Management für Partner.

Hinweis

Obwohl bestimmte API-Versionen in den Beispielen in diesem Artikel gezeigt werden, wird empfohlen, die neueste verfügbare API-Version zu verwenden. Neuere API-Versionen haben möglicherweise eine verbesserte Funktionalität. Spätere API-Versionen unterstützen frühere Versionen.

Microsoft Cost Management-APIs – Direkte und indirekte Anbieter

Partner mit Zugriff auf Abrechnungsbereiche in einem Partnermandanten können die folgenden APIs verwenden, um in Rechnung gestellte Kosten anzuzeigen.

Partner können APIs unabhängig von der Kostenrichtlinie im Abonnementbereich aufrufen, sofern sie Zugriff auf das Abonnement haben. Andere Benutzer mit Zugriff auf das Abonnement, z. B. der Kunde oder der Handelspartner, können die APIs nur aufrufen, nachdem der Partner die Kostenrichtlinie für den Kundenmandanten aktiviert hat.

So rufen Sie eine Liste von Abrechnungskonten ab

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

So rufen Sie eine Liste von Kunden ab

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

So rufen Sie eine Liste von Abonnements ab

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

So rufen Sie eine Liste der Rechnungen für einen bestimmten Zeitraum ab

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

Der API-Aufruf gibt ein Array von Rechnungen zurück, das ähnliche Elemente wie der folgende JSON-Code aufweist.

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

Verwenden Sie den zuvor zurückgegebenen ID-Feldwert und ersetzen Sie ihn im folgenden Beispiel als Gültigkeitsbereich für die Abfrage von Nutzungsdetails.

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

Im Beispiel werden die Nutzungsdatensätze für die jeweilige Rechnung zurückgegeben.

So rufen Sie die Richtlinie für Kunden zum Anzeigen von Kosten ab

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

So legen Sie die Richtlinie für Kunden zum Anzeigen von Kosten fest

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

So rufen Sie die Azure-Dienstnutzung für ein Abrechnungskonto ab

Wir empfehlen Ihnen, für diese Szenarien einen Export zu konfigurieren. Weitere Informationen finden Sie unter Abrufen großer Nutzungsdatensätze mit Exporten.

So laden Sie die Azure-Dienstnutzung eines Kunden herunter

Wir empfehlen Ihnen, auch für dieses Szenario einen Export zu konfigurieren. Wenn Sie die Daten jedoch bei Bedarf herunterladen möchten, können Sie die Cost Details API verwenden. Weitere Informationen finden Sie unter Abrufen kleiner Kostendatasets nach Bedarf.

So rufen Sie das Preisblatt für genutzte Azure-Dienste ab oder laden es herunter

Verwenden Sie zunächst den folgenden POST-Aufruf.

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

Rufen Sie dann den Eigenschaftswert des asynchronen Vorgangs auf. Beispiel:

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

Der vorherige GET-Befehl gibt den Downloadlink mit dem Preisblatt zurück.

So rufen Sie aggregierte Kosten ab

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

Erstellen eines Budgets für einen Partner

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

Erstellen eines Budgets für einen Kunden

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

Löschen eines Budgets

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