Virtual Machine Templates - Create Or Update

Referencia

Servicio:: Azure Arc enabled SCVMM

Versión de la API:: 2025-03-13

Implementa el método PUT VirtualMachineTemplates.
Incorpora la plantilla de máquina virtual scVmm como un recurso de plantilla de máquina virtual de Azure.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachineTemplates/{virtualMachineTemplateName}?api-version=2025-03-13

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
virtualMachineTemplateName	path	True	string minLength: 1 maxLength: 54 pattern: [a-zA-Z0-9-_\.]	Nombre de virtualMachineTemplate.
api-version	query	True	string minLength: 1	Versión de API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
extendedLocation	True	ExtendedLocation	Ubicación extendida.
location	True	string	Ubicación geográfica donde reside el recurso
properties.inventoryItemId		string	Obtiene o establece el identificador de elemento de inventario para el recurso.
properties.uuid		string pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$	Identificador único de la plantilla de máquina virtual.
properties.vmmServerId		string (arm-id)	Id. de ARM del recurso vmmServer en el que reside este recurso.
tags		object	Etiquetas de recursos.

Respuestas

Nombre	Tipo	Description
200 OK	VirtualMachineTemplate	Operación de actualización de recurso "VirtualMachineTemplate" correcta
201 Created	VirtualMachineTemplate	Operación de creación correcta del recurso "VirtualMachineTemplate" Encabezados Retry-After: integer
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Nombre

Tipo

Description

200 OK

VirtualMachineTemplate

Operación de actualización de recurso "VirtualMachineTemplate" correcta

201 Created

VirtualMachineTemplate

Operación de creación correcta del recurso "VirtualMachineTemplate"

Encabezados

Retry-After: integer

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

VirtualMachineTemplates_CreateOrUpdate_MaximumSet

VirtualMachineTemplates_CreateOrUpdate_MinimumSet

VirtualMachineTemplates_CreateOrUpdate_MaximumSet

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/virtualMachineTemplates/6?api-version=2025-03-13

{
  "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",
    "limitCpuForMigration": "true",
    "dynamicMemoryEnabled": "true",
    "isCustomizable": "true",
    "isHighlyAvailable": "true"
  },
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ExtendedLocation/customLocations/customLocationName"
  },
  "tags": {
    "key9494": "kkbmfpwhmvlobm"
  },
  "location": "ayxsyduviotylbojh"
}

Respuesta de muestra

status code:: 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"
  }
}

status code:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus

{
  "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"
  }
}

VirtualMachineTemplates_CreateOrUpdate_MinimumSet

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/virtualMachineTemplates/P?api-version=2025-03-13

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

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
  "extendedLocation": {},
  "location": "ayxsyduviotylbojh"
}

status code:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus

{
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
  "extendedLocation": {},
  "location": "ayxsyduviotylbojh"
}

Definiciones

Nombre	Description
AllocationMethod	Método de asignación de direcciones de red.
createdByType	Tipo de identidad que creó el recurso.
CreateDiffDisk	Cree un disco diff.
DynamicMemoryEnabled	Memoria dinámica habilitada.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
ExtendedLocation	Ubicación extendida.
IsCustomizable	Personalizables.
IsHighlyAvailable	Alta disponibilidad.
LimitCpuForMigration	Limite la CPU para la migración.
NetworkInterface	Modelo de interfaz de red
OsType	Tipo de sistema operativo de máquina virtual.
ProvisioningState	Estado de aprovisionamiento del recurso.
StorageQosPolicyDetails	Definición StorageQoSPolicyDetails.
systemData	Metadatos relativos a la creación y última modificación del recurso.
VirtualDisk	Modelo de disco virtual
VirtualMachineTemplate	Definición del recurso VirtualMachineTemplates.

AllocationMethod

Enumeración

Método de asignación de direcciones de red.

Valor	Description
Dynamic	Dirección asignada dinámicamente.
Static	Dirección asignada estáticamente.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User

CreateDiffDisk

Enumeración

Cree un disco diff.

Valor	Description
false	Deshabilite la creación de un disco de diferencias.
true	Habilite la creación de un disco diff.

DynamicMemoryEnabled

Enumeración

Memoria dinámica habilitada.

Valor	Description
false	Deshabilite la memoria dinámica.
true	Habilite la memoria dinámica.

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ExtendedLocation

Object

Ubicación extendida.

Nombre	Tipo	Description
name	string (arm-id)	Nombre de ubicación extendida.
type	string	Tipo de ubicación extendida.

IsCustomizable

Enumeración

Personalizables.

Valor	Description
false	Deshabilite personalizable.
true	Habilite personalizable.

IsHighlyAvailable

Enumeración

Alta disponibilidad.

Valor	Description
false	Deshabilite la alta disponibilidad.
true	Habilite alta disponibilidad.

LimitCpuForMigration

Enumeración

Limite la CPU para la migración.

Valor	Description
false	Deshabilite el límite de CPU para la migración.
true	Habilite el límite de CPU para la migración.

NetworkInterface

Object

Modelo de interfaz de red

