Condividi tramite

Attivare una sottoscrizione sandbox per i prodotti SaaS di Microsoft Marketplace per abilitare la fatturazione

Ruoli appropriati: agente di amministrazione

Questo articolo illustra come attivare una sottoscrizione per i prodotti Software as a Service (SaaS) di Microsoft Marketplace da account sandbox di integrazione per abilitare la fatturazione.

Annotazioni

È possibile attivare una sottoscrizione solo per i prodotti SaaS di Microsoft Marketplace da account sandbox di integrazione. Se si dispone di una sottoscrizione di produzione, è necessario visitare il sito dell'editore per completare il processo di configurazione. La fatturazione della sottoscrizione inizierà solo dopo il completamento dell'installazione.

Prerequisiti

  • Credenziali come descritto in Partner Center authentication. Questo scenario supporta l'autenticazione sia con le credenziali di App standalone che con quelle di App+Utente.
  • Un account partner sandbox di integrazione con un cliente con una sottoscrizione attiva per i prodotti SaaS di Microsoft Marketplace.
  • Per i partner che usano .NET SDK del Centro per i partner, è necessario usare SDK versione 1.14.0 o successiva per accedere a questa funzionalità.

Importante

A partire da giugno 2023, la versione più recente di .NET SDK del Centro per i partner 3.4.0 è ora archiviata. È possibile scaricare la release dell'SDK da GitHub, insieme a un file README che contiene informazioni utili.

I partner sono invitati a continuare a usare le API REST del Centro partner.

Usare C#

Usare la procedura seguente per attivare una sottoscrizione per i prodotti SaaS di Microsoft Marketplace:

  1. Rendere disponibile un'interfaccia per le operazioni di sottoscrizione. È necessario identificare il cliente e specificare l'identificatore dell'abbonamento di prova.

    var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);

  2. Attivare la sottoscrizione usando l'operazione Attiva .

    var subscriptionActivationResult = subscriptionOperations.Activate();

Inviare una richiesta REST

Usare la sintassi seguente per inviare una richiesta REST.

Sintassi della richiesta

Metodo URI della richiesta
INSERISCI {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

Parametro URI

Nome TIPO Obbligatorio Descrizione
customer-tenant-id GUID Sì Il valore è un identificatore del tenant del cliente in formato GUID (customer-tenant-id), che consente di specificare un cliente.
ID sottoscrizione GUID Sì Il valore è un identificatore di sottoscrizione in formato GUID (subscription-id), che consente di specificare una sottoscrizione.

Header di richiesta

Per ulteriori informazioni, vedere Intestazioni delle API REST del Partner Center.

Testo della richiesta

Nessuno.

Esempio di richiesta

POST https://api.partnercenter.microsoft.com/v1/customers/42b5f772-5c5c-4bce-b9d7-bdadeecca411/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

Esaminare la risposta REST

Questo metodo restituisce le proprietà id sottoscrizione e stato .

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 il codice, il tipo di errore e i parametri aggiuntivi. Per l'elenco completo, vedere codici di errore REST di Partner Center.

Esempio di risposta

HTTP/1.1 200 OK
Content-Length: 79
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "status":"Success"
}

Contenuti correlati

  • Last updated on