Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Решения
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Managed Service for SQL Server™
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Информация об имеющихся кластерах
    • Создание кластера
    • Подключение к базе данных
    • Остановка и запуск кластера
    • Изменение настроек кластера и базы данных
    • Управление хостами SQL Server
    • Управление базами данных
    • Управление пользователями
    • Назначение привилегий и ролей
    • Управление резервными копиями
    • Удаление кластера
  • Концепции
    • Взаимосвязь ресурсов сервиса
    • Классы хостов
    • Сеть в Managed Service for SQL Server
    • Квоты и лимиты
    • Типы хранилища
    • Резервные копии
  • Управление доступом
  • Правила тарификации
  • Справочник API
    • Аутентификация в API
    • gRPC
      • Обзор
      • BackupService
      • ClusterService
      • DatabaseService
      • OperationService
      • ResourcePresetService
      • UserService
      • OperationService
    • REST
      • Обзор
      • Backup
        • Обзор
        • get
        • list
      • Cluster
        • Обзор
        • backup
        • create
        • delete
        • get
        • list
        • listBackups
        • listHosts
        • listLogs
        • listOperations
        • move
        • restore
        • start
        • stop
        • update
      • Database
        • Обзор
        • create
        • delete
        • get
        • list
      • Operation
        • Обзор
        • get
      • ResourcePreset
        • Обзор
        • get
        • list
      • User
        • Обзор
        • create
        • delete
        • get
        • grantPermission
        • list
        • revokePermission
        • update
  • Вопросы и ответы
    • Общие вопросы
  1. Справочник API
  2. REST
  3. Cluster
  4. update

Метод update

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

Изменяет указанный кластер SQL Server.

HTTP-запрос

PATCH https://mdb.api.cloud.yandex.net/mdb/sqlserver/v1alpha/clusters/{clusterId}

Path-параметры

Параметр Описание
clusterId Обязательное поле. Идентификатор кластера SQL Server, который следует изменить. Чтобы получить идентификатор кластера SQL Server, используйте запрос list. Максимальная длина строки в символах — 50.

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

{
  "updateMask": "string",
  "description": "string",
  "labels": "object",
  "configSpec": {
    "version": "string",
    "resources": {
      "resourcePresetId": "string",
      "diskSize": "string",
      "diskTypeId": "string"
    },
    "backupWindowStart": {
      "hours": "integer",
      "minutes": "integer",
      "seconds": "integer",
      "nanos": "integer"
    },
    "sqlserverConfig_2016Sp2": {
      "maxDegreeOfParallelism": "integer",
      "costThresholdForParallelism": "integer",
      "sqlcollation": "string",
      "auditLevel": "integer",
      "filestreamAccessLevel": "integer",
      "fillFactorPercent": "integer",
      "inDoubtXactResolution": "integer",
      "optimizeForAdHocWorkloads": true,
      "crossDbOwnershipChaining": true
    }
  },
  "name": "string"
}
Поле Описание
updateMask string

Маска, которая указывает, какие атрибуты кластера SQL Server должны быть изменены.

Имена всех обновляемых полей, разделенные запятыми. Только значения указанных полей будут изменены. Остальные останутся нетронутыми. Если поле указано в параметре updateMask и в запросе не было отправлено значение для этого поля, значение поля будет сброшено на значение по умолчанию. Значение по умолчанию для большинства полей — null или 0.

Если в запросе не передается updateMask, значения всех полей будут обновлены. Для полей, указанных в запросе, будут использованы переданные значения. Значения остальных полей будут сброшены на значения по умолчанию.

description string

Новое описание кластера SQL Server.

Максимальная длина строки в символах — 256.

labels object

Пользовательские метки для кластера SQL Server в виде пар key:value. Максимум 64 на ресурс.

Например, "project": "mvp" или "source": "dictionary".

Новый набор меток полностью заменит старый. Чтобы добавить метку, запросите текущий набор меток с помощью метода get, затем отправьте запрос update, добавив новую метку в этот набор.

Не более 64 на ресурс. Длина строки в символах для каждого ключа должна быть от 1 до 63. Каждый ключ должен соответствовать регулярному выражению [a-z][-_0-9a-z]*. Максимальная длина строки в символах для каждого значения — 63. Каждое значение должно соответствовать регулярному выражению [-_0-9a-z]*.

configSpec object

Новая конфигурация и ресурсы для хостов кластера SQL Server.

configSpec.
version
string

Версия SQL Server, используемая в кластере.

Возможные значения:

  • 2016sp2
configSpec.
resources
object
Ресурсы, выделенные хостам SQL Server.
configSpec.
resources.
resourcePresetId
string

Идентификатор набора вычислительных ресурсов, доступных хосту (процессор, память и т. д.). Все доступные наборы ресурсов перечислены в документации.

configSpec.
resources.
diskSize
string (int64)

Объем хранилища, доступного хосту.

configSpec.
resources.
diskTypeId
string

Тип хранилища для хоста.

Возможные значения:

  • network-hdd — сетевой HDD-диск;
  • network-ssd — сетевой SSD-диск;
  • local-ssd — локальное SSD-хранилище.
configSpec.
backupWindowStart
object
Время запуска ежедневного резервного копирования, в часовом поясе UTC.

Время суток. Дата и часовой пояс либо не учитываются, либо задаются в других местах.

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

Связанные типы: google.type.Date и google.protobuf.Timestamp.

configSpec.
backupWindowStart.
hours
integer (int32)

Часы. Допустимые значения: от 0 до 23.

