Skip to main content

vw_clusters

Creates, updates, deletes, gets or lists a vw_clusters resource.

Overview

Namevw_clusters
TypeView
Idconfluent.managed_kafka_clusters.vw_clusters

Fields

The following fields are returned by this view:

NameDatatypeDescription
environmentstringEnvironment ID used to scope the cluster list (required WHERE parameter; echoed back as a column).
idstringCluster ID (e.g. lkc-50r5wn).
kindstringObject kind (always Cluster).
api_versionstringConfluent API version (e.g. cmk/v2).
display_namestringHuman-readable cluster name.
availabilitystringCluster availability tier (e.g. LOW, HIGH).
cloudstringCloud provider (AWS, GCP, AZURE).
regionstringCloud region the cluster runs in.
config_kindstringCluster sizing kind (Basic, Standard, Enterprise, Dedicated, Freight).
max_eckuintegerMaximum eCKU count for elastic clusters.
api_endpointstringCluster REST API endpoint URL.
http_endpointstringCluster HTTP endpoint URL.
kafka_bootstrap_endpointstringKafka bootstrap endpoint URL (SASL_SSL://...).
environment_idstringID of the environment that owns this cluster.
environment_resource_namestringConfluent Resource Name (CRN) of the owning environment.
phasestringCluster lifecycle phase (e.g. PROVISIONED).
created_atstringTimestamp when the cluster was created (ISO 8601).
updated_atstringTimestamp when the cluster was last updated (ISO 8601).
resource_namestringConfluent Resource Name (CRN) for this cluster.
selfstringSelf-link URL for this cluster.

Required Parameters

The following parameters are required by this view:

NameDatatypeDescription
environmentstringEnvironment ID used to scope the cluster list.

SELECT Examples

SELECT
environment,
id,
kind,
api_version,
display_name,
availability,
cloud,
region,
config_kind,
max_ecku,
api_endpoint,
http_endpoint,
kafka_bootstrap_endpoint,
environment_id,
environment_resource_name,
phase,
created_at,
updated_at,
resource_name,
self
FROM confluent.managed_kafka_clusters.vw_clusters
WHERE environment = '{{ environment }}';

SQL Definition

SELECT
id,
kind,
api_version,
environment,
JSON_EXTRACT(spec, '$.display_name') AS display_name,
JSON_EXTRACT(spec, '$.availability') AS availability,
JSON_EXTRACT(spec, '$.cloud') AS cloud,
JSON_EXTRACT(spec, '$.region') AS region,
JSON_EXTRACT(spec, '$.config.kind') AS config_kind,
JSON_EXTRACT(spec, '$.config.max_ecku') AS max_ecku,
JSON_EXTRACT(spec, '$.api_endpoint') AS api_endpoint,
JSON_EXTRACT(spec, '$.http_endpoint') AS http_endpoint,
JSON_EXTRACT(spec, '$.kafka_bootstrap_endpoint') AS kafka_bootstrap_endpoint,
JSON_EXTRACT(spec, '$.environment.id') AS environment_id,
JSON_EXTRACT(spec, '$.environment.resource_name') AS environment_resource_name,
JSON_EXTRACT(status, '$.phase') AS phase,
JSON_EXTRACT(metadata, '$.created_at') AS created_at,
JSON_EXTRACT(metadata, '$.updated_at') AS updated_at,
JSON_EXTRACT(metadata, '$.resource_name') AS resource_name,
JSON_EXTRACT(metadata, '$.self') AS self
FROM confluent.managed_kafka_clusters.clusters
WHERE environment = '{{ environment }}'