Ottenere lo stato della registrazione di un abbonamento

Articolo
02/05/2024

Come ottenere lo stato di registrazione della sottoscrizione per una sottoscrizione del cliente abilitata per l'acquisto di istanze di macchina virtuale riservate di Azure.

Per acquistare un'istanza di macchina virtuale riservata di Azure usando l'API del Centro per i partner, è necessario avere almeno una sottoscrizione di Azure CSP esistente. Il metodo Registra una sottoscrizione consente di registrare la sottoscrizione di Azure CSP esistente, abilitandola per l'acquisto di istanze di macchine virtuali riservate di Azure. Questo metodo consente di recuperare lo stato della registrazione.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).
ID sottoscrizione.

C#

Per ottenere lo stato di registrazione di una sottoscrizione, iniziare usando il metodo IAggregatePartner.Customers.ById con l'ID cliente per identificare il cliente. Ottenere quindi un'interfaccia per le operazioni di sottoscrizione chiamando il metodo Subscription.ById() con l'ID sottoscrizione per identificare la sottoscrizione. Utilizzare quindi la proprietà RegistrationStatus per ottenere un'interfaccia per le operazioni di stato di registrazione della sottoscrizione corrente e chiamare il metodo Get o GetAsync per recuperare l'oggetto 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();

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus HTTP/1.1

Parametri URI

Usare i parametri di percorso seguenti per identificare il cliente e la sottoscrizione.

Nome	Tipo	Obbligatoria	Descrizione
customer-id	string	Sì	Stringa formattata GUID che identifica il cliente.
subscription-id	string	Sì	Stringa in formato GUID che identifica la sottoscrizione.

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Nessuno.

Esempio di richiesta

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: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

Risposta REST

In caso di esito positivo, il corpo della risposta contiene una risorsa SubscriptionRegistrationStatus .

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore.

Esempio di risposta

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344

{
    "subscriptionId":"<subscription-id>",
    "status":"NotRegistered",
    "attributes":{
        "objectType":"SubscriptionRegistrationStatus"
    }
}

Condividi tramite