Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
Проект Яндекса
© 2023 ООО «Яндекс.Облако»
Yandex Managed Service for MySQL®
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Информация об имеющихся кластерах
    • Создание кластера
    • Подключение к базе данных
    • Остановка и запуск кластера
    • SQL-запросы в консоли управления
    • Изменение кластера
    • Подключение к DataLens
    • Управление хостами MySQL
    • Управление базами данных
    • Управление пользователями
    • Управление правами пользователей
    • Управление резервными копиями
    • Просмотр логов кластера
    • Удаление кластера
    • Диагностика производительности
    • Мониторинг состояния кластера и хостов
  • Концепции
    • Взаимосвязь ресурсов сервиса
    • Классы хостов
      • Действующие классы хостов
      • Архив
        • До 1 июня 2020 года
      • Использование устаревших классов хостов
    • Сеть в Managed Service for MySQL
    • Квоты и лимиты
    • Типы дисков
    • Резервные копии
    • Репликация
    • Техническое обслуживание
    • Права пользователей
    • Настройки MySQL
    • Ограничения для команд SQL
  • Практические руководства
    • Все сценарии
    • Анализ производительности и оптимизация Managed Service for MySQL
    • Выгрузка базы данных в Yandex Data Proc
    • Миграция базы данных из стороннего кластера MySQL
    • Миграция базы данных из Managed Service for MySQL в MySQL
    • Поставка данных в Yandex Managed Service for Apache Kafka® с помощью Yandex Data Transfer
    • Поставка данных в Yandex Managed Service for Apache Kafka® с помощью Debezium
    • Миграция базы данных в Yandex Managed Service for YDB с помощью Yandex Data Transfer
    • Миграция базы данных из Managed Service for MySQL в Yandex Object Storage
  • Управление доступом
  • Правила тарификации
    • Действующие правила
    • Архив
      • До 1 февраля 2020 года
  • Справочник API
    • Аутентификация в API
    • gRPC (англ.)
      • Overview
      • BackupService
      • ClusterService
      • DatabaseService
      • ResourcePresetService
      • UserService
      • OperationService
    • REST (англ.)
      • Overview
      • Backup
        • Overview
        • get
        • list
      • Cluster
        • Overview
        • addHosts
        • backup
        • create
        • delete
        • deleteHosts
        • get
        • list
        • listBackups
        • listHosts
        • listLogs
        • listOperations
        • move
        • rescheduleMaintenance
        • restore
        • start
        • startFailover
        • stop
        • streamLogs
        • update
        • updateHosts
      • Database
        • Overview
        • create
        • delete
        • get
        • list
      • ResourcePreset
        • Overview
        • get
        • list
      • User
        • Overview
        • create
        • delete
        • get
        • grantPermission
        • list
        • revokePermission
        • update
      • Operation
        • Overview
        • get
  • История изменений
  • Вопросы и ответы
    • Общие вопросы
    • Вопросы о MySQL
    • Подключение
    • Проблемы с чтением/записью в кластер
    • Проблемы с производительностью
    • Изменение кластера
    • Мониторинг и логи
    • Миграция/перенос
    • Настройки параметров MySQL
    • Все вопросы на одной странице
  1. Справочник API
  2. gRPC (англ.)
  3. ClusterService

Managed Service for MySQL API, gRPC: ClusterService

Статья создана
Yandex Cloud
  • Calls ClusterService
  • Get
    • GetClusterRequest
    • Cluster
    • Monitoring
    • ClusterConfig
    • Resources
    • Access
    • PerformanceDiagnostics
    • MaintenanceWindow
    • AnytimeMaintenanceWindow
    • WeeklyMaintenanceWindow
    • MaintenanceOperation
  • List
    • ListClustersRequest
    • ListClustersResponse
    • Cluster
    • Monitoring
    • ClusterConfig
    • Resources
    • Access
    • PerformanceDiagnostics
    • MaintenanceWindow
    • AnytimeMaintenanceWindow
    • WeeklyMaintenanceWindow
    • MaintenanceOperation
  • Create
    • CreateClusterRequest
    • ConfigSpec
    • Resources
    • Access
    • PerformanceDiagnostics
    • DatabaseSpec
    • UserSpec
    • Permission
    • ConnectionLimits
    • HostSpec
    • Operation
    • CreateClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • MaintenanceWindow
    • AnytimeMaintenanceWindow
    • WeeklyMaintenanceWindow
    • MaintenanceOperation
  • Update
    • UpdateClusterRequest
    • ConfigSpec
    • Resources
    • Access
    • PerformanceDiagnostics
    • MaintenanceWindow
    • AnytimeMaintenanceWindow
    • WeeklyMaintenanceWindow
    • Operation
    • UpdateClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • MaintenanceOperation
  • Delete
    • DeleteClusterRequest
    • Operation
    • DeleteClusterMetadata
  • Start
    • StartClusterRequest
    • Operation
    • StartClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • Resources
    • Access
    • PerformanceDiagnostics
    • MaintenanceWindow
    • AnytimeMaintenanceWindow
    • WeeklyMaintenanceWindow
    • MaintenanceOperation
  • Stop
    • StopClusterRequest
    • Operation
    • StopClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • Resources
    • Access
    • PerformanceDiagnostics
    • MaintenanceWindow
    • AnytimeMaintenanceWindow
    • WeeklyMaintenanceWindow
    • MaintenanceOperation
  • Move
    • MoveClusterRequest
    • Operation
    • MoveClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • Resources
    • Access
    • PerformanceDiagnostics
    • MaintenanceWindow
    • AnytimeMaintenanceWindow
    • WeeklyMaintenanceWindow
    • MaintenanceOperation
  • Backup
    • BackupClusterRequest
    • Operation
    • BackupClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • Resources
    • Access
    • PerformanceDiagnostics
    • MaintenanceWindow
    • AnytimeMaintenanceWindow
    • WeeklyMaintenanceWindow
    • MaintenanceOperation
  • Restore
    • RestoreClusterRequest
    • ConfigSpec
    • Resources
    • Access
    • PerformanceDiagnostics
    • HostSpec
    • Operation
    • RestoreClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • MaintenanceWindow
    • AnytimeMaintenanceWindow
    • WeeklyMaintenanceWindow
    • MaintenanceOperation
  • RescheduleMaintenance
    • RescheduleMaintenanceRequest
    • Operation
    • RescheduleMaintenanceMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • Resources
    • Access
    • PerformanceDiagnostics
    • MaintenanceWindow
    • AnytimeMaintenanceWindow
    • WeeklyMaintenanceWindow
    • MaintenanceOperation
  • StartFailover
    • StartClusterFailoverRequest
    • Operation
    • StartClusterFailoverMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • Resources
    • Access
    • PerformanceDiagnostics
    • MaintenanceWindow
    • AnytimeMaintenanceWindow
    • WeeklyMaintenanceWindow
    • MaintenanceOperation
  • ListLogs
    • ListClusterLogsRequest
    • ListClusterLogsResponse
    • LogRecord
  • StreamLogs
    • StreamClusterLogsRequest
    • StreamLogRecord
    • LogRecord
  • ListOperations
    • ListClusterOperationsRequest
    • ListClusterOperationsResponse
    • Operation
  • ListBackups
    • ListClusterBackupsRequest
    • ListClusterBackupsResponse
    • Backup
  • ListHosts
    • ListClusterHostsRequest
    • ListClusterHostsResponse
    • Host
    • Resources
    • Service
  • AddHosts
    • AddClusterHostsRequest
    • HostSpec
    • Operation
    • AddClusterHostsMetadata
  • UpdateHosts
    • UpdateClusterHostsRequest
    • UpdateHostSpec
    • Operation
    • UpdateClusterHostsMetadata
  • DeleteHosts
    • DeleteClusterHostsRequest
    • Operation
    • DeleteClusterHostsMetadata

A set of methods for managing MySQL clusters.

Call Description
Get Retrieves information about a cluster.
List Retrieves the list of clusters in a folder.
Create Creates a cluster in a folder.
Update Updates a cluster.
Delete Deletes a cluster.
Start Starts a cluster.
Stop Stops a cluster.
Move Moves a cluster to a folder.
Backup Creates a backup for a cluster.
Restore Restores a backup to a new cluster.
RescheduleMaintenance Reschedules planned maintenance operation.
StartFailover Starts a manual failover for a cluster.
ListLogs Retrieves logs for a cluster.
StreamLogs Retrieves a log stream for a cluster.
ListOperations Retrieves a list of operations for a cluster.
ListBackups Retrieves a list of backups for a cluster.
ListHosts Retrieves a list of hosts for a cluster.
AddHosts Adds new hosts in a cluster.
UpdateHosts Updates the specified hosts.
DeleteHosts Deletes the specified hosts for a cluster.

Calls ClusterService

Get

Retrieves information about a cluster.

rpc Get (GetClusterRequest) returns (Cluster)

GetClusterRequest

Field Description
cluster_id string
Required. ID of the cluster to return information about.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.

Cluster

Field Description
id string
ID of the cluster.
This ID is assigned by the platform at the time of creation.
folder_id string
ID of the folder that the cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp of the cluster.
name string
Name of the cluster.
description string
Description of the cluster.
labels map<string,string>
Custom labels for the cluster as key:value pairs.
environment enum Environment
Deployment environment of the cluster.
  • PRODUCTION: Environment for stable versions of your apps. A conservative update policy is in effect: only bug fixes are applied during regular maintenance.
  • PRESTABLE: Environment for testing, including the Managed Service for MySQL itself. This environment gets new features, improvements, and bug fixes in the first place, compared to the production environment. However, not every update ensures backward compatibility.
monitoring[] Monitoring
Monitoring systems data that is relevant to the cluster.
config ClusterConfig
Configuration of the cluster.
network_id string
ID of the network that the cluster belongs to.
health enum Health
Aggregated health of the cluster.
  • HEALTH_UNKNOWN: Health of the cluster is unknown (Host.health for every host in the cluster is UNKNOWN).
  • ALIVE: Cluster is alive and well (Host.health for every host in the cluster is ALIVE).
  • DEAD: Cluster is inoperable (Host.health for every host in the cluster is DEAD).
  • DEGRADED: Cluster is degraded (Host.health for at least one host in the cluster is not ALIVE).
status enum Status
Current state of the cluster.
  • STATUS_UNKNOWN: Cluster state is unknown.
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running normally.
  • ERROR: Cluster encountered a problem and cannot operate.
  • UPDATING: Cluster is being updated.
  • STOPPING: Cluster is stopping.
  • STOPPED: Cluster is stopped.
  • STARTING: Cluster is starting.
maintenance_window MaintenanceWindow
Maintenance window settings for the cluster.
planned_operation MaintenanceOperation
Planned maintenance operation to be started for the cluster within the nearest maintenance_window.
security_group_ids[] string
Effective list of security group IDs applied to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

