Managed Service for Trino API, REST: Cluster.Get

Field

Description

clusterId

string

Required field. ID of the Trino Cluster resource to return.

Field

Description

id

string

Unique ID of the Trino cluster.
This ID is assigned by Cloud in the process of creating a Trino cluster.

folderId

string

ID of the folder that the Trino cluster belongs to.

createdAt

string (date-time)

The time when the Trino cluster was created.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

name

string

Name of the Trino cluster.
The name is unique within the folder. 1-64 characters long.

description

string

Description of the Trino cluster. 0-256 characters long.

labels

object (map<string, string>)

Resource labels as key:value pairs. Maximum of 64 per resource.

monitoring[]

Monitoring

Monitoring systems relevant to the Trino cluster.

trino

TrinoConfig

Configuration of the Trino cluster.

health

enum (Health)

Aggregated cluster health.

• HEALTH_UNKNOWN: Object is in unknown state (we have no data)
• ALIVE: Object is alive and well (all hosts are alive)
• DEAD: Object is inoperable (it cannot perform any of its essential functions)
• DEGRADED: Object is partially alive (it can perform some of its essential functions)

status

enum (Status)

Cluster status.

• STATUS_UNKNOWN: Cluster state is unknown.
• CREATING: Cluster is being created.
• RUNNING: Cluster is running normally.
• ERROR: Cluster encountered a problem and cannot operate.
• STOPPING: Cluster is stopping.
• STOPPED: Cluster is stopped.
• STARTING: Cluster is starting.
• UPDATING: Cluster is being updated.

network

NetworkConfig

Network related configuration options.

deletionProtection

boolean

Deletion Protection inhibits deletion of the cluster.

serviceAccountId

string

Service account used to access Cloud resources.

logging

LoggingConfig

Cloud logging configuration.

coordinatorUrl

string

Address of Trino Coordinator.

maintenanceWindow

MaintenanceWindow

Window of maintenance operations.

plannedOperation

MaintenanceOperation

Maintenance operation planned at nearest maintenance_window.

Field

Description

name

string

Name of the monitoring system.

description

string

Description of the monitoring system.

link

string

Link to the monitoring system.

Field

Description

coordinatorConfig

CoordinatorConfig

Required field. Configuration for the coordinator, specifying computational resources and other settings.

workerConfig

WorkerConfig

Required field. Configuration for worker nodes, including scaling policy and computational resources.

version

string

Version of Trino.

retryPolicy

RetryPolicyConfig

Configuration for retry policy, specifying the spooling storage destination and other settings.

Field

Description

resources

Resources

Required field. Configuration for computational resources assigned to the coordinator instance.

Field

Description

resourcePresetId

string

Required field. ID of the preset for computational resources allocated to a instance (e.g., CPU, memory, etc.).

Field

Description

resources

Resources

Required field. Configuration for computational resources for worker instances.

scalePolicy

WorkerScalePolicy

Required field. Configuration for scaling policy for worker instances.

Field

Description

fixedScale

FixedScalePolicy

A fixed scaling policy that specifies a fixed number of worker instances.

Includes only one of the fields fixedScale, autoScale.

Defines the scaling type for worker instances.
Only one type of scaling can be specified at a time.

autoScale

AutoScalePolicy

A scaling policy that dynamically adjusts the number of worker instances
based on the cluster's workload. The system automatically increases or
decreases the number of instances within the defined range.

Includes only one of the fields fixedScale, autoScale.

Defines the scaling type for worker instances.
Only one type of scaling can be specified at a time.

Field

Description

count

string (int64)

Specifies the number of worker instances.

Field

Description

minCount

string (int64)

maxCount

string (int64)

Field

Description

policy

enum (RetryPolicy)

Retry policy level.

• RETRY_POLICY_UNSPECIFIED
• QUERY
• TASK

exchangeManager

ExchangeManagerConfig

Configuration for exchange manager.

additionalProperties

object (map<string, string>)

Additional properties.

Field

Description

additionalProperties

object (map<string, string>)

Additional properties.

storage

ExchangeManagerStorage

Field

Description

serviceS3

object

Use service side s3 bucket for exchange manager.

Includes only one of the fields serviceS3.

Field

Description

subnetIds[]

string

IDs of VPC network subnets where instances of the cluster are attached.

securityGroupIds[]

string

User security groups.

Field

Description

enabled

boolean

Logs generated by the Trino components are delivered to Cloud Logging.

folderId

string

Logs should be written to default log group for specified folder.

Includes only one of the fields folderId, logGroupId.

Destination of log records.

logGroupId

string

Logs should be written to log group resolved by ID.

Includes only one of the fields folderId, logGroupId.

Destination of log records.

minLevel

enum (Level)

Minimum log entry level.

See LogLevel.Level for details.

• LEVEL_UNSPECIFIED: Default log level.

  Equivalent to not specifying log level at all.

• TRACE: Trace log level.

  Possible use case: verbose logging of some business logic.

• DEBUG: Debug log level.

  Possible use case: debugging special cases in application logic.

• INFO: Info log level.

  Mostly used for information messages.

• WARN: Warn log level.

  May be used to alert about significant events.

• ERROR: Error log level.

  May be used to alert about errors in infrastructure, logic, etc.

• FATAL: Fatal log level.

  May be used to alert about unrecoverable failures and events.

Field

Description

anytime

object

Includes only one of the fields anytime, weeklyMaintenanceWindow.

weeklyMaintenanceWindow

WeeklyMaintenanceWindow

Includes only one of the fields anytime, weeklyMaintenanceWindow.

Field

Description

day

enum (WeekDay)

• WEEK_DAY_UNSPECIFIED
• MON
• TUE
• WED
• THU
• FRI
• SAT
• SUN

hour

string (int64)

Hour of the day in UTC.

Field

Description

info

string

delayedUntil

string (date-time)

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

latestMaintenanceTime

string (date-time)

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

nextMaintenanceWindowTime

string (date-time)

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).