Метод restore

HTTP-запрос
Параметры в теле запроса
Ответ

Создает новый кластер ClickHouse с использованием указанной резервной копии.

HTTP-запрос

POST https://mdb.api.cloud.yandex.net/managed-clickhouse/v1/clusters:restore

Параметры в теле запроса

{
  "backupId": "string",
  "name": "string",
  "description": "string",
  "labels": "object",
  "environment": "string",
  "configSpec": {
    "version": "string",
    "clickhouse": {
      "config": {
        "logLevel": "string",
        "mergeTree": {
          "replicatedDeduplicationWindow": "integer",
          "replicatedDeduplicationWindowSeconds": "integer",
          "partsToDelayInsert": "integer",
          "partsToThrowInsert": "integer",
          "maxReplicatedMergesInQueue": "integer",
          "numberOfFreeEntriesInPoolToLowerMaxSizeOfMerge": "integer",
          "maxBytesToMergeAtMinSpaceInPool": "integer"
        },
        "compression": [
          {
            "method": "string",
            "minPartSize": "string",
            "minPartSizeRatio": "number"
          }
        ],
        "dictionaries": [
          {
            "name": "string",
            "structure": {
              "id": {
                "name": "string"
              },
              "key": {
                "attributes": [
                  {
                    "name": "string",
                    "type": "string",
                    "nullValue": "string",
                    "expression": "string",
                    "hierarchical": true,
                    "injective": true
                  }
                ]
              },
              "rangeMin": {
                "name": "string",
                "type": "string",
                "nullValue": "string",
                "expression": "string",
                "hierarchical": true,
                "injective": true
              },
              "rangeMax": {
                "name": "string",
                "type": "string",
                "nullValue": "string",
                "expression": "string",
                "hierarchical": true,
                "injective": true
              },
              "attributes": [
                {
                  "name": "string",
                  "type": "string",
                  "nullValue": "string",
                  "expression": "string",
                  "hierarchical": true,
                  "injective": true
                }
              ]
            },
            "layout": {
              "type": "string",
              "sizeInCells": "string"
            },

            // `configSpec.clickhouse.config.dictionaries[]` включает только одно из полей `httpSource`, `mysqlSource`, `clickhouseSource`, `mongodbSource`, `postgresqlSource`
            "fixedLifetime": "string",
            "lifetimeRange": {
              "min": "string",
              "max": "string"
            },
            // конец списка возможных полей`configSpec.clickhouse.config.dictionaries[]`

            "httpSource": {
              "url": "string",
              "format": "string"
            },
            "mysqlSource": {
              "db": "string",
              "table": "string",
              "port": "string",
              "user": "string",
              "password": "string",
              "replicas": [
                {
                  "host": "string",
                  "priority": "string",
                  "port": "string",
                  "user": "string",
                  "password": "string"
                }
              ],
              "where": "string",
              "invalidateQuery": "string"
            },
            "clickhouseSource": {
              "db": "string",
              "table": "string",
              "host": "string",
              "port": "string",
              "user": "string",
              "password": "string",
              "where": "string"
            },
            "mongodbSource": {
              "db": "string",
              "collection": "string",
              "host": "string",
              "port": "string",
              "user": "string",
              "password": "string"
            },
            "postgresqlSource": {
              "db": "string",
              "table": "string",
              "hosts": [
                "string"
              ],
              "port": "string",
              "user": "string",
              "password": "string",
              "invalidateQuery": "string",
              "sslMode": "string"
            }
          }
        ],
        "graphiteRollup": [
          {
            "name": "string",
            "patterns": [
              {
                "regexp": "string",
                "function": "string",
                "retention": [
                  {
                    "age": "string",
                    "precision": "string"
                  }
                ]
              }
            ]
          }
        ],
        "maxConnections": "integer",
        "maxConcurrentQueries": "integer",
        "keepAliveTimeout": "integer",
        "uncompressedCacheSize": "integer",
        "markCacheSize": "integer",
        "maxTableSizeToDrop": "integer",
        "maxPartitionSizeToDrop": "integer",
        "builtinDictionariesReloadInterval": "integer",
        "timezone": "string",
        "geobaseUri": "string"
      },
      "resources": {
        "resourcePresetId": "string",
        "diskSize": "string",
        "diskTypeId": "string"
      }
    },
    "zookeeper": {
      "resources": {
        "resourcePresetId": "string",
        "diskSize": "string",
        "diskTypeId": "string"
      }
    },
    "backupWindowStart": {
      "hours": "integer",
      "minutes": "integer",
      "seconds": "integer",
      "nanos": "integer"
    },
    "access": {
      "dataLens": true,
      "webSql": true,
      "metrika": true,
      "serverless": true
    }
  },
  "hostSpecs": [
    {
      "zoneId": "string",
      "type": "string",
      "subnetId": "string",
      "assignPublicIp": true,
      "shardName": "string"
    }
  ],
  "networkId": "string"
}

