Delen via


Een sandbox-abonnement activeren voor SaaS-producten voor commerciële marketplace om facturering in te schakelen

Een abonnement activeren voor SaaS-producten (Software as a Service) van saaS-producten (Software as a Service) van integratie-sandboxaccounts om facturering mogelijk te maken.

Notitie

Het is alleen mogelijk om een abonnement voor saaS-producten voor commerciële marketplace te activeren vanuit sandbox-accounts voor integratie. Als u een productieabonnement hebt, moet u de site van de uitgever bezoeken om het installatieproces te voltooien. Abonnementsfacturering begint pas nadat de installatie is voltooid.

Vereisten

  • Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
  • Een sandbox-partneraccount voor integratie met een klant met een actief abonnement voor SaaS-producten voor commerciële marketplace.
  • Voor partners die .NET SDK voor Partnercentrum gebruiken, moet u SDK-versie 1.14.0 of hoger gebruiken om toegang te krijgen tot deze mogelijkheid.

Belangrijk

Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een leesmij-bestand dat nuttige informatie bevat.

Partners worden aangemoedigd om de REST API's van partnercentrum te blijven gebruiken.

C#

Gebruik de volgende stappen om een abonnement te activeren voor SaaS-producten voor commerciële marketplace:

  1. Maak een interface beschikbaar voor de abonnementsbewerkingen. U moet de klant identificeren en de abonnements-id van het proefabonnement opgeven.

    var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
    
  2. Activeer het abonnement met de bewerking Activeren .

    var subscriptionActivationResult = subscriptionOperations.Activate();
    

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
POST {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

URI-parameter

Naam Type Vereist Beschrijving
klant-tenant-id Guid J De waarde is een tenant-id met GUID-indeling (klant-tenant-id), waarmee u een klant kunt opgeven.
subscription-id Guid J De waarde is een abonnements-id met GUID-indeling (abonnements-id), waarmee u een abonnement kunt opgeven.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

POST https://api.partnercenter.microsoft.com/v1/customers/42b5f772-5c5c-4bce-b9d7-bdadeecca411/subscriptions/87363db7-39ab-dd25-d371-94340aaa2f97/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

REST-antwoord

Deze methode retourneert de abonnements-id en statuseigenschappen .

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 200 OK
Content-Length: 79
Content-Type: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"87363db7-39ab-dd25-d371-94340aaa2f97",
    "status":"Success"
}