Hämta status för prenumerationsregistrering

Artikel
02/05/2024

Så här hämtar du status för prenumerationsregistrering för en kundprenumeration som har aktiverats för att köpa azure reserved VM Instances.

Om du vill köpa en Azure Reserved VM-instans med partnercenter-API:et måste du ha minst en befintlig CSP Azure-prenumeration. Med metoden Registrera en prenumeration kan du registrera din befintliga CSP Azure-prenumeration och aktivera den för att köpa reserverade AZURE VM-instanser. Med den här metoden kan du hämta status för registreringen.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående App- och App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden i kundlistan och sedan Konto. På kundens kontosida letar du upp Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID:t (customer-tenant-id).
Ett prenumerations-ID.

C#

Om du vill hämta registreringsstatus för en prenumeration börjar du med metoden IAggregatePartner.Customers.ById med kund-ID:t för att identifiera kunden. Hämta sedan ett gränssnitt för prenumerationsåtgärder genom att anropa metoden Subscription.ById() med prenumerations-ID:t för att identifiera prenumerationen. Använd sedan egenskapen RegistrationStatus för att hämta ett gränssnitt till den aktuella prenumerationens registreringsstatusåtgärder och anropa metoden Get or GetAsync för att hämta objektet 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();

REST-begäran

Begärandesyntax

Metod	URI för förfrågan
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus HTTP/1.1

URI-parametrar

Använd följande sökvägsparametrar för att identifiera kunden och prenumerationen.

Namn	Typ	Obligatorisk	Beskrivning
kund-ID	sträng	Ja	En GUID-formaterad sträng som identifierar kunden.
prenumerations-ID	sträng	Ja	En GUID-formaterad sträng som identifierar prenumerationen.

Begärandehuvuden

Mer information finns i REST-huvuden i Partnercenter.

Begärandetext

Inga.

Exempel på begäran

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

REST-svar

Om det lyckas innehåller svarstexten en SubscriptionRegistrationStatus-resurs .

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder.

Exempel på svar

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

Dela via