Поле	Описание
backupId	string Обязательное поле. Идентификатор резервной копии, из которой следует создать кластер. Чтобы получить идентификатор резервной копии, используйте запрос listBackups.
name	string Обязательное поле. Имя нового кластера ClickHouse. Имя должно быть уникальным в каталоге. Максимальная длина строки в символах — 63. Значение должно соответствовать регулярному выражению `[a-zA-Z0-9_-]*`.
description	string Описание нового кластера ClickHouse. Максимальная длина строки в символах — 256.
labels	object Пользовательские метки для кластера ClickHouse `key:value` пары. Максимум 64 на ресурс. Например, "project": "mvp" или "source": "dictionary". Не более 64 на ресурс. Максимальная длина строки в символах для каждого ключа — 63. Каждый ключ должен соответствовать регулярному выражению `[a-z][-_0-9a-z]`. Максимальная длина строки в символах для каждого значения — 63. Каждое значение должно соответствовать регулярному выражению `[-_0-9a-z]`.
environment	string Обязательное поле. Среда развертывания для нового кластера ClickHouse. Среда развертывания. PRODUCTION: Стабильная среда с осторожной политикой обновления: во время регулярного обслуживания применяются только срочные исправления. PRESTABLE: Среда с более агрессивной политикой обновления: новые версии развертываются независимо от обратной совместимости.
configSpec	object Обязательное поле. Конфигурация для создаваемого кластера ClickHouse.
configSpec. version	string Версия серверного программного обеспечения ClickHouse.
configSpec. clickhouse	object Конфигурация и ресурсы для сервера ClickHouse.
configSpec. clickhouse. config	object Конфигурация для сервера ClickHouse. Настройки конфигурации ClickHouse. Подробное описание для каждого набора настроек доступно в документации ClickHouse. Любые настройки, не перечисленные здесь, не поддерживаются.
configSpec. clickhouse. config. logLevel	string Уровень логирования для кластера ClickHouse. Допустимые значения: "TRACE", "DEBUG", "INFORMATION", "WARNING", "ERROR". См. описание в документации ClickHouse.
configSpec. clickhouse. config. mergeTree	object Параметры движка MergeTree. См. описание в документации ClickHouse. Настройки движка таблицы MergeTree.
configSpec. clickhouse. config. mergeTree. replicatedDeduplicationWindow	integer (int64) Количество блоков хэшей, которые должен хранить ZooKeeper. Смотрите подробное описание в ClickHouse sources.
configSpec. clickhouse. config. mergeTree. replicatedDeduplicationWindowSeconds	integer (int64) Период времени, в течение которого следует хранить блоки хэшей. См. описание в ClickHouse sources.
configSpec. clickhouse. config. mergeTree. partsToDelayInsert	integer (int64)
configSpec. clickhouse. config. mergeTree. partsToThrowInsert	integer (int64)
configSpec. clickhouse. config. mergeTree. maxReplicatedMergesInQueue	integer (int64)
configSpec. clickhouse. config. mergeTree. numberOfFreeEntriesInPoolToLowerMaxSizeOfMerge	integer (int64)
configSpec. clickhouse. config. mergeTree. maxBytesToMergeAtMinSpaceInPool	integer (int64)
configSpec. clickhouse. config. compression[]	object Параметры сжатия для кластера ClickHouse. См. подробное описание в документации ClickHouse.
configSpec. clickhouse. config. compression[]. method	string Метод сжатия, используемый для указанной комбинации "min_part_size" и "min_part_size_ratio". LZ4: LZ4 compression algorithm. ZSTD: Zstandard compression algorithm.
configSpec. clickhouse. config. compression[]. minPartSize	string (int64) Минимальный размер части таблицы. Минимальное значение — 1.
configSpec. clickhouse. config. compression[]. minPartSizeRatio	number (double) Минимальное отношение части к размеру всех данных в таблице.
configSpec. clickhouse. config. dictionaries[]	object Конфигурация внешних словарей для кластера ClickHouse. См. подробное описание в документации ClickHouse.
configSpec. clickhouse. config. dictionaries[]. name	string Обязательное поле. Имя внешнего словаря.
configSpec. clickhouse. config. dictionaries[]. structure	object Обязательное поле. Набор атрибутов внешнего словаря. Подробное описание см. в документации ClickHouse.
configSpec. clickhouse. config. dictionaries[]. structure. id	object Один столбец с числовыми ключами для словаря. Числовой ключ.
configSpec. clickhouse. config. dictionaries[]. structure. id. name	string Обязательное поле. Имя числового ключа.
configSpec. clickhouse. config. dictionaries[]. structure. key	object Составной ключ для словаря, содержащего один или несколько столбцов с ключами. Подробнее см. в документации ClickHouse. Составной ключ.
configSpec. clickhouse. config. dictionaries[]. structure. key. attributes[]	object Обязательное поле. Поля составного ключа. Должен содержать хотя бы один элемент.
configSpec. clickhouse. config. dictionaries[]. structure. key. attributes[]. name	string Обязательное поле. Имя столбца.
configSpec. clickhouse. config. dictionaries[]. structure. key. attributes[]. type	string Обязательное поле. Тип столбца.
configSpec. clickhouse. config. dictionaries[]. structure. key. attributes[]. nullValue	string Значение по умолчанию для элемента без данных (например, пустая строка).
configSpec. clickhouse. config. dictionaries[]. structure. key. attributes[]. expression	string Выражение, описывающее атрибут, если применимо.
configSpec. clickhouse. config. dictionaries[]. structure. key. attributes[]. hierarchical	boolean (boolean) Признак поддержки иерархии. Значение по умолчанию "false".
configSpec. clickhouse. config. dictionaries[]. structure. key. attributes[]. injective	boolean (boolean) Признакт инъективного отображения "id -> атрибут". Значение по умолчанию "false".
configSpec. clickhouse. config. dictionaries[]. structure. rangeMin	object Поле, содержащее начало диапазона для словарей, которые хранятся в памяти способом "RANGE_HASHED". Подробнее см.документации ClickHouse
configSpec. clickhouse. config. dictionaries[]. structure. rangeMin. name	string Обязательное поле. Имя столбца.
configSpec. clickhouse. config. dictionaries[]. structure. rangeMin. type	string Обязательное поле. Тип столбца.
configSpec. clickhouse. config. dictionaries[]. structure. rangeMin. nullValue	string Значение по умолчанию для элемента без данных (например, пустая строка).
configSpec. clickhouse. config. dictionaries[]. structure. rangeMin. expression	string Выражение, описывающее атрибут, если применимо.
configSpec. clickhouse. config. dictionaries[]. structure. rangeMin. hierarchical	boolean (boolean) Признак поддержки иерархии. Значение по умолчанию "false".
configSpec. clickhouse. config. dictionaries[]. structure. rangeMin. injective	boolean (boolean) Признакт инъективного отображения "id -> атрибут". Значение по умолчанию "false".
configSpec. clickhouse. config. dictionaries[]. structure. rangeMax	object Поле, содержащее конец диапазона для словарей, которые хранятся в памяти способом "RANGE_HASHED". Подробнее см.документации ClickHouse
configSpec. clickhouse. config. dictionaries[]. structure. rangeMax. name	string Обязательное поле. Имя столбца.
configSpec. clickhouse. config. dictionaries[]. structure. rangeMax. type	string Обязательное поле. Тип столбца.
configSpec. clickhouse. config. dictionaries[]. structure. rangeMax. nullValue	string Значение по умолчанию для элемента без данных (например, пустая строка).
configSpec. clickhouse. config. dictionaries[]. structure. rangeMax. expression	string Выражение, описывающее атрибут, если применимо.
configSpec. clickhouse. config. dictionaries[]. structure. rangeMax. hierarchical	boolean (boolean) Признак поддержки иерархии. Значение по умолчанию "false".
configSpec. clickhouse. config. dictionaries[]. structure. rangeMax. injective	boolean (boolean) Признакт инъективного отображения "id -> атрибут". Значение по умолчанию "false".
configSpec. clickhouse. config. dictionaries[]. structure. attributes[]	object Обязательное поле. Описание полей, доступных для запросов к базе данных. Подробнее см. в документации ClickHouse. Должен содержать хотя бы один элемент.
configSpec. clickhouse. config. dictionaries[]. structure. attributes[]. name	string Обязательное поле. Имя столбца.
configSpec. clickhouse. config. dictionaries[]. structure. attributes[]. type	string Обязательное поле. Тип столбца.
configSpec. clickhouse. config. dictionaries[]. structure. attributes[]. nullValue	string Значение по умолчанию для элемента без данных (например, пустая строка).
configSpec. clickhouse. config. dictionaries[]. structure. attributes[]. expression	string Выражение, описывающее атрибут, если применимо.
configSpec. clickhouse. config. dictionaries[]. structure. attributes[]. hierarchical	boolean (boolean) Признак поддержки иерархии. Значение по умолчанию "false".
configSpec. clickhouse. config. dictionaries[]. structure. attributes[]. injective	boolean (boolean) Признакт инъективного отображения "id -> атрибут". Значение по умолчанию "false".
configSpec. clickhouse. config. dictionaries[]. layout	object Обязательное поле. Макет для хранения словаря в памяти. Подробное описание см. в документации ClickHouse. Макет, определяющий способ хранения словаря в памяти.
configSpec. clickhouse. config. dictionaries[]. layout. type	string Обязательное поле. Тип макета для внешнего словаря. FLAT: Весь словарь хранится в памяти в виде плоских массивов. Доступно для любых источников словарей. HASHED: Весь словарь хранится в памяти в виде хэш-таблицы. Доступно для любых источников словарей. COMPLEX_KEY_HASHED: Аналогичен HASHED, для использования с составными ключами. Доступно для любых источников словарей. RANGE_HASHED: Весь словарь хранится в памяти в виде хэш-таблицы, с упорядоченным массивом диапазонов и соответствующих им значений. Доступно для любых источников словарей. CACHE: Словарь хранится в кэше с заданным количеством ячеек. Доступно для источников словарей MySQL, ClickHouse и HTTP. COMPLEX_KEY_CACHE: Аналогичен CACHE, для использования с составными ключами. Доступно для источников словарей MySQL, ClickHouse и HTTP.
configSpec. clickhouse. config. dictionaries[]. layout. sizeInCells	string (int64) Количество ячеек в кэше. Округляется до степени двойки. Применимо только для типов макета CACHE и COMPLEX_KEY_CACHE.
configSpec. clickhouse. config. dictionaries[]. fixedLifetime	string (int64) `configSpec.clickhouse.config.dictionaries[]` включает только одно из полей `fixedLifetime`, `lifetimeRange` Жесткий интервал между обновлениями словаря.
configSpec. clickhouse. config. dictionaries[]. lifetimeRange	object Диапазон интервалов между обновлениями словаря, из которых может выбирать ClickHouse. `configSpec.clickhouse.config.dictionaries[]` включает только одно из полей `fixedLifetime`, `lifetimeRange`
configSpec. clickhouse. config. dictionaries[]. lifetimeRange. min	string (int64) Минимальное время жизни словаря.
configSpec. clickhouse. config. dictionaries[]. lifetimeRange. max	string (int64) Максимальное время жизни словаря.
configSpec. clickhouse. config. dictionaries[]. httpSource	object HTTP-источник для словаря. `configSpec.clickhouse.config.dictionaries[]` включает только одно из полей `httpSource`, `mysqlSource`, `clickhouseSource`, `mongodbSource`, `postgresqlSource`
configSpec. clickhouse. config. dictionaries[]. httpSource. url	string Обязательное поле. URL внешнего словаря, доступного по HTTP.
configSpec. clickhouse. config. dictionaries[]. httpSource. format	string Обязательное поле. Формат данных. Допустимые значения: все форматы, поддерживаемые диалектом ClickHouse SQL.
configSpec. clickhouse. config. dictionaries[]. mysqlSource	object MySQL-источник для словаря. `configSpec.clickhouse.config.dictionaries[]` включает только одно из полей `httpSource`, `mysqlSource`, `clickhouseSource`, `mongodbSource`, `postgresqlSource`
configSpec. clickhouse. config. dictionaries[]. mysqlSource. db	string Обязательное поле. Имя базы данных MySQL, к которой нужно подключаться.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. table	string Обязательное поле. Имя таблицы базы данных, которую следует использовать в качестве словаря ClickHouse.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. port	string (int64) Порт по умолчанию, который нужно использовать при подключении к реплике источника словаря. Допустимые значения — от 0 до 65535 включительно.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. user	string Имя пользователя по умолчанию для реплик источника словаря.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. password	string Пароль пользователя по умолчанию для реплик источника словаря.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. replicas[]	object Обязательное поле. Список реплик базы данных MySQL, используемой в качестве источника словаря. Должен содержать хотя бы один элемент.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. replicas[]. host	string Обязательное поле. Хост реплики MySQL. Максимальная длина строки в символах — 253.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. replicas[]. priority	string (int64) Обязательное поле. Приоритет реплики, который ClickHouse должен учитывать при подключении. Реплике с наивысшим приоритетом должно соответствовать наименьшее значение в этом поле. Значение должно быть больше 0.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. replicas[]. port	string (int64) Порт, который нужно использовать при подключении к реплике. Если для какой-либо реплики не указан порт, ClickHouse использует порт, указанный для источника. Допустимые значения — от 0 до 65535 включительно.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. replicas[]. user	string Имя пользователя базы данных MySQL.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. replicas[]. password	string Пароль пользователя базы данных MySQL.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. where	string Критерии выбора данных в указанной таблице MySQL.
configSpec. clickhouse. config. dictionaries[]. mysqlSource. invalidateQuery	string Запрос на проверку состояния словаря, который позволит извлекать только обновленные данные. Дополнительные сведения см. в документации ClickHouse on dictionaries.
configSpec. clickhouse. config. dictionaries[]. clickhouseSource	object ClickHouse-источник для словаря. `configSpec.clickhouse.config.dictionaries[]` включает только одно из полей `httpSource`, `mysqlSource`, `clickhouseSource`, `mongodbSource`, `postgresqlSource`
configSpec. clickhouse. config. dictionaries[]. clickhouseSource. db	string Обязательное поле. Имя базы данных ClickHouse.
configSpec. clickhouse. config. dictionaries[]. clickhouseSource. table	string Обязательное поле. Имя таблицы в указанной базе данных, используемой в качестве источника словаря.
configSpec. clickhouse. config. dictionaries[]. clickhouseSource. host	string Обязательное поле. Хост ClickHouse для указанной базы данных. Максимальная длина строки в символах — 253.
configSpec. clickhouse. config. dictionaries[]. clickhouseSource. port	string (int64) Порт для подключения к хосту. Допустимые значения — от 0 до 65535 включительно.
configSpec. clickhouse. config. dictionaries[]. clickhouseSource. user	string Обязательное поле. Имя пользователя базы данных ClickHouse.
configSpec. clickhouse. config. dictionaries[]. clickhouseSource. password	string Пароль пользователя базы данных ClickHouse.
configSpec. clickhouse. config. dictionaries[]. clickhouseSource. where	string Критерии выбора данных в указанной таблице ClickHouse.
configSpec. clickhouse. config. dictionaries[]. mongodbSource	object MongoDB-источник для словаря. `configSpec.clickhouse.config.dictionaries[]` включает только одно из полей `httpSource`, `mysqlSource`, `clickhouseSource`, `mongodbSource`, `postgresqlSource`
configSpec. clickhouse. config. dictionaries[]. mongodbSource. db	string Обязательное поле. Имя базы данных MongoDB.
configSpec. clickhouse. config. dictionaries[]. mongodbSource. collection	string Обязательное поле. Имя коллекции в указанной базе данных, которую следует использовать в качестве источника словаря.
configSpec. clickhouse. config. dictionaries[]. mongodbSource. host	string Обязательное поле. Хост MongoDB для указанной базы данных. Максимальная длина строки в символах — 253.
configSpec. clickhouse. config. dictionaries[]. mongodbSource. port	string (int64) Порт для подключения к хосту. Допустимые значения — от 0 до 65535 включительно.
configSpec. clickhouse. config. dictionaries[]. mongodbSource. user	string Обязательное поле. Имя пользователя базы данных MongoDB.
configSpec. clickhouse. config. dictionaries[]. mongodbSource. password	string Пароль пользователя базы данных MongoDB.
configSpec. clickhouse. config. dictionaries[]. postgresqlSource	object PostgreSQL-источник для словаря. `configSpec.clickhouse.config.dictionaries[]` включает только одно из полей `httpSource`, `mysqlSource`, `clickhouseSource`, `mongodbSource`, `postgresqlSource`
configSpec. clickhouse. config. dictionaries[]. postgresqlSource. db	string Обязательное поле. Имя базы данных PostrgreSQL.
configSpec. clickhouse. config. dictionaries[]. postgresqlSource. table	string Обязательное поле. Имя таблицы в указанной базе данных, используемой в качестве источника словаря.
configSpec. clickhouse. config. dictionaries[]. postgresqlSource. hosts[]	string Обязательное поле. Имя хоста PostrgreSQL. Должен содержать хотя бы один элемент.
configSpec. clickhouse. config. dictionaries[]. postgresqlSource. port	string (int64) Порт для подключения к хосту. Допустимые значения — от 0 до 65535 включительно.
configSpec. clickhouse. config. dictionaries[]. postgresqlSource. user	string Обязательное поле. Имя пользователя базы данных PostrgreSQL.
configSpec. clickhouse. config. dictionaries[]. postgresqlSource. password	string Пароль пользователя базы данных PostrgreSQL.
configSpec. clickhouse. config. dictionaries[]. postgresqlSource. invalidateQuery	string Запрос на проверку состояния словаря, который позволит извлекать только обновленные данные. Дополнительные сведения см. в документации ClickHouse on dictionaries.
configSpec. clickhouse. config. dictionaries[]. postgresqlSource. sslMode	string Режим SSL TCP/IP соединения с хостом PostgreSQL. Дополнительные сведения см. в PostgreSQL documentation. DISABLE: SSL-соединение не используется. ALLOW: Сначала предпринимается попытка установить незашифрованное соединение. Если это не удается, устанавливается SSL-соединение. PREFER: Сначала предпринимается попытка установить SSL-соединение. Если это не удается, устанавливается незашифрованное соединение. VERIFY_CA: Устанавливается только SSL-соединение и только при условии, что сертификат выдан доверенным центром сертификации (CA). VERIFY_FULL: Устанавливается только SSL-соединение и только при условии, что сертификат выдан доверенным центром сертификации и что имя хоста сервера совпадает с указанным в сертификате.
configSpec. clickhouse. config. graphiteRollup[]	object Параметры свертки для движка таблицы GraphiteMergeTree.
configSpec. clickhouse. config. graphiteRollup[]. name	string Обязательное поле. Имя указанной комбинации параметров для свертки Graphite.
configSpec. clickhouse. config. graphiteRollup[]. patterns[]	object Обязательное поле. Шаблон, используемый для свертки. Должен содержать хотя бы один элемент.
configSpec. clickhouse. config. graphiteRollup[]. patterns[]. regexp	string Шаблон для имен метрик.
configSpec. clickhouse. config. graphiteRollup[]. patterns[]. function	string Обязательное поле. Имя агрегирующей функции, которую следует применить к данным старше возраста, указанного в "`retention`".
configSpec. clickhouse. config. graphiteRollup[]. patterns[]. retention[]	object Обязательное поле. Возраст данных, которые следует использовать для прореживания. Должен содержать хотя бы один элемент.
configSpec. clickhouse. config. graphiteRollup[]. patterns[]. retention[]. age	string (int64) Минимальный возраст данных в секундах. Значение должно быть больше 0.
configSpec. clickhouse. config. graphiteRollup[]. patterns[]. retention[]. precision	string (int64) Точность определения возраста данных, в секундах. Значение должно быть больше 0.
configSpec. clickhouse. config. maxConnections	integer (int64) Максимальное количество входящих подключений. Минимальное значение — 10.
configSpec. clickhouse. config. maxConcurrentQueries	integer (int64) Максимальное количество одновременно обрабатываемых запросов. Минимальное значение — 10.
configSpec. clickhouse. config. keepAliveTimeout	integer (int64) Количество миллисекунд, в течение которых ClickHouse ожидает входящие запросы прежде чем закрыть подключение.
configSpec. clickhouse. config. uncompressedCacheSize	integer (int64) Размер кэша (в байтах) для несжатых данных, используемых таблицами MergeTree. См. подробное описание в документации ClickHouse.
configSpec. clickhouse. config. markCacheSize	integer (int64) Примерный размер (в байтах) кэша «меток», используемых таблицами MergeTree. Подробнее в документации ClickHouse. Значение должно быть больше 5368709120.
configSpec. clickhouse. config. maxTableSizeToDrop	integer (int64) Максимальный размер таблицы, которую можно удалить с помощью запроса DROP. См. подробное описание в документации ClickHouse.
configSpec. clickhouse. config. maxPartitionSizeToDrop	integer (int64) Максимальный размер раздела, который можно удалить с помощью запроса DROP. См. подробное описание в документации ClickHouse.
configSpec. clickhouse. config. builtinDictionariesReloadInterval	integer (int64) Параметр устарел и не имеет никакого эффекта.
configSpec. clickhouse. config. timezone	string Часовой пояс сервера, используемый в преобразованиях полей DateTime. Указывается как идентификатор IANA. См. подробное описание в документации ClickHouse.
configSpec. clickhouse. config. geobaseUri	string
configSpec. clickhouse. resources	object Ресурсы, выделенные хостам ClickHouse.
configSpec. clickhouse. resources. resourcePresetId	string Идентификатор набора вычислительных ресурсов, доступных хосту (процессор, память и т. д.). Все доступные наборы ресурсов перечислены в документации.
configSpec. clickhouse. resources. diskSize	string (int64) Объем хранилища, доступного хосту, в байтах.
configSpec. clickhouse. resources. diskTypeId	string Тип хранилища для хоста. Возможные значения: network-hdd — сетевой HDD-диск; network-ssd — сетевой SSD-диск; local-ssd — локальное SSD-хранилище.
configSpec. zookeeper	object Конфигурация и ресурсы для сервера ZooKeeper.
configSpec. zookeeper. resources	object Ресурсы, выделенные хостам ZooKeeper. Если не задано, будет использоваться минимальный доступный набор ресурсов. Все доступные наборы ресурсов можно получить с помощью запроса list.
configSpec. zookeeper. resources. resourcePresetId	string Идентификатор набора вычислительных ресурсов, доступных хосту (процессор, память и т. д.). Все доступные наборы ресурсов перечислены в документации.
configSpec. zookeeper. resources. diskSize	string (int64) Объем хранилища, доступного хосту, в байтах.
configSpec. zookeeper. resources. diskTypeId	string Тип хранилища для хоста. Возможные значения: network-hdd — сетевой HDD-диск; network-ssd — сетевой SSD-диск; local-ssd — локальное SSD-хранилище.
configSpec. backupWindowStart	object Время запуска ежедневного резервного копирования, в часовом поясе UTC. Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and google.protobuf.Timestamp.
configSpec. backupWindowStart. hours	integer (int32) Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
configSpec. backupWindowStart. minutes	integer (int32) Minutes of hour of day. Must be from 0 to 59.
configSpec. backupWindowStart. seconds	integer (int32) Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
configSpec. backupWindowStart. nanos	integer (int32) Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
configSpec. access	object Политика доступа к БД
configSpec. access. dataLens	boolean (boolean) Разрешить доступ для DataLens
configSpec. access. webSql	boolean (boolean) Разрешить доступ для Web SQL
configSpec. access. metrika	boolean (boolean) Разрешить доступ для Metrika
configSpec. access. serverless	boolean (boolean) Разрешить доступ для Serverless
hostSpecs[]	object Обязательное поле. Конфигурации для хостов ClickHouse, которые должны быть созданы для кластера, создаваемого из резервной копии. Должен содержать хотя бы один элемент.
hostSpecs[]. zoneId	string Идентификатор зоны доступности, в которой находится хост. Чтобы получить список доступных зон, используйте запрос list. Максимальная длина строки в символах — 50.
hostSpecs[]. type	string Обязательное поле. Тип развертываемого хоста. CLICKHOUSE: Хост ClickHouse. ZOOKEEPER: Хост ZooKeeper.
hostSpecs[]. subnetId	string Идентификатор подсети, к которой должен принадлежать хост. Эта подсеть должна быть частью сети, к которой принадлежит кластер. Идентификатор сети задается в поле Cluster.networkId. Максимальная длина строки в символах — 50.
hostSpecs[]. assignPublicIp	boolean (boolean) Должен ли хост получить публичный IP-адрес при создании. После создания узла этот параметр изменить нельзя. Чтобы удалить назначенный публичный IP-адрес или назначить публичный IP уже созданному хосту, пересоздайте хост с нужным значением поля `assignPublicIp`. Возможные значения: false — не назначать хосту публичный IP-адрес. true — у хоста должен быть публичный IP-адрес.
hostSpecs[]. shardName	string Имя шарда, которому принадлежит хост. Максимальная длина строки в символах — 63. Значение должно соответствовать регулярному выражению `[a-zA-Z0-9_-]*`.
networkId	string Обязательное поле. Идентификатор сети, в которой нужно создать кластер. Максимальная длина строки в символах — 50.

