Virtual Machine Templates - Update

Ссылка

Служба:: Azure Arc enabled SCVMM

Версия API:: 2024-06-01

Реализует метод VirtualMachineTemplate PATCH.
Обновляет ресурс VirtualMachineTemplate.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachineTemplates/{virtualMachineTemplateName}?api-version=2024-06-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string	Имя группы ресурсов. Имя не учитывает регистр.
subscriptionId	path	True	string uuid	Идентификатор целевой подписки. Значение должно быть UUID.
virtualMachineTemplateName	path	True	string	Имя VirtualMachineTemplate. Шаблон регулярного выражения: `[a-zA-Z0-9-_\.]`
api-version	query	True	string	Версия API, используемая для этой операции.

Текст запроса

Имя	Тип	Описание
tags	object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	VirtualMachineTemplate	Операция Azure успешно завершена.
202 Accepted		Принятый запрос на обновление ресурсов. Заголовки Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

VirtualMachineTemplate

Операция Azure успешно завершена.

202 Accepted

Принятый запрос на обновление ресурсов.

Заголовки

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

VirtualMachineTemplates_Update_MaximumSet

VirtualMachineTemplates_Update_MinimumSet

VirtualMachineTemplates_Update_MaximumSet

Образец запроса

HTTP

PATCH https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/virtualMachineTemplates/g?api-version=2024-06-01

{
  "tags": {
    "key6634": "wwfhrg"
  }
}

Пример ответа

Код состояния:: 200

{
  "properties": {
    "inventoryItemId": "qjrykoogccwlgkd",
    "uuid": "12345678-1234-1234-1234-12345678abcd",
    "vmmServerId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/vmmServers/vmmServerName",
    "osType": "Windows",
    "osName": "qcbolnbisklo",
    "computerName": "asxghqngsojdsdptpirbz",
    "memoryMB": 24,
    "cpuCount": 23,
    "limitCpuForMigration": "true",
    "dynamicMemoryEnabled": "true",
    "isCustomizable": "true",
    "dynamicMemoryMaxMB": 21,
    "dynamicMemoryMinMB": 21,
    "isHighlyAvailable": "true",
    "generation": 16,
    "networkInterfaces": [
      {
        "name": "kvofzqulbjlbtt",
        "displayName": "yoayfd",
        "ipv4Addresses": [
          "eeunirpkpqazzxhsqonkxcfuks"
        ],
        "ipv6Addresses": [
          "pk"
        ],
        "macAddress": "oaeqqegt",
        "virtualNetworkId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualNetworks/virtualNetworkName",
        "networkName": "lqbm",
        "ipv4AddressType": "Dynamic",
        "ipv6AddressType": "Dynamic",
        "macAddressType": "Dynamic",
        "nicId": "roxpsvlo"
      }
    ],
    "disks": [
      {
        "name": "fgnckfymwdsqnfxkdvexuaobe",
        "displayName": "fgladknawlgjodo",
        "diskId": "ltdrwcfjklpsimhzqyh",
        "diskSizeGB": 30,
        "maxDiskSizeGB": 18,
        "bus": 8,
        "lun": 10,
        "busType": "zu",
        "vhdType": "cnbeeeylrvopigdynvgpkfp",
        "volumeType": "ckkymkuekzzqhexyjueruzlfemoeln",
        "vhdFormatType": "vbcrrmhgahznifudvhxfagwoplcb",
        "templateDiskId": "lcdwrokpyvekqccclf",
        "storageQoSPolicy": {
          "name": "ceiyfrflu",
          "id": "o"
        },
        "createDiffDisk": "true"
      }
    ],
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ExtendedLocation/customLocations/customLocationName"
  },
  "tags": {
    "key9494": "kkbmfpwhmvlobm"
  },
  "location": "ayxsyduviotylbojh",
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
  "name": "ioeuwaznkaayvhpqbnrwbr",
  "type": "egfzqiscydkyddksvsjujdlee",
  "systemData": {
    "createdBy": "p",
    "createdByType": "User",
    "createdAt": "2024-01-29T22:28:00.094Z",
    "lastModifiedBy": "goxcwpyyqlxndquly",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-01-29T22:28:00.095Z"
  }
}

