Метод update
Изменяет указанную виртуальную машину.
HTTP-запрос
PATCH https://compute.api.cloud.yandex.net/compute/v1/instances/{instanceId}
Path-параметры
Параметр | Описание |
---|---|
instanceId | Обязательное поле. Идентификатор изменяемого ресурса Instance. Чтобы получить идентификатор виртуальной машины, используйте запрос list. Максимальная длина строки в символах — 50. |
Параметры в теле запроса
{
"updateMask": "string",
"name": "string",
"description": "string",
"labels": "object",
"platformId": "string",
"resourcesSpec": {
"memory": "string",
"cores": "string",
"coreFraction": "string",
"gpus": "string"
},
"metadata": "object",
"serviceAccountId": "string",
"networkSettings": {
"type": "string"
}
}
Поле | Описание |
---|---|
updateMask | string Маска, определяющая, какие поля ресурса Disk будут обновлены. Имена всех обновляемых полей, разделенные запятыми. Только значения указанных полей будут изменены. Остальные останутся нетронутыми. Если поле указано в параметре Если в запросе не передается |
name | string Имя виртуальной машины. Значение должно соответствовать регулярному выражению |
description | string Описание виртуальной машины. Максимальная длина строки в символах — 256. |
labels | object Метки ресурса в формате Существующий набор Не более 64 на ресурс. Длина строки в символах для каждого ключа должна быть от 1 до 63. Каждый ключ должен соответствовать регулярному выражению |
platformId | string Идентификатор аппаратной платформы виртуальной машины. Это поле влияет на допустимые значения поля resourcesSpec. Платформы позволяют создавать виртуальные машины разных типов: с большим объемом памяти, с большим количеством ядер или с высокой производительностью. Дополнительные сведения см. в разделе Платформы. |
resourcesSpec | object Вычислительные ресурсы виртуальной машины, такие как объем памяти и количество ядер. Чтобы узнать список допустимых значений, см. раздел Уровни производительности vCPU. |
resourcesSpec. memory |
string (int64) Обязательное поле. Объем памяти в байтах, доступный виртуальной машине. Максимальное значение — 274877906944. |
resourcesSpec. cores |
string (int64) Обязательное поле. Количество ядер, доступное виртуальной машине. Значение должно быть равно 1, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30 или 32. |
resourcesSpec. coreFraction |
string (int64) Базовый уровень производительности CPU с возможностью повышения производительности выше этого уровня. Это поле устанавливает базовую производительность для каждого ядра. Например, если требуется только 5% производительности CPU, можно задать значение Значение должно быть равно 0, 5, 20, 50 или 100. |
resourcesSpec. gpus |
string (int64) Количество GPU, доступное виртуальной машине. Значение должно быть равно 0, 1, 2 или 4. |
metadata | object Метаданные, назначаемые данной виртуальной машине, в формате пар Существующий набор Значениями являются строки и используются только программами, которые настраивают виртуальную машину. Значения должны быть не более 256 КБ. Например, можно использовать метаданные для доставки открытого ключа SSH на виртуальную машину. Дополнительные сведения см. в разделе Метаданные виртуальной машины. |
serviceAccountId | string Идентификатор сервисного аккаунта для аутентификации изнутри виртуальной машины. Чтобы получить идентификатор сервисного аккаунта, используйте запрос list. |
networkSettings | object Сетевые настройки. |
networkSettings. type |
string Не указывайте это поле, сетевые настройки пока не поддерживаются.
|
Ответ
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) Если значение равно |
metadata | object Метаданные операции. Обычно в поле содержится идентификатор ресурса, над которым выполняется операция. Если метод возвращает ресурс Operation, в описании метода приведена структура соответствующего ему поля |
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, в описании метода приведена структура соответствующего ему поля |