Virtual Machine Templates - Update

Başvuru

Hizmet:: Azure Arc enabled SCVMM

API Sürümü:: 2025-03-13

VirtualMachineTemplate PATCH yöntemini uygular.
VirtualMachineTemplate kaynağını güncelleştirir.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
virtualMachineTemplateName	path	True	string minLength: 1 maxLength: 54 pattern: [a-zA-Z0-9-_\.]	VirtualMachineTemplate adı.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
tags	object	Kaynak etiketleri.

Yanıtlar

Name	Tür	Description
200 OK	VirtualMachineTemplate	Azure işlemi başarıyla tamamlandı.
202 Accepted		Kaynak güncelleştirme isteği kabul edildi. Üst Bilgiler Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Name

Tür

Description

200 OK

VirtualMachineTemplate

Azure işlemi başarıyla tamamlandı.

202 Accepted

Kaynak güncelleştirme isteği kabul edildi.

Üst Bilgiler

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

VirtualMachineTemplates_Update_MaximumSet

VirtualMachineTemplates_Update_MinimumSet

VirtualMachineTemplates_Update_MaximumSet

Örnek isteği

HTTP

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

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

Örnek yanıt

Durum kodu:: 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"
  }
}

Durum kodu:: 202

location: https://contoso.com/operationstatus

VirtualMachineTemplates_Update_MinimumSet

Örnek isteği

HTTP

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

{}

Örnek yanıt

Durum kodu:: 200

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

Durum kodu:: 202

location: https://contoso.com/operationstatus

Tanımlar

Name	Description
AllocationMethod	Ağ adresi ayırma yöntemi.
createdByType	Kaynağı oluşturan kimliğin türü.
CreateDiffDisk	Fark diski oluşturun.
DynamicMemoryEnabled	Dinamik bellek etkin.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
ExtendedLocation	Genişletilmiş konum.
IsCustomizable	Özelleştirilebilir.
IsHighlyAvailable	Yüksek oranda kullanılabilir.
LimitCpuForMigration	Geçiş için CPU'ları sınırlayın.
NetworkInterface	Ağ Arabirimi modeli
OsType	Sanal makine işletim sistemi türü.
ProvisioningState	Kaynağın sağlama durumu.
StorageQosPolicyDetails	StorageQoSPolicyDetails tanımı.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
VirtualDisk	Sanal disk modeli
VirtualMachineTemplate	VirtualMachineTemplates kaynak tanımı.
VirtualMachineTemplateTagsUpdate	VirtualMachineTemplate kaynaklarında etiketleri güncelleştirmek için kullanılan tür.

AllocationMethod

Listeleme

Ağ adresi ayırma yöntemi.

Değer	Description
Dynamic	Dinamik olarak ayrılan adres.
Static	Statik olarak ayrılmış adres.

createdByType

Listeleme

Kaynağı oluşturan kimliğin türü.

Değer	Description
Application
Key
ManagedIdentity
User

CreateDiffDisk

Listeleme

Fark diski oluşturun.

Değer	Description
false	Fark diski oluşturmayı devre dışı bırakın.
true	Fark diski oluşturmayı etkinleştirin.

DynamicMemoryEnabled

Listeleme

Dinamik bellek etkin.

Değer	Description
false	Dinamik belleği devre dışı bırakın.
true	Dinamik belleği etkinleştirin.

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

ExtendedLocation

Object

Genişletilmiş konum.

Name	Tür	Description
name	string (arm-id)	Genişletilmiş konum adı.
type	string	Genişletilmiş konum türü.

IsCustomizable

Listeleme

Özelleştirilebilir.

Değer	Description
false	Özelleştirilebilir'i devre dışı bırakın.
true	Özelleştirilebilir'i etkinleştirin.

IsHighlyAvailable

Listeleme

Yüksek oranda kullanılabilir.

Değer	Description
false	Yüksek oranda kullanılabilirliği devre dışı bırakın.
true	Yüksek oranda kullanılabilirliği etkinleştirin.

LimitCpuForMigration

Listeleme

Geçiş için CPU'ları sınırlayın.

Değer	Description
false	Geçiş için CPU sınırını devre dışı bırakın.
true	Geçiş için sınır CPU'sunu etkinleştirin.

NetworkInterface

Object

Ağ Arabirimi modeli

Name	Tür	Description
displayName	string	vmmServer'da gösterildiği gibi ağ arabiriminin görünen adını alır. Bu, ad ayarlanmadığında NIC için geri dönüş etiketidir.
ipv4AddressType	AllocationMethod	ipv4 adres türünü alır veya ayarlar.
ipv4Addresses	string[]	Nic ipv4 adreslerini alır.
ipv6AddressType	AllocationMethod	ipv6 adres türünü alır veya ayarlar.
ipv6Addresses	string[]	Nic ipv6 adreslerini alır.
macAddress	string	Nic MAC adresini alır veya ayarlar.
macAddressType	AllocationMethod	Mac adres türünü alır veya ayarlar.
name	string	Ağ arabiriminin adını alır veya ayarlar.
networkName	string	vmmServer'da nic'in bağlı olduğu sanal ağın adını alır.
nicId	string	Nic kimliğini alır veya ayarlar.
virtualNetworkId	string (arm-id)	Nic'i bağlamak için Microsoft.ScVmm/virtualNetwork kaynağının ARM kimliğini alır veya ayarlar.

