Aktywuj subskrypcję piaskownicy dla produktów SaaS z komercyjnego rynku w celu umożliwienia rozliczeń

Jak aktywować subskrypcję dla produktów SaaS (oprogramowanie jako usługa) na komercyjnej platformie handlowej z kont z piaskownicy integracyjnej, aby umożliwić rozliczenia.

Notatka

Można aktywować subskrypcję produktów SaaS dostępnych na komercyjnym rynku tylko z kont piaskownicy integracyjnej. Jeśli masz subskrypcję produkcyjną, musisz odwiedzić witrynę wydawcy, aby ukończyć proces instalacji. Rozliczenia subskrypcji będą rozpoczynane dopiero po zakończeniu instalacji.

Warunki wstępne

• Poświadczenia opisane w uwierzytelnianiu Centrum partnerskiego. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
• Konto partnera piaskownicy integracji z klientem posiadającym aktywną subskrypcję produktów SaaS na platformie handlowej.
• W przypadku partnerów korzystających z zestawu .NET SDK Centrum partnerskiego należy użyć zestawu SDK w wersji 1.14.0 lub nowszej, aby uzyskać dostęp do tej możliwości.

Ważny

Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wersję zestawu SDK z witryny GitHubwraz z plikiem readme zawierającym przydatne informacje.

Zachęcamy partnerów do dalszego korzystania z Centrum Partnerskiego z interfejsów API REST .

C#

Wykonaj następujące kroki, aby aktywować subskrypcję dla produktów SaaS na platformie handlowej:

1. Udostępnianie interfejsu dla operacji subskrypcji. Musisz zidentyfikować klienta i określić identyfikator subskrypcji wersji próbnej.

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

2. Aktywuj subskrypcję przy użyciu operacji Aktywuj.

   var subscriptionActivationResult = subscriptionOperations.Activate();
   

Żądanie REST

Składnia żądania

Metoda	URI żądania
POST	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

Parametr identyfikatora URI

Nazwa	Typ	Wymagane	Opis
customer-tenant-id	guid	Y	Wartość to identyfikator dzierżawy klienta sformatowany jako GUID (identyfikator-dzierżawy-klienta), który pozwala na wskazanie konkretnego klienta.
identyfikator subskrypcji	guid	Y	Wartość jest identyfikatorem subskrypcji w formacie GUID (identyfikatora subskrypcji), który umożliwia określenie subskrypcji.

Nagłówki żądań

Aby uzyskać więcej informacji, zapoznaj się z nagłówkami REST Centrum Partnerów.

Treść żądania

Żaden.

Przykład żądania

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

Odpowiedź REST

Ta metoda zwraca właściwości identyfikatora subskrypcji i stanu .

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Przykład odpowiedzi

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