Код состояния:: 202

location: https://contoso.com/operationstatus

VirtualMachineTemplates_Update_MinimumSet

Образец запроса

HTTP

PATCH https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/virtualMachineTemplates/-?api-version=2024-06-01

{}

Пример ответа

Код состояния:: 200

{
  "extendedLocation": {},
  "location": "ayxsyduviotylbojh"
}

Код состояния:: 202

location: https://contoso.com/operationstatus

Определения

Имя	Описание
AllocationMethod	Метод выделения сетевых адресов.
createdByType	Тип удостоверения, создавшего ресурс.
CreateDiffDisk	Создайте диск диффа.
DynamicMemoryEnabled	Динамическая память включена.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
ExtendedLocation	Расширенное расположение.
IsCustomizable	Настраиваемые.
IsHighlyAvailable	Высокая доступность.
LimitCpuForMigration	Ограничение ЦП для миграции.
NetworkInterface	Модель сетевого интерфейса
OsType	Тип операционной системы виртуальной машины.
ProvisioningState	Состояние подготовки ресурса.
StorageQosPolicyDetails	Определение StorageQoSPolicyDetails.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
VirtualDisk	Модель виртуального диска
VirtualMachineTemplate	Определение ресурса VirtualMachineTemplates.
VirtualMachineTemplateTagsUpdate	Тип, используемый для обновления тегов в ресурсах VirtualMachineTemplate.

AllocationMethod

Метод выделения сетевых адресов.

Имя	Тип	Описание
Dynamic	string	Динамически выделенный адрес.
Static	string	Статически выделенный адрес.

createdByType

Тип удостоверения, создавшего ресурс.

Имя	Тип	Описание
Application	string
Key	string
ManagedIdentity	string
User	string

CreateDiffDisk

Создайте диск диффа.

Имя	Тип	Описание
false	string	Отключите создание диска диффа.
true	string	Включите создание диска диффа.

DynamicMemoryEnabled

Динамическая память включена.

Имя	Тип	Описание
false	string	Отключите динамическую память.
true	string	Включите динамическую память.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

ExtendedLocation

Расширенное расположение.

Имя	Тип	Описание
name	string	Имя расширенного расположения.
type	string	Тип расширенного расположения.

IsCustomizable

Настраиваемые.

Имя	Тип	Описание
false	string	Отключить настраиваемую настройку.
true	string	Включите настраиваемую настройку.

IsHighlyAvailable

Высокая доступность.

Имя	Тип	Описание
false	string	Отключите высокодоступную функцию.
true	string	Включение высокой доступности.

LimitCpuForMigration

Ограничение ЦП для миграции.

Имя	Тип	Описание
false	string	Отключите ограничение ЦП для миграции.
true	string	Включите ограничение ЦП для миграции.

NetworkInterface

Модель сетевого интерфейса

Имя	Тип	Описание
displayName	string	Возвращает отображаемое имя сетевого интерфейса, как показано в vmmServer. Это резервная метка сетевого адаптера, если имя не задано.
ipv4AddressType	AllocationMethod	Возвращает или задает тип ipv4-адреса.
ipv4Addresses	string[]	Возвращает ipv4-адреса сетевой карты.
ipv6AddressType	AllocationMethod	Возвращает или задает тип ipv6-адреса.
ipv6Addresses	string[]	Возвращает ipv6-адреса сетевой карты.
macAddress	string	Возвращает или задает MAC-адрес сетевого адаптера.
macAddressType	AllocationMethod	Возвращает или задает тип mac-адреса.
name	string	Возвращает или задает имя сетевого интерфейса.
networkName	string	Возвращает имя виртуальной сети в vmmServer, к которому подключен сетевой адаптер.
nicId	string	Возвращает или задает идентификатор сетевого адаптера.
virtualNetworkId	string	Возвращает или задает идентификатор ARM ресурса Microsoft.ScVmm/virtualNetwork для подключения сетевой карты.

OsType

Тип операционной системы виртуальной машины.

Имя	Тип	Описание
Linux	string	Операционная система Linux.
Other	string	Другая операционная система.
Windows	string	Операционная система Windows.

ProvisioningState

Состояние подготовки ресурса.

