0.20.1 (latest) 0.20.0 0.19.0 0.18.0 0.17.0 0.16.0 0.15.0 0.14.0 0.13.12 0.12.3 0.11.14 0.10.0 0.9.1 0.8.1 0.7.0 0.6.0 0.5.0 0.4.1 0.3.1 0.2.1 0.1.1

    AgentSearchTokenSubscriptionStatus(
        mapping=None, *, ignore_unknown_fields=False, **kwargs
    )

Per-model Agent Search TPM subscription status. One entry per active
`core_subscription.agent_search_token_subscriptions[*]` entry in
the customer-provided config; populated by UpdateProject and
GetProject.

The lifecycle scalars on this message (`start_time`,
`terminate_time`, `update_type`,
`tpm_threshold_next_update_time`) are per (project, model_version)
--- siblings of the whole-relationship `start_time` /
`terminate_time` / `update_type` on the enclosing
ConfigurableBillingStatus, but scoped to this specific Agent Search
TPM subscription instead of to the overall customer-configurable-
pricing relationship. This per-instance granularity is intentional:
the underlying SubV3 storage is per-(project, model_version), so
each model has its own activation, termination, and deferred-update
clock; surfacing that on the response gives customers the
granularity they need to manage per-model commitments independently.
QPM / IndexingCore differ --- their storage is one row per (project,
location), so their lifecycle is represented only by the whole-
relationship scalars on ConfigurableBillingStatus.

| ## Attributes ||
|---|---|
| **Name** | **Description** |
| `model_version` | `str` Output only. The Gemini model version this status corresponds to. Matches CoreSubscription.AgentSearchTokenSubscription.model_version (a stable Gemini model version from the Gemini Enterprise Agent Platform model-versions registry; see https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models). |
| `effective_tpm_threshold` | `int` Output only. The currently effective TPM threshold. Reflects scale-up immediately and scale-down at the next billing cycle, matching `effective_search_qpm_threshold` semantics. |
| `tpm_threshold_next_update_time` | `google.protobuf.timestamp_pb2.Timestamp` Output only. The earliest next update time for the TPM subscription threshold for this (project, model_version). Populated only after a successful update. |
| `start_time` | `google.protobuf.timestamp_pb2.Timestamp` Output only. When this (project, model_version) Agent Search TPM subscription was first activated. Set once on first activation of this model version and never moved by subsequent threshold updates; on termination + re-activation a new value is recorded. Does NOT move the whole-relationship `start_time` on the enclosing ConfigurableBillingStatus, which continues to represent the first activation of the overall customer-configurable-pricing relationship. |
| `terminate_time` | `google.protobuf.timestamp_pb2.Timestamp` Output only. If set, the scheduled effective time at which this (project, model_version) Agent Search TPM subscription will terminate. Populated when the customer removes this entry from `core_subscription.agent_search_token_subscriptions[*]`. Does NOT move the whole-relationship `terminate_time` on the enclosing ConfigurableBillingStatus, which is populated only when the entire customer-configurable-pricing relationship is being torn down. |
| `update_type` | `https://docs.cloud.google.com/python/docs/reference/discoveryengine/latest/google.cloud.discoveryengine_v1beta.types.Project.ConfigurableBillingStatus.UpdateType` Output only. The type of the most recent update to this (project, model_version) subscription, as performed by the most recent UpdateProject call. `UPDATE_TYPE_UNSPECIFIED` indicates this model_version was not touched by the most recent UpdateProject (its `effective_tpm_threshold` reflects an earlier update). The whole-relationship `update_type` on the enclosing ConfigurableBillingStatus continues to summarize the direction of the most recent update across all surfaces in the project (QPM, IndexingCore, and Agent Search TPM together). |