Virtual Machine Scale Set VMs - Get

Ottiene una macchina virtuale da un set di scalabilità di macchine virtuali.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}?api-version=2024-03-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}?$expand={$expand}&api-version=2024-03-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
instanceId
path True

string

ID istanza della macchina virtuale.

resourceGroupName
path True

string

Nome del gruppo di risorse.

subscriptionId
path True

string

Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

vmScaleSetName
path True

string

Nome del set di scalabilità di macchine virtuali.

api-version
query True

string

Versione dell'API client.

$expand
query

InstanceViewTypes

Espressione di espansione da applicare all'operazione. 'InstanceView' recupera la visualizzazione dell'istanza della macchina virtuale. 'UserData' recupererà userData della macchina virtuale.

Risposte

Nome Tipo Descrizione
200 OK

VirtualMachineScaleSetVM

OK

Other Status Codes

CloudError

Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Get VM scale set VM with UserData
Get VM scale set VM with VMSizeProperties

Get VM scale set VM with UserData

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}/virtualMachines/0?api-version=2024-03-01

Sample Response

{
  "name": "{vmss-vm-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}/virtualMachines/0",
  "type": "Microsoft.Compute/virtualMachines",
  "location": "westus",
  "tags": {
    "myTag1": "tagValue1"
  },
  "etag": "\"1\"",
  "properties": {
    "latestModelApplied": true,
    "modelDefinitionApplied": "VirtualMachineScaleSet",
    "networkProfileConfiguration": {
      "networkInterfaceConfigurations": [
        {
          "name": "vmsstestnetconfig5415",
          "properties": {
            "primary": true,
            "enableAcceleratedNetworking": false,
            "dnsSettings": {
              "dnsServers": []
            },
            "enableIPForwarding": false,
            "ipConfigurations": [
              {
                "name": "vmsstestnetconfig9693",
                "properties": {
                  "subnet": {
                    "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/vn4071/subnets/sn5503"
                  },
                  "privateIPAddressVersion": "IPv4"
                }
              }
            ]
          }
        }
      ]
    },
    "vmId": "42af9fdf-b906-4ad7-9905-8316209ff619",
    "hardwareProfile": {},
    "storageProfile": {
      "imageReference": {
        "publisher": "MicrosoftWindowsServer",
        "offer": "WindowsServer",
        "sku": "2012-R2-Datacenter",
        "version": "4.127.20180315",
        "exactVersion": "4.127.20180315"
      },
      "osDisk": {
        "osType": "Windows",
        "name": "vmss3176_vmss3176_0_OsDisk_1_6d72b805e50e4de6830303c5055077fc",
        "createOption": "FromImage",
        "caching": "None",
        "managedDisk": {
          "storageAccountType": "Standard_LRS",
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_OsDisk_1_6d72b805e50e4de6830303c5055077fc"
        },
        "diskSizeGB": 127
      },
      "dataDisks": [
        {
          "lun": 1,
          "name": "vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
          "createOption": "Empty",
          "caching": "None",
          "managedDisk": {
            "storageAccountType": "Standard_LRS",
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"
          },
          "diskSizeGB": 128,
          "toBeDetached": false
        }
      ]
    },
    "osProfile": {
      "computerName": "test000000",
      "adminUsername": "Foo12",
      "windowsConfiguration": {
        "provisionVMAgent": true,
        "enableAutomaticUpdates": true
      },
      "secrets": [],
      "allowExtensionOperations": true,
      "requireGuestProvisionSignal": true
    },
    "userData": "RXhhbXBsZSBVc2VyRGF0YQ==",
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}/virtualMachines/0/networkInterfaces/vmsstestnetconfig5415"
        }
      ]
    },
    "diagnosticsProfile": {
      "bootDiagnostics": {
        "enabled": true
      }
    },
    "provisioningState": "Succeeded"
  },
  "resources": [
    {
      "name": "CustomScriptExtension-DSC",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/extensions/CustomScriptExtension-DSC",
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "location": "westus",
      "tags": {
        "displayName": "CustomScriptExtension-DSC"
      },
      "properties": {
        "autoUpgradeMinorVersion": true,
        "provisioningState": "Succeeded",
        "publisher": "Microsoft.Compute",
        "type": "CustomScriptExtension",
        "typeHandlerVersion": "1.9",
        "settings": {}
      }
    }
  ]
}

Get VM scale set VM with VMSizeProperties

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}/virtualMachines/0?api-version=2024-03-01

Sample Response

{
  "name": "{vmss-vm-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}/virtualMachines/0",
  "type": "Microsoft.Compute/virtualMachines",
  "location": "westus",
  "tags": {
    "myTag1": "tagValue1"
  },
  "etag": "\"1\"",
  "properties": {
    "latestModelApplied": true,
    "modelDefinitionApplied": "VirtualMachineScaleSet",
    "networkProfileConfiguration": {
      "networkInterfaceConfigurations": [
        {
          "name": "vmsstestnetconfig5415",
          "properties": {
            "primary": true,
            "enableAcceleratedNetworking": false,
            "dnsSettings": {
              "dnsServers": []
            },
            "enableIPForwarding": false,
            "ipConfigurations": [
              {
                "name": "vmsstestnetconfig9693",
                "properties": {
                  "subnet": {
                    "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/vn4071/subnets/sn5503"
                  },
                  "privateIPAddressVersion": "IPv4"
                }
              }
            ]
          }
        }
      ]
    },
    "vmId": "42af9fdf-b906-4ad7-9905-8316209ff619",
    "hardwareProfile": {
      "vmSizeProperties": {
        "vCPUsAvailable": 1,
        "vCPUsPerCore": 1
      }
    },
    "storageProfile": {
      "imageReference": {
        "publisher": "MicrosoftWindowsServer",
        "offer": "WindowsServer",
        "sku": "2012-R2-Datacenter",
        "version": "4.127.20180315",
        "exactVersion": "4.127.20180315"
      },
      "osDisk": {
        "osType": "Windows",
        "name": "vmss3176_vmss3176_0_OsDisk_1_6d72b805e50e4de6830303c5055077fc",
        "createOption": "FromImage",
        "caching": "None",
        "managedDisk": {
          "storageAccountType": "Standard_LRS",
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_OsDisk_1_6d72b805e50e4de6830303c5055077fc"
        },
        "diskSizeGB": 127
      },
      "dataDisks": [
        {
          "lun": 1,
          "name": "vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
          "createOption": "Empty",
          "caching": "None",
          "managedDisk": {
            "storageAccountType": "Standard_LRS",
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"
          },
          "diskSizeGB": 128,
          "toBeDetached": false
        }
      ]
    },
    "osProfile": {
      "computerName": "test000000",
      "adminUsername": "Foo12",
      "windowsConfiguration": {
        "provisionVMAgent": true,
        "enableAutomaticUpdates": true
      },
      "secrets": [],
      "allowExtensionOperations": true,
      "requireGuestProvisionSignal": true
    },
    "userData": "RXhhbXBsZSBVc2VyRGF0YQ==",
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}/virtualMachines/0/networkInterfaces/vmsstestnetconfig5415"
        }
      ]
    },
    "diagnosticsProfile": {
      "bootDiagnostics": {
        "enabled": true
      }
    },
    "provisioningState": "Succeeded"
  },
  "resources": [
    {
      "name": "CustomScriptExtension-DSC",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/extensions/CustomScriptExtension-DSC",
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "location": "westus",
      "tags": {
        "displayName": "CustomScriptExtension-DSC"
      },
      "properties": {
        "autoUpgradeMinorVersion": true,
        "provisioningState": "Succeeded",
        "publisher": "Microsoft.Compute",
        "type": "CustomScriptExtension",
        "typeHandlerVersion": "1.9",
        "settings": {}
      }
    }
  ]
}

Definizioni

Nome Descrizione
AdditionalCapabilities

Specifica funzionalità aggiuntive abilitate o disabilitate nella macchina virtuale nel set di scalabilità. Ad esempio, se la macchina virtuale ha la possibilità di supportare il collegamento di dischi dati gestiti con UltraSSD_LRS tipo di account di archiviazione.

AdditionalUnattendContent

Specifica informazioni aggiuntive in formato XML con codifica Base 64 che possono essere incluse nel file Unattend.xml usato da Installazione di Windows.

ApiEntityReference

Identificatore della risorsa di origine. Può trattarsi di uno snapshot o di un punto di ripristino del disco da cui creare un disco.

ApiError

Errore dell'API.

ApiErrorBase

Base di errori dell'API.

BootDiagnostics

Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output della console e screenshot per diagnosticare lo stato della macchina virtuale. NOTA: se viene specificato storageUri, assicurarsi che l'account di archiviazione si trova nella stessa area e sottoscrizione della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.

BootDiagnosticsInstanceView

Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output della console e lo screenshot per diagnosticare lo stato della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.

CachingTypes

Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.

CloudError

Risposta di errore dal servizio di calcolo.

ComponentNames

Nome del componente. Attualmente, l'unico valore consentito è Microsoft-Windows-Shell-Setup.

DataDisk

Specifica i parametri usati per aggiungere un disco dati a una macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

DeleteOptions

Specificare cosa accade all'interfaccia di rete quando la macchina virtuale viene eliminata

DiagnosticsProfile

Specifica lo stato delle impostazioni di diagnostica di avvio. Versione minima api: 2015-06-15.

DiffDiskOptions

Specifica le impostazioni temporanee del disco per il disco del sistema operativo.

DiffDiskPlacement

Specifica il posizionamento temporaneo del disco per il disco del sistema operativo. I valori possibili sono: CacheDisk,ResourceDisk,NvmeDisk. Il comportamento predefinito è: CacheDisk se ne è configurato uno per le dimensioni della macchina virtuale; in caso contrario, viene usato ResourceDisk o NvmeDisk. Fare riferimento alla documentazione relativa alle dimensioni delle macchine virtuali Windows in https://docs.microsoft.com/azure/virtual-machines/windows/sizes e alla macchina virtuale Linux in https://docs.microsoft.com/azure/virtual-machines/linux/sizes per verificare le dimensioni delle macchine virtuali che espongono un disco della cache. Versione api minima per NvmeDisk: 2024-03-01.

DiffDiskSettings

Specifica le impostazioni temporanee del disco per il disco del sistema operativo utilizzato dalla macchina virtuale.

DiskControllerTypes

Specifica il tipo di controller del disco configurato per la macchina virtuale. Nota: Questa proprietà verrà impostata sul tipo di controller disco predefinito se non viene specificata la macchina virtuale specificata con 'hyperVGeneration' impostata su V2 in base alle funzionalità del disco del sistema operativo e delle dimensioni della macchina virtuale dalla versione api minima specificata. È necessario deallocare la macchina virtuale prima di aggiornare il tipo di controller del disco, a meno che non si aggiornino le dimensioni della macchina virtuale nella configurazione della macchina virtuale che dealloca in modo implicito e rialloca la macchina virtuale. Versione minima api: 2022-08-01.

DiskCreateOptionTypes

Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza.

DiskDeleteOptionTypes

Specifica se il disco del sistema operativo deve essere eliminato o scollegato al momento dell'eliminazione della macchina virtuale. I valori possibili sono: Elimina. Se questo valore viene usato, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco del sistema operativo viene mantenuto dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per un disco del sistema operativo temporaneo.

DiskDetachOptionTypes

Specifica il comportamento di scollegamento da usare durante lo scollegamento di un disco o che è già in fase di scollegamento dalla macchina virtuale. Valori supportati: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo di scollegamento precedente del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di scollegamento per scollegare forzatamente il disco dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su "true" insieme all'impostazione di detachOption: 'ForceDetach'.

DiskEncryptionSetParameters

Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.

DiskEncryptionSettings

Specifica le impostazioni di crittografia per il disco del sistema operativo.

Versione minima api: 2015-06-15

DiskInstanceView

Informazioni sui dischi.

DomainNameLabelScopeTypes