API может разрешить использовать значение в формате "24:00:00" в требующих этого сценариях (например, для указания времени закрытия учреждения).

configSpec.
backupWindowStart.
minutes
integer (int32)

Минуты. Допустимые значения: от 0 до 59.

configSpec.
backupWindowStart.
seconds
integer (int32)

Секунды. Стандартные допустимые значения: от 0 до 59.

API может разрешить использовать значение 60, если также разрешено использование високосной секунды.

configSpec.
backupWindowStart.
nanos
integer (int32)

Доли секунды (в наносекундах). Допустимые значения: от 0 до 999999999.

configSpec.
sqlserverConfig_2016Sp2
object
Конфигурация кластера SQL Server 2016 SP2.

Здесь перечислены поддерживаемые параметры конфигурации SQL Server 2016 SP2.

Подробное описание всех параметров доступно в документации SQL Server.

Любые параметры, не перечисленные здесь, не поддерживаются.

configSpec.
sqlserverConfig_2016Sp2.
maxDegreeOfParallelism
integer (int64)

Ограничивает число процессоров, задействованных для параллельного выполнения плана для каждой задачи.

См. подробное описание в документации SQL Server.

Допустимые значения — от 1 до 99 включительно.

configSpec.
sqlserverConfig_2016Sp2.
costThresholdForParallelism
integer (int64)

Задает пороговое значение, при котором SQL Server создает и выполняет параллельные планы для запросов.

SQL Server создает и выполняет параллельный план для запроса только в том случае, если расчетная стоимость выполнения последовательного плана для того же запроса превышает значение этого параметра.

См. подробное описание в документации SQL Server.

Допустимые значения — от 5 до 32767 включительно.

configSpec.
sqlserverConfig_2016Sp2.
sqlcollation
string

Набор правил сортировки, используемых базами данных экземпляра. Определяет, являются ли базы данных экземпляра чувствительными к регистру, акценту и т. д.

См. подробное описание в документации SQL Server.

configSpec.
sqlserverConfig_2016Sp2.
auditLevel
integer (int64)

Настройки аудита входа, необходимого для мониторинга активности подключения к компоненту SQL Server Database Engine.

Возможные значения:

  • 0 — не регистрировать попытки входа в систему,
  • 1 — регистрировать только неудачные попытки входа в систему,
  • 2 — регистрировать только успешные попытки входа в систему (не рекомендуется),
  • 3 — регистрировать все попытки входа в систему (не рекомендуется).

См. подробное описание в документации SQL Server.

Допустимые значения — от 0 до 3 включительно.

configSpec.
sqlserverConfig_2016Sp2.
filestreamAccessLevel
integer (int64)

Определяет уровень доступа FILESTREAM для экземпляра SQL Server. Технология FILESTREAM позволяет приложениям на базе SQL Server хранить BLOB-объекты, такие как документы и изображения, в файловой системе за пределами базы данных.

Возможные значения:

  • 0 — выключает FILESTREAM,
  • 1 — включает FILESTREAM для доступа с помощью Transact-SQL,
  • 2 — включает FILESTREAM для доступа с помощью Transact-SQL и потокового доступа Win32.

См. подробное описание в документации SQL Server.

Допустимые значения — от 0 до 2 включительно.

configSpec.
sqlserverConfig_2016Sp2.
fillFactorPercent
integer (int64)

Задает коэффициент заполнения. Когда индекс создается или перестраивается, коэффициент заполнения отображает процент заполнения пространства каждой страницы конечного уровня, что позволяет зарезервировать оставшееся пространство как свободное — для будущего расширения.

Значения 0 и 100 означают полное заполнение страницы (свободное место не резервируется).

См. подробное описание в документации SQL Server.

Допустимые значения — от 0 до 100 включительно.

configSpec.
sqlserverConfig_2016Sp2.
inDoubtXactResolution
integer (int64)

Определяет результат по умолчанию для распределенных транзакций, которые не удалось разрешить координатору распределенных транзакций Microsoft (MS DTC). Такие транзакции называются сомнительными распределенными транзакциями.

Возможные значения:

  • 0 — нет автоматического разрешения. Восстановление завершится неуспешно, если MS DTC не сможет разрешить какую-либо сомнительную транзакцию.
  • 1 — сомнительные транзакции считаются подтвержденными,
  • 2 — сомнительные транзакции считаются неподтвержденными и будут откачены.

См. подробное описание в документации SQL Server.

Допустимые значения — от 0 до 2 включительно.

configSpec.
sqlserverConfig_2016Sp2.
optimizeForAdHocWorkloads
boolean (boolean)

Определяет, следует ли кэшировать планы запросов только после второго выполнения. Позволяет избежать раздувания кэша SQL из-за одноразовых планов.

См. подробное описание в документации SQL Server.

configSpec.
sqlserverConfig_2016Sp2.
crossDbOwnershipChaining
boolean (boolean)

Включает цепочку владения между базами данных.

Пример: имея явный доступ к хранимой процедуре в одной базе данных, которая ссылается на объект в другой базе данных, к которой у вас нет явного доступа, вы сможете выполнить процедуру без ошибки, связанной с разрешением.

См. подробное описание в документации SQL Server.

name string

Новое имя кластера SQL Server.

Максимальная длина строки в символах — 63. Значение должно соответствовать регулярному выражению [a-zA-Z0-9_-]*.

Ответ

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.

В этой статье:
  • HTTP-запрос
  • Path-параметры
  • Параметры в теле запроса
  • Ответ
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»