Ottenere lo stato del provisioning di un abbonamento

Articolo
11/05/2024

Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

Come ottenere lo stato di provisioning della sottoscrizione per una sottoscrizione del cliente.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con le credenziali 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 Account del cliente cercare l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).
Identificatore di sottoscrizione.
Per eseguire questa operazione, sono necessarie autorizzazioni di amministratore delegate per la sottoscrizione.

Ruoli granulari di amministratore delegato (GDAP)

Sono necessari almeno uno dei ruoli GDAP seguenti:

Ruolo con autorizzazioni di lettura della directory
Ruolo con autorizzazioni di lettura globali

C#

Per ottenere lo stato di provisioning 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 Subscriptions.ById con l'ID sottoscrizione. Successivamente, utilizzare la proprietà ProvisioningStatus per ottenere un'interfaccia per le operazioni di stato di provisioning della sottoscrizione corrente e quindi chiamare il metodo Get o GetAsync per recuperare l'oggetto SubscriptionProvisioningStatus.

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

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

Richiesta REST

Sintassi della richiesta

metodo	URI della richiesta
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus HTTP/1.1

Parametri URI

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

Nome	Digita	Obbligatorio	Descrizione
ID cliente	string	Sì	Stringa con formato GUID che identifica il cliente.
SUBSCRIPTION-ID	string	Sì	Stringa con formattazione GUID che identifica la sottoscrizione.

Intestazioni delle richieste

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/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

Risposta REST

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

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Risposta di esempio

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

Osservazioni:

Il campo stato in SubscriptionProvisioningStatus è impostato su "in sospeso" durante un'assegnazione di modifica della licenza.
Il campo stato viene aggiornato ogni 15 minuti.

Condividi tramite