Aktivieren eines Sandkastenabonnements für kommerzielle Marketplace-SaaS-Produkte zur Aktivierung der Abrechnung

  • Artikel

So aktivieren Sie ein Abonnement für kommerzielle Marketplace Software as a Service (SaaS)-Produkte aus Integrations-Sandkastenkonten, um die Abrechnung zu ermöglichen.

Hinweis

Es ist nur möglich, ein Abonnement für kommerzielle Marketplace-SaaS-Produkte aus Integrations-Sandbox-Konten zu aktivieren. Wenn Sie über ein Produktionsabonnement verfügen, müssen Sie die Website des Herausgebers besuchen, um den Einrichtungsprozess abzuschließen. Die Abonnementabrechnung beginnt erst nach Abschluss des Setups.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
  • Ein Integrations-Sandbox-Partnerkonto mit einem Kunden mit einem aktiven Abonnement für kommerzielle Marketplace-SaaS-Produkte.
  • Für Partner, die das .NET SDK verwenden, müssen Sie die SDK-Version 1.14.0 oder höher verwenden, um auf diese Funktion zuzugreifen.

Wichtig

Ab Juni 2023 ist jetzt die neueste Partner Center .NET SDK-Version 3.4.0 archiviert. Sie können das SDK-Release von GitHub zusammen mit einer Infodatei herunterladen, die nützliche Informationen enthält.

Partnern wird empfohlen, weiterhin die Partner Center-REST-APIs zu verwenden.

C#

Führen Sie die folgenden Schritte aus, um ein Abonnement für kommerzielle Marketplace-SaaS-Produkte zu aktivieren:

  1. Stellen Sie eine Schnittstelle zu den Abonnementvorgängen zur Verfügung. Sie müssen den Kunden identifizieren und den Abonnementbezeichner des Testabonnements angeben.

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

  2. Aktivieren Sie das Abonnement mithilfe des Aktivierungsvorgangs .

    var subscriptionActivationResult = subscriptionOperations.Activate();

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

Name Type Erforderlich Beschreibung
customer-tenant-id guid J Der Wert ist ein GUID-formatierter Kundenmandantenbezeichner (Customer-Tenant-ID), mit dem Sie einen Kunden angeben können.
Abonnement-ID guid J Der Wert ist ein GUID-formatierter Abonnementbezeichner (Abonnement-ID), mit dem Sie ein Abonnement angeben können.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Beispiel für eine Anfrage

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

Diese Methode gibt die Eigenschaften "subscription-id " und "status " zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantwort

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