Managed Service for Trino API, REST: Cluster.Update
- HTTP request
- Path parameters
- Body parameters
- UpdateTrinoConfigSpec
- UpdateCoordinatorConfig
- Resources
- UpdateWorkerConfig
- WorkerScalePolicy
- FixedScalePolicy
- AutoScalePolicy
- RetryPolicyConfig
- ExchangeManagerConfig
- ExchangeManagerStorage
- AccessControlConfig
- CatalogAccessRule
- CatalogAccessRuleMatcher
- CatalogIds
- CatalogNames
- SchemaAccessRule
- SchemaAccessRuleMatcher
- SchemaNames
- TableAccessRule
- TableAccessRuleMatcher
- TableNames
- Column
- FunctionAccessRule
- FunctionAccessRuleMatcher
- FunctionNames
- ProcedureAccessRule
- ProcedureAccessRuleMatcher
- ProcedureNames
- QueryAccessRule
- SystemSessionPropertyAccessRule
- PropertyAccessRuleMatcher
- PropertyNames
- CatalogSessionPropertyAccessRule
- UpdateNetworkConfigSpec
- LoggingConfig
- MaintenanceWindow
- WeeklyMaintenanceWindow
- Response
- UpdateClusterMetadata
- Status
- Cluster
- Monitoring
- TrinoConfig
- CoordinatorConfig
- Resources
- WorkerConfig
- WorkerScalePolicy
- FixedScalePolicy
- AutoScalePolicy
- RetryPolicyConfig
- ExchangeManagerConfig
- ExchangeManagerStorage
- AccessControlConfig
- CatalogAccessRule
- CatalogAccessRuleMatcher
- CatalogIds
- CatalogNames
- SchemaAccessRule
- SchemaAccessRuleMatcher
- SchemaNames
- TableAccessRule
- TableAccessRuleMatcher
- TableNames
- Column
- FunctionAccessRule
- FunctionAccessRuleMatcher
- FunctionNames
- ProcedureAccessRule
- ProcedureAccessRuleMatcher
- ProcedureNames
- QueryAccessRule
- SystemSessionPropertyAccessRule
- PropertyAccessRuleMatcher
- PropertyNames
- CatalogSessionPropertyAccessRule
- NetworkConfig
- LoggingConfig
- MaintenanceWindow
- WeeklyMaintenanceWindow
- MaintenanceOperation
Updates configuration of the specified Trino cluster.
HTTP request
PATCH https://trino.api.cloud.yandex.net/managed-trino/v1/clusters/{clusterId}
Path parameters
|
Field |
Description |
|
clusterId |
string Required field. ID of the Trino cluster. |
Body parameters
{
"updateMask": "string",
"name": "string",
"description": "string",
"labels": "object",
"deletionProtection": "boolean",
"trino": {
"coordinatorConfig": {
"resources": {
"resourcePresetId": "string"
}
},
"workerConfig": {
"resources": {
"resourcePresetId": "string"
},
"scalePolicy": {
// Includes only one of the fields `fixedScale`, `autoScale`
"fixedScale": {
"count": "string"
},
"autoScale": {
"minCount": "string",
"maxCount": "string"
}
// end of the list of possible fields
}
},
"version": "string",
"retryPolicy": {
"policy": "string",
"exchangeManager": {
"additionalProperties": "object",
"storage": {
// Includes only one of the fields `serviceS3`
"serviceS3": "object"
// end of the list of possible fields
}
},
"additionalProperties": "object"
},
"accessControl": {
"catalogs": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"permission": "string",
"description": "string"
}
],
"schemas": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"owner": "string",
"description": "string"
}
],
"tables": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"table": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"string"
],
"columns": [
{
"name": "string",
"access": "string",
"mask": "string"
}
],
"filter": "string",
"description": "string"
}
],
"functions": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"function": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"string"
],
"description": "string"
}
],
"procedures": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"procedure": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"string"
],
"description": "string"
}
],
"queries": [
{
"users": [
"string"
],
"groups": [
"string"
],
"queryOwners": [
"string"
],
"privileges": [
"string"
],
"description": "string"
}
],
"systemSessionProperties": [
{
"users": [
"string"
],
"groups": [
"string"
],
"property": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"allow": "string",
"description": "string"
}
],
"catalogSessionProperties": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"property": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"allow": "string",
"description": "string"
}
]
}
},
"networkSpec": {
"securityGroupIds": [
"string"
]
},
"serviceAccountId": "string",
"logging": {
"enabled": "boolean",
// Includes only one of the fields `folderId`, `logGroupId`
"folderId": "string",
"logGroupId": "string",
// end of the list of possible fields
"minLevel": "string"
},
"maintenanceWindow": {
// Includes only one of the fields `anytime`, `weeklyMaintenanceWindow`
"anytime": "object",
"weeklyMaintenanceWindow": {
"day": "string",
"hour": "string"
}
// end of the list of possible fields
}
}
|
Field |
Description |
|
updateMask |
string (field-mask) A comma-separated names off ALL fields to be updated. If |
|
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 |
|
deletionProtection |
boolean Deletion Protection inhibits deletion of the cluster. |
|
trino |
Configuration of Trino components. |
|
networkSpec |
Network related configuration options. |
|
serviceAccountId |
string Service account used to access Cloud resources. |
|
logging |
Cloud logging configuration. |
|
maintenanceWindow |
Window of maintenance operations. |
UpdateTrinoConfigSpec
|
Field |
Description |
|
coordinatorConfig |
Configuration for the coordinator, specifying computational resources and other settings. |
|
workerConfig |
Configuration for worker nodes, including scaling policy and computational resources. |
|
version |
string Trino version. |
|
retryPolicy |
Configuration for retry policy, specifying the spooling storage destination and other settings. |
|
accessControl |
Configuration for access control, specifying the fine-grained access rules. |
UpdateCoordinatorConfig
|
Field |
Description |
|
resources |
Configuration for computational resources assigned to the coordinator instance. |
Resources
|
Field |
Description |
|
resourcePresetId |
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. |
|
scalePolicy |
Configuration for scaling policy for worker instances. |
WorkerScalePolicy
|
Field |
Description |
|
fixedScale |
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. |
|
autoScale |
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 |
string (int64) Specifies the number of worker instances. |
AutoScalePolicy
|
Field |
Description |
|
minCount |
string (int64) |
|
maxCount |
string (int64) |
RetryPolicyConfig
|
Field |
Description |
|
policy |
enum (RetryPolicy) Retry policy level.
|
|
exchangeManager |
Configuration for exchange manager. |
|
additionalProperties |
object (map<string, string>) Additional properties. |
ExchangeManagerConfig
|
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 |
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. |
|
systemSessionProperties[] |
SystemSessionPropertyAccessRule System session property access control rules. |
|
catalogSessionProperties[] |
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 |
|
nameRegexp |
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 |
|
nameRegexp |
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 |
|
nameRegexp |
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 |
|
nameRegexp |
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 |
|
nameRegexp |
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. |
|
queryOwners[] |
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 |
|
nameRegexp |
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. |
UpdateNetworkConfigSpec
|
Field |
Description |
|
securityGroupIds[] |
string User security groups. |
LoggingConfig
|
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 Destination of log records. |
|
logGroupId |
string Logs should be written to log group resolved by ID. Includes only one of the fields Destination of log records. |
|
minLevel |
enum (Level) Minimum log entry level. See LogLevel.Level for details.
|
MaintenanceWindow
|
Field |
Description |
|
anytime |
object Includes only one of the fields |
|
weeklyMaintenanceWindow |
Includes only one of the fields |
WeeklyMaintenanceWindow
|
Field |
Description |
|
day |
enum (WeekDay)
|
|
hour |
string (int64) Hour of the day in UTC. |
Response
HTTP Code: 200 - OK
{
"id": "string",
"description": "string",
"createdAt": "string",
"createdBy": "string",
"modifiedAt": "string",
"done": "boolean",
"metadata": {
"clusterId": "string"
},
// Includes only one of the fields `error`, `response`
"error": {
"code": "integer",
"message": "string",
"details": [
"object"
]
},
"response": {
"id": "string",
"folderId": "string",
"createdAt": "string",
"name": "string",
"description": "string",
"labels": "object",
"monitoring": [
{
"name": "string",
"description": "string",
"link": "string"
}
],
"trino": {
"coordinatorConfig": {
"resources": {
"resourcePresetId": "string"
}
},
"workerConfig": {
"resources": {
"resourcePresetId": "string"
},
"scalePolicy": {
// Includes only one of the fields `fixedScale`, `autoScale`
"fixedScale": {
"count": "string"
},
"autoScale": {
"minCount": "string",
"maxCount": "string"
}
// end of the list of possible fields
}
},
"version": "string",
"retryPolicy": {
"policy": "string",
"exchangeManager": {
"additionalProperties": "object",
"storage": {
// Includes only one of the fields `serviceS3`
"serviceS3": "object"
// end of the list of possible fields
}
},
"additionalProperties": "object"
},
"accessControl": {
"catalogs": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"permission": "string",
"description": "string"
}
],
"schemas": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"owner": "string",
"description": "string"
}
],
"tables": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"table": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"string"
],
"columns": [
{
"name": "string",
"access": "string",
"mask": "string"
}
],
"filter": "string",
"description": "string"
}
],
"functions": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"function": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"string"
],
"description": "string"
}
],
"procedures": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"schema": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"procedure": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"privileges": [
"string"
],
"description": "string"
}
],
"queries": [
{
"users": [
"string"
],
"groups": [
"string"
],
"queryOwners": [
"string"
],
"privileges": [
"string"
],
"description": "string"
}
],
"systemSessionProperties": [
{
"users": [
"string"
],
"groups": [
"string"
],
"property": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"allow": "string",
"description": "string"
}
],
"catalogSessionProperties": [
{
"users": [
"string"
],
"groups": [
"string"
],
"catalog": {
// Includes only one of the fields `nameRegexp`, `ids`, `names`
"nameRegexp": "string",
"ids": {
"any": [
"string"
]
},
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"property": {
// Includes only one of the fields `nameRegexp`, `names`
"nameRegexp": "string",
"names": {
"any": [
"string"
]
}
// end of the list of possible fields
},
"allow": "string",
"description": "string"
}
]
}
},
"health": "string",
"status": "string",
"network": {
"subnetIds": [
"string"
],
"securityGroupIds": [
"string"
]
},
"deletionProtection": "boolean",
"serviceAccountId": "string",
"logging": {
"enabled": "boolean",
// Includes only one of the fields `folderId`, `logGroupId`
"folderId": "string",
"logGroupId": "string",
// end of the list of possible fields
"minLevel": "string"
},
"coordinatorUrl": "string",
"maintenanceWindow": {
// Includes only one of the fields `anytime`, `weeklyMaintenanceWindow`
"anytime": "object",
"weeklyMaintenanceWindow": {
"day": "string",
"hour": "string"
}
// end of the list of possible fields
},
"plannedOperation": {
"info": "string",
"delayedUntil": "string",
"latestMaintenanceTime": "string",
"nextMaintenanceWindowTime": "string"
}
}
// 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. |
|
createdAt |
string (date-time) Creation timestamp. String in RFC3339 To work with values in this field, use the APIs described in the |
|
createdBy |
string ID of the user or service account who initiated the operation. |
|
modifiedAt |
string (date-time) The time when the Operation resource was last modified. String in RFC3339 To work with values in this field, use the APIs described in the |
|
done |
boolean 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 |
|
clusterId |
string ID of the Trino cluster that is being updated. |
Status
The error result of the operation in case of failure or cancellation.
|
Field |
Description |
|
code |
integer (int32) Error code. An enum value of google.rpc.Code |
|
message |
string An error message. |
|
details[] |
object A list of messages that carry the error details. |
Cluster
Trino cluster.
|
Field |
Description |
|
id |
string Unique ID of the 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 To work with values in this field, use the APIs described in the |
|
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. |
|
deletionProtection |
boolean Deletion Protection inhibits deletion of the cluster. |
|
serviceAccountId |
string Service account used to access Cloud resources. |
|
logging |
Cloud logging configuration. |
|
coordinatorUrl |
string Address of Trino Coordinator. |
|
maintenanceWindow |
Window of maintenance operations. |
|
plannedOperation |
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 |
|
coordinatorConfig |
Required field. Configuration for the coordinator, specifying computational resources and other settings. |
|
workerConfig |
Required field. Configuration for worker nodes, including scaling policy and computational resources. |
|
version |
string Version of Trino. |
|
retryPolicy |
Configuration for retry policy, specifying the spooling storage destination and other settings. |
|
accessControl |
Configuration for access control, specifying the fine-grained rules of accesses. |
CoordinatorConfig
|
Field |
Description |
|
resources |
Required field. Configuration for computational resources assigned to the coordinator instance. |
Resources
|
Field |
Description |
|
resourcePresetId |
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. |
|
scalePolicy |
Required field. Configuration for scaling policy for worker instances. |
WorkerScalePolicy
|
Field |
Description |
|
fixedScale |
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. |
|
autoScale |
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 |
string (int64) Specifies the number of worker instances. |
AutoScalePolicy
|
Field |
Description |
|
minCount |
string (int64) |
|
maxCount |
string (int64) |
RetryPolicyConfig
|
Field |
Description |
|
policy |
enum (RetryPolicy) Retry policy level.
|
|
exchangeManager |
Configuration for exchange manager. |
|
additionalProperties |
object (map<string, string>) Additional properties. |
ExchangeManagerConfig
|
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 |
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. |
|
systemSessionProperties[] |
SystemSessionPropertyAccessRule System session property access control rules. |
|
catalogSessionProperties[] |
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 |
|
nameRegexp |
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 |
|
nameRegexp |
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 |
|
nameRegexp |
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 |
|
nameRegexp |
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 |
|
nameRegexp |
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. |
|
queryOwners[] |
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 |
|
nameRegexp |
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. |
NetworkConfig
|
Field |
Description |
|
subnetIds[] |
string IDs of VPC network subnets where instances of the cluster are attached. |
|
securityGroupIds[] |
string User security groups. |
LoggingConfig
|
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 Destination of log records. |
|
logGroupId |
string Logs should be written to log group resolved by ID. Includes only one of the fields Destination of log records. |
|
minLevel |
enum (Level) Minimum log entry level. See LogLevel.Level for details.
|
MaintenanceWindow
|
Field |
Description |
|
anytime |
object Includes only one of the fields |
|
weeklyMaintenanceWindow |
Includes only one of the fields |
WeeklyMaintenanceWindow
|
Field |
Description |
|
day |
enum (WeekDay)
|
|
hour |
string (int64) Hour of the day in UTC. |
MaintenanceOperation
|
Field |
Description |
|
info |
string |
|
delayedUntil |
string (date-time) String in RFC3339 To work with values in this field, use the APIs described in the |
|
latestMaintenanceTime |
string (date-time) String in RFC3339 To work with values in this field, use the APIs described in the |
|
nextMaintenanceWindowTime |
string (date-time) String in RFC3339 To work with values in this field, use the APIs described in the |