Ambito dell'etichetta nome di dominio delle risorse PublicIPAddress che verranno create. L'etichetta del nome generata è la concatenazione dell'etichetta del nome di dominio hash con criteri in base all'ambito dell'etichetta del nome di dominio e all'ID univoco del profilo di rete della macchina virtuale.

EncryptionIdentity

Specifica l'identità gestita usata da ADE per ottenere il token di accesso per le operazioni di keyvault.

HardwareProfile

Specifica le impostazioni hardware per la macchina virtuale.

HyperVGeneration

Generazione dell'hypervisor della macchina virtuale [V1, V2]

ImageReference

Specifica informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini di macchine virtuali. Questo elemento è necessario quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione.

InnerError

Dettagli dell'errore interno.

InstanceViewStatus

Stato della visualizzazione dell'istanza.

InstanceViewTypes

Espressione di espansione da applicare all'operazione. 'InstanceView' recupererà la visualizzazione dell'istanza della macchina virtuale. 'UserData' recupererà userData della macchina virtuale.

IPVersion

Disponibile da Api-Version 2019-07-01 in poi, rappresenta se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito viene assunto come IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.

IPVersions

Disponibile da Api-Version 2019-07-01 in poi, rappresenta se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito viene assunto come IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.

KeyVaultKeyReference

Specifica il percorso della chiave di crittografia della chiave in Key Vault.

KeyVaultSecretReference

Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi

LinuxConfiguration

Specifica le impostazioni del sistema operativo Linux nella macchina virtuale. Per un elenco di distribuzioni Linux supportate, vedere Linux in Azure-Endorsed Distribuzioni.

LinuxPatchAssessmentMode

Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS.

I valori possibili sono:

ImageDefault : è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale.

AutomaticByPlatform : la piattaforma attiverà valutazioni delle patch periodiche. La proprietà provisionVMAgent deve essere true.

LinuxPatchSettings

