De registratiestatus van het abonnement ophalen

Artikel
02/05/2024

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: 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

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

Delen via