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 |
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).
|