De inrichtingsstatus van het abonnement ophalen

Artikel
10/15/2024

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

De inrichtingsstatus van het abonnement voor een klantabonnement ophalen.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten 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.
Gedelegeerde beheerdersmachtigingen voor het abonnement zijn vereist om deze bewerking uit te voeren.

Gedetailleerde gedelegeerde beheerdersbevoegdheden (GDAP)-rollen

U hebt ten minste een van de volgende GDAP-rollen nodig:

Maplezer
Algemene lezer

C#

Als u de inrichtingsstatus 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 op voor abonnementsbewerkingen door de methode Subscriptions.ById aan te roepen met de abonnements-id. Gebruik vervolgens de eigenschap ProvisioningStatus om een interface te verkrijgen voor de inrichtingsstatusbewerkingen van het huidige abonnement en roep vervolgens de methode Get of GetAsync aan om het object SubscriptionProvisioningStatus op te halen.

// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;

// Retrieve a subscription's provisioning status.
var provisioningStatus = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).ProvisioningStatus.Get();

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameters

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

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

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-antwoord

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

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en andere informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
    }
}

Opmerkingen

Het statusveld in SubscriptionProvisioningStatus is ingesteld op 'in behandeling' tijdens een toewijzing van licentiewijziging.
Het statusveld wordt elke 15 minuten bijgewerkt.

Delen via