為商業市集的 SaaS 產品啟用沙箱訂用帳戶，以啟用收費功能。

發行項
03/09/2025

如何從整合沙盒帳戶啟用商業市集軟體即服務（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);

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

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	全域唯一識別碼	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 回應

這個方法會傳回 訂用帳戶標識碼 和狀態屬性。

回應成功和錯誤碼

每個回應都有一個 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"
}

共用方式為