Pobieranie podsumowania użycia dla partnera
Dotyczy: Centrum partnerskie | Centrum partnerskie dla Microsoft Cloud for US Government
Za pomocą zasobu PartnerUsageSummary możesz uzyskać podsumowanie użycia partnera dla wszystkich klientów, którzy kupili określoną usługę platformy Azure lub zasób w bieżącym okresie rozliczeniowym.
Łączna wartość zwrócona przez ten interfejs API nie zwróci użycia dla klientów, którzy mają plan platformy Azure. Planowana na zakończenie obsługi w przyszłości.
Wymagania wstępne
- Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń użytkownika i aplikacji.
C#
Aby uzyskać podsumowanie użycia dla wszystkich klientów, którzy kupili określoną usługę lub zasób platformy Azure w bieżącym okresie rozliczeniowym:
Użyj narzędzia IAggregatePartner.
Wywołaj właściwość UsageSummary, a następnie metody Get() lub GetAsync():
// IAggregatePartner partnerOperations; var usageSummary = partnerOperations.UsageSummary.Get();
Aby zapoznać się z przykładem, zobacz następujące kwestie:
- Przykład: aplikacja testowa konsoli
- Projekt: PartnerSDK.FeatureSamples
- Klasa: GetPartnerUsageSummary.cs
Żądanie REST
Składnia żądania
Metoda | Identyfikator URI żądania |
---|---|
GET | {baseURL}/v1/usagesummary HTTP/1.1 |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.
Treść żądania
Brak.
Przykład żądania
GET https://api.partnercenter.microsoft.com/v1/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
Odpowiedź REST
W przypadku powodzenia ta metoda zwraca zasób PartnerUsageSummary w treści odpowiedzi.
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie oraz dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów.
Przykład odpowiedzi
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
"customersOverBudget": 1,
"customersTrendingOver": 0,
"customersWithUsageBasedSubscription": 11,
"resourceId": "11111111-4574-4539-bc42-0e539b9684c0",
"id": "11111111-4574-4539-bc42-0e539b9684c0",
"resourceName": "PLAMUATT2NETNEW",
"name": "PLAMUATT2NETNEW",
"billingStartDate": "2019-08-28T00:00:00-07:00",
"billingEndDate": "2019-09-27T00:00:00-07:00",
"totalCost": 22.861172,
"currencyLocale": "fr-FR",
"lastModifiedDate": "2019-09-01T23:04:41.193+00:00",
"links": {
"self": {
"uri": "/usagesummary",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "PartnerUsageSummary"
}
}