訂用帳戶資源
適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心
訂用帳戶可讓客戶在特定時間內使用服務。 並非所有欄位都套用至所有訂用帳戶。 許多欄位只會在生命週期中的特定點套用，例如如果訂閱已暫停或取消。
訂用帳戶
注意
訂用帳戶資源每個租用戶標識碼的速率限制為每分鐘 500 個要求。
訂用帳戶資源代表訂用帳戶的生命週期，並包含定義整個訂用帳戶生命週期狀態的屬性。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 識別碼 | string | 訂用帳戶標識碼。 |
| offerId | string | 供應項目標識碼。 |
| entitlementId | string | 權利標識碼（Azure 訂用帳戶標識符）。 |
| offerName | string | 供應項目名稱。 |
| friendlyName | string | 合作夥伴所定義的訂用帳戶易記名稱，以協助釐清。 |
| 數量 | number | 數量。 此屬性會設定為授權型計費的授權計數。 |
| unitType | string | 定義訂用帳戶數量的單位：「授權」、「使用量型」或「權益」。 |
| parentSubscriptionId | string | 取得或設定父訂閱標識碼。 |
| creationDate | string | 取得或設定建立日期，以日期時間格式。 |
| effectiveStartDate | UTC 日期時間格式的字串 | 取得或設定這個訂閱的有效開始日期，格式為日期時間。 這個屬性可用來備份已移轉的訂用帳戶，或使其與另一個訂用帳戶保持一致。 |
| commitmentEndDate | UTC 日期時間格式的字串 | 此訂用帳戶的承諾結束日期，格式為日期時間格式。 對於無法自動重新更新的訂用帳戶，此屬性代表未來遙遠的日期。 新的商務結束日期是包容性的，這表示字詞的結尾是在全天結束。 舊版結束日期不包含。 |
| commitmentEndDateTime | UTC 日期時間格式的字串 | 此訂用帳戶的承諾結束日期和時間，格式為日期時間格式。 對於無法自動重新更新的訂用帳戶，此屬性代表未來遙遠的日期。 |
| status | 字串 | 訂用帳戶狀態：「none」、“active”、“pending”、“suspended”、“expired”、“disabled” 或 “deleted”。 |
| autoRenewEnabled | boolean | 取得值，指出訂閱是否自動更新。 |
| billingType | string | 指定訂用帳戶的計費方式：「none」、“usage”、“license” 或 “benefit”。 |
| billingCycle | string | 指出合作夥伴為此訂單計費的頻率。 支援的值是 BillingCycleType 中找到的成員名稱。 |
| hasPurchasableAddons | boolean | 取得或設定值，指出訂閱是否有可購買的附加元件。 |
| isTrial | boolean | 值，指出訂閱是否為試用版。 |
| isMicrosoftProduct | boolean | 值，指出訂閱是否為 Microsoft 產品。 |
| publisherName | string | 發行者名稱。 |
| 動作 | 字串陣列 | 取得或設定允許的動作。 可能的值：“edit”、“cancel” |
| partnerId | string | 記錄轉銷商的 PartnerID，用於間接合作夥伴模型中。 |
| suspensionReasons | 字串陣列 | 唯讀。 如果訂閱已暫停，表示原因。 |
| contractType | string | 唯讀。 合約類型：「subscription」、“ productKey” 或 「redemptionCode」。 |
| refundOptions | RefundOption 資源的陣列 | 唯讀。 此訂用帳戶可用的退款選項集。 |
| scheduledNextTermInstructions | scheduledNextTermInstructions | 取得或設定下一個字詞啟動時所執行的排程指令。 |
| nextChargeInstructions | nextChargeInstructions | 取得下一個字詞計費指示的詳細數據，以取得目前期限結束時擱置計費週期變更的詳細數據。 |
| 連結 | SubscriptionLinks | 取得或設定訂閱連結。 |
| 訂單識別碼 | string | 要開始訂閱之訂單的標識碼。 |
| termDuration | string | 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M （1 個月）、 P1Y （1 年）和 P3Y （3 年）。 |
| attributes | ResourceAttributes | 對應至訂用帳戶的元數據屬性。 |
| renewalTermDuration | string | 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M （1 個月）和 P1Y （1 年）。 |
| ProductType | ItemType | 唯讀。 訂用帳戶所針對的產品類型。 |
| consumptionType | 超額資源的陣列 | 取得或設定指定客戶的超額。 |
| promotionId | string | 如果套用至訂用帳戶，則為升級標識符。 格式範例：「39NFJQT1PJQB：0001：39NFJQT1Q5KN」 |
| CancellationAllowedUntilDate | Datetime | 取消的最後一個日期。 |
| BillingCycleEndDate | Datetime | 取得或設定此訂用帳戶的計費周期結束日期，格式為日期時間格式。 |
| BillingCycleEndDateTime | Datetime | 取得此訂用帳戶的計費周期結束日期時間，格式為日期時間。 |
| productOrderId | string | 特定產品購買的標識碼（例如保留或 Azure 節省方案）。 |
| 明細項目 | SubscriptionLineItem | 明細專案包含特定訂用帳戶的購買詳細數據。 |
SubscriptionLinks
SubscriptionLinks 資源描述附加至訂用帳戶資源的連結集合。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 提供 | 連結 | 取得或設定供應專案。 |
| parentSubscription | 連結 | 取得或設定父訂閱。 |
| product | 連結 | 取得與訂用帳戶相關聯的產品。 |
| SKU | 連結 | 取得與訂用帳戶相關聯的產品 SKU。 |
| 可用性 | 連結 | 取得與訂用帳戶相關聯的產品 SKU 可用性。 |
| activationLinks | 連結 | 取得與訂用帳戶相關聯的啟用連結清單。 |
| self | 連結 | 自我 URI。 |
| next | 連結 | 專案的下一頁。 |
| previous | 連結 | 專案的上一頁。 |
SubscriptionProvisioningStatus
SubscriptionProvisioningStatus 資源會提供訂用帳戶布建狀態的相關信息。
| 屬性 | 類型 | 描述 |
|---|---|---|
| skuId | string | 識別產品 SKU 的字串。 |
| status | 字串 | 指出布建狀態：「成功」、「擱置中」或「失敗」。 |
| 數量 | number | 在布建之後提供訂用帳戶數量。 |
| endDate | UTC 日期時間格式的字串 | 訂閱的結束日期。 |
| attributes | ResourceAttributes | 元數據屬性。 |
scheduledNextTermInstructions
scheduledNextTermInstructions 資源會定義在下一個訂用帳戶下一個字詞開始時要套用的指示。 只有在已設定排程的變更，或針對所有試用訂閱時，才會存在。
| 屬性 | 類型 | 描述 |
|---|---|---|
| product | product | 識別產品 SKU 的 GUID 格式字串。 |
| 數量 | number | 在布建之後提供訂用帳戶數量。 |
| customTermEndDate | UTC 日期時間格式的字串 | 與另一個訂用帳戶的結束日期對齊時，訂閱的自定義結束日期 |
Products
scheduledNextTermInstructions.product 資源和屬性排程變更將在下一個字詞套用。
| 屬性 | 類型 | 描述 |
|---|---|---|
| productId | String | 產品的標識碼。 |
| skuId | String | 在布建之後提供訂用帳戶數量。 |
| availabilityId | String | 此可用性的識別碼。 此標識碼只在其父 產品和 SKU 的內容中是唯一的。 注意 可用性標識碼可能會隨著時間而變更。 合作夥伴只有在擷取此值之後，才應該在短時間內依賴此值。 |
| billingCycle | String | 指出合作夥伴為此訂單計費的頻率。 支援的值是 BillingCycleType 中找到的成員名稱。 |
| termDuration | String | 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M （1 個月）和 P1Y （1 年）。 |
| promotionId | String | 要套用至下一個排程字詞的升級標識碼。 格式範例：「39NFJQT1PJQB：0001：39NFJQT1Q5KN」。 |
nextChargeInstructions
nextChargeInstructions 資源會定義在訂用帳戶下一個字詞開始時套用的計費週期指示。 只有在擱置的計費週期變更擱置時才會存在。
| 屬性 | 類型 | 描述 |
|---|---|---|
| product | product | 識別產品 SKU 的 GUID 格式字串。 |
| 數量 | number | 在布建之後提供訂用帳戶數量。 |
SubscriptionRegistrationStatus
SubscriptionRegistrationStatus 資源描述附加至訂用帳戶資源的連結集合。
| 屬性 | 類型 | 描述 |
|---|---|---|
| subscriptionId | string | 訂用帳戶標識碼。 |
| status | 字串 | 指出註冊狀態：「registered」 、“ registering 或 「notregistered」。 |
SupportContact
SupportContact 資源代表客戶訂用帳戶的支持聯繫人。
| 屬性 | 類型 | 描述 |
|---|---|---|
| supportTenantId | string | GUID 格式字串，表示支持聯繫人的租使用者識別碼。 |
| supportMpnId | string | 聯繫人的合作夥伴識別碼。 |
| NAME | 字串 | 支援聯絡人的名稱。 |
| 連結 | ResourceLinks | 支援聯繫人相關連結。 |
| attributes | ResourceAttributes | 元數據屬性。 包含 “objectType”： “ SupportContact”。 |
超額
超額資源代表可能指派的耗用量訂用帳戶超額，無論是指派還是已指派的轉銷商。
| 屬性 | 類型 | 描述 |
|---|---|---|
| azureEntitlementId | string | GUID 格式化字串，表示取用訂用帳戶標識碼。 |
| partnerId | string | 與訂用帳戶相關聯的轉銷商合作夥伴標識碼。 |
| type | string | 超額類型可以是 “電話 Services” |
| 超齡 | boolean | 值，指出是否啟用超額。 |
| 連結 | ResourceLinks | 超額相關連結。 |
| attributes | ResourceAttributes | 元數據屬性。 包含 「objectType」： “Overage”。 |
RegisterSubscription
RegisterSubscription 資源會傳回連結，可用來查詢訂用帳戶的註冊狀態。 註冊狀態會在成功接受的要求回應本文中傳回，以註冊 Azure 訂用帳戶。
| 屬性 | 類型 | 描述 |
|---|---|---|
| httpResponseMessage | object | 傳回 HTTP 狀態代碼 202 「已接受」，其中包含查詢註冊狀態連結的 Location 標頭。 例如，"/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus" |
RefundOption
RefundOption 資源代表訂用帳戶的可能退款選項。
| 屬性 | 類型 | 描述 |
|---|---|---|
| type | string | 退款的類型。 支援的值為 “Partial” 和 “Full” |
| expiresAfter | UTC 日期時間格式的字串 | 此選項到期時的時間戳。 如果為 null，則退款作業沒有到期日。 |
AzureEntitlement
AzureEntitlement 資源代表訂用帳戶的 Azure 權利。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 識別碼 | string | 權利標識碼 |
| friendlyName | string | 權利的易記名稱。 |
| status | 字串 | 權利的狀態。 |
| subscriptionId | string | 權利所屬的訂用帳戶標識碼。 |
SubscriptionLineItem
明細專案包含特定訂用帳戶的購買詳細數據。
| 屬性 | 型別 | 說明 |
|---|---|---|
| 識別碼 | string | 訂用帳戶明細專案標識碼。 |
| friendlyName | string | 合作夥伴所定義的訂用帳戶明細專案的易記名稱，以協助釐清。 |
| 範圍 (scope) | 範圍 | 範圍指出適用權益的位置。 |
| autoRenewEnabled | 布林值 | 取得值，指出訂閱是否自動更新。 |
| status | 字串 | 訂用帳戶狀態：「none」、“active”、“pending”、“suspended”、“expired”、“disabled” 或 “deleted”。 |
| purchaseCommitment | 購買承諾 | 計算服務上認可的固定數量。 |
範圍
範圍指出適用權益的位置。
| 屬性 | 型別 | 說明 |
|---|---|---|
| type | string | 購買的範圍類型：「Single」、“ Shared” 、“ Resource group” 或 “Management group”。 |
| subscriptionId | string | 要用於購買的 Azure 方案標識碼。 共用範圍的必要專案。 |
| entitlementId | string | 要用於購買的 Azure 訂用帳戶標識碼。 單一範圍的必要專案。 |
| managementGroupId | string | 要用於購買的管理群組標識碼。 此範圍只能透過目前 Azure 入口網站 選取，但更新會反映在計算機中。 |
| resourceGroupId | string | 要用於購買之資源群組的標識碼。 此範圍只能透過目前 Azure 入口網站 選取，但更新會反映在計算機中。 |
購買承諾
計算服務上認可的固定數量。
| 屬性 | 型別 | 說明 |
|---|---|---|
| 金額 | string | 固定金額承諾用量。 |
| 糧食 | string | 承諾的期間。 |
| currency | string | 承諾的貨幣。 |