De registratiestatus van het abonnement ophalen

  • Artikel

De registratiestatus van het abonnement ophalen voor een klantabonnement dat is ingeschakeld voor het aanschaffen van gereserveerde VM-instanties van Azure.

Als u een gereserveerde Vm-instantie van Azure wilt aanschaffen met behulp van de PartnerCentrum-API, moet u ten minste één bestaand CSP Azure-abonnement hebben. Met de methode Een abonnement registreren kunt u uw bestaande CSP Azure-abonnement registreren, waardoor het kan worden gebruikt voor het aanschaffen van gereserveerde VM-instanties van Azure. Met deze methode kunt u de status van die registratie ophalen.

Vereisten

  • Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als App+User-referenties.

  • Een klant-id (customer-tenant-id). Als u de id van de klant niet weet, kunt u deze opzoeken in partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de klantenlijst en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

  • Een abonnements-id.

C#

Als u de registratiestatus van een abonnement wilt ophalen, begint u met de methode IAggregatePartner.Customers.ById met de klant-id om de klant te identificeren. Haal vervolgens een interface voor abonnementsbewerkingen op door de methode Subscription.ById() aan te roepen met de abonnements-id om het abonnement te identificeren. Gebruik vervolgens de eigenschap RegistrationStatus om een interface te verkrijgen voor de registratiestatusbewerkingen van het huidige abonnement en roep de methode Get of GetAsync aan om het object SubscriptionRegistrationStatus op te halen.

// IAggregatePartner partnerOperations;
// var selectedCustomerId;
// var selectedSubscriptionId;

// Retrieve a subscription's registration status details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).RegistrationStatus.Get();

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
GET {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus HTTP/1.1

URI-parameters

Gebruik de volgende padparameters om de klant en het abonnement te identificeren.

Naam Type Vereist Beschrijving
klant-id tekenreeks Ja Een tekenreeks met GUID-indeling die de klant identificeert.
subscription-id tekenreeks Ja Een tekenreeks met GUID-indeling die het abonnement identificeert.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

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: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-CorrelationId: ec8f62e5-1d92-47e9-8d5d-1924af105123
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

REST-antwoord

Als dit lukt, bevat de antwoordtekst een SubscriptionRegistrationStatus-resource .

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.

Voorbeeld van antwoord

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-RequestId: ec8f62e5-1d92-47e9-8d5d-1924af105123
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344

{
    "subscriptionId":"<subscription-id>",
    "status":"NotRegistered",
    "attributes":{
        "objectType":"SubscriptionRegistrationStatus"
    }
}