Customer
| Field | Type | Behavior | Description |
|---|---|---|---|
name |
string | OUTPUT_ONLY | Resource name (customers/{customer_id}) |
external_id |
string | REQUIRED | Identifier from your telemetry system, used to filter this customer’s data in logs. Examples: "acme-corp", "b81cb7725908" |
id |
string | OUTPUT_ONLY | The {customer_id} portion of the resource name (SHA-256 hash of external_id) |
display_name |
string | Human-readable name for the customer | |
description |
string | Description of the customer and their use case | |
runbook |
string | Instructions for investigating issues with this customer | |
workload_summary |
string | AI-generated summary of the customer’s workload patterns | |
create_time |
timestamp | OUTPUT_ONLY | When the customer was created |
update_time |
timestamp | OUTPUT_ONLY | When the customer was last modified |
delete_time |
timestamp | OUTPUT_ONLY | When the customer was soft-deleted (null if active) |
purge_time |
timestamp | OUTPUT_ONLY | Earliest time the customer can be permanently purged |
Example
{
"name": "customers/cso47xax",
"externalId": "acme-corp",
"displayName": "Acme Corp",
"description": "Enterprise customer with high request volume",
"workloadSummary": "High throughput tenant with 835K requests/6h (~39 req/s). Stable latency profile.",
"createTime": "2025-10-10T18:07:55.847133Z",
"updateTime": "2025-10-14T18:14:29.993442Z"
}