Monitoring

Field Description
name string
Name of the monitoring system.
description string
Description of the monitoring system.
link string
Link to the monitoring system charts for the cluster.

ClusterConfig

Field Description
version string
Version of MySQL used in the cluster.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfigSet5_7
Configuration of a MySQL 5.7 server.
  mysql_config_8_0 config.MysqlConfigSet8_0
Configuration of a MySQL 8.0 server.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Access

Field Description
data_lens bool
Allows access from DataLens.
See the documentation for details.
web_sql bool
Allows SQL queries to the cluster databases from management console.
See the documentation for details.
data_transfer bool
Allow access for DataTransfer.

PerformanceDiagnostics

Field Description
enabled bool
Flag that shows if performance statistics gathering is enabled for the cluster.
sessions_sampling_interval int64
Interval (in seconds) for my_session sampling. Acceptable values are 1 to 86400, inclusive.
statements_sampling_interval int64
Interval (in seconds) for my_statements sampling. Acceptable values are 1 to 86400, inclusive.

MaintenanceWindow

Field Description
policy oneof: anytime or weekly_maintenance_window
The maintenance policy in effect.
  anytime AnytimeMaintenanceWindow
Maintenance operation can be scheduled anytime.
  weekly_maintenance_window WeeklyMaintenanceWindow
Maintenance operation can be scheduled on a weekly basis.

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

Field Description
day enum WeekDay
Day of the week (in DDD format).
hour int64
Hour of the day in UTC (in HH format). Acceptable values are 1 to 24, inclusive.

MaintenanceOperation

Field Description
info string
Information about this maintenance operation. The maximum string length in characters is 256.
delayed_until google.protobuf.Timestamp
Time until which this maintenance operation is delayed.

List

Retrieves the list of clusters in a folder.

rpc List (ListClustersRequest) returns (ListClustersResponse)

ListClustersRequest

Field Description
folder_id string
Required. ID of the folder to list clusters in.
To get this ID, make a yandex.cloud.resourcemanager.v1.FolderService.List request. The maximum string length in characters is 50.
page_size int64
The maximum number of results per page to return.
If the number of available results is larger than page_size, the API returns a ListClustersResponse.next_page_token that can be used to get the next page of results in the subsequent ClusterService.List requests. Acceptable values are 0 to 1000, inclusive.
page_token string
Page token that can be used to iterate through multiple pages of results.
To get the next page of results, set page_token to the ListClustersResponse.next_page_token returned by the previous ClusterService.List request. The maximum string length in characters is 100.
filter string
A filter expression that selects clusters listed in the response.
The expression must specify:
  1. The field name. Currently you can only use filtering with the Cluster.name field.
  2. An = operator.
  3. The value in double quotes ("). Must be 1-63 characters long and match the regular expression [a-zA-Z0-9_-]+.
The maximum string length in characters is 1000.

ListClustersResponse

Field Description
clusters[] Cluster
List of clusters.
next_page_token string
The token that can be used to get the next page of results.
If the number of results is larger than ListClustersRequest.page_size, use the next_page_token as the value for the ListClustersRequest.page_token in the subsequent ClusterService.List request to iterate through multiple pages of results.
Each of the subsequent ClusterService.List requests should use the next_page_token value returned by the previous request to continue paging through the results.

Cluster

Field Description
id string
ID of the cluster.
This ID is assigned by the platform at the time of creation.
folder_id string
ID of the folder that the cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp of the cluster.
name string
Name of the cluster.
description string
Description of the cluster.
labels map<string,string>
Custom labels for the cluster as key:value pairs.
environment enum Environment
Deployment environment of the cluster.
  • PRODUCTION: Environment for stable versions of your apps. A conservative update policy is in effect: only bug fixes are applied during regular maintenance.
  • PRESTABLE: Environment for testing, including the Managed Service for MySQL itself. This environment gets new features, improvements, and bug fixes in the first place, compared to the production environment. However, not every update ensures backward compatibility.
monitoring[] Monitoring
Monitoring systems data that is relevant to the cluster.
config ClusterConfig
Configuration of the cluster.
network_id string
ID of the network that the cluster belongs to.
health enum Health
Aggregated health of the cluster.
  • HEALTH_UNKNOWN: Health of the cluster is unknown (Host.health for every host in the cluster is UNKNOWN).
  • ALIVE: Cluster is alive and well (Host.health for every host in the cluster is ALIVE).
  • DEAD: Cluster is inoperable (Host.health for every host in the cluster is DEAD).
  • DEGRADED: Cluster is degraded (Host.health for at least one host in the cluster is not ALIVE).
status enum Status
Current state of the cluster.
  • STATUS_UNKNOWN: Cluster state is unknown.
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running normally.
  • ERROR: Cluster encountered a problem and cannot operate.
  • UPDATING: Cluster is being updated.
  • STOPPING: Cluster is stopping.
  • STOPPED: Cluster is stopped.
  • STARTING: Cluster is starting.
maintenance_window MaintenanceWindow
Maintenance window settings for the cluster.
planned_operation MaintenanceOperation
Planned maintenance operation to be started for the cluster within the nearest maintenance_window.
security_group_ids[] string
Effective list of security group IDs applied to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

Monitoring

Field Description
name string
Name of the monitoring system.
description string
Description of the monitoring system.
link string
Link to the monitoring system charts for the cluster.

ClusterConfig

Field Description
version string
Version of MySQL used in the cluster.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfigSet5_7
Configuration of a MySQL 5.7 server.
  mysql_config_8_0 config.MysqlConfigSet8_0
Configuration of a MySQL 8.0 server.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Access

Field Description
data_lens bool
Allows access from DataLens.
See the documentation for details.
web_sql bool
Allows SQL queries to the cluster databases from management console.
See the documentation for details.
data_transfer bool
Allow access for DataTransfer.

PerformanceDiagnostics

Field Description
enabled bool
Flag that shows if performance statistics gathering is enabled for the cluster.
sessions_sampling_interval int64
Interval (in seconds) for my_session sampling. Acceptable values are 1 to 86400, inclusive.
statements_sampling_interval int64
Interval (in seconds) for my_statements sampling. Acceptable values are 1 to 86400, inclusive.

MaintenanceWindow

Field Description
policy oneof: anytime or weekly_maintenance_window
The maintenance policy in effect.
  anytime AnytimeMaintenanceWindow
Maintenance operation can be scheduled anytime.
  weekly_maintenance_window WeeklyMaintenanceWindow
Maintenance operation can be scheduled on a weekly basis.

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

Field Description
day enum WeekDay
Day of the week (in DDD format).
hour int64
Hour of the day in UTC (in HH format). Acceptable values are 1 to 24, inclusive.

MaintenanceOperation

Field Description
info string
Information about this maintenance operation. The maximum string length in characters is 256.
delayed_until google.protobuf.Timestamp
Time until which this maintenance operation is delayed.

Create

Creates a cluster in a folder.

rpc Create (CreateClusterRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:CreateClusterMetadata

    Operation.response:Cluster

CreateClusterRequest

Field Description
folder_id string
Required. ID of the folder to create the cluster in.
To get this ID, make a yandex.cloud.resourcemanager.v1.FolderService.List request. The maximum string length in characters is 50.
name string
Required. Name of the cluster. The name must be unique within the folder. The maximum string length in characters is 63. Value must match the regular expression [a-zA-Z0-9_-]*.
description string
Description of the cluster. The maximum string length in characters is 256.
labels map<string,string>
Custom labels for the cluster as key:value pairs. No more than 64 per resource. The maximum string length in characters for each value is 63. Each value must match the regular expression [-_0-9a-z]*. The string length in characters for each key must be 1-63. Each key must match the regular expression [a-z][-_0-9a-z]*.
environment Cluster.Environment
Deployment environment of the cluster.
config_spec ConfigSpec
Configuration of the cluster.
database_specs[] DatabaseSpec
Configuration of databases in the cluster.
user_specs[] UserSpec
Configuration of database users in the cluster.
host_specs[] HostSpec
Configuration of hosts in the cluster.
network_id string
ID of the network to create the cluster in. The maximum string length in characters is 50.
security_group_ids[] string
List of security group IDs to apply to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

ConfigSpec

Field Description
version string
Version of MySQL used in the cluster.
Possible values: 5.7, 8.0.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfig5_7
Configuration for a MySQL 5.7 cluster.
  mysql_config_8_0 config.MysqlConfig8_0
Configuration for a MySQL 8.0 cluster.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
If the specific services need to access the cluster, then set the necessary values in this policy.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Access

Field Description
data_lens bool
Allows access from DataLens.
See the documentation for details.
web_sql bool
Allows SQL queries to the cluster databases from management console.
See the documentation for details.
data_transfer bool
Allow access for DataTransfer.

PerformanceDiagnostics

Field Description
enabled bool
Flag that shows if performance statistics gathering is enabled for the cluster.
sessions_sampling_interval int64
Interval (in seconds) for my_session sampling. Acceptable values are 1 to 86400, inclusive.
statements_sampling_interval int64
Interval (in seconds) for my_statements sampling. Acceptable values are 1 to 86400, inclusive.

DatabaseSpec

Field Description
name string
Required. Name of the database. The maximum string length in characters is 63. Value must match the regular expression [a-zA-Z0-9_-]*.

UserSpec

Field Description
name string
Required. Name of the user. The maximum string length in characters is 32. Value must match the regular expression [a-zA-Z0-9_]*.
password string
Required. Password of the user. The string length in characters must be 8-128.
permissions[] Permission
Set of permissions granted to the user to access specific databases. One permission per database.
When a permission for a database is set, the user will have access to the database.
global_permissions[] enum GlobalPermission
Set of global permissions to grant to the user.
  • REPLICATION_CLIENT: Enables use of the SHOW MASTER STATUS, SHOW SLAVE STATUS, and SHOW BINARY LOGS statements.
  • REPLICATION_SLAVE: Enables the account to request updates that have been made to databases on the master server, using the SHOW SLAVE HOSTS, SHOW RELAYLOG EVENTS and SHOW BINLOG EVENTS statements.
  • PROCESS: Enables display of information about the the statements currently being performed by sessions (the set of threads executing within the server).
    The privilege enables use of SHOW PROCESSLIST or mysqladmin processlist to see threads belonging to other users. You can always see your own threads. The PROCESS privilege also enables use of SHOW ENGINE.
connection_limits ConnectionLimits
Set of user connection limits.
authentication_plugin enum AuthPlugin
User authentication plugin.
  • MYSQL_NATIVE_PASSWORD: Use Native Pluggable Authentication.
  • CACHING_SHA2_PASSWORD: Use Caching SHA-2 Pluggable Authentication.
  • SHA256_PASSWORD: Use SHA-256 Pluggable Authentication.

Permission

Field Description
database_name string
Name of the database that the permission grants access to.
roles[] enum Privilege
Roles granted to the user within the database.
See the documentation for details. The minimum number of elements is 1.
  • ALL_PRIVILEGES: All privileges that can be made available to the user.
  • ALTER: Altering tables.
  • ALTER_ROUTINE: Altering stored routines and functions.
  • CREATE: Creating tables or indexes.
  • CREATE_ROUTINE: Creating stored routines.
  • CREATE_TEMPORARY_TABLES: Creating temporary tables.
  • CREATE_VIEW: Creating views.
  • DELETE: Deleting tables.
  • DROP: Removing tables or views.
  • EVENT: Creating, altering, dropping, or displaying events for the Event Scheduler.
  • EXECUTE: Executing stored routines.
  • INDEX: Creating and removing indexes.
  • INSERT: Inserting rows into the database.
  • LOCK_TABLES: Using LOCK TABLES statement for tables available with SELECT privilege.
  • SELECT: Selecting rows from tables.
    Some SELECT statements can be allowed without the SELECT privilege. All statements that read column values require the SELECT privilege.
    See MySQL documentation for details.
  • SHOW_VIEW: Using the SHOW CREATE VIEW statement. Also needed for views used with EXPLAIN.
  • TRIGGER: Creating, removing, executing, or displaying triggers for a table.
  • UPDATE: Updating rows in the database.
  • REFERENCES: Creation of a foreign key constraint for the parent table.

ConnectionLimits

Field Description
max_questions_per_hour google.protobuf.Int64Value
The maximum permitted number of user questions per hour. The minimum value is 0.
max_updates_per_hour google.protobuf.Int64Value
The maximum permitted number of user updates per hour. The minimum value is 0.
max_connections_per_hour google.protobuf.Int64Value
The maximum permitted number of simultaneous client connections per hour. The minimum value is 0.
max_user_connections google.protobuf.Int64Value
The maximum number of simultaneous connections permitted to any given MySQL user account. The minimum value is 0.

HostSpec

Field Description
zone_id string
ID of the availability zone where the host resides.
To get a list of available zones, make the yandex.cloud.compute.v1.ZoneService.List request. The maximum string length in characters is 50.
subnet_id string
ID of the subnet to assign to the host.
This subnet should be a part of the cluster network (the network ID is specified in the ClusterService.CreateClusterRequest.network_id). The maximum string length in characters is 50.
assign_public_ip bool
Option that enables public IP address for the host so that the host can be accessed from the internet.
After a host has been created, this setting cannot be changed. To remove an assigned public IP address, or to assign a public IP address to a host without one, recreate the host with the appropriate assign_public_ip value set.
Possible values:
  • false - don't assign a public IP address to the host.
  • true - assign a public IP address to the host.
replication_source string
Host.name of the host to be used as the replication source (for cascading replication).
backup_priority int64
Host backup priority Acceptable values are 0 to 100, inclusive.
priority int64
Host master promotion priority Acceptable values are 0 to 100, inclusive.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<CreateClusterMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<Cluster>
if operation finished successfully.

CreateClusterMetadata

Field Description
cluster_id string
ID of the cluster that is being created.

Cluster

Field Description
id string
ID of the cluster.
This ID is assigned by the platform at the time of creation.
folder_id string
ID of the folder that the cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp of the cluster.
name string
Name of the cluster.
description string
Description of the cluster.
labels map<string,string>
Custom labels for the cluster as key:value pairs.
environment enum Environment
Deployment environment of the cluster.
  • PRODUCTION: Environment for stable versions of your apps. A conservative update policy is in effect: only bug fixes are applied during regular maintenance.
  • PRESTABLE: Environment for testing, including the Managed Service for MySQL itself. This environment gets new features, improvements, and bug fixes in the first place, compared to the production environment. However, not every update ensures backward compatibility.
monitoring[] Monitoring
Monitoring systems data that is relevant to the cluster.
config ClusterConfig
Configuration of the cluster.
network_id string
ID of the network that the cluster belongs to.
health enum Health
Aggregated health of the cluster.
  • HEALTH_UNKNOWN: Health of the cluster is unknown (Host.health for every host in the cluster is UNKNOWN).
  • ALIVE: Cluster is alive and well (Host.health for every host in the cluster is ALIVE).
  • DEAD: Cluster is inoperable (Host.health for every host in the cluster is DEAD).
  • DEGRADED: Cluster is degraded (Host.health for at least one host in the cluster is not ALIVE).
status enum Status
Current state of the cluster.
  • STATUS_UNKNOWN: Cluster state is unknown.
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running normally.
  • ERROR: Cluster encountered a problem and cannot operate.
  • UPDATING: Cluster is being updated.
  • STOPPING: Cluster is stopping.
  • STOPPED: Cluster is stopped.
  • STARTING: Cluster is starting.
maintenance_window MaintenanceWindow
Maintenance window settings for the cluster.
planned_operation MaintenanceOperation
Planned maintenance operation to be started for the cluster within the nearest maintenance_window.
security_group_ids[] string
Effective list of security group IDs applied to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

Monitoring

Field Description
name string
Name of the monitoring system.
description string
Description of the monitoring system.
link string
Link to the monitoring system charts for the cluster.

ClusterConfig

Field Description
version string
Version of MySQL used in the cluster.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfigSet5_7
Configuration of a MySQL 5.7 server.
  mysql_config_8_0 config.MysqlConfigSet8_0
Configuration of a MySQL 8.0 server.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

MaintenanceWindow

Field Description
policy oneof: anytime or weekly_maintenance_window
The maintenance policy in effect.
  anytime AnytimeMaintenanceWindow
Maintenance operation can be scheduled anytime.
  weekly_maintenance_window WeeklyMaintenanceWindow
Maintenance operation can be scheduled on a weekly basis.

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

Field Description
day enum WeekDay
Day of the week (in DDD format).
hour int64
Hour of the day in UTC (in HH format). Acceptable values are 1 to 24, inclusive.

MaintenanceOperation

Field Description
info string
Information about this maintenance operation. The maximum string length in characters is 256.
delayed_until google.protobuf.Timestamp
Time until which this maintenance operation is delayed.

Update

Updates a cluster.

rpc Update (UpdateClusterRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:UpdateClusterMetadata

    Operation.response:Cluster

UpdateClusterRequest

Field Description
cluster_id string
Required. ID of the cluster to update.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.
update_mask google.protobuf.FieldMask
Field mask that specifies which settings of the cluster should be updated.
description string
New description of the cluster. The maximum string length in characters is 256.
labels map<string,string>
New set of custom labels for the cluster as key:value pairs.
This set will completely replace the current one. To add a label, request the current label set with the ClusterService.Get request, then send an ClusterService.Update request with the new label added to the current set. No more than 64 per resource. The maximum string length in characters for each value is 63. Each value must match the regular expression [-_0-9a-z]*. The string length in characters for each key must be 1-63. Each key must match the regular expression [a-z][-_0-9a-z]*.
config_spec ConfigSpec
New configuration of the cluster.
name string
New name of the cluster. The maximum string length in characters is 63. Value must match the regular expression [a-zA-Z0-9_-]*.
maintenance_window MaintenanceWindow
Configuration of a maintenance window in an MySQL cluster.
security_group_ids[] string
New list of security group IDs to apply to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.

ConfigSpec

Field Description
version string
Version of MySQL used in the cluster.
Possible values: 5.7, 8.0.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfig5_7
Configuration for a MySQL 5.7 cluster.
  mysql_config_8_0 config.MysqlConfig8_0
Configuration for a MySQL 8.0 cluster.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
If the specific services need to access the cluster, then set the necessary values in this policy.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Access

Field Description
data_lens bool
Allows access from DataLens.
See the documentation for details.
web_sql bool
Allows SQL queries to the cluster databases from management console.
See the documentation for details.
data_transfer bool
Allow access for DataTransfer.

PerformanceDiagnostics

Field Description
enabled bool
Flag that shows if performance statistics gathering is enabled for the cluster.
sessions_sampling_interval int64
Interval (in seconds) for my_session sampling. Acceptable values are 1 to 86400, inclusive.
statements_sampling_interval int64
Interval (in seconds) for my_statements sampling. Acceptable values are 1 to 86400, inclusive.

MaintenanceWindow

Field Description
policy oneof: anytime or weekly_maintenance_window
The maintenance policy in effect.
  anytime AnytimeMaintenanceWindow
Maintenance operation can be scheduled anytime.
  weekly_maintenance_window WeeklyMaintenanceWindow
Maintenance operation can be scheduled on a weekly basis.

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

Field Description
day enum WeekDay
Day of the week (in DDD format).
hour int64
Hour of the day in UTC (in HH format). Acceptable values are 1 to 24, inclusive.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<UpdateClusterMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<Cluster>
if operation finished successfully.

UpdateClusterMetadata

Field Description
cluster_id string
ID of the cluster that is being updated.

Cluster

Field Description
id string
ID of the cluster.
This ID is assigned by the platform at the time of creation.
folder_id string
ID of the folder that the cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp of the cluster.
name string
Name of the cluster.
description string
Description of the cluster.
labels map<string,string>
Custom labels for the cluster as key:value pairs.
environment enum Environment
Deployment environment of the cluster.
  • PRODUCTION: Environment for stable versions of your apps. A conservative update policy is in effect: only bug fixes are applied during regular maintenance.
  • PRESTABLE: Environment for testing, including the Managed Service for MySQL itself. This environment gets new features, improvements, and bug fixes in the first place, compared to the production environment. However, not every update ensures backward compatibility.
monitoring[] Monitoring
Monitoring systems data that is relevant to the cluster.
config ClusterConfig
Configuration of the cluster.
network_id string
ID of the network that the cluster belongs to.
health enum Health
Aggregated health of the cluster.
  • HEALTH_UNKNOWN: Health of the cluster is unknown (Host.health for every host in the cluster is UNKNOWN).
  • ALIVE: Cluster is alive and well (Host.health for every host in the cluster is ALIVE).
  • DEAD: Cluster is inoperable (Host.health for every host in the cluster is DEAD).
  • DEGRADED: Cluster is degraded (Host.health for at least one host in the cluster is not ALIVE).
status enum Status
Current state of the cluster.
  • STATUS_UNKNOWN: Cluster state is unknown.
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running normally.
  • ERROR: Cluster encountered a problem and cannot operate.
  • UPDATING: Cluster is being updated.
  • STOPPING: Cluster is stopping.
  • STOPPED: Cluster is stopped.
  • STARTING: Cluster is starting.
maintenance_window MaintenanceWindow
Maintenance window settings for the cluster.
planned_operation MaintenanceOperation
Planned maintenance operation to be started for the cluster within the nearest maintenance_window.
security_group_ids[] string
Effective list of security group IDs applied to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

Monitoring

Field Description
name string
Name of the monitoring system.
description string
Description of the monitoring system.
link string
Link to the monitoring system charts for the cluster.

ClusterConfig

Field Description
version string
Version of MySQL used in the cluster.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfigSet5_7
Configuration of a MySQL 5.7 server.
  mysql_config_8_0 config.MysqlConfigSet8_0
Configuration of a MySQL 8.0 server.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

MaintenanceOperation

Field Description
info string
Information about this maintenance operation. The maximum string length in characters is 256.
delayed_until google.protobuf.Timestamp
Time until which this maintenance operation is delayed.

Delete

Deletes a cluster.

rpc Delete (DeleteClusterRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:DeleteClusterMetadata

    Operation.response:google.protobuf.Empty

DeleteClusterRequest

Field Description
cluster_id string
Required. ID of the cluster to delete.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<DeleteClusterMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<google.protobuf.Empty>
if operation finished successfully.

DeleteClusterMetadata

Field Description
cluster_id string
ID of the cluster that is being deleted.

Start

Starts a cluster.

rpc Start (StartClusterRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:StartClusterMetadata

    Operation.response:Cluster

StartClusterRequest

Field Description
cluster_id string
Required. ID of the cluster to start.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<StartClusterMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<Cluster>
if operation finished successfully.

StartClusterMetadata

Field Description
cluster_id string
ID of the cluster that is being started.

Cluster

Field Description
id string
ID of the cluster.
This ID is assigned by the platform at the time of creation.
folder_id string
ID of the folder that the cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp of the cluster.
name string
Name of the cluster.
description string
Description of the cluster.
labels map<string,string>
Custom labels for the cluster as key:value pairs.
environment enum Environment
Deployment environment of the cluster.
  • PRODUCTION: Environment for stable versions of your apps. A conservative update policy is in effect: only bug fixes are applied during regular maintenance.
  • PRESTABLE: Environment for testing, including the Managed Service for MySQL itself. This environment gets new features, improvements, and bug fixes in the first place, compared to the production environment. However, not every update ensures backward compatibility.
monitoring[] Monitoring
Monitoring systems data that is relevant to the cluster.
config ClusterConfig
Configuration of the cluster.
network_id string
ID of the network that the cluster belongs to.
health enum Health
Aggregated health of the cluster.
  • HEALTH_UNKNOWN: Health of the cluster is unknown (Host.health for every host in the cluster is UNKNOWN).
  • ALIVE: Cluster is alive and well (Host.health for every host in the cluster is ALIVE).
  • DEAD: Cluster is inoperable (Host.health for every host in the cluster is DEAD).
  • DEGRADED: Cluster is degraded (Host.health for at least one host in the cluster is not ALIVE).
status enum Status
Current state of the cluster.
  • STATUS_UNKNOWN: Cluster state is unknown.
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running normally.
  • ERROR: Cluster encountered a problem and cannot operate.
  • UPDATING: Cluster is being updated.
  • STOPPING: Cluster is stopping.
  • STOPPED: Cluster is stopped.
  • STARTING: Cluster is starting.
maintenance_window MaintenanceWindow
Maintenance window settings for the cluster.
planned_operation MaintenanceOperation
Planned maintenance operation to be started for the cluster within the nearest maintenance_window.
security_group_ids[] string
Effective list of security group IDs applied to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

Monitoring

Field Description
name string
Name of the monitoring system.
description string
Description of the monitoring system.
link string
Link to the monitoring system charts for the cluster.

ClusterConfig

Field Description
version string
Version of MySQL used in the cluster.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfigSet5_7
Configuration of a MySQL 5.7 server.
  mysql_config_8_0 config.MysqlConfigSet8_0
Configuration of a MySQL 8.0 server.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Access

Field Description
data_lens bool
Allows access from DataLens.
See the documentation for details.
web_sql bool
Allows SQL queries to the cluster databases from management console.
See the documentation for details.
data_transfer bool
Allow access for DataTransfer.

PerformanceDiagnostics

Field Description
enabled bool
Flag that shows if performance statistics gathering is enabled for the cluster.
sessions_sampling_interval int64
Interval (in seconds) for my_session sampling. Acceptable values are 1 to 86400, inclusive.
statements_sampling_interval int64
Interval (in seconds) for my_statements sampling. Acceptable values are 1 to 86400, inclusive.

MaintenanceWindow

Field Description
policy oneof: anytime or weekly_maintenance_window
The maintenance policy in effect.
  anytime AnytimeMaintenanceWindow
Maintenance operation can be scheduled anytime.
  weekly_maintenance_window WeeklyMaintenanceWindow
Maintenance operation can be scheduled on a weekly basis.

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

Field Description
day enum WeekDay
Day of the week (in DDD format).
hour int64
Hour of the day in UTC (in HH format). Acceptable values are 1 to 24, inclusive.

MaintenanceOperation

Field Description
info string
Information about this maintenance operation. The maximum string length in characters is 256.
delayed_until google.protobuf.Timestamp
Time until which this maintenance operation is delayed.

Stop

Stops a cluster.

rpc Stop (StopClusterRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:StopClusterMetadata

    Operation.response:Cluster

StopClusterRequest

Field Description
cluster_id string
Required. ID of the cluster to stop.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<StopClusterMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<Cluster>
if operation finished successfully.

StopClusterMetadata

Field Description
cluster_id string
ID of the cluster that is being stopped.

Cluster

Field Description
id string
ID of the cluster.
This ID is assigned by the platform at the time of creation.
folder_id string
ID of the folder that the cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp of the cluster.
name string
Name of the cluster.
description string
Description of the cluster.
labels map<string,string>
Custom labels for the cluster as key:value pairs.
environment enum Environment
Deployment environment of the cluster.
  • PRODUCTION: Environment for stable versions of your apps. A conservative update policy is in effect: only bug fixes are applied during regular maintenance.
  • PRESTABLE: Environment for testing, including the Managed Service for MySQL itself. This environment gets new features, improvements, and bug fixes in the first place, compared to the production environment. However, not every update ensures backward compatibility.
monitoring[] Monitoring
Monitoring systems data that is relevant to the cluster.
config ClusterConfig
Configuration of the cluster.
network_id string
ID of the network that the cluster belongs to.
health enum Health
Aggregated health of the cluster.
  • HEALTH_UNKNOWN: Health of the cluster is unknown (Host.health for every host in the cluster is UNKNOWN).
  • ALIVE: Cluster is alive and well (Host.health for every host in the cluster is ALIVE).
  • DEAD: Cluster is inoperable (Host.health for every host in the cluster is DEAD).
  • DEGRADED: Cluster is degraded (Host.health for at least one host in the cluster is not ALIVE).
status enum Status
Current state of the cluster.
  • STATUS_UNKNOWN: Cluster state is unknown.
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running normally.
  • ERROR: Cluster encountered a problem and cannot operate.
  • UPDATING: Cluster is being updated.
  • STOPPING: Cluster is stopping.
  • STOPPED: Cluster is stopped.
  • STARTING: Cluster is starting.
maintenance_window MaintenanceWindow
Maintenance window settings for the cluster.
planned_operation MaintenanceOperation
Planned maintenance operation to be started for the cluster within the nearest maintenance_window.
security_group_ids[] string
Effective list of security group IDs applied to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

Monitoring

Field Description
name string
Name of the monitoring system.
description string
Description of the monitoring system.
link string
Link to the monitoring system charts for the cluster.

ClusterConfig

Field Description
version string
Version of MySQL used in the cluster.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfigSet5_7
Configuration of a MySQL 5.7 server.
  mysql_config_8_0 config.MysqlConfigSet8_0
Configuration of a MySQL 8.0 server.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Access

Field Description
data_lens bool
Allows access from DataLens.
See the documentation for details.
web_sql bool
Allows SQL queries to the cluster databases from management console.
See the documentation for details.
data_transfer bool
Allow access for DataTransfer.

PerformanceDiagnostics

Field Description
enabled bool
Flag that shows if performance statistics gathering is enabled for the cluster.
sessions_sampling_interval int64
Interval (in seconds) for my_session sampling. Acceptable values are 1 to 86400, inclusive.
statements_sampling_interval int64
Interval (in seconds) for my_statements sampling. Acceptable values are 1 to 86400, inclusive.

MaintenanceWindow

Field Description
policy oneof: anytime or weekly_maintenance_window
The maintenance policy in effect.
  anytime AnytimeMaintenanceWindow
Maintenance operation can be scheduled anytime.
  weekly_maintenance_window WeeklyMaintenanceWindow
Maintenance operation can be scheduled on a weekly basis.

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

Field Description
day enum WeekDay
Day of the week (in DDD format).
hour int64
Hour of the day in UTC (in HH format). Acceptable values are 1 to 24, inclusive.

MaintenanceOperation

Field Description
info string
Information about this maintenance operation. The maximum string length in characters is 256.
delayed_until google.protobuf.Timestamp
Time until which this maintenance operation is delayed.

Move

Moves a cluster to a folder.

rpc Move (MoveClusterRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:MoveClusterMetadata

    Operation.response:Cluster

MoveClusterRequest

Field Description
cluster_id string
Required. ID of the cluster to move.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.
destination_folder_id string
Required. ID of the destination folder.
To get this ID, make a yandex.cloud.resourcemanager.v1.FolderService.List request. The maximum string length in characters is 50.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<MoveClusterMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<Cluster>
if operation finished successfully.

MoveClusterMetadata

Field Description
cluster_id string
ID of the cluster that is being moved.
source_folder_id string
ID of the source folder.
destination_folder_id string
ID of the destination folder.

Cluster

Field Description
id string
ID of the cluster.
This ID is assigned by the platform at the time of creation.
folder_id string
ID of the folder that the cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp of the cluster.
name string
Name of the cluster.
description string
Description of the cluster.
labels map<string,string>
Custom labels for the cluster as key:value pairs.
environment enum Environment
Deployment environment of the cluster.
  • PRODUCTION: Environment for stable versions of your apps. A conservative update policy is in effect: only bug fixes are applied during regular maintenance.
  • PRESTABLE: Environment for testing, including the Managed Service for MySQL itself. This environment gets new features, improvements, and bug fixes in the first place, compared to the production environment. However, not every update ensures backward compatibility.
monitoring[] Monitoring
Monitoring systems data that is relevant to the cluster.
config ClusterConfig
Configuration of the cluster.
network_id string
ID of the network that the cluster belongs to.
health enum Health
Aggregated health of the cluster.
  • HEALTH_UNKNOWN: Health of the cluster is unknown (Host.health for every host in the cluster is UNKNOWN).
  • ALIVE: Cluster is alive and well (Host.health for every host in the cluster is ALIVE).
  • DEAD: Cluster is inoperable (Host.health for every host in the cluster is DEAD).
  • DEGRADED: Cluster is degraded (Host.health for at least one host in the cluster is not ALIVE).
status enum Status
Current state of the cluster.
  • STATUS_UNKNOWN: Cluster state is unknown.
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running normally.
  • ERROR: Cluster encountered a problem and cannot operate.
  • UPDATING: Cluster is being updated.
  • STOPPING: Cluster is stopping.
  • STOPPED: Cluster is stopped.
  • STARTING: Cluster is starting.
maintenance_window MaintenanceWindow
Maintenance window settings for the cluster.
planned_operation MaintenanceOperation
Planned maintenance operation to be started for the cluster within the nearest maintenance_window.
security_group_ids[] string
Effective list of security group IDs applied to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

Monitoring

Field Description
name string
Name of the monitoring system.
description string
Description of the monitoring system.
link string
Link to the monitoring system charts for the cluster.

ClusterConfig

Field Description
version string
Version of MySQL used in the cluster.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfigSet5_7
Configuration of a MySQL 5.7 server.
  mysql_config_8_0 config.MysqlConfigSet8_0
Configuration of a MySQL 8.0 server.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Access

Field Description
data_lens bool
Allows access from DataLens.
See the documentation for details.
web_sql bool
Allows SQL queries to the cluster databases from management console.
See the documentation for details.
data_transfer bool
Allow access for DataTransfer.

PerformanceDiagnostics

Field Description
enabled bool
Flag that shows if performance statistics gathering is enabled for the cluster.
sessions_sampling_interval int64
Interval (in seconds) for my_session sampling. Acceptable values are 1 to 86400, inclusive.
statements_sampling_interval int64
Interval (in seconds) for my_statements sampling. Acceptable values are 1 to 86400, inclusive.

MaintenanceWindow

Field Description
policy oneof: anytime or weekly_maintenance_window
The maintenance policy in effect.
  anytime AnytimeMaintenanceWindow
Maintenance operation can be scheduled anytime.
  weekly_maintenance_window WeeklyMaintenanceWindow
Maintenance operation can be scheduled on a weekly basis.

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

Field Description
day enum WeekDay
Day of the week (in DDD format).
hour int64
Hour of the day in UTC (in HH format). Acceptable values are 1 to 24, inclusive.

MaintenanceOperation

Field Description
info string
Information about this maintenance operation. The maximum string length in characters is 256.
delayed_until google.protobuf.Timestamp
Time until which this maintenance operation is delayed.

Backup

Creates a backup for a cluster.
To get information about a backup, make a BackupService.Get request.

rpc Backup (BackupClusterRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:BackupClusterMetadata

    Operation.response:Cluster

BackupClusterRequest

Field Description
cluster_id string
Required. ID of the cluster to back up.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<BackupClusterMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<Cluster>
if operation finished successfully.

BackupClusterMetadata

Field Description
cluster_id string
ID of the cluster that is being backed up.

Cluster

Field Description
id string
ID of the cluster.
This ID is assigned by the platform at the time of creation.
folder_id string
ID of the folder that the cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp of the cluster.
name string
Name of the cluster.
description string
Description of the cluster.
labels map<string,string>
Custom labels for the cluster as key:value pairs.
environment enum Environment
Deployment environment of the cluster.
  • PRODUCTION: Environment for stable versions of your apps. A conservative update policy is in effect: only bug fixes are applied during regular maintenance.
  • PRESTABLE: Environment for testing, including the Managed Service for MySQL itself. This environment gets new features, improvements, and bug fixes in the first place, compared to the production environment. However, not every update ensures backward compatibility.
monitoring[] Monitoring
Monitoring systems data that is relevant to the cluster.
config ClusterConfig
Configuration of the cluster.
network_id string
ID of the network that the cluster belongs to.
health enum Health
Aggregated health of the cluster.
  • HEALTH_UNKNOWN: Health of the cluster is unknown (Host.health for every host in the cluster is UNKNOWN).
  • ALIVE: Cluster is alive and well (Host.health for every host in the cluster is ALIVE).
  • DEAD: Cluster is inoperable (Host.health for every host in the cluster is DEAD).
  • DEGRADED: Cluster is degraded (Host.health for at least one host in the cluster is not ALIVE).
status enum Status
Current state of the cluster.
  • STATUS_UNKNOWN: Cluster state is unknown.
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running normally.
  • ERROR: Cluster encountered a problem and cannot operate.
  • UPDATING: Cluster is being updated.
  • STOPPING: Cluster is stopping.
  • STOPPED: Cluster is stopped.
  • STARTING: Cluster is starting.
maintenance_window MaintenanceWindow
Maintenance window settings for the cluster.
planned_operation MaintenanceOperation
Planned maintenance operation to be started for the cluster within the nearest maintenance_window.
security_group_ids[] string
Effective list of security group IDs applied to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

Monitoring

Field Description
name string
Name of the monitoring system.
description string
Description of the monitoring system.
link string
Link to the monitoring system charts for the cluster.

ClusterConfig

Field Description
version string
Version of MySQL used in the cluster.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfigSet5_7
Configuration of a MySQL 5.7 server.
  mysql_config_8_0 config.MysqlConfigSet8_0
Configuration of a MySQL 8.0 server.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Access

Field Description
data_lens bool
Allows access from DataLens.
See the documentation for details.
web_sql bool
Allows SQL queries to the cluster databases from management console.
See the documentation for details.
data_transfer bool
Allow access for DataTransfer.

PerformanceDiagnostics

Field Description
enabled bool
Flag that shows if performance statistics gathering is enabled for the cluster.
sessions_sampling_interval int64
Interval (in seconds) for my_session sampling. Acceptable values are 1 to 86400, inclusive.
statements_sampling_interval int64
Interval (in seconds) for my_statements sampling. Acceptable values are 1 to 86400, inclusive.

MaintenanceWindow

Field Description
policy oneof: anytime or weekly_maintenance_window
The maintenance policy in effect.
  anytime AnytimeMaintenanceWindow
Maintenance operation can be scheduled anytime.
  weekly_maintenance_window WeeklyMaintenanceWindow
Maintenance operation can be scheduled on a weekly basis.

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

Field Description
day enum WeekDay
Day of the week (in DDD format).
hour int64
Hour of the day in UTC (in HH format). Acceptable values are 1 to 24, inclusive.

MaintenanceOperation

Field Description
info string
Information about this maintenance operation. The maximum string length in characters is 256.
delayed_until google.protobuf.Timestamp
Time until which this maintenance operation is delayed.

Restore

Restores a backup to a new cluster.
See the documentation for details.

rpc Restore (RestoreClusterRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:RestoreClusterMetadata

    Operation.response:Cluster

RestoreClusterRequest

Field Description
backup_id string
Required. ID of the backup to restore from.
To get this ID, make a BackupService.List request (lists all backups in a folder) or a ClusterService.ListBackups request (lists all backups for an existing cluster).
time google.protobuf.Timestamp
Required. Timestamp of the moment to which the MySQL cluster should be restored.
name string
Required. Name of the new MySQL cluster the backup will be restored to. The name must be unique within the folder. Value must match the regular expression [a-zA-Z0-9_-]*.
description string
Description of the new cluster. The maximum string length in characters is 256.
labels map<string,string>
Custom labels for the new cluster as key:value pairs. No more than 64 per resource. The maximum string length in characters for each value is 63. Each value must match the regular expression [-_0-9a-z]*. The string length in characters for each key must be 1-63. Each key must match the regular expression [a-z][-_0-9a-z]*.
environment Cluster.Environment
Deployment environment for the new cluster.
config_spec ConfigSpec
Configuration of the new cluster.
host_specs[] HostSpec
Configuration of hosts in the new cluster.
network_id string
ID of the network to create the new cluster in. The maximum string length in characters is 50.
folder_id string
ID of the folder to create the new cluster in. The maximum string length in characters is 50.
security_group_ids[] string
List of security group IDs to apply to the new cluster.
deletion_protection bool
Deletion Protection inhibits deletion of the cluster
host_group_ids[] string
Host groups hosting VMs of the cluster.

ConfigSpec

Field Description
version string
Version of MySQL used in the cluster.
Possible values: 5.7, 8.0.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfig5_7
Configuration for a MySQL 5.7 cluster.
  mysql_config_8_0 config.MysqlConfig8_0
Configuration for a MySQL 8.0 cluster.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
If the specific services need to access the cluster, then set the necessary values in this policy.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Access

Field Description
data_lens bool
Allows access from DataLens.
See the documentation for details.
web_sql bool
Allows SQL queries to the cluster databases from management console.
See the documentation for details.
data_transfer bool
Allow access for DataTransfer.

PerformanceDiagnostics

Field Description
enabled bool
Flag that shows if performance statistics gathering is enabled for the cluster.
sessions_sampling_interval int64
Interval (in seconds) for my_session sampling. Acceptable values are 1 to 86400, inclusive.
statements_sampling_interval int64
Interval (in seconds) for my_statements sampling. Acceptable values are 1 to 86400, inclusive.

HostSpec

Field Description
zone_id string
ID of the availability zone where the host resides.
To get a list of available zones, make the yandex.cloud.compute.v1.ZoneService.List request. The maximum string length in characters is 50.
subnet_id string
ID of the subnet to assign to the host.
This subnet should be a part of the cluster network (the network ID is specified in the ClusterService.CreateClusterRequest.network_id). The maximum string length in characters is 50.
assign_public_ip bool
Option that enables public IP address for the host so that the host can be accessed from the internet.
After a host has been created, this setting cannot be changed. To remove an assigned public IP address, or to assign a public IP address to a host without one, recreate the host with the appropriate assign_public_ip value set.
Possible values:
  • false - don't assign a public IP address to the host.
  • true - assign a public IP address to the host.
replication_source string
Host.name of the host to be used as the replication source (for cascading replication).
backup_priority int64
Host backup priority Acceptable values are 0 to 100, inclusive.
priority int64
Host master promotion priority Acceptable values are 0 to 100, inclusive.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<RestoreClusterMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<Cluster>
if operation finished successfully.

RestoreClusterMetadata

Field Description
cluster_id string
ID of the new cluster that is being created from a backup.
backup_id string
ID of the backup that is being used for creating a cluster.

Cluster

Field Description
id string
ID of the cluster.
This ID is assigned by the platform at the time of creation.
folder_id string
ID of the folder that the cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp of the cluster.
name string
Name of the cluster.
description string
Description of the cluster.
labels map<string,string>
Custom labels for the cluster as key:value pairs.
environment enum Environment
Deployment environment of the cluster.
  • PRODUCTION: Environment for stable versions of your apps. A conservative update policy is in effect: only bug fixes are applied during regular maintenance.
  • PRESTABLE: Environment for testing, including the Managed Service for MySQL itself. This environment gets new features, improvements, and bug fixes in the first place, compared to the production environment. However, not every update ensures backward compatibility.
monitoring[] Monitoring
Monitoring systems data that is relevant to the cluster.
config ClusterConfig
Configuration of the cluster.
network_id string
ID of the network that the cluster belongs to.
health enum Health
Aggregated health of the cluster.
  • HEALTH_UNKNOWN: Health of the cluster is unknown (Host.health for every host in the cluster is UNKNOWN).
  • ALIVE: Cluster is alive and well (Host.health for every host in the cluster is ALIVE).
  • DEAD: Cluster is inoperable (Host.health for every host in the cluster is DEAD).
  • DEGRADED: Cluster is degraded (Host.health for at least one host in the cluster is not ALIVE).
status enum Status
Current state of the cluster.
  • STATUS_UNKNOWN: Cluster state is unknown.
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running normally.
  • ERROR: Cluster encountered a problem and cannot operate.
  • UPDATING: Cluster is being updated.
  • STOPPING: Cluster is stopping.
  • STOPPED: Cluster is stopped.
  • STARTING: Cluster is starting.
maintenance_window MaintenanceWindow
Maintenance window settings for the cluster.
planned_operation MaintenanceOperation
Planned maintenance operation to be started for the cluster within the nearest maintenance_window.
security_group_ids[] string
Effective list of security group IDs applied to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

Monitoring

Field Description
name string
Name of the monitoring system.
description string
Description of the monitoring system.
link string
Link to the monitoring system charts for the cluster.

ClusterConfig

Field Description
version string
Version of MySQL used in the cluster.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfigSet5_7
Configuration of a MySQL 5.7 server.
  mysql_config_8_0 config.MysqlConfigSet8_0
Configuration of a MySQL 8.0 server.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

MaintenanceWindow

Field Description
policy oneof: anytime or weekly_maintenance_window
The maintenance policy in effect.
  anytime AnytimeMaintenanceWindow
Maintenance operation can be scheduled anytime.
  weekly_maintenance_window WeeklyMaintenanceWindow
Maintenance operation can be scheduled on a weekly basis.

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

Field Description
day enum WeekDay
Day of the week (in DDD format).
hour int64
Hour of the day in UTC (in HH format). Acceptable values are 1 to 24, inclusive.

MaintenanceOperation

Field Description
info string
Information about this maintenance operation. The maximum string length in characters is 256.
delayed_until google.protobuf.Timestamp
Time until which this maintenance operation is delayed.

RescheduleMaintenance

Reschedules planned maintenance operation.

rpc RescheduleMaintenance (RescheduleMaintenanceRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:RescheduleMaintenanceMetadata

    Operation.response:Cluster

RescheduleMaintenanceRequest

Field Description
cluster_id string
Required. ID of the cluster to reschedule the maintenance operation for.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.
reschedule_type enum RescheduleType
Required. The type of reschedule request.
  • IMMEDIATE: Start the maintenance operation immediately.
  • NEXT_AVAILABLE_WINDOW: Start the maintenance operation within the next available maintenance window.
  • SPECIFIC_TIME: Start the maintenance operation at the specific time.
delayed_until google.protobuf.Timestamp
The time until which this maintenance operation should be delayed. The value should be ahead of the first time when the maintenance operation has been scheduled for no more than two weeks. The value can also point to the past moment of time if IMMEDIATE reschedule type is chosen.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<RescheduleMaintenanceMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<Cluster>
if operation finished successfully.

RescheduleMaintenanceMetadata

Field Description
cluster_id string
ID of the cluster the maintenance operation is being rescheduled for.
delayed_until google.protobuf.Timestamp
The time until which this maintenance operation is to be delayed.

Cluster

Field Description
id string
ID of the cluster.
This ID is assigned by the platform at the time of creation.
folder_id string
ID of the folder that the cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp of the cluster.
name string
Name of the cluster.
description string
Description of the cluster.
labels map<string,string>
Custom labels for the cluster as key:value pairs.
environment enum Environment
Deployment environment of the cluster.
  • PRODUCTION: Environment for stable versions of your apps. A conservative update policy is in effect: only bug fixes are applied during regular maintenance.
  • PRESTABLE: Environment for testing, including the Managed Service for MySQL itself. This environment gets new features, improvements, and bug fixes in the first place, compared to the production environment. However, not every update ensures backward compatibility.
monitoring[] Monitoring
Monitoring systems data that is relevant to the cluster.
config ClusterConfig
Configuration of the cluster.
network_id string
ID of the network that the cluster belongs to.
health enum Health
Aggregated health of the cluster.
  • HEALTH_UNKNOWN: Health of the cluster is unknown (Host.health for every host in the cluster is UNKNOWN).
  • ALIVE: Cluster is alive and well (Host.health for every host in the cluster is ALIVE).
  • DEAD: Cluster is inoperable (Host.health for every host in the cluster is DEAD).
  • DEGRADED: Cluster is degraded (Host.health for at least one host in the cluster is not ALIVE).
status enum Status
Current state of the cluster.
  • STATUS_UNKNOWN: Cluster state is unknown.
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running normally.
  • ERROR: Cluster encountered a problem and cannot operate.
  • UPDATING: Cluster is being updated.
  • STOPPING: Cluster is stopping.
  • STOPPED: Cluster is stopped.
  • STARTING: Cluster is starting.
maintenance_window MaintenanceWindow
Maintenance window settings for the cluster.
planned_operation MaintenanceOperation
Planned maintenance operation to be started for the cluster within the nearest maintenance_window.
security_group_ids[] string
Effective list of security group IDs applied to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

Monitoring

Field Description
name string
Name of the monitoring system.
description string
Description of the monitoring system.
link string
Link to the monitoring system charts for the cluster.

ClusterConfig

Field Description
version string
Version of MySQL used in the cluster.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfigSet5_7
Configuration of a MySQL 5.7 server.
  mysql_config_8_0 config.MysqlConfigSet8_0
Configuration of a MySQL 8.0 server.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Access

Field Description
data_lens bool
Allows access from DataLens.
See the documentation for details.
web_sql bool
Allows SQL queries to the cluster databases from management console.
See the documentation for details.
data_transfer bool
Allow access for DataTransfer.

PerformanceDiagnostics

Field Description
enabled bool
Flag that shows if performance statistics gathering is enabled for the cluster.
sessions_sampling_interval int64
Interval (in seconds) for my_session sampling. Acceptable values are 1 to 86400, inclusive.
statements_sampling_interval int64
Interval (in seconds) for my_statements sampling. Acceptable values are 1 to 86400, inclusive.

MaintenanceWindow

Field Description
policy oneof: anytime or weekly_maintenance_window
The maintenance policy in effect.
  anytime AnytimeMaintenanceWindow
Maintenance operation can be scheduled anytime.
  weekly_maintenance_window WeeklyMaintenanceWindow
Maintenance operation can be scheduled on a weekly basis.

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

Field Description
day enum WeekDay
Day of the week (in DDD format).
hour int64
Hour of the day in UTC (in HH format). Acceptable values are 1 to 24, inclusive.

MaintenanceOperation

Field Description
info string
Information about this maintenance operation. The maximum string length in characters is 256.
delayed_until google.protobuf.Timestamp
Time until which this maintenance operation is delayed.

StartFailover

Starts a manual failover for a cluster.

rpc StartFailover (StartClusterFailoverRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:StartClusterFailoverMetadata

    Operation.response:Cluster

StartClusterFailoverRequest

Field Description
cluster_id string
Required. ID of the cluster to start failover for.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.
host_name string
Host name to switch master role to. If not provided, then the master role is switched to the most up-to-date replica host.
To get this name, make a ClusterService.ListHosts request. The maximum string length in characters is 253.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<StartClusterFailoverMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<Cluster>
if operation finished successfully.

StartClusterFailoverMetadata

Field Description
cluster_id string
ID of the cluster that is being failovered.

Cluster

Field Description
id string
ID of the cluster.
This ID is assigned by the platform at the time of creation.
folder_id string
ID of the folder that the cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp of the cluster.
name string
Name of the cluster.
description string
Description of the cluster.
labels map<string,string>
Custom labels for the cluster as key:value pairs.
environment enum Environment
Deployment environment of the cluster.
  • PRODUCTION: Environment for stable versions of your apps. A conservative update policy is in effect: only bug fixes are applied during regular maintenance.
  • PRESTABLE: Environment for testing, including the Managed Service for MySQL itself. This environment gets new features, improvements, and bug fixes in the first place, compared to the production environment. However, not every update ensures backward compatibility.
monitoring[] Monitoring
Monitoring systems data that is relevant to the cluster.
config ClusterConfig
Configuration of the cluster.
network_id string
ID of the network that the cluster belongs to.
health enum Health
Aggregated health of the cluster.
  • HEALTH_UNKNOWN: Health of the cluster is unknown (Host.health for every host in the cluster is UNKNOWN).
  • ALIVE: Cluster is alive and well (Host.health for every host in the cluster is ALIVE).
  • DEAD: Cluster is inoperable (Host.health for every host in the cluster is DEAD).
  • DEGRADED: Cluster is degraded (Host.health for at least one host in the cluster is not ALIVE).
status enum Status
Current state of the cluster.
  • STATUS_UNKNOWN: Cluster state is unknown.
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running normally.
  • ERROR: Cluster encountered a problem and cannot operate.
  • UPDATING: Cluster is being updated.
  • STOPPING: Cluster is stopping.
  • STOPPED: Cluster is stopped.
  • STARTING: Cluster is starting.
maintenance_window MaintenanceWindow
Maintenance window settings for the cluster.
planned_operation MaintenanceOperation
Planned maintenance operation to be started for the cluster within the nearest maintenance_window.
security_group_ids[] string
Effective list of security group IDs applied to the cluster.
deletion_protection bool
This option prevents unintended deletion of the cluster.
host_group_ids[] string
Host groups hosting VMs of the cluster.

Monitoring

Field Description
name string
Name of the monitoring system.
description string
Description of the monitoring system.
link string
Link to the monitoring system charts for the cluster.

ClusterConfig

Field Description
version string
Version of MySQL used in the cluster.
mysql_config oneof: mysql_config_5_7 or mysql_config_8_0
Cluster-wide MySQL configuration.
  mysql_config_5_7 config.MysqlConfigSet5_7
Configuration of a MySQL 5.7 server.
  mysql_config_8_0 config.MysqlConfigSet8_0
Configuration of a MySQL 8.0 server.
resources Resources
Resource preset for the cluster hosts.
backup_window_start google.type.TimeOfDay
Time to start the daily backup, in the UTC timezone.
access Access
Access policy for external services.
performance_diagnostics PerformanceDiagnostics
Configuration of the performance diagnostics service.
backup_retain_period_days google.protobuf.Int64Value
Retention policy of automated backups. Acceptable values are 7 to 60, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Access

Field Description
data_lens bool
Allows access from DataLens.
See the documentation for details.
web_sql bool
Allows SQL queries to the cluster databases from management console.
See the documentation for details.
data_transfer bool
Allow access for DataTransfer.

PerformanceDiagnostics

Field Description
enabled bool
Flag that shows if performance statistics gathering is enabled for the cluster.
sessions_sampling_interval int64
Interval (in seconds) for my_session sampling. Acceptable values are 1 to 86400, inclusive.
statements_sampling_interval int64
Interval (in seconds) for my_statements sampling. Acceptable values are 1 to 86400, inclusive.

MaintenanceWindow

Field Description
policy oneof: anytime or weekly_maintenance_window
The maintenance policy in effect.
  anytime AnytimeMaintenanceWindow
Maintenance operation can be scheduled anytime.
  weekly_maintenance_window WeeklyMaintenanceWindow
Maintenance operation can be scheduled on a weekly basis.

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

Field Description
day enum WeekDay
Day of the week (in DDD format).
hour int64
Hour of the day in UTC (in HH format). Acceptable values are 1 to 24, inclusive.

MaintenanceOperation

Field Description
info string
Information about this maintenance operation. The maximum string length in characters is 256.
delayed_until google.protobuf.Timestamp
Time until which this maintenance operation is delayed.

ListLogs

Retrieves logs for a cluster.
Alternatively, logs can be streamed using StreamLogs.

rpc ListLogs (ListClusterLogsRequest) returns (ListClusterLogsResponse)

ListClusterLogsRequest

Field Description
cluster_id string
Required. ID of the cluster to request logs for.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.
column_filter[] string
Columns from the logs table to request. If no columns are specified, complete log records are returned.
service_type enum ServiceType
The log type.
  • MYSQL_ERROR: MySQL error log.
  • MYSQL_GENERAL: MySQL general query log.
  • MYSQL_SLOW_QUERY: MySQL slow query log.
  • MYSQL_AUDIT: MySQL audit log.
from_time google.protobuf.Timestamp
Start timestamp for the logs request. The logs in the response will be within from_time to to_time range.
to_time google.protobuf.Timestamp
End timestamp for the logs request. The logs in the response will be within from_time to to_time range.
page_size int64
The maximum number of results per page to return.
If the number of available results is larger than page_size, the API returns a ListClusterLogsResponse.next_page_token that can be used to get the next page of results in the subsequent ClusterService.ListLogs requests. Acceptable values are 0 to 1000, inclusive.
page_token string
Page token that can be used to iterate through multiple pages of results.
To get the next page of results, set page_token to the ListClusterLogsResponse.next_page_token returned by the previous ClusterService.ListLogs request. The maximum string length in characters is 100.
always_next_page_token bool
Option that controls the behavior of result pagination. If it is set to true, then ListClusterLogsResponse.next_page_token will always be returned, even if the current page is empty.

ListClusterLogsResponse

Field Description
logs[] LogRecord
Requested log records.
next_page_token string
The token that can be used to get the next page of results.
If the number of results is larger than ListClusterLogsRequest.page_size, use the next_page_token as the value for the ListClusterLogsRequest.page_token in the subsequent ClusterService.ListLogs request to iterate through multiple pages of results.
Each of the subsequent ClusterService.ListLogs requests should use the next_page_token value returned by the previous request to continue paging through the results.
This value is interchangeable with StreamLogRecord.next_record_token from ClusterService.StreamLogs method.

LogRecord

Field Description
timestamp google.protobuf.Timestamp
Timestamp of the log record.
message map<string,string>
Contents of the log record.

StreamLogs

Retrieves a log stream for a cluster.
This method is similar to ListLogs, but uses server-side streaming, which allows for the tail -f command semantics.

rpc StreamLogs (StreamClusterLogsRequest) returns (stream StreamLogRecord)

StreamClusterLogsRequest

Field Description
cluster_id string
Required. ID of the cluster to stream logs for.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.
column_filter[] string
Columns from the logs table to request. If no columns are specified, complete log records are returned.
service_type enum ServiceType
The log type.
  • MYSQL_ERROR: MySQL error log.
  • MYSQL_GENERAL: MySQL general query log.
  • MYSQL_SLOW_QUERY: MySQL slow query log.
  • MYSQL_AUDIT: MySQL audit log.
from_time google.protobuf.Timestamp
Start timestamp for the logs request.
to_time google.protobuf.Timestamp
End timestamp for the logs request. If this field is not set, all existing log records beginning from from_time will be returned first, and then the new records will be returned as they appear.
In essence it has tail -f command semantics.
record_token string
Record token that can be used to control logs streaming.
Set record_token to the StreamLogRecord.next_record_token, returned by the previous ClusterService.StreamLogs request to start streaming from the next log record. The maximum string length in characters is 100.
filter string
A filter expression that selects clusters logs listed in the response.
The expression must specify:
  1. The field name. Currently filtering can be applied to the LogRecord.logs.hostname field.
  2. An = operator.
  3. The value in double quotes ("). Must be 3-63 characters long and match the regular expression [a-z][-a-z0-9]{1,61}[a-z0-9].
Examples of a filter: message.hostname='node1.db.cloud.yandex.net' The maximum string length in characters is 1000.

StreamLogRecord

Field Description
record LogRecord
One of the requested log records.
next_record_token string
The token that can be used to continue streaming logs starting from the exact same record. To continue streaming, specify value of next_record_token as the StreamClusterLogsRequest.record_token value in the next ClusterService.StreamLogs request.
This value is interchangeable with ListClusterLogsResponse.next_page_token from ClusterService.ListLogs method.

LogRecord

Field Description
timestamp google.protobuf.Timestamp
Timestamp of the log record.
message map<string,string>
Contents of the log record.

ListOperations

Retrieves a list of operations for a cluster.

rpc ListOperations (ListClusterOperationsRequest) returns (ListClusterOperationsResponse)

ListClusterOperationsRequest

Field Description
cluster_id string
Required. ID of the cluster to list operations for.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.
page_size int64
The maximum number of results per page to return.
If the number of available results is larger than page_size, the API returns a ListClusterOperationsResponse.next_page_token that can be used to get the next page of results in the subsequent ClusterService.ListOperations requests. Acceptable values are 0 to 1000, inclusive.
page_token string
Page token that can be used to iterate through multiple pages of results.
To get the next page of results, set page_token to the ListClusterOperationsResponse.next_page_token returned by the previous ClusterService.ListOperations request. The maximum string length in characters is 100.

ListClusterOperationsResponse

Field Description
operations[] operation.Operation
List of operations in the cluster.
next_page_token string
The token that can be used to get the next page of results.
If the number of results is larger than ListClusterOperationsRequest.page_size, use the next_page_token as the value for the ListClusterOperationsRequest.page_token in the subsequent ClusterService.ListOperations request to iterate through multiple pages of results.
Each of the subsequent ClusterService.ListOperations requests should use the next_page_token value returned by the previous request to continue paging through the results.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any
The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is the standard Create/Update, the response should be the target resource of the operation. Any method that returns a long-running operation should document the response type, if any.

ListBackups

Retrieves a list of backups for a cluster.
To list all backups in a folder, make a BackupService.List request.

rpc ListBackups (ListClusterBackupsRequest) returns (ListClusterBackupsResponse)

ListClusterBackupsRequest

Field Description
cluster_id string
Required. ID of the cluster to list backups for.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.
page_size int64
The maximum number of results per page to return.
If the number of available results is larger than page_size, the API returns a ListClusterBackupsResponse.next_page_token that can be used to get the next page of results in the subsequent ClusterService.ListBackups requests. The maximum value is 1000.
page_token string
Page token that can be used to iterate through multiple pages of results.
To get the next page of results, set page_token to the ListClusterBackupsResponse.next_page_token returned by the previous ClusterService.ListBackups request. The maximum string length in characters is 100.

ListClusterBackupsResponse

Field Description
backups[] Backup
List of the cluster backups.
next_page_token string
The token that can be used to get the next page of results.
If the number of results is larger than ListClusterBackupsRequest.page_size, use the next_page_token as the value for the ListClusterBackupsRequest.page_token in the subsequent ClusterService.ListBackups request to iterate through multiple pages of results.
Each of the subsequent ClusterService.ListBackups requests should use the next_page_token value returned by the previous request to continue paging through the results.

Backup

Field Description
id string
Required. ID of the backup.
folder_id string
ID of the folder that the backup belongs to.
created_at google.protobuf.Timestamp
Creation timestamp (the time when the backup operation was completed).
source_cluster_id string
ID of the cluster that the backup was created for.
started_at google.protobuf.Timestamp
Start timestamp (the time when the backup operation was started).

ListHosts

Retrieves a list of hosts for a cluster.

rpc ListHosts (ListClusterHostsRequest) returns (ListClusterHostsResponse)

ListClusterHostsRequest

Field Description
cluster_id string
Required. ID of the cluster to list hosts for.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.
page_size int64
The maximum number of results per page to return.
If the number of available results is larger than page_size, the API returns a ListClusterHostsResponse.next_page_token that can be used to get the next page of results in the subsequent ClusterService.ListHosts requests. Acceptable values are 0 to 1000, inclusive.
page_token string
Page token that can be used to iterate through multiple pages of results.
To get the next page of results, set page_token to the ListClusterHostsResponse.next_page_token returned by the previous ClusterService.ListHosts request. The maximum string length in characters is 100.

ListClusterHostsResponse

Field Description
hosts[] Host
List of hosts in the cluster.
next_page_token string
The token that can be used to get the next page of results.
If the number of results is larger than ListClusterHostsRequest.page_size, use the next_page_token as the value for the ListClusterHostsRequest.page_token in the subsequent ClusterService.ListHosts request to iterate through multiple pages of results.
Each of the subsequent ClusterService.ListHosts requests should use the next_page_token value returned by the previous request to continue paging through the results.

Host

Field Description
name string
Name of the host.
This name is assigned by the platform at the time of creation. The name is unique across all MDB hosts that exist on the platform, as it defines the FQDN of the host.
cluster_id string
ID of the cluster the host belongs to.
zone_id string
ID of the availability zone where the host resides.
resources Resources
Resources allocated to the host.
role enum Role
Role of the host in the cluster.
  • ROLE_UNKNOWN: Role of the host is unknown.
  • MASTER: Host is the master.
  • REPLICA: Host is a replica.
health enum Health
Aggregated health of the host.
  • HEALTH_UNKNOWN: Health of the host is unknown.
  • ALIVE: Host is performing all its functions normally.
  • DEAD: Host is inoperable, and cannot perform any of its essential functions.
  • DEGRADED: Host is degraded, and can perform only some of its essential functions.
  • READONLY: Host is alive, but in read-only mode.
services[] Service
List of services provided by the host.
subnet_id string
ID of the subnet that the host belongs to.
assign_public_ip bool
Flag that shows if public IP address is assigned to the host so that the host can be accessed from the internet.
replication_source string
Name of the host to be used as the replication source for cascading replication.
backup_priority int64
Host backup priority. Acceptable values are 0 to 100, inclusive.
priority int64
Host master promotion priority. Acceptable values are 0 to 100, inclusive.

Resources

Field Description
resource_preset_id string
ID of the resource preset that defines available computational resources (vCPU, RAM, etc.) for a cluster host.
All available presets are listed in the documentation.
disk_size int64
Volume of the storage (for each cluster host, in bytes).
disk_type_id string
Type of the storage.
Possible values:
  • network-hdd - standard network storage
  • network-ssd - fast network storage
  • network-ssd-nonreplicated - fast network nonreplicated storage
  • local-ssd - fast local storage.

See the documentation for details.

Service

Field Description
type enum Type
Type of the service provided by the host.
  • MYSQL: The host is a MySQL server.
health enum Health
Aggregated health of the service.
  • HEALTH_UNKNOWN: Health of the service is unknown.
  • ALIVE: The service is working normally.
  • DEAD: The service is dead or unresponsive.
  • READONLY: The service is in read-only mode.

AddHosts

Adds new hosts in a cluster.

rpc AddHosts (AddClusterHostsRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:AddClusterHostsMetadata

    Operation.response:google.protobuf.Empty

AddClusterHostsRequest

Field Description
cluster_id string
Required. ID of the cluster to add hosts to.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.
host_specs[] HostSpec
Configuration of the newly added hosts. The number of elements must be greater than 0.

HostSpec

Field Description
zone_id string
ID of the availability zone where the host resides.
To get a list of available zones, make the yandex.cloud.compute.v1.ZoneService.List request. The maximum string length in characters is 50.
subnet_id string
ID of the subnet to assign to the host.
This subnet should be a part of the cluster network (the network ID is specified in the ClusterService.CreateClusterRequest.network_id). The maximum string length in characters is 50.
assign_public_ip bool
Option that enables public IP address for the host so that the host can be accessed from the internet.
After a host has been created, this setting cannot be changed. To remove an assigned public IP address, or to assign a public IP address to a host without one, recreate the host with the appropriate assign_public_ip value set.
Possible values:
  • false - don't assign a public IP address to the host.
  • true - assign a public IP address to the host.
replication_source string
Host.name of the host to be used as the replication source (for cascading replication).
backup_priority int64
Host backup priority Acceptable values are 0 to 100, inclusive.
priority int64
Host master promotion priority Acceptable values are 0 to 100, inclusive.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<AddClusterHostsMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<google.protobuf.Empty>
if operation finished successfully.

AddClusterHostsMetadata

Field Description
cluster_id string
ID of the cluster to which the hosts are being added.
host_names[] string
Names of hosts that are being added.

UpdateHosts

Updates the specified hosts.

rpc UpdateHosts (UpdateClusterHostsRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:UpdateClusterHostsMetadata

    Operation.response:google.protobuf.Empty

UpdateClusterHostsRequest

Field Description
cluster_id string
Required. ID of the MySQL cluster to update hosts in. To get the MySQL cluster ID, use a ClusterService.List request. The maximum string length in characters is 50.
update_host_specs[] UpdateHostSpec
New configurations to apply to hosts. The number of elements must be greater than 0.

UpdateHostSpec

Field Description
host_name string
Required. Name of the host to update. To get a MySQL host name, use a ClusterService.ListHosts request.
replication_source string
Host.name of the host to be used as the replication source (for cascading replication). To get a MySQL host name, use a ClusterService.ListHosts request.
update_mask google.protobuf.FieldMask
Field mask that specifies which settings of the MySQL host should be updated.
backup_priority int64
Host backup priority. Acceptable values are 0 to 100, inclusive.
assign_public_ip bool
Whether the host should get a public IP address on creation.
priority int64
Host master promotion priority. Acceptable values are 0 to 100, inclusive.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<UpdateClusterHostsMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<google.protobuf.Empty>
if operation finished successfully.

UpdateClusterHostsMetadata

Field Description
cluster_id string
ID of the cluster in which the hosts are being updated.
host_names[] string
Names of hosts that are being updated.

DeleteHosts

Deletes the specified hosts for a cluster.

rpc DeleteHosts (DeleteClusterHostsRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:DeleteClusterHostsMetadata

    Operation.response:google.protobuf.Empty

DeleteClusterHostsRequest

Field Description
cluster_id string
Required. ID of the cluster to delete hosts from.
To get this ID, make a ClusterService.List request. The maximum string length in characters is 50.
host_names[] string
Names of hosts to delete.
To get these names, make a ClusterService.ListHosts request. The number of elements must be greater than 0. The maximum string length in characters for each value is 253.

Operation

Field Description
id string
ID of the operation.
description string
Description of the operation. 0-256 characters long.
created_at google.protobuf.Timestamp
Creation timestamp.
created_by string
ID of the user or service account who initiated the operation.
modified_at google.protobuf.Timestamp
The time when the Operation resource was last modified.
done bool
If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata google.protobuf.Any<DeleteClusterHostsMetadata>
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result oneof: error or response
The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
  error google.rpc.Status
The error result of the operation in case of failure or cancellation.
  response google.protobuf.Any<google.protobuf.Empty>
if operation finished successfully.

DeleteClusterHostsMetadata

Field Description
cluster_id string
ID of the cluster from which the hosts are being deleted.
host_names[] string
Names of hosts that are being deleted.

Была ли статья полезна?

Language / Region
Проект Яндекса
© 2023 ООО «Яндекс.Облако»
В этой статье:
  • Calls ClusterService
  • Get
  • GetClusterRequest
  • Cluster
  • Monitoring
  • ClusterConfig
  • Resources
  • Access
  • PerformanceDiagnostics
  • MaintenanceWindow
  • AnytimeMaintenanceWindow
  • WeeklyMaintenanceWindow
  • MaintenanceOperation
  • List
  • ListClustersRequest
  • ListClustersResponse
  • Cluster
  • Monitoring
  • ClusterConfig
  • Resources
  • Access
  • PerformanceDiagnostics
  • MaintenanceWindow
  • AnytimeMaintenanceWindow
  • WeeklyMaintenanceWindow
  • MaintenanceOperation
  • Create
  • CreateClusterRequest
  • ConfigSpec
  • Resources
  • Access
  • PerformanceDiagnostics
  • DatabaseSpec
  • UserSpec
  • Permission
  • ConnectionLimits
  • HostSpec
  • Operation
  • CreateClusterMetadata
  • Cluster
  • Monitoring
  • ClusterConfig
  • MaintenanceWindow
  • AnytimeMaintenanceWindow
  • WeeklyMaintenanceWindow
  • MaintenanceOperation
  • Update
  • UpdateClusterRequest
  • ConfigSpec
  • Resources
  • Access
  • PerformanceDiagnostics
  • MaintenanceWindow
  • AnytimeMaintenanceWindow
  • WeeklyMaintenanceWindow
  • Operation
  • UpdateClusterMetadata
  • Cluster
  • Monitoring
  • ClusterConfig
  • MaintenanceOperation
  • Delete
  • DeleteClusterRequest
  • Operation
  • DeleteClusterMetadata
  • Start
  • StartClusterRequest
  • Operation
  • StartClusterMetadata
  • Cluster
  • Monitoring
  • ClusterConfig
  • Resources
  • Access
  • PerformanceDiagnostics
  • MaintenanceWindow
  • AnytimeMaintenanceWindow
  • WeeklyMaintenanceWindow
  • MaintenanceOperation
  • Stop
  • StopClusterRequest
  • Operation
  • StopClusterMetadata
  • Cluster
  • Monitoring
  • ClusterConfig
  • Resources
  • Access
  • PerformanceDiagnostics
  • MaintenanceWindow
  • AnytimeMaintenanceWindow
  • WeeklyMaintenanceWindow
  • MaintenanceOperation
  • Move
  • MoveClusterRequest
  • Operation
  • MoveClusterMetadata
  • Cluster
  • Monitoring
  • ClusterConfig
  • Resources
  • Access
  • PerformanceDiagnostics
  • MaintenanceWindow
  • AnytimeMaintenanceWindow
  • WeeklyMaintenanceWindow
  • MaintenanceOperation
  • Backup
  • BackupClusterRequest
  • Operation
  • BackupClusterMetadata
  • Cluster
  • Monitoring
  • ClusterConfig
  • Resources
  • Access
  • PerformanceDiagnostics
  • MaintenanceWindow
  • AnytimeMaintenanceWindow
  • WeeklyMaintenanceWindow
  • MaintenanceOperation
  • Restore
  • RestoreClusterRequest
  • ConfigSpec
  • Resources
  • Access
  • PerformanceDiagnostics
  • HostSpec
  • Operation
  • RestoreClusterMetadata
  • Cluster
  • Monitoring
  • ClusterConfig
  • MaintenanceWindow
  • AnytimeMaintenanceWindow
  • WeeklyMaintenanceWindow
  • MaintenanceOperation
  • RescheduleMaintenance
  • RescheduleMaintenanceRequest
  • Operation
  • RescheduleMaintenanceMetadata
  • Cluster
  • Monitoring
  • ClusterConfig
  • Resources
  • Access
  • PerformanceDiagnostics
  • MaintenanceWindow
  • AnytimeMaintenanceWindow
  • WeeklyMaintenanceWindow
  • MaintenanceOperation
  • StartFailover
  • StartClusterFailoverRequest
  • Operation
  • StartClusterFailoverMetadata
  • Cluster
  • Monitoring
  • ClusterConfig
  • Resources
  • Access
  • PerformanceDiagnostics
  • MaintenanceWindow
  • AnytimeMaintenanceWindow
  • WeeklyMaintenanceWindow
  • MaintenanceOperation
  • ListLogs
  • ListClusterLogsRequest
  • ListClusterLogsResponse
  • LogRecord
  • StreamLogs
  • StreamClusterLogsRequest
  • StreamLogRecord
  • LogRecord
  • ListOperations
  • ListClusterOperationsRequest
  • ListClusterOperationsResponse
  • Operation
  • ListBackups
  • ListClusterBackupsRequest
  • ListClusterBackupsResponse
  • Backup
  • ListHosts
  • ListClusterHostsRequest
  • ListClusterHostsResponse
  • Host
  • Resources
  • Service
  • AddHosts
  • AddClusterHostsRequest
  • HostSpec
  • Operation
  • AddClusterHostsMetadata
  • UpdateHosts
  • UpdateClusterHostsRequest
  • UpdateHostSpec
  • Operation
  • UpdateClusterHostsMetadata
  • DeleteHosts
  • DeleteClusterHostsRequest
  • Operation
  • DeleteClusterHostsMetadata