Virtual Machine Templates - Update

Referencia

Servicio:: Azure Arc enabled SCVMM

Versión de la API:: 2024-06-01

Implementa el método PATCH VirtualMachineTemplate.
Actualiza el recurso VirtualMachineTemplate.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	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	Nombre de virtualMachineTemplate. Patrón de Regex: `[a-zA-Z0-9-_\.]`
api-version	query	True	string	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
tags	object	Etiquetas de recursos.

Respuestas

Nombre	Tipo	Description
200 OK	VirtualMachineTemplate	La operación de Azure se completó correctamente.
202 Accepted		Solicitud de actualización de recursos aceptada. Encabezados Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Nombre

Tipo

Description

200 OK

VirtualMachineTemplate

La operación de Azure se completó correctamente.

202 Accepted

Solicitud de actualización de recursos aceptada.

Encabezados

Location: string
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_Update_MaximumSet

VirtualMachineTemplates_Update_MinimumSet

VirtualMachineTemplates_Update_MaximumSet

Solicitud de ejemplo

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

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:: 202

location: https://contoso.com/operationstatus

VirtualMachineTemplates_Update_MinimumSet

Solicitud de ejemplo

HTTP

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

{}

Respuesta de muestra

status code:: 200

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

status code:: 202

location: https://contoso.com/operationstatus

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	Personalizable.
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.
VirtualMachineTemplateTagsUpdate	Tipo que se usa para actualizar etiquetas en recursos de VirtualMachineTemplate.

AllocationMethod

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

Nombre	Tipo	Description
Dynamic	string	Dirección asignada dinámicamente.
Static	string	Dirección asignada estáticamente.

createdByType

Tipo de identidad que creó el recurso.

Nombre	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CreateDiffDisk

Cree un disco diff.

Nombre	Tipo	Description
false	string	Deshabilite la creación de un disco de diferencias.
true	string	Habilite la creación de un disco diff.

DynamicMemoryEnabled

Memoria dinámica habilitada.

Nombre	Tipo	Description
false	string	Deshabilite la memoria dinámica.
true	string	Habilite la memoria dinámica.

ErrorAdditionalInfo

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

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

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ExtendedLocation

Ubicación extendida.

Nombre	Tipo	Description
name	string	Nombre de ubicación extendida.
type	string	Tipo de ubicación extendida.

IsCustomizable

Personalizable.

Nombre	Tipo	Description
false	string	Deshabilite personalizable.
true	string	Habilite personalizable.

IsHighlyAvailable

Alta disponibilidad.

Nombre	Tipo	Description
false	string	Deshabilite la alta disponibilidad.
true	string	Habilite alta disponibilidad.

LimitCpuForMigration

Limite la CPU para la migración.

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

NetworkInterface

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	Obtiene o establece el identificador de ARM del recurso Microsoft.ScVmm/virtualNetwork para conectar la nic.

OsType

Tipo de sistema operativo de máquina virtual.

Nombre	Tipo	Description
Linux	string	Sistema operativo Linux.
Other	string	Otro sistema operativo.
Windows	string	Sistema operativo Windows.

ProvisioningState

Estado de aprovisionamiento del recurso.

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

StorageQosPolicyDetails

Definición StorageQoSPolicyDetails.

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

systemData

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

Nombre	Tipo	Description
createdAt	string	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	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

Modelo de disco virtual

Nombre	Tipo	Description
bus	integer	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	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	Obtiene o establece el lun de disco.
maxDiskSizeGB	integer	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

Definición del recurso VirtualMachineTemplates.

Nombre	Tipo	Description
extendedLocation	ExtendedLocation	Ubicación extendida.
id	string	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	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	Obtiene la memoria dinámica máxima de la máquina virtual.
properties.dynamicMemoryMinMB	integer	Obtiene la memoria dinámica mínima para la máquina virtual.
properties.generation	integer	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	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	Identificador único de la plantilla de máquina virtual.
properties.vmmServerId	string	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 del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

VirtualMachineTemplateTagsUpdate

Tipo que se usa para actualizar etiquetas en recursos de VirtualMachineTemplate.

Nombre	Tipo	Description
tags	object	Etiquetas de recursos.

Compartir a través de

Virtual Machine Templates - Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

VirtualMachineTemplates_Update_MaximumSet

Solicitud de ejemplo

Respuesta de muestra

VirtualMachineTemplates_Update_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

VirtualMachineTemplateTagsUpdate

Recursos adicionales