Ответ

HTTP Code: 200 - OK

{
  "id": "string",
  "description": "string",
  "createdAt": "string",
  "createdBy": "string",
  "modifiedAt": "string",
  "done": true,
  "metadata": "object",

  //  включает только одно из полей `error`, `response`
  "error": {
    "code": "integer",
    "message": "string",
    "details": [
      "object"
    ]
  },
  "response": "object",
  // конец списка возможных полей

}

Ресурс Operation. Дополнительные сведения см. в разделе
Объект Operation.

Поле	Описание
id	string Идентификатор операции.
description	string Описание операции. Длина описания должна быть от 0 до 256 символов.
createdAt	string (date-time) Время создания ресурса в формате в RFC3339. Строка в формате RFC3339.
createdBy	string Идентификатор пользователя или сервисного аккаунта, инициировавшего операцию.
modifiedAt	string (date-time) Время, когда ресурс Operation последний раз обновлялся. Значение в формате RFC3339. Строка в формате RFC3339.
done	boolean (boolean) Если значение равно `false` — операция еще выполняется. Если `true` — операция завершена, и задано значение одного из полей `error` или `response`.
metadata	object Метаданные операции. Обычно в поле содержится идентификатор ресурса, над которым выполняется операция. Если метод возвращает ресурс Operation, в описании метода приведена структура соответствующего ему поля `metadata`.
error	object Описание ошибки в случае сбоя или отмены операции. включает только одно из полей `error`, `response` Описание ошибки в случае сбоя или отмены операции.
error. code	integer (int32) Код ошибки. Значение из списка google.rpc.Code.
error. message	string Текст ошибки.
error. details[]	object Список сообщений с подробными сведениями об ошибке.
response	object включает только одно из полей `error`, `response` Результат операции в случае успешного завершения. Если исходный метод не возвращает никаких данных при успешном завершении, например метод Delete, поле содержит объект google.protobuf.Empty. Если исходный метод — это стандартный метод Create / Update, поле содержит целевой ресурс операции. Если метод возвращает ресурс Operation, в описании метода приведена структура соответствующего ему поля `response`.