Udostępnij za pośrednictwem


Automatyzacja dla partnerów

Usługa Microsoft Cost Management jest natywnie dostępna dla bezpośrednich partnerów, którzy dołączyli swoich klientów do Umowa z Klientem Microsoft i zakupili plan platformy Azure. Partnerzy i ich klienci mogą używać typowych zadań interfejsów API usługi Cost Management. Aby uzyskać więcej informacji na temat scenariuszy nonautomacji, zobacz Cost Management for Partners (Zarządzanie kosztami dla partnerów).

Uwaga

Mimo że określone wersje interfejsu API są wyświetlane w przykładach w tym artykule, zalecamy użycie najnowszej dostępnej wersji interfejsu API. Nowsze wersje interfejsu API mogą mieć ulepszoną funkcjonalność. Nowsze wersje interfejsu API obsługują poprzednie wersje.

Interfejsy API usługi Microsoft Cost Management — dostawcy bezpośredni i pośredni

Partnerzy z dostępem do zakresów rozliczeniowych w dzierżawie partnera mogą używać następujących interfejsów API do wyświetlania zafakturowanych kosztów.

Partnerzy mogą wywoływać interfejsy API w zakresie subskrypcji niezależnie od zasad kosztów, o ile mają dostęp do subskrypcji. Inni użytkownicy z dostępem do subskrypcji, tacy jak klient lub odsprzedawca, mogą wywoływać interfejsy API tylko po włączeniu przez partnera zasad kosztów dla dzierżawy klienta.

Aby uzyskać listę kont rozliczeniowych

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

Aby uzyskać listę klientów

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

Aby uzyskać listę subskrypcji

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

Aby uzyskać listę faktur dla określonego okresu

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

Wywołanie interfejsu API zwraca tablicę faktur, która ma elementy podobne do poniższego kodu JSON.

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

Aby wysłać zapytanie o szczegóły użycia, użyj poprzedniej zwróconej wartości pola identyfikatora i zastąp ją w poniższym przykładzie jako zakres.

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

Przykład zwraca rekordy użycia skojarzone z określoną fakturą.

Aby uzyskać zasady dotyczące wyświetlania kosztów przez klientów

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

Aby określić zasady dotyczące wyświetlania kosztów przez klientów

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

Aby uzyskać użycie usługi platformy Azure dla konta rozliczeniowego

Zalecamy skonfigurowanie eksportu dla tych scenariuszy. Aby uzyskać więcej informacji, zobacz Pobieranie dużych zestawów danych użycia z eksportami.

Aby pobrać użycie usługi platformy Azure przez klienta

Zalecamy również skonfigurowanie eksportu dla tego scenariusza. Jeśli jednak musisz pobrać dane na żądanie, możesz użyć interfejsu API szczegółów kosztów. Aby uzyskać więcej informacji, zobacz Pobieranie zestawów danych o małych kosztach na żądanie.

Aby uzyskać lub pobrać arkusz cen dla użytych usług platformy Azure

Najpierw użyj poniższej operacji post.

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

Następnie wywołaj wartość właściwości operacji asynchronicznej. Na przykład:

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

Poprzednie wywołanie get zwraca link pobierania zawierający arkusz cen.

Aby uzyskać zagregowane koszty

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

Tworzenie budżetu dla partnera

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

Tworzenie budżetu dla klienta

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

Usuwanie budżetu

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