分享方式：

取得訂用帳戶的佈建狀態

  • 文章

適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心

如何取得客戶訂用帳戶的訂用帳戶布建狀態。

必要條件

  • 認證，如合作夥伴中心驗證所述。 此案例僅支援使用「應用程式+使用者」認證來進行驗證。

  • 客戶識別碼 (customer-tenant-id)。 如果您不知道客戶的標識碼，您可以在合作夥伴中心中選取 [客戶] 工作區，然後從客戶清單中查看客戶，然後從 [帳戶]。 在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找Microsoft標識碼。 Microsoft 識別碼與客戶識別碼 (customer-tenant-id) 相同。

  • 訂用帳戶標識碼。

  • 需要訂用帳戶的委派系統管理員許可權，才能執行這項作業。

細微的委派系統管理員許可權 （GDAP） 角色

您至少需要下列其中一個 GDAP 角色：

  • 目錄讀取器
  • 全域讀取者

C#

若要取得訂用帳戶的布建狀態，請先使用 IAggregatePartner.Customers.ById 方法搭配客戶標識符來識別客戶。 然後，使用訂用帳戶標識碼呼叫 Subscriptions.ById 方法，以取得訂用帳戶作業的介面。 接下來，使用 ProvisioningStatus 屬性來取得目前訂用帳戶布建狀態作業的介面，然後呼叫 Get 或 GetAsync 方法來擷取 SubscriptionProvisioningStatus 物件。

// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;

// Retrieve a subscription's provisioning status.
var provisioningStatus = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).ProvisioningStatus.Get();

REST 要求

要求語法

方法 要求 URI
GET {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus HTTP/1.1

URI 參數

使用下列路徑參數來識別客戶和訂用帳戶。

名稱 類型​​ 必要 描述
customer-ID 字串 Yes 識別客戶的 GUID 格式化字串。
subscription-ID 字串 Yes 識別訂用帳戶的 GUID 格式字串。

要求標頭

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

要求本文

無。

要求範例

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST 回應

如果成功，響應主體會 包含 SubscriptionProvisioningStatus 資源。

回應成功和錯誤碼

每個回應都有一個 HTTP 狀態代碼，指出成功或失敗和其他偵錯資訊。 使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。 如需完整清單，請參閱合作夥伴中心的 REST 錯誤碼。

回應範例

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
Date: Thu, 20 Apr 2017 19:23:39 GMT

{
    "skuId": "6FD2C87F-B296-42F0-B197-1E91E994B900",
    "status": "success",
    "quantity": 5,
    "endDate": "2018-05-10T00:00:00Z",
    "attributes": {
        "objectType": "SubscriptionProvisioningStatus"
    }
}

備註

  • SubscriptionProvisioningStatus 中的狀態字段會在授權變更指派期間設定為 「擱置」。

  • 狀態欄位會每隔 15 分鐘更新一次。