Microsoft.AzureStackHCI (preview:2024-02-01)

2024/12/17 • 4 updated methods

VirtualMachineInstances_List (updated)
Description :  Lists all of the virtual machine instances within the specified parent resource.
Reference :  Link ¶

⚶ Changes

{
  "#id": "VirtualMachineInstances_List",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "osProfile": [
                  {
                    "linuxConfiguration": [
                      {
                        "ssh": [
                          {
                            "publicKeys": {
                              "$properties": [
                                {
                                  "#name": "keyData",
                                  "Description": {
                                    "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                    "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                                  }
                                }
                              ]
                            }
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "windowsConfiguration": [
                      {
                        "ssh": [
                          {
                            "publicKeys": {
                              "$properties": [
                                {
                                  "#name": "keyData",
                                  "Description": {
                                    "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                    "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                                  }
                                }
                              ]
                            }
                          }
                        ]
                      }
                    ]
                  }
                ]
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /{resourceUri}/providers/Microsoft.AzureStackHCI/virtualMachineInstances
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
resourceUri:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The VirtualMachineInstance items on this page ,
Required: True ,
}
[
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
hardwareProfile:
{
Description: HardwareProfile - Specifies the hardware settings for the virtual machine instance. ,
Required: False ,
}
{
vmSize:
{
Description: Enum of VM Sizes ,
Enum:
{
Default: Default virtual machine size ,
Standard_A2_v2: Standard A2 v2 virtual machine size ,
Standard_A4_v2: Standard A4 v2 virtual machine size ,
Standard_D2s_v3: Standard D2s v3 virtual machine size ,
Standard_D4s_v3: Standard D4s v3 virtual machine size ,
Standard_D8s_v3: Standard D8s v3 virtual machine size ,
Standard_D16s_v3: Standard D16s v3 virtual machine size ,
Standard_D32s_v3: Standard D32s v3 virtual machine size ,
Standard_DS2_v2: Standard DS2 v2 virtual machine size ,
Standard_DS3_v2: Standard DS3 v2 virtual machine size ,
Standard_DS4_v2: Standard DS4 v2 virtual machine size ,
Standard_DS5_v2: Standard DS5 v2 virtual machine size ,
Standard_DS13_v2: Standard DS13 v2 virtual machine size ,
Standard_K8S_v1: Standard K8S v1 virtual machine size ,
Standard_K8S2_v1: Standard K8S2 v1 virtual machine size ,
Standard_K8S3_v1: Standard K8S3 v1 virtual machine size ,
Standard_K8S4_v1: Standard K8S4 v1 virtual machine size ,
Standard_NK6: Standard NK6 virtual machine size ,
Standard_NK12: Standard NK12 virtual machine size ,
Standard_NV6: Standard NV6 virtual machine size ,
Standard_NV12: Standard NV12 virtual machine size ,
Standard_K8S5_v1: Standard K8S5 v1 virtual machine size ,
Custom: Custom virtual machine size ,
}
,
Required: False ,
}
enum ,
processors:
{
Description: number of processors for the virtual machine instance ,
Format: int32 ,
Required: False ,
}
integer ,
memoryMB:
{
Description: RAM in MB for the virtual machine instance ,
Format: int64 ,
Required: False ,
}
integer ,
dynamicMemoryConfig:
{
Description: Dynamic memory config ,
Required: False ,
}
{
maximumMemoryMB:
{
Description: Maximum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
minimumMemoryMB:
{
Description: Minimum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
targetMemoryBuffer:
{
Description: Defines the amount of extra memory that should be reserved for a virtual machine instance at runtime, as a percentage of the total memory that the virtual machine instance is thought to need. This only applies to virtual systems with dynamic memory enabled. This property can be in the range of 5 to 2000. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
networkProfile:
{
Description: NetworkProfile - describes the network configuration the virtual machine instance ,
Required: False ,
}
{
networkInterfaces:
{
Description: NetworkInterfaces - list of network interfaces to be attached to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Network Interface. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
}
,
osProfile:
{
Description: OsProfile - describes the configuration of the operating system and sets login data ,
Required: False ,
}
{
adminPassword:
{
Description: AdminPassword - admin password ,
Format: password ,
Required: False ,
}
string ,
adminUsername:
{
Description: AdminUsername - admin username ,
Required: False ,
}
string ,
computerName:
{
Description: ComputerName - name of the compute ,
Required: False ,
}
string ,
linuxConfiguration:
{
Description: LinuxConfiguration - linux specific configuration values for the virtual machine instance ,
Required: False ,
}
{
disablePasswordAuthentication:
{
Description: DisablePasswordAuthentication - whether password authentication should be disabled ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for a Linux OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
windowsConfiguration:
{
Description: Windows Configuration for the virtual machine instance ,
Required: False ,
}
{
enableAutomaticUpdates:
{
Description: Whether to EnableAutomaticUpdates on the machine ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for Windows OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
timeZone:
{
Description: TimeZone for the virtual machine instance ,
Required: False ,
}
string ,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
}
,
securityProfile:
{
Description: SecurityProfile - Specifies the security settings for the virtual machine instance. ,
Required: False ,
}
{
enableTPM:
{
Description: Enable TPM flag ,
Required: False ,
}
boolean ,
uefiSettings:
{
Description: Uefi settings of the virtual machine instance ,
Required: False ,
}
{
secureBootEnabled:
{
Description: Specifies whether secure boot should be enabled on the virtual machine instance. ,
Required: False ,
}
boolean ,
}
,
securityType:
{
Description: Specifies the SecurityType of the virtual machine. EnableTPM and SecureBootEnabled must be set to true for SecurityType to function. ,
Enum:
{
TrustedLaunch: Trusted Launch security type ,
ConfidentialVM: Confidential VM security type ,
}
,
Required: False ,
}
enum ,
}
,
storageProfile:
{
Description: StorageProfile - contains information about the disks and storage information for the virtual machine instance ,
Required: False ,
}
{
dataDisks:
{
Description: adds data disks to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
imageReference:
{
Description: Which Image to use for the virtual machine instance ,
Required: False ,
}
{
id:
{
Description: The ARM ID for an image resource used by the virtual machine instance. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
osDisk:
{
Description: VHD to attach as OS disk ,
Required: False ,
}
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
osType:
{
Description: This property allows you to specify the type of the OS that is included in the disk if creating a VM from user-image or a specialized VHD. Possible values are: Windows, Linux. ,
Enum:
{
Windows: Windows operating system ,
Linux: Linux operating system ,
}
,
Required: False ,
}
enum ,
}
,
vmConfigStoragePathId:
{
Description: Id of the storage container that hosts the VM configuration file ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
httpProxyConfig:
{
Description: HTTP Proxy configuration for the VM. ,
Required: False ,
}
{
httpProxy:
{
Description: The HTTP proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
httpsProxy:
{
Description: The HTTPS proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
noProxy:
{
Description: The endpoints that should not go through proxy. ,
Required: False ,
}
[
string ,
]
,
trustedCa:
{
Description: Alternative CA cert to use for connecting to proxy servers. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: Provisioning state of the virtual machine instance. ,
Enum:
{
Succeeded: Provisioning has succeeded ,
Failed: Provisioning has failed ,
InProgress: Provisioning is in progress ,
Accepted: Provisioning has been accepted ,
Deleting: Deletion of the resource is in progress ,
Canceled: Provisioning has been canceled ,
}
,
Required: False ,
}
enum ,
instanceView:
{
Description: The virtual machine instance view. ,
Required: False ,
}
{
vmAgent:
{
Description: The VM Config Agent running on the virtual machine. ,
Required: False ,
}
{
vmConfigAgentVersion:
{
Description: The VM Config Agent full version. ,
Required: False ,
}
string ,
statuses:
{
Description: The resource status information. ,
Required: False ,
}
[
{
code:
{
Description: The status code. ,
Required: False ,
}
string ,
level:
{
Description: The level code. ,
Enum:
{
Info: Informational status level ,
Warning: Warning status level ,
Error: Error status level ,
}
,
Required: False ,
}
enum ,
displayStatus:
{
Description: The short localizable label for the status. ,
Required: False ,
}
string ,
message:
{
Description: The detailed status message, including for alerts and error messages. ,
Required: False ,
}
string ,
time:
{
Description: The time of the status. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The observed state of virtual machine instances ,
Required: False ,
}
{
errorCode:
{
Description: VirtualMachine provisioning error code ,
Required: False ,
}
string ,
errorMessage:
{
Description: Descriptive error message ,
Required: False ,
}
string ,
powerState:
{
Description: The power state of the virtual machine instance ,
Enum:
{
Deallocated: Virtual machine deallocated ,
Deallocating: Virtual machine deallocating ,
Running: Virtual machine running ,
Starting: Virtual machine starting ,
Stopped: Virtual machine stopped ,
Stopping: Virtual machine stopping ,
Paused: Virtual machine paused ,
Saved: Virtual machine Saved, ,
Unknown: Power state of the virtual machine is unknown ,
}
,
Required: False ,
}
enum ,
provisioningStatus:
{
Description: Provisioning status of the virtual machine instance ,
Required: False ,
}
{
operationId:
{
Description: The ID of the operation performed on the virtual machine instance ,
Required: False ,
}
string ,
status:
{
Description: The status of the operation performed on the virtual machine instance [Succeeded, Failed, InProgress] ,
Enum:
{
Succeeded: Operation succeeded ,
Failed: Operation failed ,
InProgress: Operation is in progress ,
}
,
Required: False ,
}
enum ,
}
,
}
,
guestAgentInstallStatus:
{
Description: Guest agent install status. ,
Required: False ,
}
{
vmUuid:
{
Description: Specifies the VM's unique SMBIOS ID. ,
Required: False ,
}
string ,
status:
{
Description: The installation status of the hybrid machine agent installation. ,
Enum:
{
Succeeded: Installation succeeded ,
InProgress: Installation in progress ,
Failed: Installation failed ,
}
,
Required: False ,
}
enum ,
lastStatusChange:
{
Description: The time of the last status change. ,
Format: date-time ,
Required: False ,
}
string ,
agentVersion:
{
Description: The hybrid machine agent full version. ,
Required: False ,
}
string ,
errorDetails:
{
Description: Details about the error state. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
}
,
vmId:
{
Description: Unique identifier for the vm resource. ,
Required: False ,
}
string ,
resourceUid:
{
Description: Unique identifier defined by ARC to identify the guest of the VM. ,
Required: False ,
}
string ,
}
,
extendedLocation:
{
Description: The extendedLocation of the resource. ,
Required: False ,
}
{
name:
{
Description: The name of the extended location. ,
Required: False ,
}
string ,
type:
{
Description: The type of the extended location. ,
Enum:
{
CustomLocation: Custom extended location type ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: The managed service identities assigned to this resource. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned,UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
VirtualMachineInstances_Get (updated)
Description :  Gets a virtual machine instance
Reference :  Link ¶

⚶ Changes

{
  "#id": "VirtualMachineInstances_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "osProfile": [
              {
                "linuxConfiguration": [
                  {
                    "ssh": [
                      {
                        "publicKeys": {
                          "$properties": [
                            {
                              "#name": "keyData",
                              "Description": {
                                "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              },
              {
                "windowsConfiguration": [
                  {
                    "ssh": [
                      {
                        "publicKeys": {
                          "$properties": [
                            {
                              "#name": "keyData",
                              "Description": {
                                "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /{resourceUri}/providers/Microsoft.AzureStackHCI/virtualMachineInstances/default
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
resourceUri:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
hardwareProfile:
{
Description: HardwareProfile - Specifies the hardware settings for the virtual machine instance. ,
Required: False ,
}
{
vmSize:
{
Description: Enum of VM Sizes ,
Enum:
{
Default: Default virtual machine size ,
Standard_A2_v2: Standard A2 v2 virtual machine size ,
Standard_A4_v2: Standard A4 v2 virtual machine size ,
Standard_D2s_v3: Standard D2s v3 virtual machine size ,
Standard_D4s_v3: Standard D4s v3 virtual machine size ,
Standard_D8s_v3: Standard D8s v3 virtual machine size ,
Standard_D16s_v3: Standard D16s v3 virtual machine size ,
Standard_D32s_v3: Standard D32s v3 virtual machine size ,
Standard_DS2_v2: Standard DS2 v2 virtual machine size ,
Standard_DS3_v2: Standard DS3 v2 virtual machine size ,
Standard_DS4_v2: Standard DS4 v2 virtual machine size ,
Standard_DS5_v2: Standard DS5 v2 virtual machine size ,
Standard_DS13_v2: Standard DS13 v2 virtual machine size ,
Standard_K8S_v1: Standard K8S v1 virtual machine size ,
Standard_K8S2_v1: Standard K8S2 v1 virtual machine size ,
Standard_K8S3_v1: Standard K8S3 v1 virtual machine size ,
Standard_K8S4_v1: Standard K8S4 v1 virtual machine size ,
Standard_NK6: Standard NK6 virtual machine size ,
Standard_NK12: Standard NK12 virtual machine size ,
Standard_NV6: Standard NV6 virtual machine size ,
Standard_NV12: Standard NV12 virtual machine size ,
Standard_K8S5_v1: Standard K8S5 v1 virtual machine size ,
Custom: Custom virtual machine size ,
}
,
Required: False ,
}
enum ,
processors:
{
Description: number of processors for the virtual machine instance ,
Format: int32 ,
Required: False ,
}
integer ,
memoryMB:
{
Description: RAM in MB for the virtual machine instance ,
Format: int64 ,
Required: False ,
}
integer ,
dynamicMemoryConfig:
{
Description: Dynamic memory config ,
Required: False ,
}
{
maximumMemoryMB:
{
Description: Maximum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
minimumMemoryMB:
{
Description: Minimum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
targetMemoryBuffer:
{
Description: Defines the amount of extra memory that should be reserved for a virtual machine instance at runtime, as a percentage of the total memory that the virtual machine instance is thought to need. This only applies to virtual systems with dynamic memory enabled. This property can be in the range of 5 to 2000. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
networkProfile:
{
Description: NetworkProfile - describes the network configuration the virtual machine instance ,
Required: False ,
}
{
networkInterfaces:
{
Description: NetworkInterfaces - list of network interfaces to be attached to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Network Interface. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
}
,
osProfile:
{
Description: OsProfile - describes the configuration of the operating system and sets login data ,
Required: False ,
}
{
adminPassword:
{
Description: AdminPassword - admin password ,
Format: password ,
Required: False ,
}
string ,
adminUsername:
{
Description: AdminUsername - admin username ,
Required: False ,
}
string ,
computerName:
{
Description: ComputerName - name of the compute ,
Required: False ,
}
string ,
linuxConfiguration:
{
Description: LinuxConfiguration - linux specific configuration values for the virtual machine instance ,
Required: False ,
}
{
disablePasswordAuthentication:
{
Description: DisablePasswordAuthentication - whether password authentication should be disabled ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for a Linux OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
windowsConfiguration:
{
Description: Windows Configuration for the virtual machine instance ,
Required: False ,
}
{
enableAutomaticUpdates:
{
Description: Whether to EnableAutomaticUpdates on the machine ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for Windows OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
timeZone:
{
Description: TimeZone for the virtual machine instance ,
Required: False ,
}
string ,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
}
,
securityProfile:
{
Description: SecurityProfile - Specifies the security settings for the virtual machine instance. ,
Required: False ,
}
{
enableTPM:
{
Description: Enable TPM flag ,
Required: False ,
}
boolean ,
uefiSettings:
{
Description: Uefi settings of the virtual machine instance ,
Required: False ,
}
{
secureBootEnabled:
{
Description: Specifies whether secure boot should be enabled on the virtual machine instance. ,
Required: False ,
}
boolean ,
}
,
securityType:
{
Description: Specifies the SecurityType of the virtual machine. EnableTPM and SecureBootEnabled must be set to true for SecurityType to function. ,
Enum:
{
TrustedLaunch: Trusted Launch security type ,
ConfidentialVM: Confidential VM security type ,
}
,
Required: False ,
}
enum ,
}
,
storageProfile:
{
Description: StorageProfile - contains information about the disks and storage information for the virtual machine instance ,
Required: False ,
}
{
dataDisks:
{
Description: adds data disks to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
imageReference:
{
Description: Which Image to use for the virtual machine instance ,
Required: False ,
}
{
id:
{
Description: The ARM ID for an image resource used by the virtual machine instance. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
osDisk:
{
Description: VHD to attach as OS disk ,
Required: False ,
}
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
osType:
{
Description: This property allows you to specify the type of the OS that is included in the disk if creating a VM from user-image or a specialized VHD. Possible values are: Windows, Linux. ,
Enum:
{
Windows: Windows operating system ,
Linux: Linux operating system ,
}
,
Required: False ,
}
enum ,
}
,
vmConfigStoragePathId:
{
Description: Id of the storage container that hosts the VM configuration file ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
httpProxyConfig:
{
Description: HTTP Proxy configuration for the VM. ,
Required: False ,
}
{
httpProxy:
{
Description: The HTTP proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
httpsProxy:
{
Description: The HTTPS proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
noProxy:
{
Description: The endpoints that should not go through proxy. ,
Required: False ,
}
[
string ,
]
,
trustedCa:
{
Description: Alternative CA cert to use for connecting to proxy servers. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: Provisioning state of the virtual machine instance. ,
Enum:
{
Succeeded: Provisioning has succeeded ,
Failed: Provisioning has failed ,
InProgress: Provisioning is in progress ,
Accepted: Provisioning has been accepted ,
Deleting: Deletion of the resource is in progress ,
Canceled: Provisioning has been canceled ,
}
,
Required: False ,
}
enum ,
instanceView:
{
Description: The virtual machine instance view. ,
Required: False ,
}
{
vmAgent:
{
Description: The VM Config Agent running on the virtual machine. ,
Required: False ,
}
{
vmConfigAgentVersion:
{
Description: The VM Config Agent full version. ,
Required: False ,
}
string ,
statuses:
{
Description: The resource status information. ,
Required: False ,
}
[
{
code:
{
Description: The status code. ,
Required: False ,
}
string ,
level:
{
Description: The level code. ,
Enum:
{
Info: Informational status level ,
Warning: Warning status level ,
Error: Error status level ,
}
,
Required: False ,
}
enum ,
displayStatus:
{
Description: The short localizable label for the status. ,
Required: False ,
}
string ,
message:
{
Description: The detailed status message, including for alerts and error messages. ,
Required: False ,
}
string ,
time:
{
Description: The time of the status. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The observed state of virtual machine instances ,
Required: False ,
}
{
errorCode:
{
Description: VirtualMachine provisioning error code ,
Required: False ,
}
string ,
errorMessage:
{
Description: Descriptive error message ,
Required: False ,
}
string ,
powerState:
{
Description: The power state of the virtual machine instance ,
Enum:
{
Deallocated: Virtual machine deallocated ,
Deallocating: Virtual machine deallocating ,
Running: Virtual machine running ,
Starting: Virtual machine starting ,
Stopped: Virtual machine stopped ,
Stopping: Virtual machine stopping ,
Paused: Virtual machine paused ,
Saved: Virtual machine Saved, ,
Unknown: Power state of the virtual machine is unknown ,
}
,
Required: False ,
}
enum ,
provisioningStatus:
{
Description: Provisioning status of the virtual machine instance ,
Required: False ,
}
{
operationId:
{
Description: The ID of the operation performed on the virtual machine instance ,
Required: False ,
}
string ,
status:
{
Description: The status of the operation performed on the virtual machine instance [Succeeded, Failed, InProgress] ,
Enum:
{
Succeeded: Operation succeeded ,
Failed: Operation failed ,
InProgress: Operation is in progress ,
}
,
Required: False ,
}
enum ,
}
,
}
,
guestAgentInstallStatus:
{
Description: Guest agent install status. ,
Required: False ,
}
{
vmUuid:
{
Description: Specifies the VM's unique SMBIOS ID. ,
Required: False ,
}
string ,
status:
{
Description: The installation status of the hybrid machine agent installation. ,
Enum:
{
Succeeded: Installation succeeded ,
InProgress: Installation in progress ,
Failed: Installation failed ,
}
,
Required: False ,
}
enum ,
lastStatusChange:
{
Description: The time of the last status change. ,
Format: date-time ,
Required: False ,
}
string ,
agentVersion:
{
Description: The hybrid machine agent full version. ,
Required: False ,
}
string ,
errorDetails:
{
Description: Details about the error state. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
}
,
vmId:
{
Description: Unique identifier for the vm resource. ,
Required: False ,
}
string ,
resourceUid:
{
Description: Unique identifier defined by ARC to identify the guest of the VM. ,
Required: False ,
}
string ,
}
,
extendedLocation:
{
Description: The extendedLocation of the resource. ,
Required: False ,
}
{
name:
{
Description: The name of the extended location. ,
Required: False ,
}
string ,
type:
{
Description: The type of the extended location. ,
Enum:
{
CustomLocation: Custom extended location type ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: The managed service identities assigned to this resource. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned,UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
VirtualMachineInstances_CreateOrUpdate (updated)
Description :  The operation to create or update a virtual machine instance. Please note some properties can be set only during virtual machine instance creation.
Reference :  Link ¶

⚶ Changes

{
  "#id": "VirtualMachineInstances_CreateOrUpdate",
  "$parameters": {
    "resource": {
      "$properties": {
        "properties": [
          {
            "osProfile": [
              {
                "linuxConfiguration": [
                  {
                    "ssh": [
                      {
                        "publicKeys": {
                          "$properties": [
                            {
                              "#name": "keyData",
                              "Description": {
                                "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              },
              {
                "windowsConfiguration": [
                  {
                    "ssh": [
                      {
                        "publicKeys": {
                          "$properties": [
                            {
                              "#name": "keyData",
                              "Description": {
                                "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "osProfile": [
              {
                "linuxConfiguration": [
                  {
                    "ssh": [
                      {
                        "publicKeys": {
                          "$properties": [
                            {
                              "#name": "keyData",
                              "Description": {
                                "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              },
              {
                "windowsConfiguration": [
                  {
                    "ssh": [
                      {
                        "publicKeys": {
                          "$properties": [
                            {
                              "#name": "keyData",
                              "Description": {
                                "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "osProfile": [
              {
                "linuxConfiguration": [
                  {
                    "ssh": [
                      {
                        "publicKeys": {
                          "$properties": [
                            {
                              "#name": "keyData",
                              "Description": {
                                "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              },
              {
                "windowsConfiguration": [
                  {
                    "ssh": [
                      {
                        "publicKeys": {
                          "$properties": [
                            {
                              "#name": "keyData",
                              "Description": {
                                "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /{resourceUri}/providers/Microsoft.AzureStackHCI/virtualMachineInstances/default
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
resourceUri:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
resource:
{
Description: Resource create parameters. ,
Required: True ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
hardwareProfile:
{
Description: HardwareProfile - Specifies the hardware settings for the virtual machine instance. ,
Required: False ,
}
{
vmSize:
{
Description: Enum of VM Sizes ,
Enum:
{
Default: Default virtual machine size ,
Standard_A2_v2: Standard A2 v2 virtual machine size ,
Standard_A4_v2: Standard A4 v2 virtual machine size ,
Standard_D2s_v3: Standard D2s v3 virtual machine size ,
Standard_D4s_v3: Standard D4s v3 virtual machine size ,
Standard_D8s_v3: Standard D8s v3 virtual machine size ,
Standard_D16s_v3: Standard D16s v3 virtual machine size ,
Standard_D32s_v3: Standard D32s v3 virtual machine size ,
Standard_DS2_v2: Standard DS2 v2 virtual machine size ,
Standard_DS3_v2: Standard DS3 v2 virtual machine size ,
Standard_DS4_v2: Standard DS4 v2 virtual machine size ,
Standard_DS5_v2: Standard DS5 v2 virtual machine size ,
Standard_DS13_v2: Standard DS13 v2 virtual machine size ,
Standard_K8S_v1: Standard K8S v1 virtual machine size ,
Standard_K8S2_v1: Standard K8S2 v1 virtual machine size ,
Standard_K8S3_v1: Standard K8S3 v1 virtual machine size ,
Standard_K8S4_v1: Standard K8S4 v1 virtual machine size ,
Standard_NK6: Standard NK6 virtual machine size ,
Standard_NK12: Standard NK12 virtual machine size ,
Standard_NV6: Standard NV6 virtual machine size ,
Standard_NV12: Standard NV12 virtual machine size ,
Standard_K8S5_v1: Standard K8S5 v1 virtual machine size ,
Custom: Custom virtual machine size ,
}
,
Required: False ,
}
enum ,
processors:
{
Description: number of processors for the virtual machine instance ,
Format: int32 ,
Required: False ,
}
integer ,
memoryMB:
{
Description: RAM in MB for the virtual machine instance ,
Format: int64 ,
Required: False ,
}
integer ,
dynamicMemoryConfig:
{
Description: Dynamic memory config ,
Required: False ,
}
{
maximumMemoryMB:
{
Description: Maximum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
minimumMemoryMB:
{
Description: Minimum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
targetMemoryBuffer:
{
Description: Defines the amount of extra memory that should be reserved for a virtual machine instance at runtime, as a percentage of the total memory that the virtual machine instance is thought to need. This only applies to virtual systems with dynamic memory enabled. This property can be in the range of 5 to 2000. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
networkProfile:
{
Description: NetworkProfile - describes the network configuration the virtual machine instance ,
Required: False ,
}
{
networkInterfaces:
{
Description: NetworkInterfaces - list of network interfaces to be attached to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Network Interface. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
}
,
osProfile:
{
Description: OsProfile - describes the configuration of the operating system and sets login data ,
Required: False ,
}
{
adminPassword:
{
Description: AdminPassword - admin password ,
Format: password ,
Required: False ,
}
string ,
adminUsername:
{
Description: AdminUsername - admin username ,
Required: False ,
}
string ,
computerName:
{
Description: ComputerName - name of the compute ,
Required: False ,
}
string ,
linuxConfiguration:
{
Description: LinuxConfiguration - linux specific configuration values for the virtual machine instance ,
Required: False ,
}
{
disablePasswordAuthentication:
{
Description: DisablePasswordAuthentication - whether password authentication should be disabled ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for a Linux OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
windowsConfiguration:
{
Description: Windows Configuration for the virtual machine instance ,
Required: False ,
}
{
enableAutomaticUpdates:
{
Description: Whether to EnableAutomaticUpdates on the machine ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for Windows OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
timeZone:
{
Description: TimeZone for the virtual machine instance ,
Required: False ,
}
string ,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
}
,
securityProfile:
{
Description: SecurityProfile - Specifies the security settings for the virtual machine instance. ,
Required: False ,
}
{
enableTPM:
{
Description: Enable TPM flag ,
Required: False ,
}
boolean ,
uefiSettings:
{
Description: Uefi settings of the virtual machine instance ,
Required: False ,
}
{
secureBootEnabled:
{
Description: Specifies whether secure boot should be enabled on the virtual machine instance. ,
Required: False ,
}
boolean ,
}
,
securityType:
{
Description: Specifies the SecurityType of the virtual machine. EnableTPM and SecureBootEnabled must be set to true for SecurityType to function. ,
Enum:
{
TrustedLaunch: Trusted Launch security type ,
ConfidentialVM: Confidential VM security type ,
}
,
Required: False ,
}
enum ,
}
,
storageProfile:
{
Description: StorageProfile - contains information about the disks and storage information for the virtual machine instance ,
Required: False ,
}
{
dataDisks:
{
Description: adds data disks to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
imageReference:
{
Description: Which Image to use for the virtual machine instance ,
Required: False ,
}
{
id:
{
Description: The ARM ID for an image resource used by the virtual machine instance. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
osDisk:
{
Description: VHD to attach as OS disk ,
Required: False ,
}
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
osType:
{
Description: This property allows you to specify the type of the OS that is included in the disk if creating a VM from user-image or a specialized VHD. Possible values are: Windows, Linux. ,
Enum:
{
Windows: Windows operating system ,
Linux: Linux operating system ,
}
,
Required: False ,
}
enum ,
}
,
vmConfigStoragePathId:
{
Description: Id of the storage container that hosts the VM configuration file ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
httpProxyConfig:
{
Description: HTTP Proxy configuration for the VM. ,
Required: False ,
}
{
httpProxy:
{
Description: The HTTP proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
httpsProxy:
{
Description: The HTTPS proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
noProxy:
{
Description: The endpoints that should not go through proxy. ,
Required: False ,
}
[
string ,
]
,
trustedCa:
{
Description: Alternative CA cert to use for connecting to proxy servers. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: Provisioning state of the virtual machine instance. ,
Enum:
{
Succeeded: Provisioning has succeeded ,
Failed: Provisioning has failed ,
InProgress: Provisioning is in progress ,
Accepted: Provisioning has been accepted ,
Deleting: Deletion of the resource is in progress ,
Canceled: Provisioning has been canceled ,
}
,
Required: False ,
}
enum ,
instanceView:
{
Description: The virtual machine instance view. ,
Required: False ,
}
{
vmAgent:
{
Description: The VM Config Agent running on the virtual machine. ,
Required: False ,
}
{
vmConfigAgentVersion:
{
Description: The VM Config Agent full version. ,
Required: False ,
}
string ,
statuses:
{
Description: The resource status information. ,
Required: False ,
}
[
{
code:
{
Description: The status code. ,
Required: False ,
}
string ,
level:
{
Description: The level code. ,
Enum:
{
Info: Informational status level ,
Warning: Warning status level ,
Error: Error status level ,
}
,
Required: False ,
}
enum ,
displayStatus:
{
Description: The short localizable label for the status. ,
Required: False ,
}
string ,
message:
{
Description: The detailed status message, including for alerts and error messages. ,
Required: False ,
}
string ,
time:
{
Description: The time of the status. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The observed state of virtual machine instances ,
Required: False ,
}
{
errorCode:
{
Description: VirtualMachine provisioning error code ,
Required: False ,
}
string ,
errorMessage:
{
Description: Descriptive error message ,
Required: False ,
}
string ,
powerState:
{
Description: The power state of the virtual machine instance ,
Enum:
{
Deallocated: Virtual machine deallocated ,
Deallocating: Virtual machine deallocating ,
Running: Virtual machine running ,
Starting: Virtual machine starting ,
Stopped: Virtual machine stopped ,
Stopping: Virtual machine stopping ,
Paused: Virtual machine paused ,
Saved: Virtual machine Saved, ,
Unknown: Power state of the virtual machine is unknown ,
}
,
Required: False ,
}
enum ,
provisioningStatus:
{
Description: Provisioning status of the virtual machine instance ,
Required: False ,
}
{
operationId:
{
Description: The ID of the operation performed on the virtual machine instance ,
Required: False ,
}
string ,
status:
{
Description: The status of the operation performed on the virtual machine instance [Succeeded, Failed, InProgress] ,
Enum:
{
Succeeded: Operation succeeded ,
Failed: Operation failed ,
InProgress: Operation is in progress ,
}
,
Required: False ,
}
enum ,
}
,
}
,
guestAgentInstallStatus:
{
Description: Guest agent install status. ,
Required: False ,
}
{
vmUuid:
{
Description: Specifies the VM's unique SMBIOS ID. ,
Required: False ,
}
string ,
status:
{
Description: The installation status of the hybrid machine agent installation. ,
Enum:
{
Succeeded: Installation succeeded ,
InProgress: Installation in progress ,
Failed: Installation failed ,
}
,
Required: False ,
}
enum ,
lastStatusChange:
{
Description: The time of the last status change. ,
Format: date-time ,
Required: False ,
}
string ,
agentVersion:
{
Description: The hybrid machine agent full version. ,
Required: False ,
}
string ,
errorDetails:
{
Description: Details about the error state. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
}
,
vmId:
{
Description: Unique identifier for the vm resource. ,
Required: False ,
}
string ,
resourceUid:
{
Description: Unique identifier defined by ARC to identify the guest of the VM. ,
Required: False ,
}
string ,
}
,
extendedLocation:
{
Description: The extendedLocation of the resource. ,
Required: False ,
}
{
name:
{
Description: The name of the extended location. ,
Required: False ,
}
string ,
type:
{
Description: The type of the extended location. ,
Enum:
{
CustomLocation: Custom extended location type ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: The managed service identities assigned to this resource. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned,UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
hardwareProfile:
{
Description: HardwareProfile - Specifies the hardware settings for the virtual machine instance. ,
Required: False ,
}
{
vmSize:
{
Description: Enum of VM Sizes ,
Enum:
{
Default: Default virtual machine size ,
Standard_A2_v2: Standard A2 v2 virtual machine size ,
Standard_A4_v2: Standard A4 v2 virtual machine size ,
Standard_D2s_v3: Standard D2s v3 virtual machine size ,
Standard_D4s_v3: Standard D4s v3 virtual machine size ,
Standard_D8s_v3: Standard D8s v3 virtual machine size ,
Standard_D16s_v3: Standard D16s v3 virtual machine size ,
Standard_D32s_v3: Standard D32s v3 virtual machine size ,
Standard_DS2_v2: Standard DS2 v2 virtual machine size ,
Standard_DS3_v2: Standard DS3 v2 virtual machine size ,
Standard_DS4_v2: Standard DS4 v2 virtual machine size ,
Standard_DS5_v2: Standard DS5 v2 virtual machine size ,
Standard_DS13_v2: Standard DS13 v2 virtual machine size ,
Standard_K8S_v1: Standard K8S v1 virtual machine size ,
Standard_K8S2_v1: Standard K8S2 v1 virtual machine size ,
Standard_K8S3_v1: Standard K8S3 v1 virtual machine size ,
Standard_K8S4_v1: Standard K8S4 v1 virtual machine size ,
Standard_NK6: Standard NK6 virtual machine size ,
Standard_NK12: Standard NK12 virtual machine size ,
Standard_NV6: Standard NV6 virtual machine size ,
Standard_NV12: Standard NV12 virtual machine size ,
Standard_K8S5_v1: Standard K8S5 v1 virtual machine size ,
Custom: Custom virtual machine size ,
}
,
Required: False ,
}
enum ,
processors:
{
Description: number of processors for the virtual machine instance ,
Format: int32 ,
Required: False ,
}
integer ,
memoryMB:
{
Description: RAM in MB for the virtual machine instance ,
Format: int64 ,
Required: False ,
}
integer ,
dynamicMemoryConfig:
{
Description: Dynamic memory config ,
Required: False ,
}
{
maximumMemoryMB:
{
Description: Maximum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
minimumMemoryMB:
{
Description: Minimum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
targetMemoryBuffer:
{
Description: Defines the amount of extra memory that should be reserved for a virtual machine instance at runtime, as a percentage of the total memory that the virtual machine instance is thought to need. This only applies to virtual systems with dynamic memory enabled. This property can be in the range of 5 to 2000. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
networkProfile:
{
Description: NetworkProfile - describes the network configuration the virtual machine instance ,
Required: False ,
}
{
networkInterfaces:
{
Description: NetworkInterfaces - list of network interfaces to be attached to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Network Interface. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
}
,
osProfile:
{
Description: OsProfile - describes the configuration of the operating system and sets login data ,
Required: False ,
}
{
adminPassword:
{
Description: AdminPassword - admin password ,
Format: password ,
Required: False ,
}
string ,
adminUsername:
{
Description: AdminUsername - admin username ,
Required: False ,
}
string ,
computerName:
{
Description: ComputerName - name of the compute ,
Required: False ,
}
string ,
linuxConfiguration:
{
Description: LinuxConfiguration - linux specific configuration values for the virtual machine instance ,
Required: False ,
}
{
disablePasswordAuthentication:
{
Description: DisablePasswordAuthentication - whether password authentication should be disabled ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for a Linux OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
windowsConfiguration:
{
Description: Windows Configuration for the virtual machine instance ,
Required: False ,
}
{
enableAutomaticUpdates:
{
Description: Whether to EnableAutomaticUpdates on the machine ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for Windows OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
timeZone:
{
Description: TimeZone for the virtual machine instance ,
Required: False ,
}
string ,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
}
,
securityProfile:
{
Description: SecurityProfile - Specifies the security settings for the virtual machine instance. ,
Required: False ,
}
{
enableTPM:
{
Description: Enable TPM flag ,
Required: False ,
}
boolean ,
uefiSettings:
{
Description: Uefi settings of the virtual machine instance ,
Required: False ,
}
{
secureBootEnabled:
{
Description: Specifies whether secure boot should be enabled on the virtual machine instance. ,
Required: False ,
}
boolean ,
}
,
securityType:
{
Description: Specifies the SecurityType of the virtual machine. EnableTPM and SecureBootEnabled must be set to true for SecurityType to function. ,
Enum:
{
TrustedLaunch: Trusted Launch security type ,
ConfidentialVM: Confidential VM security type ,
}
,
Required: False ,
}
enum ,
}
,
storageProfile:
{
Description: StorageProfile - contains information about the disks and storage information for the virtual machine instance ,
Required: False ,
}
{
dataDisks:
{
Description: adds data disks to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
imageReference:
{
Description: Which Image to use for the virtual machine instance ,
Required: False ,
}
{
id:
{
Description: The ARM ID for an image resource used by the virtual machine instance. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
osDisk:
{
Description: VHD to attach as OS disk ,
Required: False ,
}
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
osType:
{
Description: This property allows you to specify the type of the OS that is included in the disk if creating a VM from user-image or a specialized VHD. Possible values are: Windows, Linux. ,
Enum:
{
Windows: Windows operating system ,
Linux: Linux operating system ,
}
,
Required: False ,
}
enum ,
}
,
vmConfigStoragePathId:
{
Description: Id of the storage container that hosts the VM configuration file ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
httpProxyConfig:
{
Description: HTTP Proxy configuration for the VM. ,
Required: False ,
}
{
httpProxy:
{
Description: The HTTP proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
httpsProxy:
{
Description: The HTTPS proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
noProxy:
{
Description: The endpoints that should not go through proxy. ,
Required: False ,
}
[
string ,
]
,
trustedCa:
{
Description: Alternative CA cert to use for connecting to proxy servers. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: Provisioning state of the virtual machine instance. ,
Enum:
{
Succeeded: Provisioning has succeeded ,
Failed: Provisioning has failed ,
InProgress: Provisioning is in progress ,
Accepted: Provisioning has been accepted ,
Deleting: Deletion of the resource is in progress ,
Canceled: Provisioning has been canceled ,
}
,
Required: False ,
}
enum ,
instanceView:
{
Description: The virtual machine instance view. ,
Required: False ,
}
{
vmAgent:
{
Description: The VM Config Agent running on the virtual machine. ,
Required: False ,
}
{
vmConfigAgentVersion:
{
Description: The VM Config Agent full version. ,
Required: False ,
}
string ,
statuses:
{
Description: The resource status information. ,
Required: False ,
}
[
{
code:
{
Description: The status code. ,
Required: False ,
}
string ,
level:
{
Description: The level code. ,
Enum:
{
Info: Informational status level ,
Warning: Warning status level ,
Error: Error status level ,
}
,
Required: False ,
}
enum ,
displayStatus:
{
Description: The short localizable label for the status. ,
Required: False ,
}
string ,
message:
{
Description: The detailed status message, including for alerts and error messages. ,
Required: False ,
}
string ,
time:
{
Description: The time of the status. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The observed state of virtual machine instances ,
Required: False ,
}
{
errorCode:
{
Description: VirtualMachine provisioning error code ,
Required: False ,
}
string ,
errorMessage:
{
Description: Descriptive error message ,
Required: False ,
}
string ,
powerState:
{
Description: The power state of the virtual machine instance ,
Enum:
{
Deallocated: Virtual machine deallocated ,
Deallocating: Virtual machine deallocating ,
Running: Virtual machine running ,
Starting: Virtual machine starting ,
Stopped: Virtual machine stopped ,
Stopping: Virtual machine stopping ,
Paused: Virtual machine paused ,
Saved: Virtual machine Saved, ,
Unknown: Power state of the virtual machine is unknown ,
}
,
Required: False ,
}
enum ,
provisioningStatus:
{
Description: Provisioning status of the virtual machine instance ,
Required: False ,
}
{
operationId:
{
Description: The ID of the operation performed on the virtual machine instance ,
Required: False ,
}
string ,
status:
{
Description: The status of the operation performed on the virtual machine instance [Succeeded, Failed, InProgress] ,
Enum:
{
Succeeded: Operation succeeded ,
Failed: Operation failed ,
InProgress: Operation is in progress ,
}
,
Required: False ,
}
enum ,
}
,
}
,
guestAgentInstallStatus:
{
Description: Guest agent install status. ,
Required: False ,
}
{
vmUuid:
{
Description: Specifies the VM's unique SMBIOS ID. ,
Required: False ,
}
string ,
status:
{
Description: The installation status of the hybrid machine agent installation. ,
Enum:
{
Succeeded: Installation succeeded ,
InProgress: Installation in progress ,
Failed: Installation failed ,
}
,
Required: False ,
}
enum ,
lastStatusChange:
{
Description: The time of the last status change. ,
Format: date-time ,
Required: False ,
}
string ,
agentVersion:
{
Description: The hybrid machine agent full version. ,
Required: False ,
}
string ,
errorDetails:
{
Description: Details about the error state. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
}
,
vmId:
{
Description: Unique identifier for the vm resource. ,
Required: False ,
}
string ,
resourceUid:
{
Description: Unique identifier defined by ARC to identify the guest of the VM. ,
Required: False ,
}
string ,
}
,
extendedLocation:
{
Description: The extendedLocation of the resource. ,
Required: False ,
}
{
name:
{
Description: The name of the extended location. ,
Required: False ,
}
string ,
type:
{
Description: The type of the extended location. ,
Enum:
{
CustomLocation: Custom extended location type ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: The managed service identities assigned to this resource. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned,UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (201)

{
$headers:
{
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}
,
$schema:
{
Description: The virtual machine instance resource definition. ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
hardwareProfile:
{
Description: HardwareProfile - Specifies the hardware settings for the virtual machine instance. ,
Required: False ,
}
{
vmSize:
{
Description: Enum of VM Sizes ,
Enum:
{
Default: Default virtual machine size ,
Standard_A2_v2: Standard A2 v2 virtual machine size ,
Standard_A4_v2: Standard A4 v2 virtual machine size ,
Standard_D2s_v3: Standard D2s v3 virtual machine size ,
Standard_D4s_v3: Standard D4s v3 virtual machine size ,
Standard_D8s_v3: Standard D8s v3 virtual machine size ,
Standard_D16s_v3: Standard D16s v3 virtual machine size ,
Standard_D32s_v3: Standard D32s v3 virtual machine size ,
Standard_DS2_v2: Standard DS2 v2 virtual machine size ,
Standard_DS3_v2: Standard DS3 v2 virtual machine size ,
Standard_DS4_v2: Standard DS4 v2 virtual machine size ,
Standard_DS5_v2: Standard DS5 v2 virtual machine size ,
Standard_DS13_v2: Standard DS13 v2 virtual machine size ,
Standard_K8S_v1: Standard K8S v1 virtual machine size ,
Standard_K8S2_v1: Standard K8S2 v1 virtual machine size ,
Standard_K8S3_v1: Standard K8S3 v1 virtual machine size ,
Standard_K8S4_v1: Standard K8S4 v1 virtual machine size ,
Standard_NK6: Standard NK6 virtual machine size ,
Standard_NK12: Standard NK12 virtual machine size ,
Standard_NV6: Standard NV6 virtual machine size ,
Standard_NV12: Standard NV12 virtual machine size ,
Standard_K8S5_v1: Standard K8S5 v1 virtual machine size ,
Custom: Custom virtual machine size ,
}
,
Required: False ,
}
enum ,
processors:
{
Description: number of processors for the virtual machine instance ,
Format: int32 ,
Required: False ,
}
integer ,
memoryMB:
{
Description: RAM in MB for the virtual machine instance ,
Format: int64 ,
Required: False ,
}
integer ,
dynamicMemoryConfig:
{
Description: Dynamic memory config ,
Required: False ,
}
{
maximumMemoryMB:
{
Description: Maximum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
minimumMemoryMB:
{
Description: Minimum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
targetMemoryBuffer:
{
Description: Defines the amount of extra memory that should be reserved for a virtual machine instance at runtime, as a percentage of the total memory that the virtual machine instance is thought to need. This only applies to virtual systems with dynamic memory enabled. This property can be in the range of 5 to 2000. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
networkProfile:
{
Description: NetworkProfile - describes the network configuration the virtual machine instance ,
Required: False ,
}
{
networkInterfaces:
{
Description: NetworkInterfaces - list of network interfaces to be attached to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Network Interface. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
}
,
osProfile:
{
Description: OsProfile - describes the configuration of the operating system and sets login data ,
Required: False ,
}
{
adminPassword:
{
Description: AdminPassword - admin password ,
Format: password ,
Required: False ,
}
string ,
adminUsername:
{
Description: AdminUsername - admin username ,
Required: False ,
}
string ,
computerName:
{
Description: ComputerName - name of the compute ,
Required: False ,
}
string ,
linuxConfiguration:
{
Description: LinuxConfiguration - linux specific configuration values for the virtual machine instance ,
Required: False ,
}
{
disablePasswordAuthentication:
{
Description: DisablePasswordAuthentication - whether password authentication should be disabled ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for a Linux OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
windowsConfiguration:
{
Description: Windows Configuration for the virtual machine instance ,
Required: False ,
}
{
enableAutomaticUpdates:
{
Description: Whether to EnableAutomaticUpdates on the machine ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for Windows OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
timeZone:
{
Description: TimeZone for the virtual machine instance ,
Required: False ,
}
string ,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
}
,
securityProfile:
{
Description: SecurityProfile - Specifies the security settings for the virtual machine instance. ,
Required: False ,
}
{
enableTPM:
{
Description: Enable TPM flag ,
Required: False ,
}
boolean ,
uefiSettings:
{
Description: Uefi settings of the virtual machine instance ,
Required: False ,
}
{
secureBootEnabled:
{
Description: Specifies whether secure boot should be enabled on the virtual machine instance. ,
Required: False ,
}
boolean ,
}
,
securityType:
{
Description: Specifies the SecurityType of the virtual machine. EnableTPM and SecureBootEnabled must be set to true for SecurityType to function. ,
Enum:
{
TrustedLaunch: Trusted Launch security type ,
ConfidentialVM: Confidential VM security type ,
}
,
Required: False ,
}
enum ,
}
,
storageProfile:
{
Description: StorageProfile - contains information about the disks and storage information for the virtual machine instance ,
Required: False ,
}
{
dataDisks:
{
Description: adds data disks to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
imageReference:
{
Description: Which Image to use for the virtual machine instance ,
Required: False ,
}
{
id:
{
Description: The ARM ID for an image resource used by the virtual machine instance. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
osDisk:
{
Description: VHD to attach as OS disk ,
Required: False ,
}
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
osType:
{
Description: This property allows you to specify the type of the OS that is included in the disk if creating a VM from user-image or a specialized VHD. Possible values are: Windows, Linux. ,
Enum:
{
Windows: Windows operating system ,
Linux: Linux operating system ,
}
,
Required: False ,
}
enum ,
}
,
vmConfigStoragePathId:
{
Description: Id of the storage container that hosts the VM configuration file ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
httpProxyConfig:
{
Description: HTTP Proxy configuration for the VM. ,
Required: False ,
}
{
httpProxy:
{
Description: The HTTP proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
httpsProxy:
{
Description: The HTTPS proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
noProxy:
{
Description: The endpoints that should not go through proxy. ,
Required: False ,
}
[
string ,
]
,
trustedCa:
{
Description: Alternative CA cert to use for connecting to proxy servers. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: Provisioning state of the virtual machine instance. ,
Enum:
{
Succeeded: Provisioning has succeeded ,
Failed: Provisioning has failed ,
InProgress: Provisioning is in progress ,
Accepted: Provisioning has been accepted ,
Deleting: Deletion of the resource is in progress ,
Canceled: Provisioning has been canceled ,
}
,
Required: False ,
}
enum ,
instanceView:
{
Description: The virtual machine instance view. ,
Required: False ,
}
{
vmAgent:
{
Description: The VM Config Agent running on the virtual machine. ,
Required: False ,
}
{
vmConfigAgentVersion:
{
Description: The VM Config Agent full version. ,
Required: False ,
}
string ,
statuses:
{
Description: The resource status information. ,
Required: False ,
}
[
{
code:
{
Description: The status code. ,
Required: False ,
}
string ,
level:
{
Description: The level code. ,
Enum:
{
Info: Informational status level ,
Warning: Warning status level ,
Error: Error status level ,
}
,
Required: False ,
}
enum ,
displayStatus:
{
Description: The short localizable label for the status. ,
Required: False ,
}
string ,
message:
{
Description: The detailed status message, including for alerts and error messages. ,
Required: False ,
}
string ,
time:
{
Description: The time of the status. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The observed state of virtual machine instances ,
Required: False ,
}
{
errorCode:
{
Description: VirtualMachine provisioning error code ,
Required: False ,
}
string ,
errorMessage:
{
Description: Descriptive error message ,
Required: False ,
}
string ,
powerState:
{
Description: The power state of the virtual machine instance ,
Enum:
{
Deallocated: Virtual machine deallocated ,
Deallocating: Virtual machine deallocating ,
Running: Virtual machine running ,
Starting: Virtual machine starting ,
Stopped: Virtual machine stopped ,
Stopping: Virtual machine stopping ,
Paused: Virtual machine paused ,
Saved: Virtual machine Saved, ,
Unknown: Power state of the virtual machine is unknown ,
}
,
Required: False ,
}
enum ,
provisioningStatus:
{
Description: Provisioning status of the virtual machine instance ,
Required: False ,
}
{
operationId:
{
Description: The ID of the operation performed on the virtual machine instance ,
Required: False ,
}
string ,
status:
{
Description: The status of the operation performed on the virtual machine instance [Succeeded, Failed, InProgress] ,
Enum:
{
Succeeded: Operation succeeded ,
Failed: Operation failed ,
InProgress: Operation is in progress ,
}
,
Required: False ,
}
enum ,
}
,
}
,
guestAgentInstallStatus:
{
Description: Guest agent install status. ,
Required: False ,
}
{
vmUuid:
{
Description: Specifies the VM's unique SMBIOS ID. ,
Required: False ,
}
string ,
status:
{
Description: The installation status of the hybrid machine agent installation. ,
Enum:
{
Succeeded: Installation succeeded ,
InProgress: Installation in progress ,
Failed: Installation failed ,
}
,
Required: False ,
}
enum ,
lastStatusChange:
{
Description: The time of the last status change. ,
Format: date-time ,
Required: False ,
}
string ,
agentVersion:
{
Description: The hybrid machine agent full version. ,
Required: False ,
}
string ,
errorDetails:
{
Description: Details about the error state. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
}
,
vmId:
{
Description: Unique identifier for the vm resource. ,
Required: False ,
}
string ,
resourceUid:
{
Description: Unique identifier defined by ARC to identify the guest of the VM. ,
Required: False ,
}
string ,
}
,
extendedLocation:
{
Description: The extendedLocation of the resource. ,
Required: False ,
}
{
name:
{
Description: The name of the extended location. ,
Required: False ,
}
string ,
type:
{
Description: The type of the extended location. ,
Enum:
{
CustomLocation: Custom extended location type ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: The managed service identities assigned to this resource. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned,UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
VirtualMachineInstances_Update (updated)
Description :  The operation to update a virtual machine instance.
Reference :  Link ¶

⚶ Changes

{
  "#id": "VirtualMachineInstances_Update",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "osProfile": [
              {
                "linuxConfiguration": [
                  {
                    "ssh": [
                      {
                        "publicKeys": {
                          "$properties": [
                            {
                              "#name": "keyData",
                              "Description": {
                                "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              },
              {
                "windowsConfiguration": [
                  {
                    "ssh": [
                      {
                        "publicKeys": {
                          "$properties": [
                            {
                              "#name": "keyData",
                              "Description": {
                                "new": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).",
                                "old": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. 

 For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed)."
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /{resourceUri}/providers/Microsoft.AzureStackHCI/virtualMachineInstances/default
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
resourceUri:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
properties:
{
Description: The resource properties to be updated. ,
Required: True ,
}
{
properties:
{
Description: Defines the resource properties for the update. ,
Required: False ,
}
{
hardwareProfile:
{
Description: HardwareProfile - Specifies the hardware settings for the virtual machine instance. ,
Required: False ,
}
{
vmSize:
{
Description: VM Size Enum ,
Enum:
{
Default: Default virtual machine size ,
Standard_A2_v2: Standard A2 v2 virtual machine size ,
Standard_A4_v2: Standard A4 v2 virtual machine size ,
Standard_D2s_v3: Standard D2s v3 virtual machine size ,
Standard_D4s_v3: Standard D4s v3 virtual machine size ,
Standard_D8s_v3: Standard D8s v3 virtual machine size ,
Standard_D16s_v3: Standard D16s v3 virtual machine size ,
Standard_D32s_v3: Standard D32s v3 virtual machine size ,
Standard_DS2_v2: Standard DS2 v2 virtual machine size ,
Standard_DS3_v2: Standard DS3 v2 virtual machine size ,
Standard_DS4_v2: Standard DS4 v2 virtual machine size ,
Standard_DS5_v2: Standard DS5 v2 virtual machine size ,
Standard_DS13_v2: Standard DS13 v2 virtual machine size ,
Standard_K8S_v1: Standard K8S v1 virtual machine size ,
Standard_K8S2_v1: Standard K8S2 v1 virtual machine size ,
Standard_K8S3_v1: Standard K8S3 v1 virtual machine size ,
Standard_K8S4_v1: Standard K8S4 v1 virtual machine size ,
Standard_NK6: Standard NK6 virtual machine size ,
Standard_NK12: Standard NK12 virtual machine size ,
Standard_NV6: Standard NV6 virtual machine size ,
Standard_NV12: Standard NV12 virtual machine size ,
Standard_K8S5_v1: Standard K8S5 v1 virtual machine size ,
Custom: Custom virtual machine size ,
}
,
Required: False ,
}
enum ,
processors:
{
Description: number of processors for the virtual machine instance ,
Format: int32 ,
Required: False ,
}
integer ,
memoryMB:
{
Description: RAM in MB for the virtual machine instance ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
storageProfile:
{
Description: StorageProfile - Specifies the storage settings for the virtual machine instance. ,
Required: False ,
}
{
dataDisks:
{
Description: adds data disks to the virtual machine instance for the update call ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
}
,
networkProfile:
{
Description: NetworkProfile - describes the network update configuration the virtual machine instance ,
Required: False ,
}
{
networkInterfaces:
{
Description: NetworkInterfaces - list of network interfaces to be attached to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Network Interface. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
}
,
osProfile:
{
Description: OsProfile - describes the update configuration of the operating system ,
Required: False ,
}
{
computerName:
{
Description: ComputerName - name of the computer ,
Required: False ,
}
string ,
linuxConfiguration:
{
Description: Linux configuration properties ,
Required: False ,
}
{
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
windowsConfiguration:
{
Description: Windows configuration properties ,
Required: False ,
}
{
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
identity:
{
Description: Identity for the resource. ,
Required: False ,
}
{
principalId:
{
Description: The principal ID of resource identity. The value must be an UUID. ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of resource. The value must be an UUID. ,
Required: False ,
}
string ,
type:
{
Description: The identity type. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
hardwareProfile:
{
Description: HardwareProfile - Specifies the hardware settings for the virtual machine instance. ,
Required: False ,
}
{
vmSize:
{
Description: Enum of VM Sizes ,
Enum:
{
Default: Default virtual machine size ,
Standard_A2_v2: Standard A2 v2 virtual machine size ,
Standard_A4_v2: Standard A4 v2 virtual machine size ,
Standard_D2s_v3: Standard D2s v3 virtual machine size ,
Standard_D4s_v3: Standard D4s v3 virtual machine size ,
Standard_D8s_v3: Standard D8s v3 virtual machine size ,
Standard_D16s_v3: Standard D16s v3 virtual machine size ,
Standard_D32s_v3: Standard D32s v3 virtual machine size ,
Standard_DS2_v2: Standard DS2 v2 virtual machine size ,
Standard_DS3_v2: Standard DS3 v2 virtual machine size ,
Standard_DS4_v2: Standard DS4 v2 virtual machine size ,
Standard_DS5_v2: Standard DS5 v2 virtual machine size ,
Standard_DS13_v2: Standard DS13 v2 virtual machine size ,
Standard_K8S_v1: Standard K8S v1 virtual machine size ,
Standard_K8S2_v1: Standard K8S2 v1 virtual machine size ,
Standard_K8S3_v1: Standard K8S3 v1 virtual machine size ,
Standard_K8S4_v1: Standard K8S4 v1 virtual machine size ,
Standard_NK6: Standard NK6 virtual machine size ,
Standard_NK12: Standard NK12 virtual machine size ,
Standard_NV6: Standard NV6 virtual machine size ,
Standard_NV12: Standard NV12 virtual machine size ,
Standard_K8S5_v1: Standard K8S5 v1 virtual machine size ,
Custom: Custom virtual machine size ,
}
,
Required: False ,
}
enum ,
processors:
{
Description: number of processors for the virtual machine instance ,
Format: int32 ,
Required: False ,
}
integer ,
memoryMB:
{
Description: RAM in MB for the virtual machine instance ,
Format: int64 ,
Required: False ,
}
integer ,
dynamicMemoryConfig:
{
Description: Dynamic memory config ,
Required: False ,
}
{
maximumMemoryMB:
{
Description: Maximum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
minimumMemoryMB:
{
Description: Minimum memory in MB ,
Format: int64 ,
Required: False ,
}
integer ,
targetMemoryBuffer:
{
Description: Defines the amount of extra memory that should be reserved for a virtual machine instance at runtime, as a percentage of the total memory that the virtual machine instance is thought to need. This only applies to virtual systems with dynamic memory enabled. This property can be in the range of 5 to 2000. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
networkProfile:
{
Description: NetworkProfile - describes the network configuration the virtual machine instance ,
Required: False ,
}
{
networkInterfaces:
{
Description: NetworkInterfaces - list of network interfaces to be attached to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Network Interface. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
}
,
osProfile:
{
Description: OsProfile - describes the configuration of the operating system and sets login data ,
Required: False ,
}
{
adminPassword:
{
Description: AdminPassword - admin password ,
Format: password ,
Required: False ,
}
string ,
adminUsername:
{
Description: AdminUsername - admin username ,
Required: False ,
}
string ,
computerName:
{
Description: ComputerName - name of the compute ,
Required: False ,
}
string ,
linuxConfiguration:
{
Description: LinuxConfiguration - linux specific configuration values for the virtual machine instance ,
Required: False ,
}
{
disablePasswordAuthentication:
{
Description: DisablePasswordAuthentication - whether password authentication should be disabled ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for a Linux OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
windowsConfiguration:
{
Description: Windows Configuration for the virtual machine instance ,
Required: False ,
}
{
enableAutomaticUpdates:
{
Description: Whether to EnableAutomaticUpdates on the machine ,
Required: False ,
}
boolean ,
ssh:
{
Description: Specifies the ssh key configuration for Windows OS. ,
Required: False ,
}
{
publicKeys:
{
Description: The list of SSH public keys used to authenticate with linux based VMs. ,
Required: False ,
}
[
{
path:
{
Description: Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys ,
Required: False ,
}
string ,
keyData:
{
Description: SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://learn.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). ,
Required: False ,
}
string ,
}
,
]
,
}
,
timeZone:
{
Description: TimeZone for the virtual machine instance ,
Required: False ,
}
string ,
provisionVMAgent:
{
Description: Used to indicate whether Arc for Servers agent onboarding should be triggered during the virtual machine instance creation process. ,
Required: False ,
}
boolean ,
provisionVMConfigAgent:
{
Description: Used to indicate whether the VM Config Agent should be installed during the virtual machine creation process. ,
Required: False ,
}
boolean ,
}
,
}
,
securityProfile:
{
Description: SecurityProfile - Specifies the security settings for the virtual machine instance. ,
Required: False ,
}
{
enableTPM:
{
Description: Enable TPM flag ,
Required: False ,
}
boolean ,
uefiSettings:
{
Description: Uefi settings of the virtual machine instance ,
Required: False ,
}
{
secureBootEnabled:
{
Description: Specifies whether secure boot should be enabled on the virtual machine instance. ,
Required: False ,
}
boolean ,
}
,
securityType:
{
Description: Specifies the SecurityType of the virtual machine. EnableTPM and SecureBootEnabled must be set to true for SecurityType to function. ,
Enum:
{
TrustedLaunch: Trusted Launch security type ,
ConfidentialVM: Confidential VM security type ,
}
,
Required: False ,
}
enum ,
}
,
storageProfile:
{
Description: StorageProfile - contains information about the disks and storage information for the virtual machine instance ,
Required: False ,
}
{
dataDisks:
{
Description: adds data disks to the virtual machine instance ,
Required: False ,
}
[
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
imageReference:
{
Description: Which Image to use for the virtual machine instance ,
Required: False ,
}
{
id:
{
Description: The ARM ID for an image resource used by the virtual machine instance. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
osDisk:
{
Description: VHD to attach as OS disk ,
Required: False ,
}
{
id:
{
Description: The ARM ID for a Virtual Hard Disk. ,
Format: arm-id ,
Required: False ,
}
string ,
osType:
{
Description: This property allows you to specify the type of the OS that is included in the disk if creating a VM from user-image or a specialized VHD. Possible values are: Windows, Linux. ,
Enum:
{
Windows: Windows operating system ,
Linux: Linux operating system ,
}
,
Required: False ,
}
enum ,
}
,
vmConfigStoragePathId:
{
Description: Id of the storage container that hosts the VM configuration file ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
httpProxyConfig:
{
Description: HTTP Proxy configuration for the VM. ,
Required: False ,
}
{
httpProxy:
{
Description: The HTTP proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
httpsProxy:
{
Description: The HTTPS proxy server endpoint to use. ,
Format: password ,
Required: False ,
}
string ,
noProxy:
{
Description: The endpoints that should not go through proxy. ,
Required: False ,
}
[
string ,
]
,
trustedCa:
{
Description: Alternative CA cert to use for connecting to proxy servers. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: Provisioning state of the virtual machine instance. ,
Enum:
{
Succeeded: Provisioning has succeeded ,
Failed: Provisioning has failed ,
InProgress: Provisioning is in progress ,
Accepted: Provisioning has been accepted ,
Deleting: Deletion of the resource is in progress ,
Canceled: Provisioning has been canceled ,
}
,
Required: False ,
}
enum ,
instanceView:
{
Description: The virtual machine instance view. ,
Required: False ,
}
{
vmAgent:
{
Description: The VM Config Agent running on the virtual machine. ,
Required: False ,
}
{
vmConfigAgentVersion:
{
Description: The VM Config Agent full version. ,
Required: False ,
}
string ,
statuses:
{
Description: The resource status information. ,
Required: False ,
}
[
{
code:
{
Description: The status code. ,
Required: False ,
}
string ,
level:
{
Description: The level code. ,
Enum:
{
Info: Informational status level ,
Warning: Warning status level ,
Error: Error status level ,
}
,
Required: False ,
}
enum ,
displayStatus:
{
Description: The short localizable label for the status. ,
Required: False ,
}
string ,
message:
{
Description: The detailed status message, including for alerts and error messages. ,
Required: False ,
}
string ,
time:
{
Description: The time of the status. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The observed state of virtual machine instances ,
Required: False ,
}
{
errorCode:
{
Description: VirtualMachine provisioning error code ,
Required: False ,
}
string ,
errorMessage:
{
Description: Descriptive error message ,
Required: False ,
}
string ,
powerState:
{
Description: The power state of the virtual machine instance ,
Enum:
{
Deallocated: Virtual machine deallocated ,
Deallocating: Virtual machine deallocating ,
Running: Virtual machine running ,
Starting: Virtual machine starting ,
Stopped: Virtual machine stopped ,
Stopping: Virtual machine stopping ,
Paused: Virtual machine paused ,
Saved: Virtual machine Saved, ,
Unknown: Power state of the virtual machine is unknown ,
}
,
Required: False ,
}
enum ,
provisioningStatus:
{
Description: Provisioning status of the virtual machine instance ,
Required: False ,
}
{
operationId:
{
Description: The ID of the operation performed on the virtual machine instance ,
Required: False ,
}
string ,
status:
{
Description: The status of the operation performed on the virtual machine instance [Succeeded, Failed, InProgress] ,
Enum:
{
Succeeded: Operation succeeded ,
Failed: Operation failed ,
InProgress: Operation is in progress ,
}
,
Required: False ,
}
enum ,
}
,
}
,
guestAgentInstallStatus:
{
Description: Guest agent install status. ,
Required: False ,
}
{
vmUuid:
{
Description: Specifies the VM's unique SMBIOS ID. ,
Required: False ,
}
string ,
status:
{
Description: The installation status of the hybrid machine agent installation. ,
Enum:
{
Succeeded: Installation succeeded ,
InProgress: Installation in progress ,
Failed: Installation failed ,
}
,
Required: False ,
}
enum ,
lastStatusChange:
{
Description: The time of the last status change. ,
Format: date-time ,
Required: False ,
}
string ,
agentVersion:
{
Description: The hybrid machine agent full version. ,
Required: False ,
}
string ,
errorDetails:
{
Description: Details about the error state. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
}
,
vmId:
{
Description: Unique identifier for the vm resource. ,
Required: False ,
}
string ,
resourceUid:
{
Description: Unique identifier defined by ARC to identify the guest of the VM. ,
Required: False ,
}
string ,
}
,
extendedLocation:
{
Description: The extendedLocation of the resource. ,
Required: False ,
}
{
name:
{
Description: The name of the extended location. ,
Required: False ,
}
string ,
type:
{
Description: The type of the extended location. ,
Enum:
{
CustomLocation: Custom extended location type ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: The managed service identities assigned to this resource. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned,UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}