Sdílet prostřednictvím


Získání stavu zřizování předplatných

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Jak získat stav zřizování předplatného pro předplatné zákazníka

Požadavky

  • Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pouze s přihlašovacími údaji aplikace a uživatele.

  • ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

  • Identifikátor předplatného.

  • K provedení této operace se vyžadují delegovaná oprávnění správce předplatného.

Podrobná delegovaná oprávnění správce (GDAP)

Potřebujete alespoň jednu z následujících rolí GDAP:

  • Čtenář adresáře
  • Globální čtenář

C#

Pokud chcete získat stav zřizování předplatného, začněte metodou IAggregatePartner.Customers.ById s ID zákazníka a identifikujte zákazníka. Pak získejte rozhraní pro operace předplatného voláním metody Subscriptions.ById s ID předplatného. Dále pomocí provisioningStatus vlastnost získat rozhraní pro operace stavu zřizování aktuálního předplatného a pak zavolejte Get nebo GetAsync metoda načtení SubscriptionProvisioningStatus objektu.

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

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

Požadavek REST

Syntaxe požadavku

metoda Identifikátor URI žádosti
GET {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus HTTP/1.1

Parametry identifikátoru URI

Pomocí následujících parametrů cesty identifikujte zákazníka a předplatné.

Name Type Požadováno Popis
ID zákazníka string Ano Formátovaný řetězec GUID, který identifikuje zákazníka.
id předplatného string Ano Řetězec formátovaný identifikátorem GUID, který identifikuje předplatné.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Nezaokrouhlovat.

Příklad požadavku

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

Odpověď REST

V případě úspěchu obsahuje tělo odpovědi prostředek SubscriptionProvisioningStatus .

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklad odpovědi

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

Poznámky

  • Stavové pole v subscriptionProvisioningStatus je během přiřazení změny licence nastavené na čeká na vyřízení.

  • Pole stavu se aktualizuje každých 15 minut.