OsType

Listeleme

Sanal makine işletim sistemi türü.

Değer	Description
Linux	Linux işletim sistemi.
Other	Diğer işletim sistemi.
Windows	Windows işletim sistemi.

ProvisioningState

Listeleme

Kaynağın sağlama durumu.

Değer	Description
Accepted	Kaynak kabul edildi.
Canceled	Kaynak oluşturma işlemi iptal edildi.
Created	Kaynak oluşturuldu.
Deleting	Kaynak siliniyor.
Failed	Kaynak oluşturulamadı.
Provisioning	Kaynak sağlanıyor.
Succeeded	Kaynak oluşturuldu.
Updating	Kaynak güncelleştiriliyor.

StorageQosPolicyDetails

Object

StorageQoSPolicyDetails tanımı.

Name	Tür	Description
id	string	QoS ilkesinin kimliği.
name	string	İlkenin adı.

systemData

Object

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

VirtualDisk

Object

Sanal disk modeli

Name	Tür	Description
bus	integer (int32)	Disk veri yolunu alır veya ayarlar.
busType	string	Disk veri yolu türünü alır veya ayarlar.
createDiffDisk	CreateDiffDisk	Diski fark eden bir değer alır veya ayarlar.
diskId	string	Disk kimliğini alır veya ayarlar.
diskSizeGB	integer (int32)	Disk toplam boyutunu alır veya ayarlar.
displayName	string	vmmServer'da gösterildiği gibi sanal diskin görünen adını alır. Bu, ad ayarlanmadığında diskin geri dönüş etiketidir.
lun	integer (int32)	Disk lun'unu alır veya ayarlar.
maxDiskSizeGB	integer (int32)	Maksimum disk boyutunu alır.
name	string	Diskin adını alır veya ayarlar.
storageQoSPolicy	StorageQosPolicyDetails	Disk için QoS ilkesi.
templateDiskId	string	Şablondaki disk kimliğini alır veya ayarlar.
vhdFormatType	string	Disk vhd biçim türünü alır.
vhdType	string	Disk vhd türünü alır veya ayarlar.
volumeType	string	Disk birimi türünü alır.

VirtualMachineTemplate

Object

VirtualMachineTemplates kaynak tanımı.

Name	Tür	Description
extendedLocation	ExtendedLocation	Genişletilmiş konum.
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Kaynağın bulunduğu coğrafi konum
name	string	Kaynağın adı
properties.computerName	string	Bilgisayar adını alır.
properties.cpuCount	integer (int32)	Vm için istenen sayıda vCPU alır.
properties.disks	VirtualDisk[]	Şablonun disklerini alır.
properties.dynamicMemoryEnabled	DynamicMemoryEnabled	Dinamik belleğin etkinleştirilip etkinleştirilmeydiğini belirten bir değer alır.
properties.dynamicMemoryMaxMB	integer (int32)	Vm için maksimum dinamik belleği alır.
properties.dynamicMemoryMinMB	integer (int32)	Vm için en düşük dinamik belleği alır.
properties.generation	integer (int32)	Vm için oluşturma işlemini alır.
properties.inventoryItemId	string	Kaynağın stok Madde Kimliğini alır veya ayarlar.
properties.isCustomizable	IsCustomizable	Vm şablonunun özelleştirilebilir olup olmadığını belirten bir değer alır.
properties.isHighlyAvailable	IsHighlyAvailable	Yüksek oranda kullanılabilir özelliği alır.
properties.limitCpuForMigration	LimitCpuForMigration	VM'lerin dinamik geçişi için işlemci uyumluluk modunun etkinleştirilip etkinleştirilmeydiğini belirten bir değer alır.
properties.memoryMB	integer (int32)	MemoryMB, bir sanal makinenin belleğinin MB cinsinden istenen boyutudur.
properties.networkInterfaces	NetworkInterface[]	Şablonun ağ arabirimlerini alır.
properties.osName	string	İşletim sistemi adını alır.
properties.osType	OsType	İşletim sisteminin türünü alır.
properties.provisioningState	ProvisioningState	Kaynağın sağlama durumu.
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}$	Sanal makine şablonunun benzersiz kimliği.
properties.vmmServerId	string (arm-id)	Bu kaynağın bulunduğu vmmServer kaynağının ARM Kimliği.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

VirtualMachineTemplateTagsUpdate

Object

VirtualMachineTemplate kaynaklarında etiketleri güncelleştirmek için kullanılan tür.

Name	Tür	Description
tags	object	Kaynak etiketleri.

Aracılığıyla paylaş

Virtual Machine Templates - Update

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

VirtualMachineTemplates_Update_MaximumSet

Örnek isteği

Örnek yanıt

VirtualMachineTemplates_Update_MinimumSet

Örnek isteği

Örnek yanıt

Tanımlar

AllocationMethod

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

IsCustomizable

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

OsType

ProvisioningState

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineTemplate

VirtualMachineTemplateTagsUpdate