Attivare una sottoscrizione sandbox per i prodotti SaaS del marketplace commerciale per abilitare la fatturazione

  • Articolo

Come attivare una sottoscrizione per i prodotti SaaS (Software as a Service) del marketplace commerciale dagli account sandbox di integrazione per abilitare la fatturazione.

Nota

È possibile attivare una sottoscrizione solo per i prodotti SaaS del marketplace commerciale dagli 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 descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
  • Un account partner sandbox di integrazione con un cliente con una sottoscrizione attiva per i prodotti SaaS del marketplace commerciale.
  • 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 versione dell'SDK da GitHub, insieme a un file leggimi che contiene informazioni utili.

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

C#

Usare la procedura seguente per attivare una sottoscrizione per i prodotti SaaS del marketplace commerciale:

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

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

  2. Attivare la sottoscrizione usando l'operazione Attiva .

    var subscriptionActivationResult = subscriptionOperations.Activate();

Richiesta REST

Sintassi della richiesta

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

Parametro URI

Nome Digita Richiesto Descrizione
customer-tenant-id guid Y Il valore è un identificatore del tenant del cliente in formato GUID (customer-tenant-id), che consente di specificare un cliente.
subscription-id guid Y Il valore è un identificatore di sottoscrizione in formato GUID (subscription-id), che consente di specificare una sottoscrizione.

Intestazioni delle richieste

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

Corpo 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

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 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 REST del Centro per i partner.

Risposta di esempio

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