REST Resource: billingAccounts.billingAccountLicenseConfigs

資源:BillingAccountLicenseConfig

帳單帳戶層級的授權設定相關資訊。

JSON 表示法
{
  "name": string,
  "licenseCount": string,
  "licenseConfigDistributions": {
    string: string,
    ...
  },
  "subscriptionName": string,
  "subscriptionTier": enum (SubscriptionTier),
  "subscriptionTerm": enum (SubscriptionTerm),
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "state": enum (State),
  "autoRenew": boolean,
  "procurementEntitlementId": string,
  "subscriptionDisplayName": string,
  "geminiBundle": boolean,
  "earlyTerminated": boolean,
  "earlyTerminationDate": {
    object (Date)
  }
}
欄位
name

string

不可變動。ID。帳單帳戶授權設定的完整資源名稱。格式:billingAccounts/{billingAccount}/billingAccountLicenseConfigs/{billingAccountLicenseConfig}

licenseCount

string (int64 format)

這是必要旗標,透過這個帳單帳戶授權設定購買的授權數量。

licenseConfigDistributions

map (key: string, value: string (int64 format))

LicenseConfig 名稱對應至分配給每個名稱的授權數量。

鍵是 LicenseConfig 的完整資源名稱,例如 projects/{project}/locations/{location}/licenseConfigs/{licenseConfig}。值是分配給該資源的授權數量。

subscriptionName

string

僅供輸出。對應的 SubV3 訂閱項目名稱。

subscriptionTier

enum (SubscriptionTier)

這是必要旗標,訂閱級別。

subscriptionTerm

enum (SubscriptionTerm)

這是必要旗標,訂閱方案的約期。

startDate

object (Date)

這是必要旗標,訂閱開始日期。

endDate

object (Date)

選用。預計的訂閱結束日期。

state

enum (State)

僅供輸出。BillingAccountLicenseConfig 的狀態。

autoRenew

boolean

BillingAccountLicenseConfig 是否會在到期時自動續訂。

procurementEntitlementId

string

訂閱項目的採購授權 ID。

subscriptionDisplayName

string

訂閱方案顯示名稱。

geminiBundle

boolean

授權設定是否適用於 Gemini 套裝組合。

earlyTerminated

boolean

指出訂閱項目是否在到期日前終止。訂閱項目從 subsv3 終止後,管道通常會終止訂閱。

earlyTerminationDate

object (Date)

訂閱方案在到期日前終止的日期。

狀態

BillingAccountLicenseConfig 狀態列舉。

列舉
STATE_UNSPECIFIED BillingAccountLicenseConfig 不存在。預設值。請勿使用。
ACTIVE BillingAccountLicenseConfig 處於啟用狀態且正在使用中。
EXPIRED BillingAccountLicenseConfig 已過期。
NOT_STARTED BillingAccountLicenseConfig 尚未開始,且開始日期為未來的時間。
DEACTIVATING 授權設定在到期日前終止,並處於停用狀態。客戶在此狀態下仍可存取。停用期結束 (14 天) 或達到結束日期時 (以先到者為準),授權設定會轉換為「已過期」。

方法

distributeLicenseConfig

將帳單帳戶層級的 LicenseConfig 分配至專案層級。

get

取得 BillingAccountLicenseConfig

list

列出指定帳單帳戶的所有 BillingAccountLicenseConfig

retractLicenseConfig

這個方法會從帳單帳戶端呼叫,將指定專案的 LicenseConfig 撤回至帳單帳戶。