Získání stavu registrace předplatných

Článek
02/05/2024

Jak získat stav registrace předplatného pro předplatné zákazníka, u kterého je povolený nákup rezervovaných instancí virtuálních počítačů Azure.

Pokud chcete zakoupit rezervovanou instanci virtuálního počítače Azure pomocí rozhraní API Partnerského centra, musíte mít aspoň jedno stávající předplatné Azure CSP. Metoda Registrace předplatného umožňuje zaregistrovat stávající předplatné Azure CSP a umožnit tak nákup rezervovaných instancí virtuálních počítačů Azure. Tato metoda umožňuje načíst stav dané registrace.

Požadavky

Přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
ID zákazníka (customer-tenant-id). Pokud ID zákazníka neznáte, můžete ho vyhledat v Partnerském centru tak, že vyberete pracovní prostor Zákazníci , pak zákazníka ze seznamu zákazníků a pak Účet. Na stránce Účet zákazníka vyhledejte Microsoft ID v části Informace o účtu zákazníka . ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
ID předplatného.

C#

Pokud chcete získat stav registrace předplatného, začněte pomocí metody 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 Subscription.ById() s ID předplatného, která identifikuje předplatné. Dále pomocí vlastnosti RegistrationStatus získejte rozhraní pro operace stavu registrace aktuálního předplatného a voláním metody Get nebo GetAsync načtěte objekt SubscriptionRegistrationStatus .

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

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

Požadavek REST

Syntaxe požadavku

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

Parametry identifikátoru URI

K identifikaci zákazníka a předplatného použijte následující parametry cesty.

Název	Typ	Vyžadováno	Popis
customer-ID	řetězec	Yes	Řetězec formátovaný identifikátorem GUID, který identifikuje zákazníka.
ID předplatného	řetězec	Yes	Řetězec formátovaný identifikátorem GUID, který identifikuje předplatné.

Hlavičky požadavku

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

Text požadavku

Žádné

Příklad požadavku

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

Odpověď REST

V případě úspěchu obsahuje text odpovědi prostředek SubscriptionRegistrationStatus .

Kódy úspěšných odpovědí a chyb

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 trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi

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

Sdílet prostřednictvím