Nombre	Tipo	Description
displayName	string	Obtiene el nombre para mostrar de la interfaz de red como se muestra en vmmServer. Esta es la etiqueta de reserva de una NIC cuando no se establece el nombre.
ipv4AddressType	AllocationMethod	Obtiene o establece el tipo de dirección ipv4.
ipv4Addresses	string[]	Obtiene las direcciones ipv4 nic.
ipv6AddressType	AllocationMethod	Obtiene o establece el tipo de dirección ipv6.
ipv6Addresses	string[]	Obtiene las direcciones ipv6 nic.
macAddress	string	Obtiene o establece la dirección MAC nic.
macAddressType	AllocationMethod	Obtiene o establece el tipo de dirección mac.
name	string	Obtiene o establece el nombre de la interfaz de red.
networkName	string	Obtiene el nombre de la red virtual en vmmServer a la que está conectada la nic.
nicId	string	Obtiene o establece el identificador de nic.
virtualNetworkId	string (arm-id)	Obtiene o establece el identificador de ARM del recurso Microsoft.ScVmm/virtualNetwork para conectar la nic.

OsType

Enumeración

Tipo de sistema operativo de máquina virtual.

Valor	Description
Linux	Sistema operativo Linux.
Other	Otro sistema operativo.
Windows	Sistema operativo Windows.

ProvisioningState

Enumeración

Estado de aprovisionamiento del recurso.

Valor	Description
Accepted	Se ha aceptado el recurso.
Canceled	Se canceló la creación de recursos.
Created	Se creó el recurso.
Deleting	El recurso se está eliminando.
Failed	Error en la creación de recursos.
Provisioning	El recurso está aprovisionando.
Succeeded	Se ha creado el recurso.
Updating	El recurso se está actualizando.

StorageQosPolicyDetails

Object

Definición StorageQoSPolicyDetails.

Nombre	Tipo	Description
id	string	Identificador de la directiva de QoS.
name	string	El nombre de la directiva.

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

VirtualDisk

Object

Modelo de disco virtual

Nombre	Tipo	Description
bus	integer (int32)	Obtiene o establece el bus de disco.
busType	string	Obtiene o establece el tipo de bus de disco.
createDiffDisk	CreateDiffDisk	Obtiene o establece un valor que indica el disco de diferencias.
diskId	string	Obtiene o establece el identificador de disco.
diskSizeGB	integer (int32)	Obtiene o establece el tamaño total del disco.
displayName	string	Obtiene el nombre para mostrar del disco virtual como se muestra en vmmServer. Esta es la etiqueta de reserva de un disco cuando no se establece el nombre.
lun	integer (int32)	Obtiene o establece el lun de disco.
maxDiskSizeGB	integer (int32)	Obtiene el tamaño máximo del disco.
name	string	Obtiene o establece el nombre del disco.
storageQoSPolicy	StorageQosPolicyDetails	Directiva QoS del disco.
templateDiskId	string	Obtiene o establece el identificador de disco de la plantilla.
vhdFormatType	string	Obtiene el tipo de formato vhd de disco.
vhdType	string	Obtiene o establece el tipo de disco duro virtual.
volumeType	string	Obtiene el tipo de volumen de disco.

VirtualMachineTemplate

Object

Definición del recurso VirtualMachineTemplates.

Nombre	Tipo	Description
extendedLocation	ExtendedLocation	Ubicación extendida.
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties.computerName	string	Obtiene el nombre del equipo.
properties.cpuCount	integer (int32)	Obtiene el número deseado de vCPU para la máquina virtual.
properties.disks	VirtualDisk[]	Obtiene los discos de la plantilla.
properties.dynamicMemoryEnabled	DynamicMemoryEnabled	Obtiene un valor que indica si se va a habilitar la memoria dinámica o no.
properties.dynamicMemoryMaxMB	integer (int32)	Obtiene la memoria dinámica máxima de la máquina virtual.
properties.dynamicMemoryMinMB	integer (int32)	Obtiene la memoria dinámica mínima para la máquina virtual.
properties.generation	integer (int32)	Obtiene la generación de la máquina virtual.
properties.inventoryItemId	string	Obtiene o establece el identificador de elemento de inventario para el recurso.
properties.isCustomizable	IsCustomizable	Obtiene un valor que indica si la plantilla de máquina virtual es personalizable o no.
properties.isHighlyAvailable	IsHighlyAvailable	Obtiene la propiedad de alta disponibilidad.
properties.limitCpuForMigration	LimitCpuForMigration	Obtiene un valor que indica si se va a habilitar el modo de compatibilidad del procesador para la migración en vivo de máquinas virtuales.
properties.memoryMB	integer (int32)	MemoryMB es el tamaño deseado de la memoria de una máquina virtual, en MB.
properties.networkInterfaces	NetworkInterface[]	Obtiene las interfaces de red de la plantilla.
properties.osName	string	Obtiene el nombre del sistema operativo.
properties.osType	OsType	Obtiene el tipo del sistema operativo.
properties.provisioningState	ProvisioningState	Estado de aprovisionamiento del recurso.
properties.uuid	string pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$	Identificador único de la plantilla de máquina virtual.
properties.vmmServerId	string (arm-id)	Id. de ARM del recurso vmmServer en el que reside este recurso.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

Compartir a través de

Virtual Machine Templates - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

VirtualMachineTemplates_CreateOrUpdate_MaximumSet

Solicitud de ejemplo

Respuesta de muestra

VirtualMachineTemplates_CreateOrUpdate_MinimumSet

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AllocationMethod

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

IsCustomizable

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

OsType

ProvisioningState

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineTemplate