Virtual Machine Templates - Update

Référence

Service:: Azure Arc enabled SCVMM

Version d'API:: 2024-06-01

Implémente la méthode PATCH VirtualMachineTemplate.
Met à jour la ressource VirtualMachineTemplate.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string uuid	ID de l’abonnement cible. La valeur doit être un UUID.
virtualMachineTemplateName	path	True	string	Nom de VirtualMachineTemplate. Modèle d’expression régulière: `[a-zA-Z0-9-_\.]`
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
tags	object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	VirtualMachineTemplate	L’opération Azure s’est terminée avec succès.
202 Accepted		Demande de mise à jour de ressource acceptée. En-têtes Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

VirtualMachineTemplate

L’opération Azure s’est terminée avec succès.

202 Accepted

Demande de mise à jour de ressource acceptée.

En-têtes

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

VirtualMachineTemplates_Update_MaximumSet

VirtualMachineTemplates_Update_MinimumSet

VirtualMachineTemplates_Update_MaximumSet

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
  }
}

Code d’état:: 202

location: https://contoso.com/operationstatus

VirtualMachineTemplates_Update_MinimumSet

Exemple de requête

HTTP

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

{}

Exemple de réponse

Code d’état:: 200

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

Code d’état:: 202

location: https://contoso.com/operationstatus

Définitions

Nom	Description
AllocationMethod	Méthode d’allocation d’adresses réseau.
createdByType	Type d’identité qui a créé la ressource.
CreateDiffDisk	Créez un disque de différences.
DynamicMemoryEnabled	Mémoire dynamique activée.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
ExtendedLocation	Emplacement étendu.
IsCustomizable	Personnalisable.
IsHighlyAvailable	Hautement disponible.
LimitCpuForMigration	Limitez l’UC pour la migration.
NetworkInterface	Modèle d’interface réseau
OsType	Type de système d’exploitation de machine virtuelle.
ProvisioningState	État d’approvisionnement de la ressource.
StorageQosPolicyDetails	Définition StorageQoSPolicyDetails.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
VirtualDisk	Modèle de disque virtuel
VirtualMachineTemplate	Définition de ressource VirtualMachineTemplates.
VirtualMachineTemplateTagsUpdate	Type utilisé pour la mise à jour des balises dans les ressources VirtualMachineTemplate.

AllocationMethod

Méthode d’allocation d’adresses réseau.

Nom	Type	Description
Dynamic	string	Adresse allouée dynamiquement.
Static	string	Adresse allouée statiquement.

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CreateDiffDisk

Créez un disque de différences.

Nom	Type	Description
false	string	Désactivez la création d’un disque de différences.
true	string	Activez la création d’un disque de différences.

DynamicMemoryEnabled

Mémoire dynamique activée.

Nom	Type	Description
false	string	Désactivez la mémoire dynamique.
true	string	Activez la mémoire dynamique.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

ExtendedLocation

Emplacement étendu.

Nom	Type	Description
name	string	Nom de l’emplacement étendu.
type	string	Type d’emplacement étendu.

IsCustomizable

Personnalisable.

Nom	Type	Description
false	string	Désactivez la personnalisation.
true	string	Activez la personnalisation.

IsHighlyAvailable

Hautement disponible.

Nom	Type	Description
false	string	Désactivez les fonctionnalités hautement disponibles.
true	string	Activez hautement disponible.

LimitCpuForMigration

Limitez l’UC pour la migration.

Nom	Type	Description
false	string	Désactivez la limite du processeur pour la migration.
true	string	Activez la limite du processeur pour la migration.

NetworkInterface

Modèle d’interface réseau

Nom	Type	Description
displayName	string	Obtient le nom complet de l’interface réseau, comme indiqué dans vmmServer. Il s’agit de l’étiquette de secours d’une carte réseau lorsque le nom n’est pas défini.
ipv4AddressType	AllocationMethod	Obtient ou définit le type d’adresse ipv4.
ipv4Addresses	string[]	Obtient les adresses ipv4 de carte réseau.
ipv6AddressType	AllocationMethod	Obtient ou définit le type d’adresse ipv6.
ipv6Addresses	string[]	Obtient les adresses ipv6 de carte réseau.
macAddress	string	Obtient ou définit l’adresse MAC de carte réseau.
macAddressType	AllocationMethod	Obtient ou définit le type d’adresse mac.
name	string	Obtient ou définit le nom de l’interface réseau.
networkName	string	Obtient le nom du réseau virtuel dans vmmServer auquel la carte réseau est connectée.
nicId	string	Obtient ou définit l’ID de carte réseau.
virtualNetworkId	string	Obtient ou définit l’ID ARM de la ressource Microsoft.ScVmm/virtualNetwork pour connecter la carte réseau.

OsType

Type de système d’exploitation de machine virtuelle.

Nom	Type	Description
Linux	string	Système d’exploitation Linux.
Other	string	Autre système d’exploitation.
Windows	string	Système d’exploitation Windows.

ProvisioningState

État d’approvisionnement de la ressource.

Nom	Type	Description
Accepted	string	La ressource a été acceptée.
Canceled	string	La création de ressources a été annulée.
Created	string	La ressource a été créée.
Deleting	string	La ressource est en cours de suppression.
Failed	string	Échec de la création de ressources.
Provisioning	string	La ressource est en cours d’approvisionnement.
Succeeded	string	La ressource a été créée.
Updating	string	La ressource est mise à jour.

StorageQosPolicyDetails

Définition StorageQoSPolicyDetails.

Nom	Type	Description
id	string	ID de la stratégie QoS.
name	string	Nom de la stratégie.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

VirtualDisk

Modèle de disque virtuel

Nom	Type	Description
bus	integer	Obtient ou définit le bus de disque.
busType	string	Obtient ou définit le type de bus de disque.
createDiffDisk	CreateDiffDisk	Obtient ou définit une valeur indiquant le disque de différences.
diskId	string	Obtient ou définit l’ID de disque.
diskSizeGB	integer	Obtient ou définit la taille totale du disque.
displayName	string	Obtient le nom complet du disque virtuel, comme indiqué dans vmmServer. Il s’agit de l’étiquette de secours d’un disque lorsque le nom n’est pas défini.
lun	integer	Obtient ou définit le lun de disque.
maxDiskSizeGB	integer	Obtient la taille maximale du disque.
name	string	Obtient ou définit le nom du disque.
storageQoSPolicy	StorageQosPolicyDetails	Stratégie QoS pour le disque.
templateDiskId	string	Obtient ou définit l’ID de disque dans le modèle.
vhdFormatType	string	Obtient le type de format de disque dur virtuel.
vhdType	string	Obtient ou définit le type de disque dur virtuel.
volumeType	string	Obtient le type de volume de disque.

VirtualMachineTemplate

Définition de ressource VirtualMachineTemplates.

Nom	Type	Description
extendedLocation	ExtendedLocation	Emplacement étendu.
id	string	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties.computerName	string	Obtient le nom de l’ordinateur.
properties.cpuCount	integer	Obtient le nombre souhaité de processeurs virtuels pour la machine virtuelle.
properties.disks	VirtualDisk[]	Obtient les disques du modèle.
properties.dynamicMemoryEnabled	DynamicMemoryEnabled	Obtient une valeur indiquant s’il faut activer la mémoire dynamique ou non.
properties.dynamicMemoryMaxMB	integer	Obtient la mémoire dynamique maximale pour la machine virtuelle.
properties.dynamicMemoryMinMB	integer	Obtient la mémoire dynamique minimale pour la machine virtuelle.
properties.generation	integer	Obtient la génération de la machine virtuelle.
properties.inventoryItemId	string	Obtient ou définit l’ID d’élément d’inventaire de la ressource.
properties.isCustomizable	IsCustomizable	Obtient une valeur indiquant si le modèle de machine virtuelle est personnalisable ou non.
properties.isHighlyAvailable	IsHighlyAvailable	Obtient une propriété hautement disponible.
properties.limitCpuForMigration	LimitCpuForMigration	Obtient une valeur indiquant s’il faut activer le mode de compatibilité du processeur pour la migration dynamique des machines virtuelles.
properties.memoryMB	integer	MemoryMB est la taille souhaitée de la mémoire d’une machine virtuelle, en Mo.
properties.networkInterfaces	NetworkInterface[]	Obtient les interfaces réseau du modèle.
properties.osName	string	Obtient le nom du système d’exploitation.
properties.osType	OsType	Obtient le type du système d’exploitation.
properties.provisioningState	ProvisioningState	État d’approvisionnement de la ressource.
properties.uuid	string	ID unique du modèle de machine virtuelle.
properties.vmmServerId	string	ID ARM de la ressource vmmServer dans laquelle réside cette ressource.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

VirtualMachineTemplateTagsUpdate

Type utilisé pour la mise à jour des balises dans les ressources VirtualMachineTemplate.

Nom	Type	Description
tags	object	Balises de ressource.

Partager via

Virtual Machine Templates - Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

VirtualMachineTemplates_Update_MaximumSet

Exemple de requête

Exemple de réponse

VirtualMachineTemplates_Update_MinimumSet

Exemple de requête

Exemple de réponse

Définitions

AllocationMethod

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

IsCustomizable

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

OsType

ProvisioningState

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineTemplate

VirtualMachineTemplateTagsUpdate

Ressources supplémentaires