[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest alle macchine virtuali in Linux.

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

Specifica l'impostazione di riavvio per tutte le operazioni di installazione di patch AutomaticByPlatform.

LinuxVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nella patch guest della macchina virtuale in Linux.

LinuxVMGuestPatchMode

Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile.

I valori possibili sono:

ImageDefault : viene usata la configurazione predefinita dell'applicazione di patch della macchina virtuale.

AutomaticByPlatform : la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. La proprietà provisionVMAgent deve essere true

MaintenanceOperationResultCodeTypes

Codice risultato dell'ultima operazione di manutenzione.

MaintenanceRedeployStatus

Stato dell'operazione di manutenzione nella macchina virtuale.

ManagedDiskParameters

Parametri del disco gestito.

Mode

Specifica la modalità su cui verrà eseguito ProxyAgent se la funzionalità è abilitata. ProxyAgent inizierà a controllare o monitorare ma non a imporre il controllo di accesso sulle richieste agli endpoint host in modalità di controllo, mentre in modalità Di imposizione applichererà il controllo di accesso. Il valore predefinito è Modalità di imposizione.

NetworkApiVersion

specifica la versione dell'API Microsoft.Network usata durante la creazione di risorse di rete nelle configurazioni dell'interfaccia di rete

NetworkInterfaceAuxiliaryMode

Specifica se la modalità ausiliaria è abilitata per la risorsa Interfaccia di rete.

NetworkInterfaceAuxiliarySku

Specifica se lo SKU ausiliario è abilitato per la risorsa Interfaccia di rete.

NetworkInterfaceReference

Specifica l'elenco di ID risorsa per le interfacce di rete associate alla macchina virtuale.

NetworkProfile

Specifica le interfacce di rete della macchina virtuale.

OperatingSystemTypes

Tipo di sistema operativo.

OSDisk

Specifica informazioni sul disco del sistema operativo utilizzato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

OSProfile

Specifica le impostazioni del sistema operativo per la macchina virtuale.

PassNames

Nome del passaggio. Attualmente, l'unico valore consentito è OobeSystem.

PatchSettings

[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.

Plan

Specifica informazioni sull'immagine del marketplace usata per creare la macchina virtuale. Questo elemento viene usato solo per le immagini del marketplace. Prima di poter usare un'immagine del marketplace da un'API, è necessario abilitare l'immagine per l'uso a livello di codice. Nella portale di Azure individuare l'immagine del marketplace che si vuole usare e quindi fare clic su Vuoi distribuire a livello di codice, Introduzione a ->. Immettere le informazioni necessarie e quindi fare clic su Salva.

ProtocolTypes

Specifica il protocollo del listener WinRM. I valori possibili sono: http,https.

ProxyAgentSettings

Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale. Versione minima api: 2024-03-01.

PublicIPAddressSku

Descrive lo SKU IP pubblico. Può essere impostato solo con OrchestrationMode come flessibile.

PublicIPAddressSkuName

Specificare il nome dello sku IP pubblico

PublicIPAddressSkuTier

Specificare il livello sku IP pubblico

PublicIPAllocationMethod

Specificare il tipo di allocazione IP pubblico

ResourceIdentityType

Tipo di identità usato per la macchina virtuale. Il tipo "SystemAssigned, UserAssigned" include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà le identità dalla macchina virtuale.

securityEncryptionTypes

Specifica EncryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: Può essere impostato solo per le macchine virtuali riservate.

SecurityProfile

Specifica le impostazioni del profilo correlato alla sicurezza per la macchina virtuale.

SecurityTypes

Specifica il tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.

SettingNames

Specifica il nome dell'impostazione a cui si applica il contenuto. I valori possibili sono: FirstLogonCommands e AutoLogon.

Sku

SKU della macchina virtuale.

SshConfiguration

Specifica la configurazione delle chiavi SSH per un sistema operativo Linux.

SshPublicKey

Elenco di chiavi pubbliche SSH usate per l'autenticazione con macchine virtuali basate su Linux.

StatusLevelTypes

Codice di livello.

StorageAccountTypes

Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con i dischi dati, non può essere usato con il disco del sistema operativo.

StorageProfile

Specifica le impostazioni di archiviazione per i dischi della macchina virtuale.

SubResource

URL relativo del Key Vault contenente il segreto.

UefiSettings

Specifica le impostazioni di sicurezza come l'avvio sicuro e vTPM usato durante la creazione della macchina virtuale. Versione minima api: 2020-12-01.

UserAssignedIdentities

Elenco di identità utente associate alla macchina virtuale. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

VaultCertificate

Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati.

VaultSecretGroup

Specifica il set di certificati che deve essere installato nella macchina virtuale. Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.

VirtualHardDisk

Disco rigido virtuale.

VirtualMachineAgentInstanceView

Agente di macchine virtuali in esecuzione nella macchina virtuale.

VirtualMachineExtension

Risorse dell'estensione figlio della macchina virtuale.

VirtualMachineExtensionHandlerInstanceView

Visualizzazione dell'istanza del gestore dell'estensione della macchina virtuale.

VirtualMachineExtensionInstanceView

Visualizzazione dell'istanza dell'estensione della macchina virtuale.

VirtualMachineHealthStatus

Stato di integrità per la macchina virtuale.

VirtualMachineIdentity

Identità della macchina virtuale, se configurata.

VirtualMachineIpTag

Elenco di tag IP associati all'indirizzo IP pubblico.

VirtualMachineNetworkInterfaceConfiguration

Specifica le configurazioni di rete che verranno usate per creare le risorse di rete della macchina virtuale.

VirtualMachineNetworkInterfaceDnsSettingsConfiguration

Impostazioni DNS da applicare alle interfacce di rete.

VirtualMachineNetworkInterfaceIPConfiguration

Specifica le configurazioni IP dell'interfaccia di rete.

VirtualMachinePublicIPAddressConfiguration

PublicIPAddressConfiguration.

VirtualMachinePublicIPAddressDnsSettingsConfiguration

Le impostazioni dns da applicare agli indirizzi publicIP .

VirtualMachineScaleSetIPConfiguration

Specifica le configurazioni IP dell'interfaccia di rete.

VirtualMachineScaleSetIpTag

Elenco di tag IP associati all'indirizzo IP pubblico.

VirtualMachineScaleSetNetworkConfiguration

Elenco delle configurazioni di rete.

VirtualMachineScaleSetNetworkConfigurationDnsSettings

Impostazioni DNS da applicare alle interfacce di rete.

VirtualMachineScaleSetPublicIPAddressConfiguration

PublicIPAddressConfiguration.

VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings

Le impostazioni dns da applicare agli indirizzi publicIP .

VirtualMachineScaleSetVM

Descrive una macchina virtuale del set di scalabilità di macchine virtuali.

VirtualMachineScaleSetVMInstanceView

Visualizzazione dell'istanza della macchina virtuale.

VirtualMachineScaleSetVMNetworkProfileConfiguration

Specifica la configurazione del profilo di rete della macchina virtuale.

VirtualMachineScaleSetVMProtectionPolicy

Specifica i criteri di protezione della macchina virtuale.

VirtualMachineSizeTypes

Specifica le dimensioni della macchina virtuale. Il tipo di dati enum è attualmente deprecato e verrà rimosso entro il 23 dicembre 2023. Il modo consigliato per ottenere l'elenco delle dimensioni disponibili consiste nell'usare queste API: elencare tutte le dimensioni delle macchine virtuali disponibili in un set di disponibilità, Elencare tutte le dimensioni disponibili delle macchine virtuali in un'area, Elencare tutte le dimensioni disponibili delle macchine virtuali per il ridimensionamento. Per altre informazioni sulle dimensioni delle macchine virtuali, vedere Dimensioni per le macchine virtuali. Le dimensioni della macchina virtuale disponibili dipendono dall'area e dal set di disponibilità.

VMDiskSecurityProfile

Specifica il profilo di sicurezza per il disco gestito.

VMSizeProperties

Specifica le proprietà per la personalizzazione delle dimensioni della macchina virtuale. Versione minima api: 2021-07-01. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per altri dettagli, seguire le istruzioni riportate in Personalizzazione della macchina virtuale .

WindowsConfiguration

Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.

WindowsPatchAssessmentMode

Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS.

I valori possibili sono:

ImageDefault : è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale.

AutomaticByPlatform : la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

Specifica l'impostazione di riavvio per tutte le operazioni di installazione di patch AutomaticByPlatform.

WindowsVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nella patch guest della macchina virtuale in Windows.

WindowsVMGuestPatchMode

Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile.

I valori possibili sono:

Manuale : è possibile controllare l'applicazione di patch a una macchina virtuale. A tale scopo, applicare manualmente le patch all'interno della macchina virtuale. In questa modalità, gli aggiornamenti automatici sono disabilitati; La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere false

AutomaticByOS : la macchina virtuale verrà aggiornata automaticamente dal sistema operativo. La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere true.

AutomaticByPlatform : la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. Le proprietà provisionVMAgent e WindowsConfiguration.enableAutomaticUpdates devono essere true

WinRMConfiguration

Specifica i listener di gestione remota Windows. In questo modo viene abilitato Windows PowerShell.

WinRMListener

Elenco di listener di Gestione remota Windows

AdditionalCapabilities

Specifica funzionalità aggiuntive abilitate o disabilitate nella macchina virtuale nel set di scalabilità. Ad esempio, se la macchina virtuale ha la possibilità di supportare il collegamento di dischi dati gestiti con UltraSSD_LRS tipo di account di archiviazione.

Nome Tipo Descrizione
hibernationEnabled

boolean

Flag che abilita o disabilita la funzionalità di ibernazione nella macchina virtuale.

ultraSSDEnabled

boolean

Flag che abilita o disabilita una funzionalità per avere uno o più dischi dati gestiti con UltraSSD_LRS tipo di account di archiviazione nella macchina virtuale o nella macchina virtuale. I dischi gestiti con tipo di account di archiviazione UltraSSD_LRS possono essere aggiunti a una macchina virtuale o a un set di scalabilità di macchine virtuali solo se questa proprietà è abilitata.

AdditionalUnattendContent

Specifica informazioni aggiuntive in formato XML con codifica Base 64 che possono essere incluse nel file Unattend.xml usato da Installazione di Windows.

Nome Tipo Descrizione
componentName

ComponentNames

Nome del componente. Attualmente, l'unico valore consentito è Microsoft-Windows-Shell-Setup.

content

string

Specifica il contenuto in formato XML aggiunto al file unattend.xml per il percorso e il componente specificati. Il codice XML deve essere minore di 4 KB e deve includere l'elemento radice per l'impostazione o la funzionalità da inserire.

passName

PassNames

Nome del passaggio. Attualmente, l'unico valore consentito è OobeSystem.

settingName

SettingNames

Specifica il nome dell'impostazione a cui si applica il contenuto. I valori possibili sono: FirstLogonCommands e AutoLogon.

ApiEntityReference

Identificatore della risorsa di origine. Può trattarsi di uno snapshot o di un punto di ripristino del disco da cui creare un disco.

Nome Tipo Descrizione
id

string

ID risorsa ARM nel formato /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Errore dell'API.

Nome Tipo Descrizione
code

string

Codice di errore.

details

ApiErrorBase[]

Dettagli dell'errore dell'API

innererror

InnerError

Errore interno dell'API

message

string

Messaggio di errore.

target

string

Destinazione dell'errore specifico.

ApiErrorBase

Base di errori dell'API.

Nome Tipo Descrizione
code

string

Codice di errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore specifico.

BootDiagnostics

Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output della console e screenshot per diagnosticare lo stato della macchina virtuale. NOTA: se viene specificato storageUri, assicurarsi che l'account di archiviazione si trova nella stessa area e sottoscrizione della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.

Nome Tipo Descrizione
enabled

boolean

Se la diagnostica di avvio deve essere abilitata nella macchina virtuale.

storageUri

string

Uri dell'account di archiviazione da usare per inserire l'output e lo screenshot della console. Se l'uri di archiviazione non è specificato durante l'abilitazione della diagnostica di avvio, verrà usata l'archiviazione gestita.

BootDiagnosticsInstanceView

Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output della console e lo screenshot per diagnosticare lo stato della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.

Nome Tipo Descrizione
consoleScreenshotBlobUri

string

URI BLOB dello screenshot della console. Nota: Questa impostazione non verrà impostata se la diagnostica di avvio è attualmente abilitata con l'archiviazione gestita.

serialConsoleLogBlobUri

string

Uri del BLOB di log della console seriale. Nota: Questa impostazione non verrà impostata se la diagnostica di avvio è attualmente abilitata con l'archiviazione gestita.

status

InstanceViewStatus

Informazioni sullo stato di diagnostica di avvio per la macchina virtuale. Nota: Verrà impostato solo se si verificano errori durante l'abilitazione della diagnostica di avvio.

CachingTypes

Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.

Nome Tipo Descrizione
None

string

ReadOnly

string

ReadWrite

string

CloudError

Risposta di errore dal servizio di calcolo.

Nome Tipo Descrizione
error

ApiError

Errore dell'API.

ComponentNames

Nome del componente. Attualmente, l'unico valore consentito è Microsoft-Windows-Shell-Setup.

Nome Tipo Descrizione
Microsoft-Windows-Shell-Setup

string

DataDisk

Specifica i parametri usati per aggiungere un disco dati a una macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

Nome Tipo Descrizione
caching

CachingTypes

Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.

createOption

DiskCreateOptionTypes

Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare il disco dati della macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza. Vuoto: Questo valore viene usato durante la creazione di un disco dati vuoto. Copia: Questo valore viene usato per creare un disco dati da uno snapshot o da un altro disco. Ripristinare: Questo valore viene usato per creare un disco dati da un punto di ripristino del disco.

deleteOption

DiskDeleteOptionTypes

Specifica se il disco dati deve essere eliminato o scollegato al momento dell'eliminazione della macchina virtuale. I valori possibili sono: Elimina. Se questo valore viene usato, il disco dati viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco dati viene conservato dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach.

detachOption

DiskDetachOptionTypes

Specifica il comportamento di scollegamento da usare durante lo scollegamento di un disco o che è già in fase di scollegamento dalla macchina virtuale. Valori supportati: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo di scollegamento precedente del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di scollegamento per scollegare forzatamente il disco dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su "true" insieme all'impostazione di detachOption: 'ForceDetach'.

diskIOPSReadWrite

integer

Specifica il Read-Write IOPS per il disco gestito quando StorageAccountType è UltraSSD_LRS. Restituito solo per i dischi delle macchine virtuali VirtualMachine ScaleSet. Può essere aggiornato solo tramite aggiornamenti al set di scalabilità VirtualMachine.

diskMBpsReadWrite

integer

Specifica la larghezza di banda in MB al secondo per il disco gestito quando StorageAccountType è UltraSSD_LRS. Restituito solo per i dischi delle macchine virtuali VirtualMachine ScaleSet. Può essere aggiornato solo tramite aggiornamenti al set di scalabilità VirtualMachine.

diskSizeGB

integer

Specifica le dimensioni di un disco dati vuoto in gigabyte. Questo elemento può essere usato per sovrascrivere le dimensioni del disco in un'immagine di macchina virtuale. La proprietà 'diskSizeGB' è il numero di byte x 1024^3 per il disco e il valore non può essere maggiore di 1023.

image

VirtualHardDisk

Disco rigido virtuale dell'immagine utente di origine. Il disco rigido virtuale verrà copiato prima di essere collegato alla macchina virtuale. Se viene fornito SourceImage, il disco rigido virtuale di destinazione non deve esistere.

lun

integer

Specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato a una macchina virtuale.

managedDisk

ManagedDiskParameters

Parametri del disco gestito.

name

string

Nome del disco.

sourceResource

ApiEntityReference

Identificatore della risorsa di origine. Può trattarsi di uno snapshot o di un punto di ripristino del disco da cui creare un disco.

toBeDetached

boolean

Specifica se il disco dati è in fase di scollegamento da VirtualMachine/VirtualMachineScaleset

vhd

VirtualHardDisk

Disco rigido virtuale.

writeAcceleratorEnabled

boolean

Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

DeleteOptions

Specificare cosa accade all'interfaccia di rete quando la macchina virtuale viene eliminata

Nome Tipo Descrizione
Delete

string

Detach

string

DiagnosticsProfile

Specifica lo stato delle impostazioni di diagnostica di avvio. Versione minima api: 2015-06-15.

Nome Tipo Descrizione
bootDiagnostics

BootDiagnostics

Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output della console e lo screenshot per diagnosticare lo stato della macchina virtuale. NOTA: se si specifica storageUri, assicurarsi che l'account di archiviazione si trova nella stessa area e nella stessa sottoscrizione della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.

DiffDiskOptions

Specifica le impostazioni temporanee del disco per il disco del sistema operativo.

Nome Tipo Descrizione
Local

string

DiffDiskPlacement

Specifica il posizionamento temporaneo del disco per il disco del sistema operativo. I valori possibili sono: CacheDisk,ResourceDisk,NvmeDisk. Il comportamento predefinito è: CacheDisk se ne è configurato uno per le dimensioni della macchina virtuale; in caso contrario, viene usato ResourceDisk o NvmeDisk. Fare riferimento alla documentazione relativa alle dimensioni delle macchine virtuali Windows in https://docs.microsoft.com/azure/virtual-machines/windows/sizes e alla macchina virtuale Linux in https://docs.microsoft.com/azure/virtual-machines/linux/sizes per verificare le dimensioni delle macchine virtuali che espongono un disco della cache. Versione api minima per NvmeDisk: 2024-03-01.

Nome Tipo Descrizione
CacheDisk

string

NvmeDisk

string

ResourceDisk

string

DiffDiskSettings

Specifica le impostazioni temporanee del disco per il disco del sistema operativo utilizzato dalla macchina virtuale.

Nome Tipo Descrizione
option

DiffDiskOptions

Specifica le impostazioni temporanee del disco per il disco del sistema operativo.

placement

DiffDiskPlacement

Specifica il posizionamento temporaneo del disco per il disco del sistema operativo. I valori possibili sono: CacheDisk,ResourceDisk,NvmeDisk. Il comportamento predefinito è: CacheDisk se ne è configurato uno per le dimensioni della macchina virtuale; in caso contrario, viene usato ResourceDisk o NvmeDisk. Fare riferimento alla documentazione relativa alle dimensioni delle macchine virtuali Windows in https://docs.microsoft.com/azure/virtual-machines/windows/sizes e alla macchina virtuale Linux in https://docs.microsoft.com/azure/virtual-machines/linux/sizes per verificare le dimensioni delle macchine virtuali che espongono un disco della cache. Versione api minima per NvmeDisk: 2024-03-01.

DiskControllerTypes

Specifica il tipo di controller del disco configurato per la macchina virtuale. Nota: Questa proprietà verrà impostata sul tipo di controller disco predefinito se non viene specificata la macchina virtuale specificata con 'hyperVGeneration' impostata su V2 in base alle funzionalità del disco del sistema operativo e delle dimensioni della macchina virtuale dalla versione api minima specificata. È necessario deallocare la macchina virtuale prima di aggiornare il tipo di controller del disco, a meno che non si aggiornino le dimensioni della macchina virtuale nella configurazione della macchina virtuale che dealloca in modo implicito e rialloca la macchina virtuale. Versione minima api: 2022-08-01.

Nome Tipo Descrizione
NVMe

string

SCSI

string

DiskCreateOptionTypes

Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza.

Nome Tipo Descrizione
Attach

string

Copy

string

Empty

string

FromImage

string

Restore

string

DiskDeleteOptionTypes

Specifica se il disco del sistema operativo deve essere eliminato o scollegato al momento dell'eliminazione della macchina virtuale. I valori possibili sono: Elimina. Se questo valore viene usato, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco del sistema operativo viene mantenuto dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per un disco del sistema operativo temporaneo.

Nome Tipo Descrizione
Delete

string

Detach

string

DiskDetachOptionTypes

Specifica il comportamento di scollegamento da usare durante lo scollegamento di un disco o che è già in fase di scollegamento dalla macchina virtuale. Valori supportati: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo di scollegamento precedente del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di scollegamento per scollegare forzatamente il disco dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su "true" insieme all'impostazione di detachOption: 'ForceDetach'.

Nome Tipo Descrizione
ForceDetach

string

DiskEncryptionSetParameters

Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.

Nome Tipo Descrizione
id

string

ID risorsa

DiskEncryptionSettings

Specifica le impostazioni di crittografia per il disco del sistema operativo.

Versione minima api: 2015-06-15

Nome Tipo Descrizione
diskEncryptionKey

KeyVaultSecretReference

Specifica il percorso della chiave di crittografia del disco, ovvero un segreto Key Vault.

enabled

boolean

Specifica se la crittografia del disco deve essere abilitata nella macchina virtuale.

keyEncryptionKey

KeyVaultKeyReference

Specifica la posizione della chiave di crittografia della chiave in Key Vault.

DiskInstanceView

Informazioni sui dischi.

Nome Tipo Descrizione
encryptionSettings

DiskEncryptionSettings[]

Specifica le impostazioni di crittografia per il disco del sistema operativo.

Versione minima api: 2015-06-15

name

string

Nome del disco.

statuses

InstanceViewStatus[]

Informazioni sullo stato della risorsa.

DomainNameLabelScopeTypes

Ambito dell'etichetta nome di dominio delle risorse PublicIPAddress che verranno create. L'etichetta del nome generata è la concatenazione dell'etichetta del nome di dominio hash con criteri in base all'ambito dell'etichetta del nome di dominio e all'ID univoco del profilo di rete della macchina virtuale.

Nome Tipo Descrizione
NoReuse

string

ResourceGroupReuse

string

SubscriptionReuse

string

TenantReuse

string

EncryptionIdentity

Specifica l'identità gestita usata da ADE per ottenere il token di accesso per le operazioni di keyvault.

Nome Tipo Descrizione
userAssignedIdentityResourceId

string

Specifica l'ID risorsa ARM di una delle identità utente associate alla macchina virtuale.

HardwareProfile

Specifica le impostazioni hardware per la macchina virtuale.

Nome Tipo Descrizione
vmSize

VirtualMachineSizeTypes

Specifica le dimensioni della macchina virtuale. Il tipo di dati enumerazione è attualmente deprecato e verrà rimosso entro il 23 dicembre 2023. Il modo consigliato per ottenere l'elenco delle dimensioni disponibili consiste nell'usare queste API: elencare tutte le dimensioni delle macchine virtuali disponibili in un set di disponibilità, Elencare tutte le dimensioni delle macchine virtuali disponibili inun'area, Elencare tutte le dimensioni delle macchine virtuali disponibili per il ridimensionamento. Per altre informazioni sulle dimensioni delle macchine virtuali, vedere Dimensioni per le macchine virtuali. Le dimensioni della macchina virtuale disponibili dipendono dall'area e dal set di disponibilità.

vmSizeProperties

VMSizeProperties

Specifica le proprietà per personalizzare le dimensioni della macchina virtuale. Versione minima api: 2021-07-01. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per altre informazioni, seguire le istruzioni riportate nella personalizzazione della macchina virtuale .

HyperVGeneration

Generazione dell'hypervisor della macchina virtuale [V1, V2]

Nome Tipo Descrizione
V1

string

V2

string

ImageReference

Specifica informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini di macchine virtuali. Questo elemento è necessario quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione.

Nome Tipo Descrizione
communityGalleryImageId

string

Specifica l'ID univoco dell'immagine della raccolta della community per la distribuzione di macchine virtuali. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta della community.

exactVersion

string

Specifica i numeri decimali, la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. Questo campo di sola lettura è diverso da 'version', solo se il valore specificato nel campo 'version' è 'latest'.

id

string

ID risorsa

offer

string

Specifica l'offerta dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale.

publisher

string

Autore dell'immagine.

sharedGalleryImageId

string

Specifica l'ID univoco dell'immagine della raccolta condivisa per la distribuzione della macchina virtuale. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta condivisa.

sku

string

SKU dell'immagine.

version

string

Specifica la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. I formati consentiti sono Major.Minor.Build o 'latest'. Major, Minor e Build sono numeri decimali. Specificare "latest" per usare la versione più recente di un'immagine disponibile in fase di distribuzione. Anche se si usa 'latest', l'immagine della macchina virtuale non verrà aggiornata automaticamente dopo la distribuzione anche se una nuova versione diventa disponibile. Non usare il campo 'version' per la distribuzione di immagini della raccolta, l'immagine della raccolta deve sempre usare il campo 'id' per la distribuzione, per usare la versione più recente dell'immagine della raccolta, è sufficiente impostare '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}' nel campo 'id' senza input della versione.

InnerError

Dettagli dell'errore interno.

Nome Tipo Descrizione
errordetail

string

Messaggio di errore interno o dump di eccezioni.

exceptiontype

string

Tipo di eccezione.

InstanceViewStatus

Stato della visualizzazione dell'istanza.

Nome Tipo Descrizione
code

string

Codice di stato.

displayStatus

string

Etichetta localizzabile breve per lo stato.

level

StatusLevelTypes

Codice di livello.

message

string

Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore.

time

string

Ora dello stato.

InstanceViewTypes

Espressione di espansione da applicare all'operazione. 'InstanceView' recupererà la visualizzazione dell'istanza della macchina virtuale. 'UserData' recupererà userData della macchina virtuale.

Nome Tipo Descrizione
instanceView

string

userData

string

IPVersion

Disponibile da Api-Version 2019-07-01 in poi, rappresenta se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito viene assunto come IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.

Nome Tipo Descrizione
IPv4

string

IPv6

string

IPVersions

Disponibile da Api-Version 2019-07-01 in poi, rappresenta se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito viene assunto come IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.

Nome Tipo Descrizione
IPv4

string

IPv6

string

KeyVaultKeyReference

Specifica il percorso della chiave di crittografia della chiave in Key Vault.

Nome Tipo Descrizione
keyUrl

string

URL che fa riferimento a una chiave di crittografia della chiave in Key Vault.

sourceVault

SubResource

URL relativo del Key Vault contenente la chiave.

KeyVaultSecretReference

Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi

Nome Tipo Descrizione
secretUrl

string

URL che fa riferimento a un segreto in un Key Vault.

sourceVault

SubResource

URL relativo del Key Vault contenente il segreto.

LinuxConfiguration

Specifica le impostazioni del sistema operativo Linux nella macchina virtuale. Per un elenco di distribuzioni Linux supportate, vedere Linux in Azure-Endorsed Distribuzioni.

Nome Tipo Descrizione
disablePasswordAuthentication

boolean

Specifica se l'autenticazione password deve essere disabilitata.

enableVMAgentPlatformUpdates

boolean

Indica se vmAgent Platform Aggiornamenti è abilitato per la macchina virtuale Linux. Il valore predefinito è false.

patchSettings

LinuxPatchSettings

[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Linux.

provisionVMAgent

boolean

Indica se nella macchina virtuale deve essere effettuato il provisioning dell'agente della macchina virtuale. Quando questa proprietà non è specificata nel corpo della richiesta, il comportamento predefinito consiste nel impostarlo su true. In questo modo, l'agente di macchine virtuali viene installato nella macchina virtuale in modo che le estensioni possano essere aggiunte alla macchina virtuale in un secondo momento.

ssh

SshConfiguration

Specifica la configurazione delle chiavi SSH per un sistema operativo Linux.

LinuxPatchAssessmentMode

Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS.

I valori possibili sono:

ImageDefault : è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale.

AutomaticByPlatform : la piattaforma attiverà valutazioni delle patch periodiche. La proprietà provisionVMAgent deve essere true.

Nome Tipo Descrizione
AutomaticByPlatform

string

ImageDefault

string

LinuxPatchSettings

[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest alle macchine virtuali in Linux.

Nome Tipo Descrizione
assessmentMode

LinuxPatchAssessmentMode

Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS.

I valori possibili sono:

ImageDefault : è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale.

AutomaticByPlatform : la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.

automaticByPlatformSettings

LinuxVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nella patch guest della macchina virtuale in Linux.

patchMode

LinuxVMGuestPatchMode

Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile.

I valori possibili sono:

ImageDefault : viene usata la configurazione predefinita dell'applicazione di patch della macchina virtuale.

AutomaticByPlatform : la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. La proprietà provisionVMAgent deve essere true

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

Specifica l'impostazione di riavvio per tutte le operazioni di installazione di patch AutomaticByPlatform.

Nome Tipo Descrizione
Always

string

IfRequired

string

Never

string

Unknown

string

LinuxVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nella patch guest della macchina virtuale in Linux.

Nome Tipo Descrizione
bypassPlatformSafetyChecksOnUserSchedule

boolean

Consente al cliente di pianificare l'applicazione di patch senza aggiornamenti accidentali

rebootSetting

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

Specifica l'impostazione di riavvio per tutte le operazioni di installazione di patch AutomaticByPlatform.

LinuxVMGuestPatchMode

Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile.

I valori possibili sono:

ImageDefault : viene usata la configurazione predefinita dell'applicazione di patch della macchina virtuale.

AutomaticByPlatform : la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. La proprietà provisionVMAgent deve essere true

Nome Tipo Descrizione
AutomaticByPlatform

string

ImageDefault

string

MaintenanceOperationResultCodeTypes

Codice risultato dell'ultima operazione di manutenzione.

Nome Tipo Descrizione
MaintenanceAborted

string

MaintenanceCompleted

string

None

string

RetryLater

string

MaintenanceRedeployStatus

Stato dell'operazione di manutenzione nella macchina virtuale.

Nome Tipo Descrizione
isCustomerInitiatedMaintenanceAllowed

boolean

True, se il cliente è autorizzato a eseguire la manutenzione.

lastOperationMessage

string

Messaggio restituito per l'ultima operazione di manutenzione.

lastOperationResultCode

MaintenanceOperationResultCodeTypes

Codice risultato dell'ultima operazione di manutenzione.

maintenanceWindowEndTime

string

Ora di fine per la finestra di manutenzione.

maintenanceWindowStartTime

string

Ora di inizio per la finestra di manutenzione.

preMaintenanceWindowEndTime

string

Ora di fine per la finestra di manutenzione preliminare.

preMaintenanceWindowStartTime

string

Ora di inizio per la finestra di manutenzione preliminare.

ManagedDiskParameters

Parametri del disco gestito.

Nome Tipo Descrizione
diskEncryptionSet

DiskEncryptionSetParameters

Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.

id

string

ID risorsa

securityProfile

VMDiskSecurityProfile

Specifica il profilo di sicurezza per il disco gestito.

storageAccountType

StorageAccountTypes

Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con i dischi dati, non può essere usato con il disco del sistema operativo.

Mode

Specifica la modalità su cui verrà eseguito ProxyAgent se la funzionalità è abilitata. ProxyAgent inizierà a controllare o monitorare ma non a imporre il controllo di accesso sulle richieste agli endpoint host in modalità di controllo, mentre in modalità Di imposizione applichererà il controllo di accesso. Il valore predefinito è Modalità di imposizione.

Nome Tipo Descrizione
Audit

string

Enforce

string

NetworkApiVersion

specifica la versione dell'API Microsoft.Network usata durante la creazione di risorse di rete nelle configurazioni dell'interfaccia di rete

Nome Tipo Descrizione
2020-11-01

string

NetworkInterfaceAuxiliaryMode

Specifica se la modalità ausiliaria è abilitata per la risorsa Interfaccia di rete.

Nome Tipo Descrizione
AcceleratedConnections

string

Floating

string

None

string

NetworkInterfaceAuxiliarySku

Specifica se lo SKU ausiliario è abilitato per la risorsa Interfaccia di rete.

Nome Tipo Descrizione
A1

string

A2

string

A4

string

A8

string

None

string

NetworkInterfaceReference

Specifica l'elenco di ID risorsa per le interfacce di rete associate alla macchina virtuale.

Nome Tipo Descrizione
id

string

ID risorsa

properties.deleteOption

DeleteOptions

Specificare cosa accade all'interfaccia di rete quando la macchina virtuale viene eliminata

properties.primary

boolean

Specifica l'interfaccia di rete primaria nel caso in cui la macchina virtuale abbia più di 1 interfaccia di rete.

NetworkProfile

Specifica le interfacce di rete della macchina virtuale.

Nome Tipo Descrizione
networkApiVersion

NetworkApiVersion

specifica la versione dell'API Microsoft.Network usata durante la creazione di risorse di rete nelle configurazioni dell'interfaccia di rete

networkInterfaceConfigurations

VirtualMachineNetworkInterfaceConfiguration[]

Specifica le configurazioni di rete che verranno usate per creare le risorse di rete della macchina virtuale.

networkInterfaces

NetworkInterfaceReference[]

Specifica l'elenco di ID risorsa per le interfacce di rete associate alla macchina virtuale.

OperatingSystemTypes

Tipo di sistema operativo.

Nome Tipo Descrizione
Linux

string

Windows

string

OSDisk

Specifica informazioni sul disco del sistema operativo utilizzato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

Nome Tipo Descrizione
caching

CachingTypes

Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.

createOption

DiskCreateOptionTypes

Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza.

deleteOption

DiskDeleteOptionTypes

Specifica se il disco del sistema operativo deve essere eliminato o scollegato al momento dell'eliminazione della macchina virtuale. I valori possibili sono: Elimina. Se questo valore viene usato, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco del sistema operativo viene mantenuto dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per un disco del sistema operativo temporaneo.

diffDiskSettings

DiffDiskSettings

Specifica le impostazioni temporanee del disco per il disco del sistema operativo utilizzato dalla macchina virtuale.

diskSizeGB

integer

Specifica le dimensioni di un disco dati vuoto in gigabyte. Questo elemento può essere usato per sovrascrivere le dimensioni del disco in un'immagine di macchina virtuale. La proprietà 'diskSizeGB' è il numero di byte x 1024^3 per il disco e il valore non può essere maggiore di 1023.

encryptionSettings

DiskEncryptionSettings

Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15.

image

VirtualHardDisk

Disco rigido virtuale dell'immagine utente di origine. Il disco rigido virtuale verrà copiato prima di essere collegato alla macchina virtuale. Se viene fornito SourceImage, il disco rigido virtuale di destinazione non deve esistere.

managedDisk

ManagedDiskParameters

Parametri del disco gestito.

name

string

Nome del disco.

osType

OperatingSystemTypes

Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco se si crea una macchina virtuale da un'immagine utente o un disco rigido virtuale specializzato. I valori possibili sono : Windows,Linux.

vhd

VirtualHardDisk

Disco rigido virtuale.

writeAcceleratorEnabled

boolean

Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

OSProfile

Specifica le impostazioni del sistema operativo per la macchina virtuale.

Nome Tipo Descrizione
adminPassword

string

Specifica la password dell'account amministratore.

Lunghezza minima (Windows): 8 caratteri

Lunghezza minima (Linux): 6 caratteri

Lunghezza massima (Windows): 123 caratteri

Lunghezza massima (Linux): 72 caratteri

Requisiti di complessità: 3 condizioni inferiori a 4 devono essere soddisfatte
Dispone di caratteri inferiori
Ha caratteri superiori
Ha una cifra
Ha un carattere speciale (corrispondenza Regex [\W_])

Valori non consentiti: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"

Per reimpostare la password, vedere Come reimpostare il servizio Desktop remoto o la relativa password di accesso in una macchina virtuale Windows

Per reimpostare la password radice, vedere Gestire gli utenti, SSH e controllare o ripristinare i dischi nelle macchine virtuali Linux di Azure usando l'estensione VMAccess

adminUsername

string

Specifica il nome dell'account amministratore.

Questa proprietà non può essere aggiornata dopo la creazione della macchina virtuale.

Restrizione solo Windows: Impossibile terminare in "."

Valori non consentiti: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "asp "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5".

Lunghezza minima (Linux): 1 carattere

Lunghezza massima (Linux): 64 caratteri

Lunghezza massima (Windows): 20 caratteri.

allowExtensionOperations

boolean

Specifica se le operazioni di estensione devono essere consentite nella macchina virtuale. Questa opzione può essere impostata solo su False quando non sono presenti estensioni nella macchina virtuale.

computerName

string

Specifica il nome del sistema operativo host della macchina virtuale. Questo nome non può essere aggiornato dopo la creazione della macchina virtuale. Lunghezza massima (Windows): 15 caratteri. Lunghezza massima (Linux): 64 caratteri. Per le convenzioni di denominazione e le restrizioni, vedere Linee guida per l'implementazione dei servizi di infrastruttura di Azure.

customData

string

Specifica una stringa con codifica in Base 64 di dati personalizzati. La stringa con codifica in Base 64 viene decodificata in una matrice binaria salvata come file nella macchina virtuale. La lunghezza massima della matrice binaria è 65535 byte. Nota: non passare segreti o password nella proprietà customData. Questa proprietà non può essere aggiornata dopo la creazione della macchina virtuale. La proprietà 'customData' viene passata alla macchina virtuale da salvare come file, per altre informazioni, vedere Dati personalizzati nelle macchine virtuali di Azure. Per usare cloud-init per la macchina virtuale Linux, vedere Uso di cloud-init per personalizzare una macchina virtuale Linux durante la creazione.

linuxConfiguration

LinuxConfiguration

Specifica le impostazioni del sistema operativo Linux nella macchina virtuale. Per un elenco di distribuzioni Linux supportate, vedere Linux in Azure-Endorsed Distribuzioni.

requireGuestProvisionSignal

boolean

Proprietà facoltativa che deve essere impostata su True o omessa.

secrets

VaultSecretGroup[]

Specifica il set di certificati che deve essere installato nella macchina virtuale. Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.

windowsConfiguration

WindowsConfiguration

Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.

PassNames

Nome del passaggio. Attualmente, l'unico valore consentito è OobeSystem.

Nome Tipo Descrizione
OobeSystem

string

PatchSettings

[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.

Nome Tipo Descrizione
assessmentMode

WindowsPatchAssessmentMode

Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS.

I valori possibili sono:

ImageDefault : è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale.

AutomaticByPlatform : la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.

automaticByPlatformSettings

WindowsVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nella patch guest della macchina virtuale in Windows.

enableHotpatching

boolean

Consente ai clienti di applicare patch alle macchine virtuali di Azure senza richiedere un riavvio. Per enableHotpatching, 'provisionVMAgent' deve essere impostato su true e 'patchMode' deve essere impostato su 'AutomaticByPlatform'.

patchMode

WindowsVMGuestPatchMode

Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile.

I valori possibili sono:

Manuale : è possibile controllare l'applicazione di patch a una macchina virtuale. A tale scopo, applicare manualmente le patch all'interno della macchina virtuale. In questa modalità, gli aggiornamenti automatici sono disabilitati; La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere false

AutomaticByOS : la macchina virtuale verrà aggiornata automaticamente dal sistema operativo. La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere true.

AutomaticByPlatform : la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. Le proprietà provisionVMAgent e WindowsConfiguration.enableAutomaticUpdates devono essere true

Plan

Specifica informazioni sull'immagine del marketplace usata per creare la macchina virtuale. Questo elemento viene usato solo per le immagini del marketplace. Prima di poter usare un'immagine del marketplace da un'API, è necessario abilitare l'immagine per l'uso a livello di codice. Nella portale di Azure individuare l'immagine del marketplace che si vuole usare e quindi fare clic su Vuoi distribuire a livello di codice, Introduzione a ->. Immettere le informazioni necessarie e quindi fare clic su Salva.

Nome Tipo Descrizione
name

string

ID piano.

product

string

Specifica il prodotto dell'immagine dal marketplace. Si tratta dello stesso valore di Offer nell'elemento imageReference.

promotionCode

string

Codice promozione.

publisher

string

ID editore.

ProtocolTypes

Specifica il protocollo del listener WinRM. I valori possibili sono: http,https.

Nome Tipo Descrizione
Http

string

Https

string

ProxyAgentSettings

Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale. Versione minima api: 2024-03-01.

Nome Tipo Descrizione
enabled

boolean

Specifica se la funzionalità ProxyAgent deve essere abilitata nella macchina virtuale o nel set di scalabilità di macchine virtuali.

keyIncarnationId

integer

Aumentare il valore di questa proprietà consente all'utente di reimpostare la chiave usata per proteggere il canale di comunicazione tra guest e host.

mode

Mode

Specifica la modalità in cui ProxyAgent verrà eseguito se la funzionalità è abilitata. ProxyAgent inizierà a controllare o monitorare ma non applicare il controllo di accesso alle richieste agli endpoint host in modalità di controllo, mentre in modalità Applica applichererà il controllo di accesso. Il valore predefinito è Applica modalità.

PublicIPAddressSku

Descrive lo SKU IP pubblico. Può essere impostato solo con OrchestrationMode come flessibile.

Nome Tipo Descrizione
name

PublicIPAddressSkuName

Specificare il nome dello sku IP pubblico

tier

PublicIPAddressSkuTier

Specificare il livello sku IP pubblico

PublicIPAddressSkuName

Specificare il nome dello sku IP pubblico

Nome Tipo Descrizione
Basic

string

Standard

string

PublicIPAddressSkuTier

Specificare il livello sku IP pubblico

Nome Tipo Descrizione
Global

string

Regional

string

PublicIPAllocationMethod

Specificare il tipo di allocazione IP pubblico

Nome Tipo Descrizione
Dynamic

string

Static

string

ResourceIdentityType

Tipo di identità usato per la macchina virtuale. Il tipo "SystemAssigned, UserAssigned" include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà le identità dalla macchina virtuale.

Nome Tipo Descrizione
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

securityEncryptionTypes

Specifica EncryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: Può essere impostato solo per le macchine virtuali riservate.

Nome Tipo Descrizione
DiskWithVMGuestState

string

NonPersistedTPM

string

VMGuestStateOnly

string

SecurityProfile

Specifica le impostazioni del profilo correlato alla sicurezza per la macchina virtuale.

Nome Tipo Descrizione
encryptionAtHost

boolean

Questa proprietà può essere usata dall'utente nella richiesta per abilitare o disabilitare la crittografia host per la macchina virtuale o il set di scalabilità di macchine virtuali. In questo modo verrà abilitata la crittografia per tutti i dischi, incluso il disco Resource/Temp nell'host stesso. Il comportamento predefinito è: la crittografia nell'host verrà disabilitata a meno che questa proprietà non sia impostata su true per la risorsa.

encryptionIdentity

EncryptionIdentity

Specifica l'identità gestita usata da ADE per ottenere il token di accesso per le operazioni dell'insieme di credenziali delle chiavi.

proxyAgentSettings

ProxyAgentSettings

Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale. Versione minima api: 2024-03-01.

securityType

SecurityTypes

Specifica il tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.

uefiSettings

UefiSettings

Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM, usate durante la creazione della macchina virtuale. Versione minima api: 2020-12-01.

SecurityTypes

Specifica il tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.

Nome Tipo Descrizione
ConfidentialVM

string

TrustedLaunch

string

SettingNames

Specifica il nome dell'impostazione a cui si applica il contenuto. I valori possibili sono: FirstLogonCommands e AutoLogon.

Nome Tipo Descrizione
AutoLogon

string

FirstLogonCommands

string

Sku

SKU della macchina virtuale.

Nome Tipo Descrizione
capacity

integer

Specifica il numero di macchine virtuali nel set di scalabilità.

name

string

Nome sku.

tier

string

Specifica il livello di macchine virtuali in un set di scalabilità.

I valori possibili sono:

Standard

Base

SshConfiguration

Specifica la configurazione delle chiavi SSH per un sistema operativo Linux.

Nome Tipo Descrizione
publicKeys

SshPublicKey[]

Elenco di chiavi pubbliche SSH usate per l'autenticazione con macchine virtuali basate su Linux.

SshPublicKey

Elenco di chiavi pubbliche SSH usate per l'autenticazione con macchine virtuali basate su Linux.

Nome Tipo Descrizione
keyData

string

Certificato di chiave pubblica SSH usato per eseguire l'autenticazione con la macchina virtuale tramite ssh. La chiave deve essere almeno a 2048 bit e in formato ssh-rsa. Per la creazione di chiavi SSH, vedere [Creare chiavi SSH in Linux e Mac per macchine virtuali Linux in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).

path

string

Specifica il percorso completo nella macchina virtuale creata in cui è archiviata la chiave pubblica SSH. Se il file esiste già, la chiave specificata viene aggiunta al file. Esempio: /home/user/.ssh/authorized_keys

StatusLevelTypes

Codice di livello.

Nome Tipo Descrizione
Error

string

Info

string

Warning

string

StorageAccountTypes

Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con i dischi dati, non può essere usato con il disco del sistema operativo.

Nome Tipo Descrizione
PremiumV2_LRS

string

Premium_LRS

string

Premium_ZRS

string

StandardSSD_LRS

string

StandardSSD_ZRS

string

Standard_LRS

string

UltraSSD_LRS

string

StorageProfile

Specifica le impostazioni di archiviazione per i dischi della macchina virtuale.

Nome Tipo Descrizione
dataDisks

DataDisk[]

Specifica i parametri usati per aggiungere un disco dati a una macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni sui dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

diskControllerType

DiskControllerTypes

Specifica il tipo di controller del disco configurato per la macchina virtuale. Nota: Questa proprietà verrà impostata sul tipo di controller del disco predefinito se non specificata la macchina virtuale specificata viene creata con 'hyperVGeneration' impostata su V2 in base alle funzionalità del disco del sistema operativo e alle dimensioni della macchina virtuale dalla versione minima dell'API specificata. È necessario deallocare la macchina virtuale prima di aggiornare il tipo di controller del disco, a meno che non si aggiornino le dimensioni della macchina virtuale nella configurazione della macchina virtuale che dealloca in modo implicito e rialloca la macchina virtuale. Versione minima api: 2022-08-01.

imageReference

ImageReference

Specifica informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini della macchina virtuale. Questo elemento è necessario quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine della macchina virtuale, ma non viene usata in altre operazioni di creazione.

osDisk

OSDisk

Specifica informazioni sul disco del sistema operativo usato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni sui dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

SubResource

URL relativo del Key Vault contenente il segreto.

Nome Tipo Descrizione
id

string

ID risorsa

UefiSettings

Specifica le impostazioni di sicurezza come l'avvio sicuro e vTPM usato durante la creazione della macchina virtuale. Versione minima api: 2020-12-01.

Nome Tipo Descrizione
secureBootEnabled

boolean

Specifica se l'avvio sicuro deve essere abilitato nella macchina virtuale. Versione minima api: 2020-12-01.

vTpmEnabled

boolean

Specifica se vTPM deve essere abilitato nella macchina virtuale. Versione minima api: 2020-12-01.

UserAssignedIdentities

Elenco di identità utente associate alla macchina virtuale. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Nome Tipo Descrizione

VaultCertificate

Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati.

Nome Tipo Descrizione
certificateStore

string

Per le macchine virtuali Windows, specifica l'archivio certificati nella macchina virtuale a cui aggiungere il certificato. L'archivio certificati specificato è in modo implicito nell'account LocalMachine. Per le macchine virtuali Linux, il file di certificato viene inserito nella directory /var/lib/waagent, con il nome <di file UppercaseThumbprint.crt> per il file di certificato X509 e <UppercaseThumbprint.prv> per la chiave privata. Entrambi questi file sono formattati con estensione pem.

certificateUrl

string

Si tratta dell'URL di un certificato caricato in Key Vault come segreto. Per aggiungere un segreto alla Key Vault, vedere Aggiungere una chiave o un segreto all'insieme di credenziali delle chiavi. In questo caso, il certificato deve essere La codifica Base64 dell'oggetto JSON seguente codificato in UTF-8:

{
"data":"",
"dataType":"pfx",
"password":""
}
Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.

VaultSecretGroup

Specifica il set di certificati che deve essere installato nella macchina virtuale. Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.

Nome Tipo Descrizione
sourceVault

SubResource

URL relativo della Key Vault contenente tutti i certificati in VaultCertificates.

vaultCertificates

VaultCertificate[]

Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati.

VirtualHardDisk

Disco rigido virtuale.

Nome Tipo Descrizione
uri

string

Specifica l'URI del disco rigido virtuale.

VirtualMachineAgentInstanceView

Agente di macchine virtuali in esecuzione nella macchina virtuale.

Nome Tipo Descrizione
extensionHandlers

VirtualMachineExtensionHandlerInstanceView[]

Visualizzazione dell'istanza del gestore dell'estensione della macchina virtuale.

statuses

InstanceViewStatus[]

Informazioni sullo stato della risorsa.

vmAgentVersion

string

Versione completa dell'agente di macchine virtuali.

VirtualMachineExtension

Risorse dell'estensione figlio della macchina virtuale.

Nome Tipo Descrizione
id

string

ID risorsa

location

string

Posizione risorsa

name

string

Nome risorsa

properties.autoUpgradeMinorVersion

boolean

Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie, a meno che non venga ridistribuibile, anche con questa proprietà impostata su true.

properties.enableAutomaticUpgrade

boolean

Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione.

properties.forceUpdateTag

string

Modalità di aggiornamento forzato del gestore dell'estensione anche se la configurazione dell'estensione non è stata modificata.

properties.instanceView

VirtualMachineExtensionInstanceView

Visualizzazione dell'istanza dell'estensione della macchina virtuale.

properties.protectedSettings

object

L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta.

properties.protectedSettingsFromKeyVault

KeyVaultSecretReference

Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi

properties.provisionAfterExtensions

string[]

Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione.

properties.provisioningState

string

Stato di provisioning, che viene visualizzato solo nella risposta.

properties.publisher

string

Nome del server di pubblicazione del gestore dell'estensione.

properties.settings

object

Impostazioni pubbliche in formato JSON per l'estensione.

properties.suppressFailures

boolean

Indica se gli errori derivanti dall'estensione verranno eliminati (gli errori operativi, ad esempio la mancata connessione alla macchina virtuale, non verranno eliminati indipendentemente da questo valore). Il valore predefinito è false.

properties.type

string

Specifica il tipo di estensione; un esempio è "CustomScriptExtension".

properties.typeHandlerVersion

string

Specifica la versione del gestore di script.

tags

object

Tag delle risorse

type

string

Tipo di risorsa

VirtualMachineExtensionHandlerInstanceView

Visualizzazione dell'istanza del gestore dell'estensione della macchina virtuale.

Nome Tipo Descrizione
status

InstanceViewStatus

Stato del gestore dell'estensione.

type

string

Specifica il tipo dell'estensione; un esempio è "CustomScriptExtension".

typeHandlerVersion

string

Specifica la versione del gestore script.

VirtualMachineExtensionInstanceView

Visualizzazione dell'istanza dell'estensione della macchina virtuale.

Nome Tipo Descrizione
name

string

Nome dell'estensione della macchina virtuale.

statuses

InstanceViewStatus[]

Informazioni sullo stato della risorsa.

substatuses

InstanceViewStatus[]

Informazioni sullo stato della risorsa.

type

string

Specifica il tipo di estensione; un esempio è "CustomScriptExtension".

typeHandlerVersion

string

Specifica la versione del gestore di script.

VirtualMachineHealthStatus

Stato di integrità per la macchina virtuale.

Nome Tipo Descrizione
status

InstanceViewStatus

Informazioni sullo stato di integrità per la macchina virtuale.

VirtualMachineIdentity

Identità della macchina virtuale, se configurata.

Nome Tipo Descrizione
principalId

string

ID entità dell'identità della macchina virtuale. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.

tenantId

string

ID tenant associato alla macchina virtuale. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.

type

ResourceIdentityType

Tipo di identità utilizzata per la macchina virtuale. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà le identità dalla macchina virtuale.

userAssignedIdentities

UserAssignedIdentities

Elenco delle identità utente associate alla macchina virtuale. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel modulo: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

VirtualMachineIpTag

Elenco di tag IP associati all'indirizzo IP pubblico.

Nome Tipo Descrizione
ipTagType

string

Tipo di tag IP. Esempio: FirstPartyUsage.

tag

string

Tag IP associato all'INDIRIZZO IP pubblico. Esempio: SQL, Archiviazione e così via.

VirtualMachineNetworkInterfaceConfiguration

Specifica le configurazioni di rete che verranno usate per creare le risorse di rete della macchina virtuale.

Nome Tipo Descrizione
name

string

Nome di configurazione dell'interfaccia di rete.

properties.auxiliaryMode

NetworkInterfaceAuxiliaryMode

Specifica se la modalità ausiliaria è abilitata per la risorsa Interfaccia di rete.

properties.auxiliarySku

NetworkInterfaceAuxiliarySku

Specifica se lo sku ausiliario è abilitato per la risorsa Interfaccia di rete.

properties.deleteOption

DeleteOptions

Specificare cosa accade all'interfaccia di rete quando la macchina virtuale viene eliminata

properties.disableTcpStateTracking

boolean

Specifica se l'interfaccia di rete è disabilitata per il rilevamento dello stato tcp.

properties.dnsSettings

VirtualMachineNetworkInterfaceDnsSettingsConfiguration

Le impostazioni dns da applicare nelle interfacce di rete.

properties.dscpConfiguration

SubResource

properties.enableAcceleratedNetworking

boolean

Specifica se l'interfaccia di rete è abilitata per la rete.

properties.enableFpga

boolean

Specifica se l'interfaccia di rete è abilitata per la rete FPGA.

properties.enableIPForwarding

boolean

Indica se l'inoltro IP è abilitato in questa scheda di interfaccia di rete.

properties.ipConfigurations

VirtualMachineNetworkInterfaceIPConfiguration[]

Specifica le configurazioni IP dell'interfaccia di rete.

properties.networkSecurityGroup

SubResource

Gruppo di sicurezza di rete.

properties.primary

boolean

Specifica l'interfaccia di rete primaria nel caso in cui la macchina virtuale abbia più di 1 interfaccia di rete.

VirtualMachineNetworkInterfaceDnsSettingsConfiguration

Impostazioni DNS da applicare alle interfacce di rete.

Nome Tipo Descrizione
dnsServers

string[]

Elenco di indirizzi IP dei server DNS

VirtualMachineNetworkInterfaceIPConfiguration

Specifica le configurazioni IP dell'interfaccia di rete.

Nome Tipo Descrizione
name

string

Nome della configurazione IP.

properties.applicationGatewayBackendAddressPools

SubResource[]

Specifica una matrice di riferimenti ai pool di indirizzi back-end dei gateway applicazione. Una macchina virtuale può fare riferimento a pool di indirizzi back-end di più gateway applicazione. Più macchine virtuali non possono usare lo stesso gateway applicazione.

properties.applicationSecurityGroups

SubResource[]

Specifica una matrice di riferimenti al gruppo di sicurezza delle applicazioni.

properties.loadBalancerBackendAddressPools

SubResource[]

Specifica una matrice di riferimenti ai pool di indirizzi back-end di servizi di bilanciamento del carico. Una macchina virtuale può fare riferimento a pool di indirizzi back-end di un servizio di bilanciamento del carico pubblico e di un servizio di bilanciamento del carico interno. [Più macchine virtuali non possono usare lo stesso servizio di bilanciamento del carico sku basic].

properties.primary

boolean

Specifica l'interfaccia di rete primaria nel caso in cui la macchina virtuale abbia più di 1 interfaccia di rete.

properties.privateIPAddressVersion

IPVersions

Disponibile da Api-Version 2017-03-30 e versioni successive, indica se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito è IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.

properties.publicIPAddressConfiguration

VirtualMachinePublicIPAddressConfiguration

PublicIPAddressConfiguration.

properties.subnet

SubResource

Specifica l'identificatore della subnet.

VirtualMachinePublicIPAddressConfiguration

PublicIPAddressConfiguration.

Nome Tipo Descrizione
name

string

Nome di configurazione dell'indirizzo publicIP.

properties.deleteOption

DeleteOptions

Specificare cosa accade all'indirizzo IP pubblico quando la macchina virtuale viene eliminata

properties.dnsSettings

VirtualMachinePublicIPAddressDnsSettingsConfiguration

Le impostazioni dns da applicare agli indirizzi publicIP .

properties.idleTimeoutInMinutes

integer

Timeout inattiva dell'indirizzo IP pubblico.

properties.ipTags

VirtualMachineIpTag[]

Elenco di tag IP associati all'indirizzo IP pubblico.

properties.publicIPAddressVersion

IPVersions

Disponibile da Api-Version 2019-07-01 in poi, rappresenta se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito viene assunto come IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.

properties.publicIPAllocationMethod

PublicIPAllocationMethod

Specificare il tipo di allocazione IP pubblico

properties.publicIPPrefix

SubResource

PublicIPPrefix da cui allocare indirizzi publicIP.

sku

PublicIPAddressSku

Descrive lo SKU IP pubblico. Può essere impostato solo con OrchestrationMode come flessibile.

VirtualMachinePublicIPAddressDnsSettingsConfiguration

Le impostazioni dns da applicare agli indirizzi publicIP .

Nome Tipo Descrizione
domainNameLabel

string

Prefisso dell'etichetta nome di dominio delle risorse PublicIPAddress che verranno create. L'etichetta del nome generata è la concatenazione dell'etichetta del nome di dominio e dell'ID univoco del profilo di rete vm.

domainNameLabelScope

DomainNameLabelScopeTypes

Ambito dell'etichetta nome di dominio delle risorse PublicIPAddress che verranno create. L'etichetta del nome generata è la concatenazione dell'etichetta del nome di dominio hash con criteri in base all'ambito dell'etichetta del nome di dominio e all'ID univoco del profilo di rete della macchina virtuale.

VirtualMachineScaleSetIPConfiguration

Specifica le configurazioni IP dell'interfaccia di rete.

Nome Tipo Descrizione
name

string

Nome della configurazione IP.

properties.applicationGatewayBackendAddressPools

SubResource[]

Specifica una matrice di riferimenti ai pool di indirizzi back-end dei gateway applicazione. Un set di scalabilità può fare riferimento a pool di indirizzi back-end di più gateway applicazione. Più set di scalabilità non possono usare lo stesso gateway applicazione.

properties.applicationSecurityGroups

SubResource[]

Specifica una matrice di riferimenti al gruppo di sicurezza delle applicazioni.

properties.loadBalancerBackendAddressPools

SubResource[]

Specifica una matrice di riferimenti ai pool di indirizzi back-end di servizi di bilanciamento del carico. Un set di scalabilità può fare riferimento a pool di indirizzi back-end di un servizio di bilanciamento del carico pubblico e di un servizio di bilanciamento del carico interno. Più set di scalabilità non possono usare lo stesso servizio di bilanciamento del carico sku basic.

properties.loadBalancerInboundNatPools

SubResource[]

Specifica una matrice di riferimenti ai pool Nat in ingresso dei servizi di bilanciamento del carico. Un set di scalabilità può fare riferimento a pool NAT in ingresso di un servizio di bilanciamento del carico pubblico e di un servizio di bilanciamento del carico interno. Più set di scalabilità non possono usare lo stesso servizio di bilanciamento del carico sku basic.

properties.primary

boolean

Specifica l'interfaccia di rete primaria nel caso in cui la macchina virtuale abbia più di 1 interfaccia di rete.

properties.privateIPAddressVersion

IPVersion

Disponibile da Api-Version 2017-03-30 e versioni successive, indica se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito è IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.

properties.publicIPAddressConfiguration

VirtualMachineScaleSetPublicIPAddressConfiguration

PublicIPAddressConfiguration.

properties.subnet

ApiEntityReference

Specifica l'identificatore della subnet.

VirtualMachineScaleSetIpTag

Elenco di tag IP associati all'indirizzo IP pubblico.

Nome Tipo Descrizione
ipTagType

string

Tipo di tag IP. Esempio: FirstPartyUsage.

tag

string

Tag IP associato all'INDIRIZZO IP pubblico. Esempio: SQL, Archiviazione e così via.

VirtualMachineScaleSetNetworkConfiguration

Elenco delle configurazioni di rete.

Nome Tipo Descrizione
name

string

Nome della configurazione di rete.

properties.auxiliaryMode

NetworkInterfaceAuxiliaryMode

Specifica se la modalità ausiliaria è abilitata per la risorsa Interfaccia di rete.

properties.auxiliarySku

NetworkInterfaceAuxiliarySku

Specifica se lo sku ausiliario è abilitato per la risorsa Interfaccia di rete.

properties.deleteOption

DeleteOptions

Specificare cosa accade all'interfaccia di rete quando la macchina virtuale viene eliminata

properties.disableTcpStateTracking

boolean

Specifica se l'interfaccia di rete è disabilitata per il rilevamento dello stato tcp.

properties.dnsSettings

VirtualMachineScaleSetNetworkConfigurationDnsSettings

Le impostazioni dns da applicare nelle interfacce di rete.

properties.enableAcceleratedNetworking

boolean

Specifica se l'interfaccia di rete è abilitata per la rete.

properties.enableFpga

boolean

Specifica se l'interfaccia di rete è abilitata per la rete FPGA.

properties.enableIPForwarding

boolean

Indica se l'inoltro IP è abilitato in questa scheda di interfaccia di rete.

properties.ipConfigurations

VirtualMachineScaleSetIPConfiguration[]

Specifica le configurazioni IP dell'interfaccia di rete.

properties.networkSecurityGroup

SubResource

Gruppo di sicurezza di rete.

properties.primary

boolean

Specifica l'interfaccia di rete primaria nel caso in cui la macchina virtuale abbia più di 1 interfaccia di rete.

VirtualMachineScaleSetNetworkConfigurationDnsSettings

Impostazioni DNS da applicare alle interfacce di rete.

Nome Tipo Descrizione
dnsServers

string[]

Elenco di indirizzi IP dei server DNS

VirtualMachineScaleSetPublicIPAddressConfiguration

PublicIPAddressConfiguration.

Nome Tipo Descrizione
name

string

Nome di configurazione dell'indirizzo publicIP.

properties.deleteOption

DeleteOptions

Specificare cosa accade all'INDIRIZZO IP pubblico quando la macchina virtuale viene eliminata

properties.dnsSettings

VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings

Le impostazioni dns da applicare agli indirizzi publicIP .

properties.idleTimeoutInMinutes

integer

Timeout inattiva dell'indirizzo IP pubblico.

properties.ipTags

VirtualMachineScaleSetIpTag[]

Elenco di tag IP associati all'indirizzo IP pubblico.

properties.publicIPAddressVersion

IPVersion

Disponibile da Api-Version 2019-07-01 in poi, rappresenta se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito viene assunto come IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.

properties.publicIPPrefix

SubResource

PublicIPPrefix da cui allocare indirizzi publicIP.

sku

PublicIPAddressSku

Descrive lo SKU IP pubblico. Può essere impostato solo con OrchestrationMode come flessibile.

VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings

Le impostazioni dns da applicare agli indirizzi publicIP .

Nome Tipo Descrizione
domainNameLabel

string

Etichetta Nome di dominio. La concatenazione dell'etichetta del nome di dominio e dell'indice vm sarà le etichette dei nomi di dominio delle risorse PublicIPAddress che verranno create

domainNameLabelScope

DomainNameLabelScopeTypes

Ambito dell'etichetta Nome di dominio. La concatenazione dell'etichetta del nome di dominio hash generata in base ai criteri dall'ambito dell'etichetta del nome di dominio e l'indice della macchina virtuale saranno le etichette dei nomi di dominio delle risorse PublicIPAddress che verranno create

VirtualMachineScaleSetVM

Descrive una macchina virtuale del set di scalabilità di macchine virtuali.

Nome Tipo Descrizione
etag

string

Etag è la proprietà restituita nella risposta Update/Get della macchina virtuale del set di scalabilità di macchine virtuali, in modo che il cliente possa specificarlo nell'intestazione per garantire gli aggiornamenti ottimistici.

id

string

ID risorsa

identity

VirtualMachineIdentity

Identità della macchina virtuale, se configurata.

instanceId

string

ID istanza della macchina virtuale.

location

string

Posizione risorsa

name

string

Nome risorsa

plan

Plan

Specifica informazioni sull'immagine del marketplace usata per creare la macchina virtuale. Questo elemento viene usato solo per le immagini del marketplace. Prima di poter usare un'immagine del marketplace da un'API, è necessario abilitare l'immagine per l'uso a livello di codice. Nella portale di Azure individuare l'immagine del marketplace che si vuole usare e quindi fare clic su Vuoi distribuire a livello di codice, Introduzione a ->. Immettere le informazioni necessarie e quindi fare clic su Salva.

properties.additionalCapabilities

AdditionalCapabilities

Specifica funzionalità aggiuntive abilitate o disabilitate nella macchina virtuale nel set di scalabilità. Ad esempio, se la macchina virtuale ha la possibilità di supportare il collegamento di dischi dati gestiti con UltraSSD_LRS tipo di account di archiviazione.

properties.availabilitySet

SubResource

Specifica informazioni sul set di disponibilità a cui deve essere assegnata la macchina virtuale. Le macchine virtuali specificate nello stesso set di disponibilità vengono allocate a nodi diversi per ottimizzare la disponibilità. Per altre informazioni sui set di disponibilità, vedere Panoramica dei set di disponibilità. Per altre informazioni sulla manutenzione pianificata di Azure, vedere Manutenzione e aggiornamenti per Macchine virtuali in Azure. Attualmente, una macchina virtuale può essere aggiunta solo al set di disponibilità in fase di creazione. Non è possibile aggiungere una macchina virtuale esistente a un set di disponibilità.

properties.diagnosticsProfile

DiagnosticsProfile

Specifica lo stato delle impostazioni di diagnostica di avvio. Versione minima api: 2015-06-15.

properties.hardwareProfile

HardwareProfile

Specifica le impostazioni hardware per la macchina virtuale.

properties.instanceView

VirtualMachineScaleSetVMInstanceView

Visualizzazione dell'istanza della macchina virtuale.

properties.latestModelApplied

boolean

Specifica se il modello più recente è stato applicato alla macchina virtuale.

properties.licenseType

string

Specifica che l'immagine o il disco usato è stato concesso in licenza in locale.

I valori possibili per il sistema operativo Windows Server sono:

Windows_Client

Windows_Server

I valori possibili per il sistema operativo Linux Server sono:

RHEL_BYOS (per RHEL)

SLES_BYOS (per SUSE)

Per altre informazioni, vedere Vantaggio Azure Hybrid Use per Windows Server

Vantaggio Azure Hybrid Use per Linux Server

Versione minima api: 2015-06-15

properties.modelDefinitionApplied

string

Specifica se il modello applicato alla macchina virtuale è il modello del set di scalabilità di macchine virtuali o il modello personalizzato per la macchina virtuale.

properties.networkProfile

NetworkProfile

Specifica le interfacce di rete della macchina virtuale.

properties.networkProfileConfiguration

VirtualMachineScaleSetVMNetworkProfileConfiguration

Specifica la configurazione del profilo di rete della macchina virtuale.

properties.osProfile

OSProfile

Specifica le impostazioni del sistema operativo per la macchina virtuale.

properties.protectionPolicy

VirtualMachineScaleSetVMProtectionPolicy

Specifica i criteri di protezione della macchina virtuale.

properties.provisioningState

string

Stato di provisioning, che viene visualizzato solo nella risposta.

properties.securityProfile

SecurityProfile

Specifica le impostazioni del profilo correlato alla sicurezza per la macchina virtuale.

properties.storageProfile

StorageProfile

Specifica le impostazioni di archiviazione per i dischi della macchina virtuale.

properties.timeCreated

string

Specifica l'ora in cui è stata creata la risorsa macchina virtuale.

Versione minima api: 2021-11-01.

properties.userData

string

UserData per la macchina virtuale, che deve essere codificata in base 64. Il cliente non deve passare segreti qui.

Versione minima api: 2021-03-01

properties.vmId

string

ID univoco della macchina virtuale di Azure.

resources

VirtualMachineExtension[]

Risorse dell'estensione figlio della macchina virtuale.

sku

Sku

SKU della macchina virtuale.

tags

object

Tag delle risorse

type

string

Tipo di risorsa

zones

string[]

Zone della macchina virtuale.

VirtualMachineScaleSetVMInstanceView

Visualizzazione dell'istanza della macchina virtuale.

Nome Tipo Descrizione
assignedHost

string

ID risorsa dell'host dedicato, in cui la macchina virtuale viene allocata tramite posizionamento automatico, quando la macchina virtuale è associata a un gruppo host dedicato con posizionamento automatico abilitato. Versione minima api: 2020-06-01.

bootDiagnostics

BootDiagnosticsInstanceView

Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output della console e screenshot per diagnosticare lo stato della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.

computerName

string

Specifica il nome del sistema operativo host della macchina virtuale.

Questo nome non può essere aggiornato dopo la creazione della macchina virtuale.

Lunghezza massima (Windows): 15 caratteri

Lunghezza massima (Linux): 64 caratteri.

Per le convenzioni di denominazione e le restrizioni, vedere Linee guida per l'implementazione dei servizi di infrastruttura di Azure.

disks

DiskInstanceView[]

Informazioni sui dischi.

extensions

VirtualMachineExtensionInstanceView[]

Informazioni sulle estensioni.

hyperVGeneration

HyperVGeneration

Generazione di hypervisor della macchina virtuale [V1, V2]

maintenanceRedeployStatus

MaintenanceRedeployStatus

Stato dell'operazione di manutenzione nella macchina virtuale.

osName

string

Sistema operativo in esecuzione nel computer ibrido.

osVersion

string

Versione del sistema operativo in esecuzione nel computer ibrido.

placementGroupId

string

Gruppo di posizionamento in cui è in esecuzione la macchina virtuale. Se la macchina virtuale viene deallocata non avrà un placementGroupId.

platformFaultDomain

integer

Numero di domini di errore.

platformUpdateDomain

integer

Numero di domini di aggiornamento.

rdpThumbPrint

string

Identificazione personale del certificato desktop remoto.

statuses

InstanceViewStatus[]

Informazioni sullo stato della risorsa.

vmAgent

VirtualMachineAgentInstanceView

Agente vm in esecuzione nella macchina virtuale.

vmHealth

VirtualMachineHealthStatus

Stato di integrità per la macchina virtuale.

VirtualMachineScaleSetVMNetworkProfileConfiguration

Specifica la configurazione del profilo di rete della macchina virtuale.

Nome Tipo Descrizione
networkInterfaceConfigurations

VirtualMachineScaleSetNetworkConfiguration[]

Elenco di configurazioni di rete.

VirtualMachineScaleSetVMProtectionPolicy

Specifica i criteri di protezione della macchina virtuale.

Nome Tipo Descrizione
protectFromScaleIn

boolean

Indica che la macchina virtuale del set di scalabilità di macchine virtuali non deve essere considerata per l'eliminazione durante un'operazione con scalabilità orizzontale.

protectFromScaleSetActions

boolean

Indica che gli aggiornamenti o le azioni del modello (incluso il ridimensionamento) avviati nel set di scalabilità di macchine virtuali non devono essere applicati alla macchina virtuale del set di scalabilità di macchine virtuali.

VirtualMachineSizeTypes

Specifica le dimensioni della macchina virtuale. Il tipo di dati enum è attualmente deprecato e verrà rimosso entro il 23 dicembre 2023. Il modo consigliato per ottenere l'elenco delle dimensioni disponibili consiste nell'usare queste API: elencare tutte le dimensioni delle macchine virtuali disponibili in un set di disponibilità, Elencare tutte le dimensioni disponibili delle macchine virtuali in un'area, Elencare tutte le dimensioni disponibili delle macchine virtuali per il ridimensionamento. Per altre informazioni sulle dimensioni delle macchine virtuali, vedere Dimensioni per le macchine virtuali. Le dimensioni della macchina virtuale disponibili dipendono dall'area e dal set di disponibilità.

Nome Tipo Descrizione
Basic_A0

string

Basic_A1

string

Basic_A2

string

Basic_A3

string

Basic_A4

string

Standard_A0

string

Standard_A1

string

Standard_A10

string

Standard_A11

string

Standard_A1_v2

string

Standard_A2

string

Standard_A2_v2

string

Standard_A2m_v2

string

Standard_A3

string

Standard_A4

string

Standard_A4_v2

string

Standard_A4m_v2

string

Standard_A5

string

Standard_A6

string

Standard_A7

string

Standard_A8

string

Standard_A8_v2

string

Standard_A8m_v2

string

Standard_A9

string

Standard_B1ms

string

Standard_B1s

string

Standard_B2ms

string

Standard_B2s

string

Standard_B4ms

string

Standard_B8ms

string

Standard_D1

string

Standard_D11

string

Standard_D11_v2

string

Standard_D12

string

Standard_D12_v2

string

Standard_D13

string

Standard_D13_v2

string

Standard_D14

string

Standard_D14_v2

string

Standard_D15_v2

string

Standard_D16_v3

string

Standard_D16s_v3

string

Standard_D1_v2

string

Standard_D2

string

Standard_D2_v2

string

Standard_D2_v3

string

Standard_D2s_v3

string

Standard_D3

string

Standard_D32_v3

string

Standard_D32s_v3

string

Standard_D3_v2

string

Standard_D4

string

Standard_D4_v2

string

Standard_D4_v3

string

Standard_D4s_v3

string

Standard_D5_v2

string

Standard_D64_v3

string

Standard_D64s_v3

string

Standard_D8_v3

string

Standard_D8s_v3

string

Standard_DS1

string

Standard_DS11

string

Standard_DS11_v2

string

Standard_DS12

string

Standard_DS12_v2

string

Standard_DS13

string

Standard_DS13-2_v2

string

Standard_DS13-4_v2

string

Standard_DS13_v2

string

Standard_DS14

string

Standard_DS14-4_v2

string

Standard_DS14-8_v2

string

Standard_DS14_v2

string

Standard_DS15_v2

string

Standard_DS1_v2

string

Standard_DS2

string

Standard_DS2_v2

string

Standard_DS3

string

Standard_DS3_v2

string

Standard_DS4

string

Standard_DS4_v2

string

Standard_DS5_v2

string

Standard_E16_v3

string

Standard_E16s_v3

string

Standard_E2_v3

string

Standard_E2s_v3

string

Standard_E32-16_v3

string

Standard_E32-8s_v3

string

Standard_E32_v3

string

Standard_E32s_v3

string

Standard_E4_v3

string

Standard_E4s_v3

string

Standard_E64-16s_v3

string

Standard_E64-32s_v3

string

Standard_E64_v3

string

Standard_E64s_v3

string

Standard_E8_v3

string

Standard_E8s_v3

string

Standard_F1

string

Standard_F16

string

Standard_F16s

string

Standard_F16s_v2

string

Standard_F1s

string

Standard_F2

string

Standard_F2s

string

Standard_F2s_v2

string

Standard_F32s_v2

string

Standard_F4

string

Standard_F4s

string

Standard_F4s_v2

string

Standard_F64s_v2

string

Standard_F72s_v2

string

Standard_F8

string

Standard_F8s

string

Standard_F8s_v2

string

Standard_G1

string

Standard_G2

string

Standard_G3

string

Standard_G4

string

Standard_G5

string

Standard_GS1

string

Standard_GS2

string

Standard_GS3

string

Standard_GS4

string

Standard_GS4-4

string

Standard_GS4-8

string

Standard_GS5

string

Standard_GS5-16

string

Standard_GS5-8

string

Standard_H16

string

Standard_H16m

string

Standard_H16mr

string

Standard_H16r

string

Standard_H8

string

Standard_H8m

string

Standard_L16s

string

Standard_L32s

string

Standard_L4s

string

Standard_L8s

string

Standard_M128-32ms

string

Standard_M128-64ms

string

Standard_M128ms

string

Standard_M128s

string

Standard_M64-16ms

string

Standard_M64-32ms

string

Standard_M64ms

string

Standard_M64s

string

Standard_NC12

string

Standard_NC12s_v2

string

Standard_NC12s_v3

string

Standard_NC24

string

Standard_NC24r

string

Standard_NC24rs_v2

string

Standard_NC24rs_v3

string

Standard_NC24s_v2

string

Standard_NC24s_v3

string

Standard_NC6

string

Standard_NC6s_v2

string

Standard_NC6s_v3

string

Standard_ND12s

string

Standard_ND24rs

string

Standard_ND24s

string

Standard_ND6s

string

Standard_NV12

string

Standard_NV24

string

Standard_NV6

string

VMDiskSecurityProfile

Specifica il profilo di sicurezza per il disco gestito.

Nome Tipo Descrizione
diskEncryptionSet

DiskEncryptionSetParameters

Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito usato per il disco del sistema operativo ConfidentialVM crittografato con chiave gestita dal cliente e il BLOB VMGuest.

securityEncryptionType

securityEncryptionTypes

Specifica il tipo di crittografia del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: Può essere impostata solo per le macchine virtuali riservate.

VMSizeProperties

Specifica le proprietà per la personalizzazione delle dimensioni della macchina virtuale. Versione minima api: 2021-07-01. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per altri dettagli, seguire le istruzioni riportate in Personalizzazione della macchina virtuale .

Nome Tipo Descrizione
vCPUsAvailable

integer

Specifica il numero di vCPU disponibili per la macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito consiste nell'impostarlo sul valore delle vCPU disponibili per le dimensioni della macchina virtuale esposte nella risposta api di Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area.

vCPUsPerCore

integer

Specifica il rapporto tra vCPU e core fisici. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito viene impostato sul valore di vCPUsPerCore per le dimensioni della macchina virtuale esposte nella risposta api di Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area. L'impostazione di questa proprietà su 1 significa anche che l'hyperthreading è disabilitato.

WindowsConfiguration

Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.

Nome Tipo Descrizione
additionalUnattendContent

AdditionalUnattendContent[]

Specifica informazioni aggiuntive in formato XML con codifica Base 64 che possono essere incluse nel file Unattend.xml usato da Installazione di Windows.

enableAutomaticUpdates

boolean

Indica se l'Aggiornamenti automatica è abilitata per la macchina virtuale Windows. Il valore predefinito è true. Per i set di scalabilità di macchine virtuali, questa proprietà può essere aggiornata e gli aggiornamenti avranno effetto sul reprovisioning del sistema operativo.

enableVMAgentPlatformUpdates

boolean

Indica se vmAgent Platform Aggiornamenti è abilitato per la macchina virtuale Windows. Il valore predefinito è false.

patchSettings

PatchSettings

[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.

provisionVMAgent

boolean

Indica se nella macchina virtuale deve essere effettuato il provisioning dell'agente della macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, viene impostata su true per impostazione predefinita. In questo modo, l'agente di macchine virtuali viene installato nella macchina virtuale in modo che le estensioni possano essere aggiunte alla macchina virtuale in un secondo momento.

timeZone

string

Specifica il fuso orario della macchina virtuale. ad esempio "Pacifico Standard Time". I valori possibili possono essere TimeZoneInfo.Id valore dai fusi orari restituiti da TimeZoneInfo.GetSystemTimeZones.

winRM

WinRMConfiguration

Specifica i listener di Gestione remota Windows. In questo modo viene abilitato Windows PowerShell.

WindowsPatchAssessmentMode

Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS.

I valori possibili sono:

ImageDefault : è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale.

AutomaticByPlatform : la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.

Nome Tipo Descrizione
AutomaticByPlatform

string

ImageDefault

string

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

Specifica l'impostazione di riavvio per tutte le operazioni di installazione di patch AutomaticByPlatform.

Nome Tipo Descrizione
Always

string

IfRequired

string

Never

string

Unknown

string

WindowsVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nella patch guest della macchina virtuale in Windows.

Nome Tipo Descrizione
bypassPlatformSafetyChecksOnUserSchedule

boolean

Consente al cliente di pianificare l'applicazione di patch senza aggiornamenti accidentali

rebootSetting

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.

WindowsVMGuestPatchMode

Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile.

I valori possibili sono:

Manuale : è possibile controllare l'applicazione di patch a una macchina virtuale. A tale scopo, applicare manualmente le patch all'interno della macchina virtuale. In questa modalità, gli aggiornamenti automatici sono disabilitati; La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere false

AutomaticByOS : la macchina virtuale verrà aggiornata automaticamente dal sistema operativo. La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere true.

AutomaticByPlatform : la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. Le proprietà provisionVMAgent e WindowsConfiguration.enableAutomaticUpdates devono essere true

Nome Tipo Descrizione
AutomaticByOS

string

AutomaticByPlatform

string

Manual

string

WinRMConfiguration

Specifica i listener di gestione remota Windows. In questo modo viene abilitato Windows PowerShell.

Nome Tipo Descrizione
listeners

WinRMListener[]

Elenco di listener di Gestione remota Windows

WinRMListener

Elenco di listener di Gestione remota Windows

Nome Tipo Descrizione
certificateUrl

string

Si tratta dell'URL di un certificato caricato in Key Vault come segreto. Per aggiungere un segreto alla Key Vault, vedere Aggiungere una chiave o un segreto all'insieme di credenziali delle chiavi. In questo caso, il certificato deve essere la codifica Base64 dell'oggetto JSON seguente, codificato in UTF-8:

{
"data":"",
"dataType":"pfx",
"password":""
}
Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.

protocol

ProtocolTypes

Specifica il protocollo del listener WinRM. I valori possibili sono: http,https.