Pobieranie stanu rejestracji subskrypcji
Jak uzyskać stan rejestracji subskrypcji dla subskrypcji klienta, która została włączona do zakupu wystąpień zarezerwowanych maszyn wirtualnych platformy Azure.
Aby kupić wystąpienie zarezerwowane maszyny wirtualnej platformy Azure przy użyciu interfejsu API Centrum partnerskiego, musisz mieć co najmniej jedną istniejącą subskrypcję platformy Azure dostawcy usług kryptograficznych. Metoda Zarejestruj subskrypcję umożliwia zarejestrowanie istniejącej subskrypcji platformy Azure dostawcy usług kryptograficznych, umożliwiając jej zakup wystąpień zarezerwowanych maszyn wirtualnych platformy Azure. Ta metoda umożliwia pobranie stanu tej rejestracji.
Wymagania wstępne
Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Identyfikator klienta (
customer-tenant-id
). Jeśli nie znasz identyfikatora klienta, możesz go wyszukać 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 Firmy Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id
).Identyfikator subskrypcji.
C#
Aby uzyskać stan rejestracji subskrypcji, zacznij 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ę Subscription.ById() z identyfikatorem subskrypcji w celu zidentyfikowania subskrypcji. Następnie użyj właściwości RegistrationStatus, aby uzyskać interfejs dla operacji stanu rejestracji bieżącej subskrypcji, a następnie wywołaj metodę Get lub GetAsync , aby pobrać obiekt SubscriptionRegistrationStatus .
// IAggregatePartner partnerOperations;
// var selectedCustomerId;
// var selectedSubscriptionId;
// Retrieve a subscription's registration status details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).RegistrationStatus.Get();
Żądanie REST
Składnia żądania
Metoda | Identyfikator URI żądania |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus HTTP/1.1 |
Parametry identyfikatora URI
Użyj następujących parametrów ścieżki, aby zidentyfikować klienta i subskrypcję.
Nazwa | Typ | Wymagane | Opis |
---|---|---|---|
customer-id | ciąg | Tak | Identyfikator GUID sformatowany ciąg identyfikujący klienta. |
identyfikator subskrypcji | 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/<customer-id>/subscriptions/<subscription-id>/registrationstatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive
Odpowiedź REST
W przypadku powodzenia treść odpowiedzi zawiera zasób SubscriptionRegistrationStatus .
Kody powodzenia odpowiedzi i błędów
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.
Przykład odpowiedzi
HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
{
"subscriptionId":"<subscription-id>",
"status":"NotRegistered",
"attributes":{
"objectType":"SubscriptionRegistrationStatus"
}
}