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"
    }
}