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 的完整資源名稱,例如 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 BillingAccountLicenseConfig 處於寬限期。訂閱方案已終止 (提前終止或到期),但客戶仍可在一段時間內存取。寬限期結束後,就會變成「已過期」。

方法

distributeLicenseConfig

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

get

取得 BillingAccountLicenseConfig。

list

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

retractLicenseConfig

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