取得訂用帳戶的佈建狀態
適用于:合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心
如何取得客戶訂用帳戶的訂用帳戶布建狀態。
必要條件
認證,如合作夥伴中心驗證所述。 此案例僅支援使用「應用程式+使用者」認證來進行驗證。
客戶識別碼 (
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 | string | Yes | 識別客戶的 GUID 格式化字串。 |
subscription-id | string | Yes | 識別訂用帳戶的 GUID 格式字串。 |
要求標頭
如需詳細資訊,請參閱合作夥伴中心 REST 標頭。
要求本文
無。
要求範例
GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/34828C05-C16C-4D6F-9CFC-4D2650EF19A1/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
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: e937630b-8341-4d70-8f73-450d32ee0189
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 分鐘更新一次。
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應