Managed Service for Trino API, gRPC: ClusterService.Update
- gRPC request
- UpdateClusterRequest
- UpdateTrinoConfigSpec
- UpdateCoordinatorConfig
- Resources
- UpdateWorkerConfig
- WorkerScalePolicy
- FixedScalePolicy
- AutoScalePolicy
- RetryPolicyConfig
- ExchangeManagerConfig
- ExchangeManagerStorage
- ServiceS3
- AccessControlConfig
- CatalogAccessRule
- CatalogAccessRuleMatcher
- CatalogIds
- CatalogNames
- SchemaAccessRule
- SchemaAccessRuleMatcher
- SchemaNames
- TableAccessRule
- TableAccessRuleMatcher
- TableNames
- Column
- FunctionAccessRule
- FunctionAccessRuleMatcher
- FunctionNames
- ProcedureAccessRule
- ProcedureAccessRuleMatcher
- ProcedureNames
- QueryAccessRule
- SystemSessionPropertyAccessRule
- PropertyAccessRuleMatcher
- PropertyNames
- CatalogSessionPropertyAccessRule
- TLSConfig
- UpdateNetworkConfigSpec
- LoggingConfig
- MaintenanceWindow
- AnytimeMaintenanceWindow
- WeeklyMaintenanceWindow
- operation.Operation
- UpdateClusterMetadata
- Cluster
- Monitoring
- TrinoConfig
- CoordinatorConfig
- Resources
- WorkerConfig
- WorkerScalePolicy
- FixedScalePolicy
- AutoScalePolicy
- RetryPolicyConfig
- ExchangeManagerConfig
- ExchangeManagerStorage
- ServiceS3
- AccessControlConfig
- CatalogAccessRule
- CatalogAccessRuleMatcher
- CatalogIds
- CatalogNames
- SchemaAccessRule
- SchemaAccessRuleMatcher
- SchemaNames
- TableAccessRule
- TableAccessRuleMatcher
- TableNames
- Column
- FunctionAccessRule
- FunctionAccessRuleMatcher
- FunctionNames
- ProcedureAccessRule
- ProcedureAccessRuleMatcher
- ProcedureNames
- QueryAccessRule
- SystemSessionPropertyAccessRule
- PropertyAccessRuleMatcher
- PropertyNames
- CatalogSessionPropertyAccessRule
- TLSConfig
- NetworkConfig
- LoggingConfig
- MaintenanceWindow
- AnytimeMaintenanceWindow
- WeeklyMaintenanceWindow
- MaintenanceOperation
Updates configuration of the specified Trino cluster.
gRPC request
rpc Update (UpdateClusterRequest) returns (operation.Operation)
UpdateClusterRequest
{
"cluster_id": "string",
"update_mask": "google.protobuf.FieldMask",
"name": "string",
"description": "string",
"labels": "map<string, string>",
"deletion_protection": "bool",
"trino": {
"coordinator_config": {
"resources": {
"resource_preset_id": "string"
}
},
"worker_config": {
"resources": {
"resource_preset_id": "string"
},
"scale_policy": {
// Includes only one of the fields `fixed_scale`, `auto_scale`
"fixed_scale": {
"count": "int64"
},
"auto_scale": {
"min_count": "int64",
"max_count": "int64"
}
// end of the list of possible fields
}
},
"version": "string",
"retry_policy": {
"policy": "RetryPolicy",
"exchange_manager": {
"additional_properties": "map<string, string>",
"storage": {
// Includes only one of the fields `service_s3`
"service_s3": "ServiceS3"
// end of the list of possible fields
}
},
"additional_properties": "map<string, string>"
},
"access_control": {
"catalogs": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"permission": "Permission",
"description": "string"
}
],
"schemas": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"owner": "Owner",
"description": "string"
}
],
"tables": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"table": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"Privilege"
],
"columns": [
{
"name": "string",
"access": "AccessMode",
"mask": "string"
}
],
"filter": "string",
"description": "string"
}
],
"functions": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"function": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"Privilege"
],
"description": "string"
}
],
"procedures": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"procedure": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"Privilege"
],
"description": "string"
}
],
"queries": [
{
"users": [
"string"
],
"groups": [
"string"
],
"query_owners": [
"string"
],
"privileges": [
"Privilege"
],
"description": "string"
}
],
"system_session_properties": [
{
"users": [
"string"
],
"groups": [
"string"
],
"property": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"allow": "Allow",
"description": "string"
}
],
"catalog_session_properties": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"property": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"allow": "Allow",
"description": "string"
}
]
},
"tls": {
"trusted_certificates": [
"string"
]
}
},
"network_spec": {
"security_group_ids": [
"string"
]
},
"service_account_id": "string",
"logging": {
"enabled": "bool",
// Includes only one of the fields `folder_id`, `log_group_id`
"folder_id": "string",
"log_group_id": "string",
// end of the list of possible fields
"min_level": "Level"
},
"maintenance_window": {
// Includes only one of the fields `anytime`, `weekly_maintenance_window`
"anytime": "AnytimeMaintenanceWindow",
"weekly_maintenance_window": {
"day": "WeekDay",
"hour": "int64"
}
// end of the list of possible fields
}
}
|
Field |
Description |
|
cluster_id |
string Required field. ID of the Trino cluster. |
|
update_mask |
|
|
name |
string Name of the Trino cluster. The name must be unique within the folder. |
|
description |
string Description of the Trino cluster. |
|
labels |
object (map<string, string>) Custom labels for the Trino cluster as |
|
deletion_protection |
bool Deletion Protection inhibits deletion of the cluster. |
|
trino |
Configuration of Trino components. |
|
network_spec |
Network related configuration options. |
|
service_account_id |
string Service account used to access Cloud resources. |
|
logging |
Cloud logging configuration. |
|
maintenance_window |
Window of maintenance operations. |
UpdateTrinoConfigSpec
|
Field |
Description |
|
coordinator_config |
Configuration for the coordinator, specifying computational resources and other settings. |
|
worker_config |
Configuration for worker nodes, including scaling policy and computational resources. |
|
version |
string Trino version. |
|
retry_policy |
Configuration for retry policy, specifying the spooling storage destination and other settings. |
|
access_control |
Configuration for access control, specifying the fine-grained access rules. |
|
tls |
Configuration for TLS. |
UpdateCoordinatorConfig
|
Field |
Description |
|
resources |
Configuration for computational resources assigned to the coordinator instance. |
Resources
|
Field |
Description |
|
resource_preset_id |
string Required field. ID of the preset for computational resources allocated to a instance (e.g., CPU, memory, etc.). |
UpdateWorkerConfig
|
Field |
Description |
|
resources |
Configuration for computational resources for worker instances. |
|
scale_policy |
Configuration for scaling policy for worker instances. |
WorkerScalePolicy
|
Field |
Description |
|
fixed_scale |
A fixed scaling policy that specifies a fixed number of worker instances. Includes only one of the fields Defines the scaling type for worker instances. |
|
auto_scale |
A scaling policy that dynamically adjusts the number of worker instances Includes only one of the fields Defines the scaling type for worker instances. |
FixedScalePolicy
|
Field |
Description |
|
count |
int64 Specifies the number of worker instances. |
AutoScalePolicy
|
Field |
Description |
|
min_count |
int64 |
|
max_count |
int64 |
RetryPolicyConfig
|
Field |
Description |
|
policy |
enum RetryPolicy Retry policy level.
|
|
exchange_manager |
Configuration for exchange manager. |
|
additional_properties |
object (map<string, string>) Additional properties. |
ExchangeManagerConfig
|
Field |
Description |
|
additional_properties |
object (map<string, string>) Additional properties. |
|
storage |
ExchangeManagerStorage
|
Field |
Description |
|
service_s3 |
Use service side s3 bucket for exchange manager. Includes only one of the fields |
ServiceS3
|
Field |
Description |
|
Empty |
|
AccessControlConfig
|
Field |
Description |
|
catalogs[] |
Catalog access control rules. |
|
schemas[] |
Schema access control rules. |
|
tables[] |
Table access control rules. |
|
functions[] |
Function access control rules. |
|
procedures[] |
Procedures access control rules. |
|
queries[] |
Queries access control rules. |
|
system_session_properties[] |
SystemSessionPropertyAccessRule System session property access control rules. |
|
catalog_session_properties[] |
CatalogSessionPropertyAccessRule Catalog session property access control rules. |
CatalogAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
permission |
enum Permission Required field. Permission granted by the rule.
|
|
description |
string Rule description. |
CatalogAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Catalog name regexp the rule is applied to. Includes only one of the fields |
|
ids |
Catalog IDs rule is applied to. Includes only one of the fields |
|
names |
Catalog names rule is applied to. Includes only one of the fields |
CatalogIds
|
Field |
Description |
|
any[] |
string |
CatalogNames
|
Field |
Description |
|
any[] |
string |
SchemaAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
schema |
Schema matcher specifying what schemas the rule is applied to. |
|
owner |
enum Owner Required field. Ownership granted by the rule.
|
|
description |
string Rule description. |
SchemaAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Schema name regexp the rule is applied to. Includes only one of the fields |
|
names |
Schema names the rule is applied to. Includes only one of the fields |
SchemaNames
|
Field |
Description |
|
any[] |
string |
TableAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
schema |
Schema matcher specifying what schemas the rule is applied to. |
|
table |
Table matcher specifying what tables the rule is applied to. |
|
privileges[] |
enum Privilege Permission granted by the rule.
|
|
columns[] |
Column rules. |
|
filter |
string Boolean SQL expression to filter table rows for particular user. |
|
description |
string Rule description. |
TableAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Table name regexp the rule is applied to. Includes only one of the fields |
|
names |
Table names the rule is applied to. Includes only one of the fields |
TableNames
|
Field |
Description |
|
any[] |
string |
Column
|
Field |
Description |
|
name |
string Required field. Column name. |
|
access |
enum AccessMode Required field. Column access mode.
|
|
mask |
string SQL expression mask to evaluate instead of original column values. |
FunctionAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
schema |
Schema matcher specifying what schema the rule is applied to. |
|
function |
Function matcher specifying what functions the rule is applied to. |
|
privileges[] |
enum Privilege Privileges granted by the rule.
|
|
description |
string Rule description. |
FunctionAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Function name regexp the rule is applied to. Includes only one of the fields |
|
names |
Function names the rule is applied to. Includes only one of the fields |
FunctionNames
|
Field |
Description |
|
any[] |
string |
ProcedureAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
schema |
Schema matcher specifying what schema the rule is applied to. |
|
procedure |
Procedure matcher specifying what functions the rule is applied to. |
|
privileges[] |
enum Privilege Privileges granted by the rule.
|
|
description |
string Rule description. |
ProcedureAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Procedure name regexp the rule is applied to. Includes only one of the fields |
|
names |
Procedure names the rule is applied to. Includes only one of the fields |
ProcedureNames
|
Field |
Description |
|
any[] |
string |
QueryAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
query_owners[] |
string Owners of queries the rule is applied to. |
|
privileges[] |
enum Privilege Privileges granted by the user.
|
|
description |
string Rule description. |
SystemSessionPropertyAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
property |
Property matcher specifying what properties the rule is applied to. |
|
allow |
enum Allow Required field. Whether the rule allows setting the property.
|
|
description |
string Rule description. |
PropertyAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Property name regexp the rule is applied to. Includes only one of the fields |
|
names |
Property names the rule is applied to. Includes only one of the fields |
PropertyNames
|
Field |
Description |
|
any[] |
string |
CatalogSessionPropertyAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
property |
Property matcher specifying what properties the rule is applied to. |
|
allow |
enum Allow Required field. Whether the rule allows setting the property.
|
|
description |
string Rule description. |
TLSConfig
|
Field |
Description |
|
trusted_certificates[] |
string Trusted CA-certificates. Each element should contain single self-signed CA-certificate or |
UpdateNetworkConfigSpec
|
Field |
Description |
|
security_group_ids[] |
string User security groups. |
LoggingConfig
|
Field |
Description |
|
enabled |
bool Logs generated by the Trino components are delivered to Cloud Logging. |
|
folder_id |
string Logs should be written to default log group for specified folder. Includes only one of the fields Destination of log records. |
|
log_group_id |
string Logs should be written to log group resolved by ID. Includes only one of the fields Destination of log records. |
|
min_level |
enum Level Minimum log entry level. See LogLevel.Level for details.
|
MaintenanceWindow
|
Field |
Description |
|
anytime |
Includes only one of the fields |
|
weekly_maintenance_window |
Includes only one of the fields |
AnytimeMaintenanceWindow
|
Field |
Description |
|
Empty |
|
WeeklyMaintenanceWindow
|
Field |
Description |
|
day |
enum WeekDay
|
|
hour |
int64 Hour of the day in UTC. |
operation.Operation
{
"id": "string",
"description": "string",
"created_at": "google.protobuf.Timestamp",
"created_by": "string",
"modified_at": "google.protobuf.Timestamp",
"done": "bool",
"metadata": {
"cluster_id": "string"
},
// Includes only one of the fields `error`, `response`
"error": "google.rpc.Status",
"response": {
"id": "string",
"folder_id": "string",
"created_at": "google.protobuf.Timestamp",
"name": "string",
"description": "string",
"labels": "map<string, string>",
"monitoring": [
{
"name": "string",
"description": "string",
"link": "string"
}
],
"trino": {
"coordinator_config": {
"resources": {
"resource_preset_id": "string"
}
},
"worker_config": {
"resources": {
"resource_preset_id": "string"
},
"scale_policy": {
// Includes only one of the fields `fixed_scale`, `auto_scale`
"fixed_scale": {
"count": "int64"
},
"auto_scale": {
"min_count": "int64",
"max_count": "int64"
}
// end of the list of possible fields
}
},
"version": "string",
"retry_policy": {
"policy": "RetryPolicy",
"exchange_manager": {
"additional_properties": "map<string, string>",
"storage": {
// Includes only one of the fields `service_s3`
"service_s3": "ServiceS3"
// end of the list of possible fields
}
},
"additional_properties": "map<string, string>"
},
"access_control": {
"catalogs": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"permission": "Permission",
"description": "string"
}
],
"schemas": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"owner": "Owner",
"description": "string"
}
],
"tables": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"table": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"Privilege"
],
"columns": [
{
"name": "string",
"access": "AccessMode",
"mask": "string"
}
],
"filter": "string",
"description": "string"
}
],
"functions": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"function": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"Privilege"
],
"description": "string"
}
],
"procedures": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"procedure": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"Privilege"
],
"description": "string"
}
],
"queries": [
{
"users": [
"string"
],
"groups": [
"string"
],
"query_owners": [
"string"
],
"privileges": [
"Privilege"
],
"description": "string"
}
],
"system_session_properties": [
{
"users": [
"string"
],
"groups": [
"string"
],
"property": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"allow": "Allow",
"description": "string"
}
],
"catalog_session_properties": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `name_regexp`, `ids`, `names`
"name_regexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"property": {
// Includes only one of the fields `name_regexp`, `names`
"name_regexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"allow": "Allow",
"description": "string"
}
]
},
"tls": {
"trusted_certificates": [
"string"
]
}
},
"health": "Health",
"status": "Status",
"network": {
"subnet_ids": [
"string"
],
"security_group_ids": [
"string"
]
},
"deletion_protection": "bool",
"service_account_id": "string",
"logging": {
"enabled": "bool",
// Includes only one of the fields `folder_id`, `log_group_id`
"folder_id": "string",
"log_group_id": "string",
// end of the list of possible fields
"min_level": "Level"
},
"coordinator_url": "string",
"maintenance_window": {
// Includes only one of the fields `anytime`, `weekly_maintenance_window`
"anytime": "AnytimeMaintenanceWindow",
"weekly_maintenance_window": {
"day": "WeekDay",
"hour": "int64"
}
// end of the list of possible fields
},
"planned_operation": {
"info": "string",
"delayed_until": "google.protobuf.Timestamp",
"latest_maintenance_time": "google.protobuf.Timestamp",
"next_maintenance_window_time": "google.protobuf.Timestamp"
}
}
// end of the list of possible fields
}
An Operation resource. For more information, see Operation.
|
Field |
Description |
|
id |
string ID of the operation. |
|
description |
string Description of the operation. 0-256 characters long. |
|
created_at |
Creation timestamp. |
|
created_by |
string ID of the user or service account who initiated the operation. |
|
modified_at |
The time when the Operation resource was last modified. |
|
done |
bool If the value is |
|
metadata |
Service-specific metadata associated with the operation. |
|
error |
The error result of the operation in case of failure or cancellation. Includes only one of the fields The operation result. |
|
response |
The normal response of the operation in case of success. Includes only one of the fields The operation result. |
UpdateClusterMetadata
|
Field |
Description |
|
cluster_id |
string ID of the Trino cluster that is being updated. |
Cluster
Trino cluster.
|
Field |
Description |
|
id |
string Unique ID of the Trino cluster. |
|
folder_id |
string ID of the folder that the Trino cluster belongs to. |
|
created_at |
The time when the Trino cluster was created. |
|
name |
string Name of the Trino cluster. |
|
description |
string Description of the Trino cluster. 0-256 characters long. |
|
labels |
object (map<string, string>) Resource labels as |
|
monitoring[] |
Monitoring systems relevant to the Trino cluster. |
|
trino |
Configuration of the Trino cluster. |
|
health |
enum Health Aggregated cluster health.
|
|
status |
enum Status Cluster status.
|
|
network |
Network related configuration options. |
|
deletion_protection |
bool Deletion Protection inhibits deletion of the cluster. |
|
service_account_id |
string Service account used to access Cloud resources. |
|
logging |
Cloud logging configuration. |
|
coordinator_url |
string Address of Trino Coordinator. |
|
maintenance_window |
Window of maintenance operations. |
|
planned_operation |
Maintenance operation planned at nearest maintenance_window. |
Monitoring
Monitoring system.
|
Field |
Description |
|
name |
string Name of the monitoring system. |
|
description |
string Description of the monitoring system. |
|
link |
string Link to the monitoring system. |
TrinoConfig
|
Field |
Description |
|
coordinator_config |
Required field. Configuration for the coordinator, specifying computational resources and other settings. |
|
worker_config |
Required field. Configuration for worker nodes, including scaling policy and computational resources. |
|
version |
string Version of Trino. |
|
retry_policy |
Configuration for retry policy, specifying the spooling storage destination and other settings. |
|
access_control |
Configuration for access control, specifying the fine-grained rules of accesses. |
|
tls |
Configuration for TLS. |
CoordinatorConfig
|
Field |
Description |
|
resources |
Required field. Configuration for computational resources assigned to the coordinator instance. |
Resources
|
Field |
Description |
|
resource_preset_id |
string Required field. ID of the preset for computational resources allocated to a instance (e.g., CPU, memory, etc.). |
WorkerConfig
|
Field |
Description |
|
resources |
Required field. Configuration for computational resources for worker instances. |
|
scale_policy |
Required field. Configuration for scaling policy for worker instances. |
WorkerScalePolicy
|
Field |
Description |
|
fixed_scale |
A fixed scaling policy that specifies a fixed number of worker instances. Includes only one of the fields Defines the scaling type for worker instances. |
|
auto_scale |
A scaling policy that dynamically adjusts the number of worker instances Includes only one of the fields Defines the scaling type for worker instances. |
FixedScalePolicy
|
Field |
Description |
|
count |
int64 Specifies the number of worker instances. |
AutoScalePolicy
|
Field |
Description |
|
min_count |
int64 |
|
max_count |
int64 |
RetryPolicyConfig
|
Field |
Description |
|
policy |
enum RetryPolicy Retry policy level.
|
|
exchange_manager |
Configuration for exchange manager. |
|
additional_properties |
object (map<string, string>) Additional properties. |
ExchangeManagerConfig
|
Field |
Description |
|
additional_properties |
object (map<string, string>) Additional properties. |
|
storage |
ExchangeManagerStorage
|
Field |
Description |
|
service_s3 |
Use service side s3 bucket for exchange manager. Includes only one of the fields |
ServiceS3
|
Field |
Description |
|
Empty |
|
AccessControlConfig
|
Field |
Description |
|
catalogs[] |
Catalog access control rules. |
|
schemas[] |
Schema access control rules. |
|
tables[] |
Table access control rules. |
|
functions[] |
Function access control rules. |
|
procedures[] |
Procedures access control rules. |
|
queries[] |
Queries access control rules. |
|
system_session_properties[] |
SystemSessionPropertyAccessRule System session property access control rules. |
|
catalog_session_properties[] |
CatalogSessionPropertyAccessRule Catalog session property access control rules. |
CatalogAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
permission |
enum Permission Required field. Permission granted by the rule.
|
|
description |
string Rule description. |
CatalogAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Catalog name regexp the rule is applied to. Includes only one of the fields |
|
ids |
Catalog IDs rule is applied to. Includes only one of the fields |
|
names |
Catalog names rule is applied to. Includes only one of the fields |
CatalogIds
|
Field |
Description |
|
any[] |
string |
CatalogNames
|
Field |
Description |
|
any[] |
string |
SchemaAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
schema |
Schema matcher specifying what schemas the rule is applied to. |
|
owner |
enum Owner Required field. Ownership granted by the rule.
|
|
description |
string Rule description. |
SchemaAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Schema name regexp the rule is applied to. Includes only one of the fields |
|
names |
Schema names the rule is applied to. Includes only one of the fields |
SchemaNames
|
Field |
Description |
|
any[] |
string |
TableAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
schema |
Schema matcher specifying what schemas the rule is applied to. |
|
table |
Table matcher specifying what tables the rule is applied to. |
|
privileges[] |
enum Privilege Permission granted by the rule.
|
|
columns[] |
Column rules. |
|
filter |
string Boolean SQL expression to filter table rows for particular user. |
|
description |
string Rule description. |
TableAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Table name regexp the rule is applied to. Includes only one of the fields |
|
names |
Table names the rule is applied to. Includes only one of the fields |
TableNames
|
Field |
Description |
|
any[] |
string |
Column
|
Field |
Description |
|
name |
string Required field. Column name. |
|
access |
enum AccessMode Required field. Column access mode.
|
|
mask |
string SQL expression mask to evaluate instead of original column values. |
FunctionAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
schema |
Schema matcher specifying what schema the rule is applied to. |
|
function |
Function matcher specifying what functions the rule is applied to. |
|
privileges[] |
enum Privilege Privileges granted by the rule.
|
|
description |
string Rule description. |
FunctionAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Function name regexp the rule is applied to. Includes only one of the fields |
|
names |
Function names the rule is applied to. Includes only one of the fields |
FunctionNames
|
Field |
Description |
|
any[] |
string |
ProcedureAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
schema |
Schema matcher specifying what schema the rule is applied to. |
|
procedure |
Procedure matcher specifying what functions the rule is applied to. |
|
privileges[] |
enum Privilege Privileges granted by the rule.
|
|
description |
string Rule description. |
ProcedureAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Procedure name regexp the rule is applied to. Includes only one of the fields |
|
names |
Procedure names the rule is applied to. Includes only one of the fields |
ProcedureNames
|
Field |
Description |
|
any[] |
string |
QueryAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
query_owners[] |
string Owners of queries the rule is applied to. |
|
privileges[] |
enum Privilege Privileges granted by the user.
|
|
description |
string Rule description. |
SystemSessionPropertyAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
property |
Property matcher specifying what properties the rule is applied to. |
|
allow |
enum Allow Required field. Whether the rule allows setting the property.
|
|
description |
string Rule description. |
PropertyAccessRuleMatcher
|
Field |
Description |
|
name_regexp |
string Property name regexp the rule is applied to. Includes only one of the fields |
|
names |
Property names the rule is applied to. Includes only one of the fields |
PropertyNames
|
Field |
Description |
|
any[] |
string |
CatalogSessionPropertyAccessRule
|
Field |
Description |
|
users[] |
string IAM user IDs the rule is applied to. |
|
groups[] |
string IAM group IDs the rule is applied to. |
|
catalog |
Catalog matcher specifying what catalogs the rule is applied to. |
|
property |
Property matcher specifying what properties the rule is applied to. |
|
allow |
enum Allow Required field. Whether the rule allows setting the property.
|
|
description |
string Rule description. |
TLSConfig
|
Field |
Description |
|
trusted_certificates[] |
string Trusted CA-certificates. Each element should contain single self-signed CA-certificate or |
NetworkConfig
|
Field |
Description |
|
subnet_ids[] |
string IDs of VPC network subnets where instances of the cluster are attached. |
|
security_group_ids[] |
string User security groups. |
LoggingConfig
|
Field |
Description |
|
enabled |
bool Logs generated by the Trino components are delivered to Cloud Logging. |
|
folder_id |
string Logs should be written to default log group for specified folder. Includes only one of the fields Destination of log records. |
|
log_group_id |
string Logs should be written to log group resolved by ID. Includes only one of the fields Destination of log records. |
|
min_level |
enum Level Minimum log entry level. See LogLevel.Level for details.
|
MaintenanceWindow
|
Field |
Description |
|
anytime |
Includes only one of the fields |
|
weekly_maintenance_window |
Includes only one of the fields |
AnytimeMaintenanceWindow
|
Field |
Description |
|
Empty |
|
WeeklyMaintenanceWindow
|
Field |
Description |
|
day |
enum WeekDay
|
|
hour |
int64 Hour of the day in UTC. |
MaintenanceOperation
|
Field |
Description |
|
info |
string |
|
delayed_until |
|
|
latest_maintenance_time |
|
|
next_maintenance_window_time |