Имя	Тип	Описание
Accepted	string	Ресурс был принят.
Canceled	string	Создание ресурсов было отменено.
Created	string	Ресурс был создан.
Deleting	string	Ресурс удаляется.
Failed	string	Не удалось создать ресурс.
Provisioning	string	Ресурс подготавливается.
Succeeded	string	Ресурс создан.
Updating	string	Ресурс обновляется.

StorageQosPolicyDetails

Определение StorageQoSPolicyDetails.

Имя	Тип	Описание
id	string	Идентификатор политики качества обслуживания.
name	string	Имя политики.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

VirtualDisk

Модель виртуального диска

Имя	Тип	Описание
bus	integer	Возвращает или задает шину диска.
busType	string	Возвращает или задает тип шины диска.
createDiffDisk	CreateDiffDisk	Возвращает или задает значение, указывающее диск диффа.
diskId	string	Возвращает или задает идентификатор диска.
diskSizeGB	integer	Возвращает или задает общий размер диска.
displayName	string	Возвращает отображаемое имя виртуального диска, как показано в vmmServer. Это резервная метка для диска, если имя не задано.
lun	integer	Возвращает или задает lun диска.
maxDiskSizeGB	integer	Возвращает максимальный размер диска.
name	string	Возвращает или задает имя диска.
storageQoSPolicy	StorageQosPolicyDetails	Политика качества обслуживания для диска.
templateDiskId	string	Возвращает или задает идентификатор диска в шаблоне.
vhdFormatType	string	Возвращает тип формата vhd диска.
vhdType	string	Возвращает или задает тип виртуального жесткого диска.
volumeType	string	Возвращает тип тома диска.

VirtualMachineTemplate

Определение ресурса VirtualMachineTemplates.

Имя	Тип	Описание
extendedLocation	ExtendedLocation	Расширенное расположение.
id	string	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
properties.computerName	string	Возвращает имя компьютера.
properties.cpuCount	integer	Возвращает требуемое количество виртуальных ЦП для виртуальной машины.
properties.disks	VirtualDisk[]	Возвращает диски шаблона.
properties.dynamicMemoryEnabled	DynamicMemoryEnabled	Возвращает значение, указывающее, следует ли включить динамическую память или нет.
properties.dynamicMemoryMaxMB	integer	Возвращает максимальную динамическую память для виртуальной машины.
properties.dynamicMemoryMinMB	integer	Возвращает минимальную динамическую память для виртуальной машины.
properties.generation	integer	Возвращает поколение виртуальной машины.
properties.inventoryItemId	string	Возвращает или задает идентификатор элемента инвентаризации для ресурса.
properties.isCustomizable	IsCustomizable	Возвращает значение, указывающее, настраивается ли шаблон виртуальной машины.
properties.isHighlyAvailable	IsHighlyAvailable	Возвращает свойство с высоким уровнем доступности.
properties.limitCpuForMigration	LimitCpuForMigration	Возвращает значение, указывающее, следует ли включить режим совместимости процессора для динамической миграции виртуальных машин.
properties.memoryMB	integer	MemoryMB — это требуемый размер памяти виртуальной машины в МБ.
properties.networkInterfaces	NetworkInterface[]	Возвращает сетевые интерфейсы шаблона.
properties.osName	string	Возвращает имя ос.
properties.osType	OsType	Возвращает тип ос.
properties.provisioningState	ProvisioningState	Состояние подготовки ресурса.
properties.uuid	string	Уникальный идентификатор шаблона виртуальной машины.
properties.vmmServerId	string	Идентификатор ARM ресурса vmmServer, в котором находится этот ресурс.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

VirtualMachineTemplateTagsUpdate

Тип, используемый для обновления тегов в ресурсах VirtualMachineTemplate.

Имя	Тип	Описание
tags	object	Теги ресурсов.

Поделиться через

Virtual Machine Templates - Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

VirtualMachineTemplates_Update_MaximumSet

Образец запроса

Пример ответа

VirtualMachineTemplates_Update_MinimumSet

Образец запроса

Пример ответа

Определения

AllocationMethod

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

IsCustomizable

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

OsType

ProvisioningState

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineTemplate

VirtualMachineTemplateTagsUpdate

Дополнительные ресурсы