Megosztás a következőn keresztül:

Előfizetés kiépítési állapotának lekérése

  • Cikk

A következőre vonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont a Microsoft Cloud for US Government számára

Az előfizetés kiépítési állapotának lekérése egy ügyfél-előfizetéshez.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak app+felhasználói hitelesítő adatokkal támogatja a hitelesítést.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

  • Előfizetés-azonosító.

  • A művelet végrehajtásához delegált rendszergazdai engedélyekre van szükség az előfizetésen.

GDAP-szerepkörök

A következő GDAP-szerepkörök közül legalább egyre lesz szüksége:

  • Címtárolvasó
  • Globális olvasó

C#

Az előfizetés kiépítési állapotának lekéréséhez először használja az IAggregatePartner.Customers.ById metódust az ügyfélazonosítóval az ügyfél azonosításához. Ezután szerezze be az előfizetési műveletek felületét az Subscriptions.ById metódus meghívásával az előfizetés-azonosítóval. Ezután a ProvisioningStatus tulajdonság használatával szerezze be az aktuális előfizetés kiépítési állapotműveleteinek felületét, majd hívja meg a Get vagy a GetAsync metódust az SubscriptionProvisioningStatus objektum lekéréséhez.

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

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

REST-kérés

Kérés szintaxisa

Metódus Kérés URI-ja
GET {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus HTTP/1.1

URI-paraméterek

Az ügyfél és az előfizetés azonosításához használja az alábbi elérésiút-paramétereket.

Név Típus Kötelező Leírás
ügyfél-azonosító sztring Igen Egy GUID formátumú sztring, amely azonosítja az ügyfelet.
előfizetés-azonosító sztring Igen Az előfizetést azonosító GUID formátumú sztring.

Kérelemfejlécek

További információ: Partnerközpont – REST fejlécek.

A kérés törzse

Nincs.

Példa kérése

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/34828C05-C16C-4D6F-9CFC-4D2650EF19A1/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-válasz

Ha sikeres, a válasz törzse egy SubscriptionProvisioningStatus erőforrást tartalmaz.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont REST-hibakódjaiban találja.

Példa válaszra

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
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"
    }
}

Megjegyzések

  • A licencmódosítás-hozzárendelés során az SubscriptionProvisioningStatus állapotmezője "függőben" értékre van állítva.

  • Az állapotmező 15 percenként frissül.