訂用帳戶資源

適用於：合作夥伴中心 |由 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	承諾的貨幣。