Pobieranie stanu aprowizacji subskrypcji
Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA
Jak uzyskać stan aprowizacji subskrypcji dla subskrypcji klienta.
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ń aplikacji i użytkownika.
Identyfikator klienta (
customer-tenant-id
). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim, wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta. Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id
).Identyfikator subskrypcji.
Do wykonania tej operacji są wymagane uprawnienia administratora delegowanego w subskrypcji.
Role GDAP
Będziesz potrzebować co najmniej jednej z następujących ról GDAP:
- Czytelnik katalogów
- Czytelnik globalny
C#
Aby uzyskać stan aprowizacji subskrypcji, rozpocznij od użycia metody IAggregatePartner.Customers.ById z identyfikatorem klienta w celu zidentyfikowania klienta. Następnie pobierz interfejs do operacji subskrypcji, wywołując metodę Subscriptions.ById z identyfikatorem subskrypcji. Następnie użyj właściwości ProvisioningStatus, aby uzyskać interfejs do operacji stanu aprowizacji bieżącej subskrypcji, a następnie wywołaj metodę Get lub GetAsync, aby pobrać obiekt SubscriptionProvisioningStatus.
// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;
// Retrieve a subscription's provisioning status.
var provisioningStatus = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).ProvisioningStatus.Get();
Żądanie REST
Składnia żądania
Metoda | Identyfikator URI żądania |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus HTTP/1.1 |
Parametry identyfikatora URI
Użyj następujących parametrów ścieżki, aby zidentyfikować klienta i subskrypcję.
Imię i nazwisko/nazwa | Type | Wymagana | Opis |
---|---|---|---|
identyfikator klienta | ciąg | Tak | Identyfikator GUID sformatowany ciąg identyfikujący klienta. |
subscription-id | ciąg | Tak | Identyfikator GUID sformatowany ciąg identyfikujący subskrypcję. |
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/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/34828C05-C16C-4D6F-9CFC-4D2650EF19A1/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Odpowiedź REST
W przypadku powodzenia treść odpowiedzi zawiera zasób SubscriptionProvisioningStatus .
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i 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 REST Centrum partnerskiego.
Przykład odpowiedzi
HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
Date: Thu, 20 Apr 2017 19:23:39 GMT
{
"skuId": "6FD2C87F-B296-42F0-B197-1E91E994B900",
"status": "success",
"quantity": 5,
"endDate": "2018-05-10T00:00:00Z",
"attributes": {
"objectType": "SubscriptionProvisioningStatus"
}
}
Uwagi
Podczas przypisywania zmiany licencji pole stanu w obszarze SubscriptionProvisioningStatus ma wartość "pending".
Pole stanu jest aktualizowane co 15 minut.
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla