Cluster

JSON-представление
Методы

Набор методов для управления кластерами MySQL.

JSON-представление

{
  "id": "string",
  "folderId": "string",
  "createdAt": "string",
  "name": "string",
  "description": "string",
  "labels": "object",
  "environment": "string",
  "monitoring": [
    {
      "name": "string",
      "description": "string",
      "link": "string"
    }
  ],
  "config": {
    "version": "string",
    "resources": {
      "resourcePresetId": "string",
      "diskSize": "string",
      "diskTypeId": "string"
    },
    "backupWindowStart": {
      "hours": "integer",
      "minutes": "integer",
      "seconds": "integer",
      "nanos": "integer"
    },
    "access": {
      "dataLens": true
    },

    // `config` включает только одно из полей `mysqlConfig_5_7`, `mysqlConfig_8_0`
    "mysqlConfig_5_7": {
      "effectiveConfig": {
        "innodbBufferPoolSize": "integer",
        "maxConnections": "integer",
        "longQueryTime": "number",
        "generalLog": true,
        "auditLog": true,
        "sqlMode": [
          "string"
        ],
        "maxAllowedPacket": "integer",
        "defaultAuthenticationPlugin": "string"
      },
      "userConfig": {
        "innodbBufferPoolSize": "integer",
        "maxConnections": "integer",
        "longQueryTime": "number",
        "generalLog": true,
        "auditLog": true,
        "sqlMode": [
          "string"
        ],
        "maxAllowedPacket": "integer",
        "defaultAuthenticationPlugin": "string"
      },
      "defaultConfig": {
        "innodbBufferPoolSize": "integer",
        "maxConnections": "integer",
        "longQueryTime": "number",
        "generalLog": true,
        "auditLog": true,
        "sqlMode": [
          "string"
        ],
        "maxAllowedPacket": "integer",
        "defaultAuthenticationPlugin": "string"
      }
    },
    "mysqlConfig_8_0": {
      "effectiveConfig": {
        "innodbBufferPoolSize": "integer",
        "maxConnections": "integer",
        "longQueryTime": "number",
        "generalLog": true,
        "auditLog": true,
        "sqlMode": [
          "string"
        ],
        "maxAllowedPacket": "integer",
        "defaultAuthenticationPlugin": "string"
      },
      "userConfig": {
        "innodbBufferPoolSize": "integer",
        "maxConnections": "integer",
        "longQueryTime": "number",
        "generalLog": true,
        "auditLog": true,
        "sqlMode": [
          "string"
        ],
        "maxAllowedPacket": "integer",
        "defaultAuthenticationPlugin": "string"
      },
      "defaultConfig": {
        "innodbBufferPoolSize": "integer",
        "maxConnections": "integer",
        "longQueryTime": "number",
        "generalLog": true,
        "auditLog": true,
        "sqlMode": [
          "string"
        ],
        "maxAllowedPacket": "integer",
        "defaultAuthenticationPlugin": "string"
      }
    },
    // конец списка возможных полей`config`

  },
  "networkId": "string",
  "health": "string",
  "status": "string"
}

Поле	Описание
id	string Идентификатор кластера MySQL. Этот идентификатор Managed Service for MySQL генерирует при создании.
folderId	string Идентификатор каталога, которому принадлежит кластер MySQL.
createdAt	string (date-time) Строка в формате RFC3339.
name	string Имя кластера MySQL. Имя должно быть уникальным в каталоге, соответствовать RFC 1035 и иметь длину 1-63 символа.
description	string Описание кластера MySQL. Длина описания должна быть от 0 до 256 символов.
labels	object Пользовательские метки для кластера MySQL в виде пар `key:value`. Максимум 64 на ресурс.
environment	string Среда развертывания кластера MySQL. PRODUCTION: Стабильная среда с осторожной политикой обновления: во время регулярного обслуживания применяются только срочные исправления. PRESTABLE: Среда с более агрессивной политикой обновления: новые версии развертываются независимо от обратной совместимости.
monitoring[]	object Описание систем мониторинга, относящихся к данному кластеру MySQL.
monitoring[]. name	string Название системы мониторинга.
monitoring[]. description	string Описание системы мониторинга.
monitoring[]. link	string Ссылка на графики системы мониторинга для кластера MySQL.
config	object Конфигурация кластера MySQL.
config. version	string Версия серверного программного обеспечения MySQL.
config. resources	object
config. resources. resourcePresetId	string Идентификатор набора вычислительных ресурсов, доступных хосту (процессор, память и т. д.). Все доступные наборы ресурсов перечислены в документации.
config. resources. diskSize	string (int64) Объем хранилища, доступного хосту.
config. resources. diskTypeId	string Тип хранилища для хоста. Возможные значения: network-ssd — сетевой SSD-диск; local-ssd — локальное SSD-хранилище.
config. backupWindowStart	object Описывает время суток. Дата и часовой пояс либо не имеют значения, либо указаны другим образом. API может разрешить високосные секунды. Связанные типы: [google.type.Date][google.type.Date] и `google.protobuf.Timestamp`.
config. backupWindowStart. hours	integer (int32) Час в 24-часовом формате. Допустимые значения — от 0 до 23. API может разрешить значение "24:00:00" для таких сценариев, как время закрытия заведения.
config. backupWindowStart. minutes	integer (int32) Минута часа. Допустимые значения — от 0 до 59.
config. backupWindowStart. seconds	integer (int32) Секунда минуты. Обычно допустимые значения — от 0 до 59. API может разрешить значение 60, если поддерживаются високосные секунды.
config. backupWindowStart. nanos	integer (int32) Доли секунды, в наносекундах. Допустимые значения — от 0 до 999 999 999.
config. access	object
config. access. dataLens	boolean (boolean) Разрешить доступ для DataLens
config. mysqlConfig_5_7	object `config` включает только одно из полей `mysqlConfig_5_7`, `mysqlConfig_8_0`
config. mysqlConfig_5_7. effectiveConfig	object Действующие параметры для кластера MySQL 5.7 (сочетание параметров, определенных в userConfig и [default_config]). Поля и структура `MysqlConfig5_7` отражает параметры конфигурации MySQL 5.7.
config. mysqlConfig_5_7. effectiveConfig. innodbBufferPoolSize	integer (int64) Размер буфера InnoDB, который используется для кэширования данных таблиц и индексов. Подробнее см. в описании параметра в документации MySQL. Минимальное значение — 5242880.
config. mysqlConfig_5_7. effectiveConfig. maxConnections	integer (int64) Максимальное количество одновременных подключений, которые принимает MySQL. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 10 до 10000 включительно.
config. mysqlConfig_5_7. effectiveConfig. longQueryTime	number (double) Время, в течение которого запрос должен обрабатываться, прежде чем он начинает считаться медленным. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. effectiveConfig. generalLog	boolean (boolean) Включить запись общего лога запросов MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. effectiveConfig. auditLog	boolean (boolean) Включить запись лога аудита MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. effectiveConfig. sqlMode[]	string Режим SQL для сервера MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. effectiveConfig. maxAllowedPacket	integer (int64) Максимальный размер одного пакета в байтах. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 1024 до 134217728 включительно.
config. mysqlConfig_5_7. effectiveConfig. defaultAuthenticationPlugin	string Плагин аутентификации, используемый в управляемом кластере MySQL. MYSQL_NATIVE_PASSWORD: Использует Native Pluggable Authentication. SHA256_PASSWORD: Использует SHA-256 Pluggable Authentication.
config. mysqlConfig_5_7. userConfig	object Пользовательские настройки для кластера MySQL 5.7. Поля и структура `MysqlConfig5_7` отражает параметры конфигурации MySQL 5.7.
config. mysqlConfig_5_7. userConfig. innodbBufferPoolSize	integer (int64) Размер буфера InnoDB, который используется для кэширования данных таблиц и индексов. Подробнее см. в описании параметра в документации MySQL. Минимальное значение — 5242880.
config. mysqlConfig_5_7. userConfig. maxConnections	integer (int64) Максимальное количество одновременных подключений, которые принимает MySQL. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 10 до 10000 включительно.
config. mysqlConfig_5_7. userConfig. longQueryTime	number (double) Время, в течение которого запрос должен обрабатываться, прежде чем он начинает считаться медленным. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. userConfig. generalLog	boolean (boolean) Включить запись общего лога запросов MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. userConfig. auditLog	boolean (boolean) Включить запись лога аудита MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. userConfig. sqlMode[]	string Режим SQL для сервера MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. userConfig. maxAllowedPacket	integer (int64) Максимальный размер одного пакета в байтах. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 1024 до 134217728 включительно.
config. mysqlConfig_5_7. userConfig. defaultAuthenticationPlugin	string Плагин аутентификации, используемый в управляемом кластере MySQL. MYSQL_NATIVE_PASSWORD: Использует Native Pluggable Authentication. SHA256_PASSWORD: Использует SHA-256 Pluggable Authentication.
config. mysqlConfig_5_7. defaultConfig	object Конфигурация по умолчанию для кластера MySQL 5.7. Поля и структура `MysqlConfig5_7` отражает параметры конфигурации MySQL 5.7.
config. mysqlConfig_5_7. defaultConfig. innodbBufferPoolSize	integer (int64) Размер буфера InnoDB, который используется для кэширования данных таблиц и индексов. Подробнее см. в описании параметра в документации MySQL. Минимальное значение — 5242880.
config. mysqlConfig_5_7. defaultConfig. maxConnections	integer (int64) Максимальное количество одновременных подключений, которые принимает MySQL. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 10 до 10000 включительно.
config. mysqlConfig_5_7. defaultConfig. longQueryTime	number (double) Время, в течение которого запрос должен обрабатываться, прежде чем он начинает считаться медленным. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. defaultConfig. generalLog	boolean (boolean) Включить запись общего лога запросов MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. defaultConfig. auditLog	boolean (boolean) Включить запись лога аудита MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. defaultConfig. sqlMode[]	string Режим SQL для сервера MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_5_7. defaultConfig. maxAllowedPacket	integer (int64) Максимальный размер одного пакета в байтах. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 1024 до 134217728 включительно.
config. mysqlConfig_5_7. defaultConfig. defaultAuthenticationPlugin	string Плагин аутентификации, используемый в управляемом кластере MySQL. MYSQL_NATIVE_PASSWORD: Использует Native Pluggable Authentication. SHA256_PASSWORD: Использует SHA-256 Pluggable Authentication.
config. mysqlConfig_8_0	object `config` включает только одно из полей `mysqlConfig_5_7`, `mysqlConfig_8_0`
config. mysqlConfig_8_0. effectiveConfig	object Действующие параметры для кластера MySQL 8.0 (сочетание параметров, определенных в userConfig и [default_config]). Поля и структура `MysqlConfig8_0` отражает параметры конфигурации MySQL 8.0.
config. mysqlConfig_8_0. effectiveConfig. innodbBufferPoolSize	integer (int64) Размер буфера InnoDB, который используется для кэширования данных таблиц и индексов. Подробнее см. в описании переменной в документации MySQL. Минимальное значение — 5242880.
config. mysqlConfig_8_0. effectiveConfig. maxConnections	integer (int64) Максимальное количество одновременных подключений, которые принимает MySQL. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 10 до 10000 включительно.
config. mysqlConfig_8_0. effectiveConfig. longQueryTime	number (double) Время, в течение которого запрос должен обрабатываться, прежде чем он начинает считаться медленным. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. effectiveConfig. generalLog	boolean (boolean) Включить запись общего лога запросов MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. effectiveConfig. auditLog	boolean (boolean) Включить запись лога аудита MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. effectiveConfig. sqlMode[]	string Режим SQL для сервера MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. effectiveConfig. maxAllowedPacket	integer (int64) Максимальный размер одного пакета в байтах. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 1024 до 134217728 включительно.
config. mysqlConfig_8_0. effectiveConfig. defaultAuthenticationPlugin	string Плагин аутентификации, используемый в управляемом кластере MySQL. MYSQL_NATIVE_PASSWORD: Использует Native Pluggable Authentication. CACHING_SHA2_PASSWORD: Использует Caching SHA-2 Pluggable Authentication. SHA256_PASSWORD: Использует SHA-256 Pluggable Authentication.
config. mysqlConfig_8_0. userConfig	object Пользовательские настройки для кластера MySQL 8.0. Поля и структура `MysqlConfig8_0` отражает параметры конфигурации MySQL 8.0.
config. mysqlConfig_8_0. userConfig. innodbBufferPoolSize	integer (int64) Размер буфера InnoDB, который используется для кэширования данных таблиц и индексов. Подробнее см. в описании переменной в документации MySQL. Минимальное значение — 5242880.
config. mysqlConfig_8_0. userConfig. maxConnections	integer (int64) Максимальное количество одновременных подключений, которые принимает MySQL. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 10 до 10000 включительно.
config. mysqlConfig_8_0. userConfig. longQueryTime	number (double) Время, в течение которого запрос должен обрабатываться, прежде чем он начинает считаться медленным. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. userConfig. generalLog	boolean (boolean) Включить запись общего лога запросов MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. userConfig. auditLog	boolean (boolean) Включить запись лога аудита MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. userConfig. sqlMode[]	string Режим SQL для сервера MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. userConfig. maxAllowedPacket	integer (int64) Максимальный размер одного пакета в байтах. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 1024 до 134217728 включительно.
config. mysqlConfig_8_0. userConfig. defaultAuthenticationPlugin	string Плагин аутентификации, используемый в управляемом кластере MySQL. MYSQL_NATIVE_PASSWORD: Использует Native Pluggable Authentication. CACHING_SHA2_PASSWORD: Использует Caching SHA-2 Pluggable Authentication. SHA256_PASSWORD: Использует SHA-256 Pluggable Authentication.
config. mysqlConfig_8_0. defaultConfig	object Конфигурация по умолчанию для кластера MySQL 8.0. Поля и структура `MysqlConfig8_0` отражает параметры конфигурации MySQL 8.0.
config. mysqlConfig_8_0. defaultConfig. innodbBufferPoolSize	integer (int64) Размер буфера InnoDB, который используется для кэширования данных таблиц и индексов. Подробнее см. в описании переменной в документации MySQL. Минимальное значение — 5242880.
config. mysqlConfig_8_0. defaultConfig. maxConnections	integer (int64) Максимальное количество одновременных подключений, которые принимает MySQL. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 10 до 10000 включительно.
config. mysqlConfig_8_0. defaultConfig. longQueryTime	number (double) Время, в течение которого запрос должен обрабатываться, прежде чем он начинает считаться медленным. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. defaultConfig. generalLog	boolean (boolean) Включить запись общего лога запросов MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. defaultConfig. auditLog	boolean (boolean) Включить запись лога аудита MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. defaultConfig. sqlMode[]	string Режим SQL для сервера MySQL. Подробнее см. в описании переменной в документации MySQL.
config. mysqlConfig_8_0. defaultConfig. maxAllowedPacket	integer (int64) Максимальный размер одного пакета в байтах. Подробнее см. в описании переменной в документации MySQL. Допустимые значения — от 1024 до 134217728 включительно.
config. mysqlConfig_8_0. defaultConfig. defaultAuthenticationPlugin	string Плагин аутентификации, используемый в управляемом кластере MySQL. MYSQL_NATIVE_PASSWORD: Использует Native Pluggable Authentication. CACHING_SHA2_PASSWORD: Использует Caching SHA-2 Pluggable Authentication. SHA256_PASSWORD: Использует SHA-256 Pluggable Authentication.
networkId	string Идентификатор сети, к которой принадлежит кластер.
health	string Агрегированная работоспособность кластера. HEALTH_UNKNOWN: Состояние кластера неизвестно ([Host.health] для каждого хоста в кластере — UNKNOWN). ALIVE: Кластер работает нормально ([Host.health] для каждого хоста в кластере — ALIVE). DEAD: Кластер не работает ([Host.health] для каждого узла в кластере — DEAD). DEGRADED: Кластер работает неоптимально ([Host.health] по крайней мере для одного узла в кластере не ALIVE).
status	string Текущее состояние кластера. STATUS_UNKNOWN: Состояние кластера неизвестно. CREATING: Кластер создается. RUNNING: Кластер работает нормально. ERROR: На кластере произошла ошибка, блокирующая работу. UPDATING: Кластер изменяется. STOPPING: Кластер останавливается. STOPPED: Кластер остановлен. STARTING: Кластер запускается.

Методы

Метод	Описание
addHosts	Создает новые хосты для кластера.
backup	Создает резервную копию для указанного кластера MySQL.
create	Создает кластер MySQL в указанном каталоге.
delete	Удаляет указанный кластер MySQL.
deleteHosts	Удаляет указанные хосты кластера.
get	Возвращает указанный кластер MySQL.
list	Возвращает список кластеров MySQL, принадлежащих указанному каталогу.
listBackups	Получает список доступных резервных копий для указанного кластера MySQL.
listHosts	Получает список хостов для указанного кластера MySQL.
listLogs	Получает логи для указанного кластера MySQL.
listOperations	Возвращает список операций для указанного кластера MySQL.
move	Перемещает кластер MySQL в указанный каталог.
restore	Создает новый кластер MySQL с использованием указанной резервной копии.
start	Запускает указанный кластер MySQL.
startFailover	Запускает ручное переключение мастера для указанного кластера MySQL.
stop	Останавливает указанный кластер MySQL.
update	Изменяет указанный кластер MySQL.