Aktivieren eines Sandbox-Abonnements für kommerzielle Marketplace-SaaS-Produkte, um die Abrechnung zu ermöglichen

2025-06-27

Geeignete Rollen: Administrator-Agent

In diesem Artikel erfahren Sie, wie Sie ein Abonnement für kommerzielle Marketplace-Produkte für Software as a Service (SaaS) aus Integrations-Sandkastenkonten aktivieren, 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.

Von Bedeutung

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.

Verwenden von C#

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

Stellen Sie eine Schnittstelle zu den Abonnementvorgängen zur Verfügung. Sie müssen den Kunden identifizieren und die Kennung des Abonnements für das Test-Abonnement angeben.
```
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
```

Aktivieren Sie das Abonnement mithilfe der Aktivieren-Funktion.

var subscriptionActivationResult = subscriptionOperations.Activate();

Senden einer REST-Anforderung

Verwenden Sie die folgende Syntax, um eine REST-Anforderung zu senden.

Anforderungssyntax

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

URI-Parameter

Name	Typ	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.
subscription-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

Keiner.

Beispielanfrage

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

Überprüfen der REST-Antwort

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

Antworterfolgs- und Fehlercodes

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. 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.

Antwortbeispiel

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

Was sind die Partner Center-REST-APIs?