訂用帳戶資源
適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心
訂用帳戶可讓客戶在特定時間內使用服務。 並非所有欄位都套用至所有訂用帳戶。 許多欄位只會在生命週期中的特定點套用，例如如果訂閱已暫停或取消。
訂閱
注意
訂閱 資源的租戶識別碼有每分鐘 500 次請求的速率限制。
訂用帳戶 資源代表訂用帳戶的生命週期，並包含定義整個訂用帳戶生命週期狀態的屬性。
| 財產 | 類型 | 描述 |
|---|---|---|
| 識別碼 | 字串 | 訂用帳戶標識碼。 |
| offerId | 字串 | 提案識別碼。 |
| 權利ID | 字串 | 權利標識碼（Azure 訂用帳戶標識符）。 |
| 優惠名稱 | 字串 | 優惠名稱。 |
| 友好名稱 | 字串 | 合作夥伴所定義的訂閱易記名稱，以協助澄清。 |
| 數量 | 數字 | 數量。 此屬性設定為基於授權的計費所需的授權數量。 |
| 單位類型 | 字串 | 定義訂用帳戶數量的單位：「授權」、「使用量型」或「權益」。 |
| 父項訂閱ID | 字串 | 取得或設定父訂閱標識碼。 |
| 建立日期 | 字串 | 取得或設定建立日期，以特定的日期時間格式。 |
| 生效開始日期 | UTC 日期時間格式的字串 | 取得或設定這個訂閱的有效開始日期，格式為日期時間。 這個屬性可用來備份已移轉的訂用帳戶，或使其與另一個訂用帳戶保持一致。 |
| 承諾結束日期 | UTC 日期時間格式的字串 | 此訂閱的承諾結束日期，以日期時間格式表示。 對於無法自動重新更新的訂用帳戶，此屬性代表未來遙遠的日期。 新的商務結束日期是包含性的，這表示期限的結束是在一整天的最後。 舊版結束日期不包含在內。 |
| 承諾結束日期時間 | UTC 日期時間格式的字串 | 此訂閱的合約終止日期及時間，以日期時間格式表示。 對於無法自動重新更新的訂用帳戶，此屬性代表未來遙遠的日期。 |
| 地位 | 字串 | 訂用帳戶狀態：〈無〉、〈啟用〉、〈待定中〉、〈暫停〉、〈已過期〉、〈已停用〉或〈已刪除〉。 |
| 自動續訂啟用 | 布爾 | 取得值，指出訂閱是否自動更新。 |
| 計費類型 | 字串 | 指定訂用帳戶的計費方式：「無」、「使用」、「授權」或「福利」。 |
| billingCycle | 字串 | 指出合作夥伴為此訂單計費的頻率。 支援的值是 BillingCycleType中找到的成員名稱。 |
| 可購買附加元件 | 布林值 | 取得或設定值，指出訂閱是否有可購買的附加元件。 |
| isTrial | 布爾 | 值，指出訂閱是否為試用版。 |
| isMicrosoftProduct | 布爾 | 值，指出訂閱是否為Microsoft產品。 |
| 出版者名稱 | 字串 | 發行者名稱。 |
| 行動 | 字串陣列 | 取得或設定允許的動作。 可能的值：“edit”、“cancel” |
| partnerId | 字串 | 記錄轉銷商的 PartnerID，用於間接合作夥伴模型中。 |
| 暫停原因 | 字串陣列 | 唯讀的。 如果訂閱已暫停，表示原因。 |
| 合約類型 | 字串 | 唯讀的。 合約類型：「subscription」、“ productKey” 或 「redemptionCode」。 |
| 退款選項 | RefundOption 資源的陣列 | 唯讀。 此訂閱服務的可用退款選項。 |
| 下學期安排說明 | scheduledNextTermInstructions | 取得或設定在下個時段開始時執行的排程指令。 |
| 下一次充電指示 | 下一次收費說明 | 取得下一個期限的計費說明詳細資訊，以了解當前期限結束時待處理的計費週期變更。 |
| 連結 | SubscriptionLinks | 取得或設定訂閱連結。 |
| 訂單編號 | 字串 | 要開始訂閱的訂單之ID。 |
| 合約期限 | 字串 | 詞彙持續時間的 ISO 8601 標準表示法。 目前的支援值為 P1M （1 個月）、P1Y （1 年） 和 P3Y （3 年）。 |
| 屬性 | ResourceAttributes | 對應於訂閱的元數據屬性。 |
| 續約期限期間 | 字串 | 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M （1 個月） 和 P1Y （1 年）。 |
| 產品類型 | 項目類型 | 唯讀。 訂用帳戶所針對的產品類型。 |
| 消費類型 | 超額 資源的 陣列 | 取得或設定指定客戶的超額。 |
| promotionId | 字串 | 訂閱中若應用促銷標識符。 格式範例：「39NFJQT1PJQB：0001：39NFJQT1Q5KN」 |
| 可取消截止日期 | 日期時間 | 最後取消日期 |
| 帳單週期結束日期 | 日期時間 | 取得或設定此訂用帳戶的計費周期結束日期，格式為日期時間格式。 |
| 計費周期結束日期時間 | 日期時間 | 取得此訂用帳戶的計費周期結束日期時間，格式為日期時間。 |
| 產品訂單編號 | 字串 | 特定產品購買的識別碼（例如預留或「Azure」節省方案）。 |
| lineItems | 訂閱項目 | 明細項目包含特定訂閱的購買詳細資訊。 |
訂閱連結
SubscriptionLinks 資源描述附加至訂閱資源的一系列的連結。
| 財產 | 類型 | 描述 |
|---|---|---|
| 提供, 提議, 優惠 | 連結 | 取得或設定優惠。 |
| 父訂閱 | 連結 | 取得或設定父訂閱。 |
| 產品 | 連結 | 取得與訂閱相關的產品。 |
| sku | 連結 | 取得與訂用帳戶相關聯的產品 SKU。 |
| 可用性 | 連結 | 取得與訂閱相關聯的產品 SKU 的可用狀態。 |
| activationLinks | 連結 | 取得與訂用帳戶相關聯的啟用連結清單。 |
| 自我 | 連結 | 自我 URI。 |
| 下一個 | 連結 | 項目的下一頁。 |
| 以前 | 連結 | 商品的上一頁。 |
訂閱配置狀態 (SubscriptionProvisioningStatus)
SubscriptionProvisioningStatus 資源會提供訂用帳戶布建狀態的相關信息。
| 財產 | 類型 | 描述 |
|---|---|---|
| skuId | 字串 | 識別產品 SKU 的字串。 |
| 地位 | 字串 | 指出布建狀態：「成功」、「擱置中」或「失敗」。 |
| 數量 | 數字 | 在布建之後提供訂用帳戶數量。 |
| 結束日期 | UTC 日期時間格式的字串 | 訂閱的結束日期。 |
| 屬性 | ResourceAttributes | 元數據屬性。 |
預定下個學期的指導說明
scheduledNextTermInstructions 資源定義了訂閱的下個期限開始時要套用的指示。 只有在已設定排程的變更，或針對所有試用訂閱時，才會存在。
| 財產 | 類型 | 描述 |
|---|---|---|
| 產品 | 產品 | 識別產品 SKU 的 GUID 格式字串。 |
| 數量 | 數字 | 在配置之後提供訂閱數量。 |
| 自訂條款結束日期 | UTC 日期時間格式的字串 | 訂閱的自定義結束日期，當它與另一個訂用帳戶的結束日期對齊時 |
產品
scheduledNextTermInstructions.product 資源及屬性的排程變更將在下個期間生效。
| 財產 | 類型 | 描述 |
|---|---|---|
| productId | 字串 | 產品的標識碼。 |
| skuId | 字串 | 佈建完成後提供訂閱數量。 |
| 可用性ID | 字串 | 此項可用性的識別碼。 此識別碼只有在其父系 產品 以及在 SKU的內容中是唯一的。 注意 可用性標識符可能會隨著時間而變更。 合作夥伴應該在擷取此值後的短時間內依賴此值。 |
| billingCycle | 字串 | 指出合作夥伴為此訂單計費的頻率。 支援的值是 BillingCycleType中找到的成員名稱。 |
| 期限時長 | 字串 | 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M （1 個月） 和 P1Y （1 年）。 |
| promotionId | 字串 | 要套用至下一個排定期間的促銷代碼。 格式範例：「39NFJQT1PJQB：0001：39NFJQT1Q5KN」。 |
下一次充電指示
nextChargeInstructions 資源會指明在訂用帳戶下一個週期開始時套用的計費週期的說明。 只有在擱置的計費週期變更時才存在。
| 財產 | 類型 | 描述 |
|---|---|---|
| 產品 | 產品 | 識別產品 SKU 的 GUID 格式字串。 |
| 數量 | 數字 | 在配置後提供訂閱數量。 |
訂閱註冊狀態
SubscriptionRegistrationStatus 資源描述附加至訂用帳戶資源的連結集合。
| 財產 | 類型 | 描述 |
|---|---|---|
| 訂閱ID | 字串 | 訂用帳戶標識碼。 |
| 地位 | 字串 | 指出註冊狀態：「已註冊」、「註冊中」或「未註冊」。 |
SupportContact
SupportContact 資源代表客戶的訂閱支援聯繫人。
| 財產 | 類型 | 描述 |
|---|---|---|
| supportTenantId | 字串 | GUID 格式字串，表示支援聯絡人的租戶識別碼。 |
| supportMpnId | 字串 | 聯繫人的合作夥伴識別碼。 |
| 名字 | 字串 | 支援聯絡人的名稱。 |
| 連結 | 資源連結 | 支援聯繫人相關連結。 |
| 屬性 | 資源屬性 | 元數據屬性。 包含 “objectType”： “ SupportContact”。 |
超額
超額 資源代表超額消費的資源，這些可能會指派給某個訂閱，無論該資源是否已被指派或是由轉銷商指派。
| 財產 | 類型 | 描述 |
|---|---|---|
| azureEntitlementId | 字串 | GUID 格式化字串，表示消費訂閱標識符。 |
| partnerId | 字串 | 與訂用帳戶相關聯的轉銷商合作夥伴標識碼。 |
| 類型 | 字串 | 超額類型可以是「電話服務」 |
| 超額 | 布爾 | 指示是否啟用超額使用的值。 |
| 連結 | 資源連結 | 超量相關連結。 |
| 屬性 | ResourceAttributes | 元數據屬性。 包含「objectType」：「超額」。 |
註冊訂閱
RegisterSubscription 資源會傳回連結，可用來查詢訂用帳戶的註冊狀態。 註冊狀態會在已成功接受的註冊要求的回應內容中傳回，用於註冊 Azure 訂用帳戶。
| 財產 | 類型 | 描述 |
|---|---|---|
| http回應訊息 | 物件 | 傳回 HTTP 狀態代碼 202 「已接受」，其中包含查詢註冊狀態連結的 Location 標頭。 例如，"/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus" |
退款選項
RefundOption 資源代表訂閱服務的可能的退款選項。
| 財產 | 類型 | 描述 |
|---|---|---|
| 類型 | 字串 | 退款的類型。 支持的值為「Partial」和「Full」 |
| 過期後 | UTC 日期時間格式的字串 | 此選項到期時的時間戳。 如果為 null，則退款作業沒有到期日。 |
Azure 使用權限
AzureEntitlement 資源代表訂用帳戶的 Azure 權利。
| 財產 | 類型 | 描述 |
|---|---|---|
| 識別碼 | 字串 | 權利標識碼 |
| 友好名稱 | 字串 | 權利的易記名稱。 |
| 地位 | 字串 | 權利的狀態。 |
| 訂閱識別碼 | 字串 | 權利所屬的訂用帳戶標識碼。 |
訂閱項目明細
訂單明細包含特定訂閱的購買詳細資料。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 身份識別碼 | 字串 | 訂閱項目識別碼。 |
| 友善名稱 | 字串 | 合作夥伴所定義的訂閱項目的友好名稱，以便於辨識。 |
| 範圍 | 範圍 | 範圍指出適用權益的位置。 |
| 自動續訂啟用 | 布爾 | 取得值，指出訂閱是否自動更新。 |
| 地位 | 字串 | 訂閱狀態：「無」、「啟用」、「待定」、「暫停」、「過期」、「停用」或「刪除」。 |
| 購買承諾 | 購買承諾 | 計算服務上承諾的固定金額。 |
範圍
範圍指出適用權益的位置。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 類型 | 字串 | 購買的範圍類型：「單一」、「共享」、「資源群組」或「管理群組」。 |
| 訂閱識別碼 | 字串 | 要用於購買的 Azure 方案標識碼。 共用範圍的必要條件。 |
| entitlementId | 字串 | 要用於購買的 Azure 訂用帳戶標識碼。 單一範圍的必要專案。 |
| managementGroupId (管理群組ID) | 字串 | 要用於購買的管理群組標識碼。 目前只能透過 Azure 入口網站選取此範圍，但更新會反映在個人電腦中。 |
| 資源群組識別碼 (resourceGroupId) | 字串 | 要用於購買之資源群組的標識碼。 目前僅能透過 Azure 介面選取此範圍，但更新會反映在電腦中。 |
購買承諾
在計算服務上承諾的固定金額。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 量 | 字串 | 固定金額承諾。 |
| 糧食 | 字串 | 承諾的期間。 |
| 貨幣 | 字串 | 承諾的貨幣。 |