啟用商業市集 SaaS 產品的沙箱訂用帳戶，以啟用計費

發行項
03/14/2024

如何從整合沙箱帳戶啟用商業市集軟體即服務（SaaS）產品的訂用帳戶，以啟用計費。

注意

您只能從整合沙箱帳戶啟用商業市集 SaaS 產品的訂用帳戶。如果您有生產訂用帳戶，您必須造訪發行者的網站，才能完成設定程式。訂閱計費只會在安裝完成之後開始。

必要條件

認證，如合作夥伴中心驗證所述。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
整合沙箱合作夥伴帳戶，客戶具有商業市集 SaaS 產品的使用中訂用帳戶。
對於使用合作夥伴中心 .NET SDK 的合作夥伴，您必須使用 SDK 1.14.0 版或更新版本來存取這項功能。

重要

自 2023 年 6 月起，最新的合作夥伴中心 .NET SDK 3.4.0 版現已封存。您可以從 GitHub 下載 SDK 版本，以及包含實用資訊的讀我檔案。

鼓勵合作夥伴繼續使用合作夥伴中心 REST API 。

C#

使用下列步驟來啟用商業市集 SaaS 產品的訂用帳戶：

提供訂用帳戶作業的介面。您必須識別客戶，並指定試用訂閱的訂用帳戶識別碼。

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

使用 Activate 作業啟動訂用帳戶。

var subscriptionActivationResult = subscriptionOperations.Activate();

REST 要求

要求語法

方法	要求 URI
POST	{baseURL} /v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

URI 參數

名稱	類型	必填	描述
customer-tenant-id	guid	Y	此值是 GUID 格式的客戶租使用者識別碼（ customer-tenant-id ），可讓您指定客戶。
subscription-id	guid	Y	此值是 GUID 格式的訂用帳戶識別碼（ subscription-id ），可讓您指定訂用帳戶。

要求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

要求本文

無。

要求範例

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

REST 回應

這個方法會傳 回 subscription-id 和 status 屬性。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。如需完整清單，請參閱合作夥伴中心的 REST 錯誤碼。

回應範例

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

共用方式為