Virtual Machines - Create Or Update

Service:

Operator Nexus - Network Cloud

API Version:

2025-09-01

Create a new virtual machine or update the properties of the existing virtual machine.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}?api-version=2025-09-01

URI Parameters

Name	In	Required	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	The name of the resource group. The name is case insensitive.
subscriptionId	path	True	string (uuid)	The ID of the target subscription. The value must be an UUID.
virtualMachineName	path	True	string pattern: ^([a-zA-Z0-9][a-zA-Z0-9]{0,62}[a-zA-Z0-9])$	The name of the virtual machine.
api-version	query	True	string minLength: 1	The API version to use for this operation.

Request Header

Name	Required	Type	Description
If-Match		string	The ETag of the transformation. Omit this value to always overwrite the current resource. Specify the last-seen ETag value to prevent accidentally overwriting concurrent changes.
If-None-Match		string	Set to '*' to allow a new record set to be created, but to prevent updating an existing resource. Other values will result in error from server as they are not supported.

Request Body

Name	Required	Type	Description
extendedLocation	True	Azure.ResourceManager.CommonTypes.ExtendedLocation	The extended location of the resource. This property is required when creating the resource.
location	True	string	The geo-location where the resource lives
properties.adminUsername	True	string minLength: 1 maxLength: 32 pattern: ^[a-z_][a-z0-9_]{0,31}$	The name of the administrator to which the ssh public keys will be added into the authorized keys.
properties.cloudServicesNetworkAttachment	True	NetworkAttachment	The cloud service network that provides platform-level services for the virtual machine.
properties.cpuCores	True	integer (int64) minimum: 2	The number of CPU cores in the virtual machine.
properties.memorySizeGB	True	integer (int64) minimum: 1	The memory size of the virtual machine. Allocations are measured in gibibytes.
properties.storageProfile	True	StorageProfile	The storage profile that specifies size and other parameters about the disks related to the virtual machine.
properties.vmImage	True	string	The virtual machine image that is currently provisioned to the OS disk, using the full url and tag notation used to pull the image.
identity		ManagedServiceIdentity	The managed service identities assigned to this resource.
properties.bootMethod		VirtualMachineBootMethod	Selects the boot method for the virtual machine.
properties.consoleExtendedLocation		Azure.ResourceManager.CommonTypes.ExtendedLocation	The extended location to use for creation of a VM console resource.
properties.isolateEmulatorThread		VirtualMachineIsolateEmulatorThread	Field Deprecated, the value will be ignored if provided. The indicator of whether one of the specified CPU cores is isolated to run the emulator thread for this virtual machine.
properties.networkAttachments		NetworkAttachment[]	The list of network attachments to the virtual machine.
properties.networkData		string	Field Deprecated: The Base64 encoded cloud-init network data. The networkDataContent property will be used in preference to this property.
properties.networkDataContent		string (password)	The Base64 encoded cloud-init network data.
properties.placementHints		VirtualMachinePlacementHint[]	The scheduling hints for the virtual machine.
properties.sshPublicKeys		SshPublicKey[]	The list of ssh public keys. Each key will be added to the virtual machine using the cloud-init ssh_authorized_keys mechanism for the adminUsername.
properties.userData		string	Field Deprecated: The Base64 encoded cloud-init user data. The userDataContent property will be used in preference to this property.
properties.userDataContent		string (password)	The Base64 encoded cloud-init user data.
properties.virtioInterface		VirtualMachineVirtioInterfaceType	Field Deprecated, use virtualizationModel instead. The type of the virtio interface.
properties.vmDeviceModel		VirtualMachineDeviceModelType	The type of the device model to use.
properties.vmImageRepositoryCredentials		ImageRepositoryCredentials	The credentials used to login to the image repository that has access to the specified image.
tags		object	Resource tags.

Responses

Name	Type	Description
200 OK	VirtualMachine	Resource 'VirtualMachine' update operation succeeded
201 Created	VirtualMachine	Resource 'VirtualMachine' create operation succeeded Headers Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	An unexpected error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

Create or update virtual machine

Sample request

HTTP

PUT https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/virtualMachines/virtualMachineName?api-version=2025-09-01

{
  "extendedLocation": {
    "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
    "type": "CustomLocation"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userIdentity1": {}
    }
  },
  "location": "location",
  "properties": {
    "adminUsername": "username",
    "bootMethod": "UEFI",
    "cloudServicesNetworkAttachment": {
      "attachedNetworkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName",
      "ipAllocationMethod": "Dynamic"
    },
    "cpuCores": 2,
    "memorySizeGB": 8,
    "networkAttachments": [
      {
        "attachedNetworkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName",
        "defaultGateway": "True",
        "ipAllocationMethod": "Dynamic",
        "ipv4Address": "198.51.100.1",
        "ipv6Address": "2001:0db8:0000:0000:0000:0000:0000:0000",
        "networkAttachmentName": "netAttachName01"
      }
    ],
    "networkDataContent": "bmV0d29ya0RhdGVTYW1wbGU=",
    "placementHints": [
      {
        "hintType": "Affinity",
        "resourceId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName",
        "schedulingExecution": "Hard",
        "scope": ""
      }
    ],
    "sshPublicKeys": [
      {
        "keyData": "ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT/ojNZfpB3af/YDzwQCZgTcTRyNNhL4o/blKUmug0daSsSXISTRnIDpcf5qytjs1Xo+yYyJMvzLL59mhAyb3p/cD+Y3/s3WhAx+l0XOKpzXnblrv9d3q4c2tWmm/SyFqthaqd0= admin@vm"
      }
    ],
    "storageProfile": {
      "osDisk": {
        "createOption": "Ephemeral",
        "deleteOption": "Delete",
        "diskSizeGB": 120
      },
      "volumeAttachments": [
        "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName"
      ]
    },
    "userDataContent": "dXNlckRhdGVTYW1wbGU=",
    "vmDeviceModel": "T2",
    "vmImage": "myacr.azurecr.io/foobar:latest",
    "vmImageRepositoryCredentials": {
      "password": "{password}",
      "registryUrl": "myacr.azurecr.io",
      "username": "myuser"
    }
  },
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  }
}

Java

import com.azure.resourcemanager.networkcloud.models.DefaultGateway;
import com.azure.resourcemanager.networkcloud.models.ExtendedLocation;
import com.azure.resourcemanager.networkcloud.models.ImageRepositoryCredentials;
import com.azure.resourcemanager.networkcloud.models.ManagedServiceIdentity;
import com.azure.resourcemanager.networkcloud.models.ManagedServiceIdentityType;
import com.azure.resourcemanager.networkcloud.models.NetworkAttachment;
import com.azure.resourcemanager.networkcloud.models.OsDisk;
import com.azure.resourcemanager.networkcloud.models.OsDiskCreateOption;
import com.azure.resourcemanager.networkcloud.models.OsDiskDeleteOption;
import com.azure.resourcemanager.networkcloud.models.SshPublicKey;
import com.azure.resourcemanager.networkcloud.models.StorageProfile;
import com.azure.resourcemanager.networkcloud.models.UserAssignedIdentity;
import com.azure.resourcemanager.networkcloud.models.VirtualMachineBootMethod;
import com.azure.resourcemanager.networkcloud.models.VirtualMachineDeviceModelType;
import com.azure.resourcemanager.networkcloud.models.VirtualMachineIpAllocationMethod;
import com.azure.resourcemanager.networkcloud.models.VirtualMachinePlacementHint;
import com.azure.resourcemanager.networkcloud.models.VirtualMachinePlacementHintPodAffinityScope;
import com.azure.resourcemanager.networkcloud.models.VirtualMachinePlacementHintType;
import com.azure.resourcemanager.networkcloud.models.VirtualMachineSchedulingExecution;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for VirtualMachines CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2025-09-01/examples/
     * VirtualMachines_Create.json
     */
    /**
     * Sample code: Create or update virtual machine.
     * 
     * @param manager Entry point to NetworkCloudManager.
     */
    public static void
        createOrUpdateVirtualMachine(com.azure.resourcemanager.networkcloud.NetworkCloudManager manager) {
        manager.virtualMachines().define("virtualMachineName").withRegion("location")
            .withExistingResourceGroup("resourceGroupName")
            .withExtendedLocation(new ExtendedLocation().withName(
                "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName")
                .withType("CustomLocation"))
            .withAdminUsername("username")
            .withCloudServicesNetworkAttachment(new NetworkAttachment().withAttachedNetworkId(
                "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName")
                .withIpAllocationMethod(VirtualMachineIpAllocationMethod.DYNAMIC))
            .withCpuCores(2L).withMemorySizeGB(8L)
            .withStorageProfile(new StorageProfile()
                .withOsDisk(new OsDisk().withCreateOption(OsDiskCreateOption.EPHEMERAL)
                    .withDeleteOption(OsDiskDeleteOption.DELETE).withDiskSizeGB(120L))
                .withVolumeAttachments(Arrays.asList(
                    "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName")))
            .withVmImage("myacr.azurecr.io/foobar:latest")
            .withTags(mapOf("key1", "fakeTokenPlaceholder", "key2", "fakeTokenPlaceholder"))
            .withIdentity(new ManagedServiceIdentity().withType(ManagedServiceIdentityType.USER_ASSIGNED)
                .withUserAssignedIdentities(mapOf(
                    "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userIdentity1",
                    new UserAssignedIdentity())))
            .withBootMethod(VirtualMachineBootMethod.UEFI)
            .withNetworkAttachments(Arrays.asList(new NetworkAttachment().withAttachedNetworkId(
                "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName")
                .withDefaultGateway(DefaultGateway.TRUE)
                .withIpAllocationMethod(VirtualMachineIpAllocationMethod.DYNAMIC).withIpv4Address("198.51.100.1")
                .withIpv6Address("2001:0db8:0000:0000:0000:0000:0000:0000")
                .withNetworkAttachmentName("netAttachName01")))
            .withNetworkDataContent("bmV0d29ya0RhdGVTYW1wbGU=")
            .withPlacementHints(Arrays.asList(new VirtualMachinePlacementHint()
                .withHintType(VirtualMachinePlacementHintType.AFFINITY)
                .withResourceId(
                    "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName")
                .withSchedulingExecution(VirtualMachineSchedulingExecution.HARD)
                .withScope(VirtualMachinePlacementHintPodAffinityScope.fromString(""))))
            .withSshPublicKeys(Arrays.asList(new SshPublicKey().withKeyData("fakeTokenPlaceholder")))
            .withUserDataContent("dXNlckRhdGVTYW1wbGU=").withVmDeviceModel(VirtualMachineDeviceModelType.T2)
            .withVmImageRepositoryCredentials(new ImageRepositoryCredentials().withPassword("fakeTokenPlaceholder")
                .withRegistryUrl("myacr.azurecr.io").withUsername("myuser"))
            .create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.networkcloud import NetworkCloudMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-networkcloud
# USAGE
    python virtual_machines_create.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = NetworkCloudMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.virtual_machines.begin_create_or_update(
        resource_group_name="resourceGroupName",
        virtual_machine_name="virtualMachineName",
        virtual_machine_parameters={
            "extendedLocation": {
                "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
                "type": "CustomLocation",
            },
            "identity": {
                "type": "UserAssigned",
                "userAssignedIdentities": {
                    "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userIdentity1": {}
                },
            },
            "location": "location",
            "properties": {
                "adminUsername": "username",
                "bootMethod": "UEFI",
                "cloudServicesNetworkAttachment": {
                    "attachedNetworkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName",
                    "ipAllocationMethod": "Dynamic",
                },
                "cpuCores": 2,
                "memorySizeGB": 8,
                "networkAttachments": [
                    {
                        "attachedNetworkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName",
                        "defaultGateway": "True",
                        "ipAllocationMethod": "Dynamic",
                        "ipv4Address": "198.51.100.1",
                        "ipv6Address": "2001:0db8:0000:0000:0000:0000:0000:0000",
                        "networkAttachmentName": "netAttachName01",
                    }
                ],
                "networkDataContent": "bmV0d29ya0RhdGVTYW1wbGU=",
                "placementHints": [
                    {
                        "hintType": "Affinity",
                        "resourceId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName",
                        "schedulingExecution": "Hard",
                        "scope": "",
                    }
                ],
                "sshPublicKeys": [
                    {
                        "keyData": "ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT/ojNZfpB3af/YDzwQCZgTcTRyNNhL4o/blKUmug0daSsSXISTRnIDpcf5qytjs1Xo+yYyJMvzLL59mhAyb3p/cD+Y3/s3WhAx+l0XOKpzXnblrv9d3q4c2tWmm/SyFqthaqd0= admin@vm"
                    }
                ],
                "storageProfile": {
                    "osDisk": {"createOption": "Ephemeral", "deleteOption": "Delete", "diskSizeGB": 120},
                    "volumeAttachments": [
                        "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName"
                    ],
                },
                "userDataContent": "dXNlckRhdGVTYW1wbGU=",
                "vmDeviceModel": "T2",
                "vmImage": "myacr.azurecr.io/foobar:latest",
                "vmImageRepositoryCredentials": {
                    "password": "{password}",
                    "registryUrl": "myacr.azurecr.io",
                    "username": "myuser",
                },
            },
            "tags": {"key1": "myvalue1", "key2": "myvalue2"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-09-01/VirtualMachines_Create.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armnetworkcloud_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/networkcloud/armnetworkcloud"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/46c51b03d99b113ecc3b38883e3cb2d395fe94a4/specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2025-09-01/examples/VirtualMachines_Create.json
func ExampleVirtualMachinesClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armnetworkcloud.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewVirtualMachinesClient().BeginCreateOrUpdate(ctx, "resourceGroupName", "virtualMachineName", armnetworkcloud.VirtualMachine{
		Location: to.Ptr("location"),
		Tags: map[string]*string{
			"key1": to.Ptr("myvalue1"),
			"key2": to.Ptr("myvalue2"),
		},
		ExtendedLocation: &armnetworkcloud.ExtendedLocation{
			Name: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName"),
			Type: to.Ptr("CustomLocation"),
		},
		Identity: &armnetworkcloud.ManagedServiceIdentity{
			Type: to.Ptr(armnetworkcloud.ManagedServiceIdentityTypeUserAssigned),
			UserAssignedIdentities: map[string]*armnetworkcloud.UserAssignedIdentity{
				"/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userIdentity1": {},
			},
		},
		Properties: &armnetworkcloud.VirtualMachineProperties{
			AdminUsername: to.Ptr("username"),
			BootMethod:    to.Ptr(armnetworkcloud.VirtualMachineBootMethodUEFI),
			CloudServicesNetworkAttachment: &armnetworkcloud.NetworkAttachment{
				AttachedNetworkID:  to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName"),
				IPAllocationMethod: to.Ptr(armnetworkcloud.VirtualMachineIPAllocationMethodDynamic),
			},
			CPUCores:     to.Ptr[int64](2),
			MemorySizeGB: to.Ptr[int64](8),
			NetworkAttachments: []*armnetworkcloud.NetworkAttachment{
				{
					AttachedNetworkID:     to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName"),
					DefaultGateway:        to.Ptr(armnetworkcloud.DefaultGatewayTrue),
					IPAllocationMethod:    to.Ptr(armnetworkcloud.VirtualMachineIPAllocationMethodDynamic),
					IPv4Address:           to.Ptr("198.51.100.1"),
					IPv6Address:           to.Ptr("2001:0db8:0000:0000:0000:0000:0000:0000"),
					NetworkAttachmentName: to.Ptr("netAttachName01"),
				}},
			NetworkDataContent: to.Ptr("bmV0d29ya0RhdGVTYW1wbGU="),
			PlacementHints: []*armnetworkcloud.VirtualMachinePlacementHint{
				{
					HintType:            to.Ptr(armnetworkcloud.VirtualMachinePlacementHintTypeAffinity),
					ResourceID:          to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName"),
					SchedulingExecution: to.Ptr(armnetworkcloud.VirtualMachineSchedulingExecutionHard),
					Scope:               to.Ptr(armnetworkcloud.VirtualMachinePlacementHintPodAffinityScope("")),
				}},
			SSHPublicKeys: []*armnetworkcloud.SSHPublicKey{
				{
					KeyData: to.Ptr("ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT/ojNZfpB3af/YDzwQCZgTcTRyNNhL4o/blKUmug0daSsSXISTRnIDpcf5qytjs1Xo+yYyJMvzLL59mhAyb3p/cD+Y3/s3WhAx+l0XOKpzXnblrv9d3q4c2tWmm/SyFqthaqd0= admin@vm"),
				}},
			StorageProfile: &armnetworkcloud.StorageProfile{
				OSDisk: &armnetworkcloud.OsDisk{
					CreateOption: to.Ptr(armnetworkcloud.OsDiskCreateOptionEphemeral),
					DeleteOption: to.Ptr(armnetworkcloud.OsDiskDeleteOptionDelete),
					DiskSizeGB:   to.Ptr[int64](120),
				},
				VolumeAttachments: []*string{
					to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName")},
			},
			UserDataContent: to.Ptr("dXNlckRhdGVTYW1wbGU="),
			VMDeviceModel:   to.Ptr(armnetworkcloud.VirtualMachineDeviceModelTypeT2),
			VMImage:         to.Ptr("myacr.azurecr.io/foobar:latest"),
			VMImageRepositoryCredentials: &armnetworkcloud.ImageRepositoryCredentials{
				Password:    to.Ptr("{password}"),
				RegistryURL: to.Ptr("myacr.azurecr.io"),
				Username:    to.Ptr("myuser"),
			},
		},
	}, &armnetworkcloud.VirtualMachinesClientBeginCreateOrUpdateOptions{IfMatch: nil,
		IfNoneMatch: nil,
	})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.VirtualMachine = armnetworkcloud.VirtualMachine{
	// 	Name: to.Ptr("virtualMachineName"),
	// 	Type: to.Ptr("Microsoft.NetworkCloud/virtualMachines"),
	// 	ID: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/virtualMachines/virtualMachineName"),
	// 	SystemData: &armnetworkcloud.SystemData{
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-01-22T13:27:03.008Z"); return t}()),
	// 		CreatedBy: to.Ptr("identityA"),
	// 		CreatedByType: to.Ptr(armnetworkcloud.CreatedByTypeApplication),
	// 		LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-01-22T13:29:03.001Z"); return t}()),
	// 		LastModifiedBy: to.Ptr("identityB"),
	// 		LastModifiedByType: to.Ptr(armnetworkcloud.CreatedByTypeUser),
	// 	},
	// 	Location: to.Ptr("location"),
	// 	Tags: map[string]*string{
	// 		"key1": to.Ptr("myvalue1"),
	// 		"key2": to.Ptr("myvalue2"),
	// 	},
	// 	ExtendedLocation: &armnetworkcloud.ExtendedLocation{
	// 		Name: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName"),
	// 		Type: to.Ptr("CustomLocation"),
	// 	},
	// 	Identity: &armnetworkcloud.ManagedServiceIdentity{
	// 		Type: to.Ptr(armnetworkcloud.ManagedServiceIdentityTypeUserAssigned),
	// 		UserAssignedIdentities: map[string]*armnetworkcloud.UserAssignedIdentity{
	// 			"/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userIdentity1": &armnetworkcloud.UserAssignedIdentity{
	// 			},
	// 		},
	// 	},
	// 	Properties: &armnetworkcloud.VirtualMachineProperties{
	// 		AdminUsername: to.Ptr("username"),
	// 		AvailabilityZone: to.Ptr("1"),
	// 		BareMetalMachineID: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/bareMetalMachines/bareMetalMachineName"),
	// 		BootMethod: to.Ptr(armnetworkcloud.VirtualMachineBootMethodUEFI),
	// 		CloudServicesNetworkAttachment: &armnetworkcloud.NetworkAttachment{
	// 			AttachedNetworkID: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName"),
	// 			IPAllocationMethod: to.Ptr(armnetworkcloud.VirtualMachineIPAllocationMethodDynamic),
	// 		},
	// 		ClusterID: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/clusters/clusterName"),
	// 		ConsoleExtendedLocation: &armnetworkcloud.ExtendedLocation{
	// 			Name: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/consoleCustomLocationName"),
	// 			Type: to.Ptr("CustomLocation"),
	// 		},
	// 		CPUCores: to.Ptr[int64](2),
	// 		DetailedStatus: to.Ptr(armnetworkcloud.VirtualMachineDetailedStatusAvailable),
	// 		DetailedStatusMessage: to.Ptr("VM is up and healthy"),
	// 		MemorySizeGB: to.Ptr[int64](8),
	// 		NetworkAttachments: []*armnetworkcloud.NetworkAttachment{
	// 			{
	// 				AttachedNetworkID: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName"),
	// 				DefaultGateway: to.Ptr(armnetworkcloud.DefaultGatewayTrue),
	// 				IPAllocationMethod: to.Ptr(armnetworkcloud.VirtualMachineIPAllocationMethodDynamic),
	// 				IPv4Address: to.Ptr("198.51.100.1"),
	// 				IPv6Address: to.Ptr("2001:0db8:0000:0000:0000:0000:0000:0000"),
	// 				MacAddress: to.Ptr("bf:1c:29:31:31:1f"),
	// 				NetworkAttachmentName: to.Ptr("netAttachName01"),
	// 		}},
	// 		PlacementHints: []*armnetworkcloud.VirtualMachinePlacementHint{
	// 			{
	// 				HintType: to.Ptr(armnetworkcloud.VirtualMachinePlacementHintTypeAffinity),
	// 				ResourceID: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName"),
	// 				SchedulingExecution: to.Ptr(armnetworkcloud.VirtualMachineSchedulingExecutionHard),
	// 				Scope: to.Ptr(armnetworkcloud.VirtualMachinePlacementHintPodAffinityScope("")),
	// 		}},
	// 		PowerState: to.Ptr(armnetworkcloud.VirtualMachinePowerStateOn),
	// 		ProvisioningState: to.Ptr(armnetworkcloud.VirtualMachineProvisioningStateSucceeded),
	// 		SSHPublicKeys: []*armnetworkcloud.SSHPublicKey{
	// 			{
	// 				KeyData: to.Ptr("ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT/ojNZfpB3af/YDzwQCZgTcTRyNNhL4o/blKUmug0daSsSXISTRnIDpcf5qytjs1Xo+yYyJMvzLL59mhAyb3p/cD+Y3/s3WhAx+l0XOKpzXnblrv9d3q4c2tWmm/SyFqthaqd0= admin@vm"),
	// 		}},
	// 		StorageProfile: &armnetworkcloud.StorageProfile{
	// 			OSDisk: &armnetworkcloud.OsDisk{
	// 				CreateOption: to.Ptr(armnetworkcloud.OsDiskCreateOptionEphemeral),
	// 				DeleteOption: to.Ptr(armnetworkcloud.OsDiskDeleteOptionDelete),
	// 				DiskSizeGB: to.Ptr[int64](120),
	// 			},
	// 			VolumeAttachments: []*string{
	// 				to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName")},
	// 			},
	// 			VMDeviceModel: to.Ptr(armnetworkcloud.VirtualMachineDeviceModelTypeT2),
	// 			VMImage: to.Ptr("myacr.azurecr.io/foobar:latest"),
	// 			VMImageRepositoryCredentials: &armnetworkcloud.ImageRepositoryCredentials{
	// 				RegistryURL: to.Ptr("myacr.azurecr.io"),
	// 				Username: to.Ptr("myuser"),
	// 			},
	// 			Volumes: []*string{
	// 				to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName")},
	// 			},
	// 		}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { NetworkCloud } = require("@azure/arm-networkcloud");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Create a new virtual machine or update the properties of the existing virtual machine.
 *
 * @summary Create a new virtual machine or update the properties of the existing virtual machine.
 * x-ms-original-file: specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2025-09-01/examples/VirtualMachines_Create.json
 */
async function createOrUpdateVirtualMachine() {
  const subscriptionId =
    process.env["NETWORKCLOUD_SUBSCRIPTION_ID"] || "123e4567-e89b-12d3-a456-426655440000";
  const resourceGroupName = process.env["NETWORKCLOUD_RESOURCE_GROUP"] || "resourceGroupName";
  const virtualMachineName = "virtualMachineName";
  const virtualMachineParameters = {
    adminUsername: "username",
    bootMethod: "UEFI",
    cloudServicesNetworkAttachment: {
      attachedNetworkId:
        "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName",
      ipAllocationMethod: "Dynamic",
    },
    cpuCores: 2,
    extendedLocation: {
      name: "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
      type: "CustomLocation",
    },
    identity: {
      type: "UserAssigned",
      userAssignedIdentities: {
        "/subscriptions/123e4567E89b12d3A456426655440000/resourceGroups/resourceGroupName/providers/MicrosoftManagedIdentity/userAssignedIdentities/userIdentity1":
          {},
      },
    },
    location: "location",
    memorySizeGB: 8,
    networkAttachments: [
      {
        attachedNetworkId:
          "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName",
        defaultGateway: "True",
        ipAllocationMethod: "Dynamic",
        ipv4Address: "198.51.100.1",
        ipv6Address: "2001:0db8:0000:0000:0000:0000:0000:0000",
        networkAttachmentName: "netAttachName01",
      },
    ],
    networkDataContent: "bmV0d29ya0RhdGVTYW1wbGU=",
    placementHints: [
      {
        hintType: "Affinity",
        resourceId:
          "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName",
        schedulingExecution: "Hard",
        scope: "",
      },
    ],
    sshPublicKeys: [
      {
        keyData:
          "ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT/ojNZfpB3af/YDzwQCZgTcTRyNNhL4o/blKUmug0daSsSXISTRnIDpcf5qytjs1Xo+yYyJMvzLL59mhAyb3p/cD+Y3/s3WhAx+l0XOKpzXnblrv9d3q4c2tWmm/SyFqthaqd0= admin@vm",
      },
    ],
    storageProfile: {
      osDisk: {
        createOption: "Ephemeral",
        deleteOption: "Delete",
        diskSizeGB: 120,
      },
      volumeAttachments: [
        "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName",
      ],
    },
    tags: { key1: "myvalue1", key2: "myvalue2" },
    userDataContent: "dXNlckRhdGVTYW1wbGU=",
    vmDeviceModel: "T2",
    vmImage: "myacr.azurecr.io/foobar:latest",
    vmImageRepositoryCredentials: {
      password: "{password}",
      registryUrl: "myacr.azurecr.io",
      username: "myuser",
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new NetworkCloud(credential, subscriptionId);
  const result = await client.virtualMachines.beginCreateOrUpdateAndWait(
    resourceGroupName,
    virtualMachineName,
    virtualMachineParameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.NetworkCloud.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.NetworkCloud;

// Generated from example definition: specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2025-09-01/examples/VirtualMachines_Create.json
// this example is just showing the usage of "VirtualMachines_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "123e4567-e89b-12d3-a456-426655440000";
string resourceGroupName = "resourceGroupName";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this NetworkCloudVirtualMachineResource
NetworkCloudVirtualMachineCollection collection = resourceGroupResource.GetNetworkCloudVirtualMachines();

// invoke the operation
string virtualMachineName = "virtualMachineName";
NetworkCloudVirtualMachineData data = new NetworkCloudVirtualMachineData(
    new AzureLocation("location"),
    new ExtendedLocation("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName", "CustomLocation"),
    "username",
    new NetworkAttachment(new ResourceIdentifier("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName"), VirtualMachineIPAllocationMethod.Dynamic),
    2L,
    8L,
    new NetworkCloudStorageProfile(new NetworkCloudOSDisk(120L)
    {
        CreateOption = OSDiskCreateOption.Ephemeral,
        DeleteOption = OSDiskDeleteOption.Delete,
    })
    {
        VolumeAttachments = { new ResourceIdentifier("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName") },
    },
    "myacr.azurecr.io/foobar:latest")
{
    Identity = new ManagedServiceIdentity("UserAssigned")
    {
        UserAssignedIdentities =
        {
        [new ResourceIdentifier("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userIdentity1")] = new UserAssignedIdentity()
        },
    },
    BootMethod = VirtualMachineBootMethod.Uefi,
    NetworkAttachments = {new NetworkAttachment(new ResourceIdentifier("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName"), VirtualMachineIPAllocationMethod.Dynamic)
    {
    DefaultGateway = DefaultGateway.True,
    IPv4Address = "198.51.100.1",
    IPv6Address = "2001:0db8:0000:0000:0000:0000:0000:0000",
    NetworkAttachmentName = "netAttachName01",
    }},
    NetworkDataContent = "bmV0d29ya0RhdGVTYW1wbGU=",
    PlacementHints = { new VirtualMachinePlacementHint(VirtualMachinePlacementHintType.Affinity, new ResourceIdentifier("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName"), VirtualMachineSchedulingExecution.Hard, new VirtualMachinePlacementHintPodAffinityScope("")) },
    SshPublicKeys = { new NetworkCloudSshPublicKey("ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT/ojNZfpB3af/YDzwQCZgTcTRyNNhL4o/blKUmug0daSsSXISTRnIDpcf5qytjs1Xo+yYyJMvzLL59mhAyb3p/cD+Y3/s3WhAx+l0XOKpzXnblrv9d3q4c2tWmm/SyFqthaqd0= admin@vm") },
    UserDataContent = "dXNlckRhdGVTYW1wbGU=",
    VmDeviceModel = VirtualMachineDeviceModelType.T2,
    VmImageRepositoryCredentials = new ImageRepositoryCredentials("myacr.azurecr.io", "myuser")
    {
        Password = "{password}",
    },
    Tags =
    {
    ["key1"] = "myvalue1",
    ["key2"] = "myvalue2"
    },
};
ArmOperation<NetworkCloudVirtualMachineResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineName, data);
NetworkCloudVirtualMachineResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
NetworkCloudVirtualMachineData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample response

Status code:

200

{
  "extendedLocation": {
    "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/virtualMachines/virtualMachineName",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userIdentity1": {}
    }
  },
  "location": "location",
  "name": "virtualMachineName",
  "properties": {
    "adminUsername": "username",
    "availabilityZone": "1",
    "bareMetalMachineId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/bareMetalMachines/bareMetalMachineName",
    "bootMethod": "UEFI",
    "cloudServicesNetworkAttachment": {
      "attachedNetworkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName",
      "ipAllocationMethod": "Dynamic"
    },
    "clusterId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/clusters/clusterName",
    "consoleExtendedLocation": {
      "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/consoleCustomLocationName",
      "type": "CustomLocation"
    },
    "cpuCores": 2,
    "detailedStatus": "Available",
    "detailedStatusMessage": "VM is up and healthy",
    "memorySizeGB": 8,
    "networkAttachments": [
      {
        "attachedNetworkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName",
        "defaultGateway": "True",
        "ipAllocationMethod": "Dynamic",
        "ipv4Address": "198.51.100.1",
        "ipv6Address": "2001:0db8:0000:0000:0000:0000:0000:0000",
        "macAddress": "bf:1c:29:31:31:1f",
        "networkAttachmentName": "netAttachName01"
      }
    ],
    "placementHints": [
      {
        "hintType": "Affinity",
        "resourceId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName",
        "schedulingExecution": "Hard",
        "scope": ""
      }
    ],
    "powerState": "On",
    "provisioningState": "Succeeded",
    "sshPublicKeys": [
      {
        "keyData": "ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT/ojNZfpB3af/YDzwQCZgTcTRyNNhL4o/blKUmug0daSsSXISTRnIDpcf5qytjs1Xo+yYyJMvzLL59mhAyb3p/cD+Y3/s3WhAx+l0XOKpzXnblrv9d3q4c2tWmm/SyFqthaqd0= admin@vm"
      }
    ],
    "storageProfile": {
      "osDisk": {
        "createOption": "Ephemeral",
        "deleteOption": "Delete",
        "diskSizeGB": 120
      },
      "volumeAttachments": [
        "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName"
      ]
    },
    "vmDeviceModel": "T2",
    "vmImage": "myacr.azurecr.io/foobar:latest",
    "vmImageRepositoryCredentials": {
      "registryUrl": "myacr.azurecr.io",
      "username": "myuser"
    },
    "volumes": [
      "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName"
    ]
  },
  "systemData": {
    "createdAt": "2021-01-22T13:27:03.008Z",
    "createdBy": "identityA",
    "createdByType": "Application",
    "lastModifiedAt": "2021-01-22T13:29:03.001Z",
    "lastModifiedBy": "identityB",
    "lastModifiedByType": "User"
  },
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  },
  "type": "Microsoft.NetworkCloud/virtualMachines"
}

Status code:

201

Azure-AsyncOperation: https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/locations/location/operationStatuses/operationId?api-version=2025-09-01

{
  "extendedLocation": {
    "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/virtualMachines/virtualMachineName",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userIdentity1": {}
    }
  },
  "location": "location",
  "name": "virtualMachineName",
  "properties": {
    "adminUsername": "username",
    "availabilityZone": "1",
    "bareMetalMachineId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/bareMetalMachines/bareMetalMachineName",
    "bootMethod": "UEFI",
    "cloudServicesNetworkAttachment": {
      "attachedNetworkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName",
      "ipAllocationMethod": "Dynamic"
    },
    "clusterId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/clusters/clusterName",
    "consoleExtendedLocation": {
      "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/consoleCustomLocationName",
      "type": "CustomLocation"
    },
    "cpuCores": 2,
    "detailedStatus": "Available",
    "detailedStatusMessage": "VM is up and healthy",
    "memorySizeGB": 8,
    "networkAttachments": [
      {
        "attachedNetworkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName",
        "defaultGateway": "True",
        "ipAllocationMethod": "Dynamic",
        "ipv4Address": "198.51.100.1",
        "ipv6Address": "2001:0db8:0000:0000:0000:0000:0000:0000",
        "macAddress": "bf:1c:29:31:31:1f",
        "networkAttachmentName": "netAttachName01"
      }
    ],
    "placementHints": [
      {
        "hintType": "Affinity",
        "resourceId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName",
        "schedulingExecution": "Hard",
        "scope": ""
      }
    ],
    "powerState": "On",
    "provisioningState": "Accepted",
    "sshPublicKeys": [
      {
        "keyData": "ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT/ojNZfpB3af/YDzwQCZgTcTRyNNhL4o/blKUmug0daSsSXISTRnIDpcf5qytjs1Xo+yYyJMvzLL59mhAyb3p/cD+Y3/s3WhAx+l0XOKpzXnblrv9d3q4c2tWmm/SyFqthaqd0= admin@vm"
      }
    ],
    "storageProfile": {
      "osDisk": {
        "createOption": "Ephemeral",
        "deleteOption": "Delete",
        "diskSizeGB": 120
      },
      "volumeAttachments": [
        "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName"
      ]
    },
    "vmDeviceModel": "T2",
    "vmImage": "myacr.azurecr.io/foobar:latest",
    "vmImageRepositoryCredentials": {
      "registryUrl": "myacr.azurecr.io",
      "username": "myuser"
    },
    "volumes": [
      "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/volumes/volumeName"
    ]
  },
  "systemData": {
    "createdAt": "2021-01-22T13:27:03.008Z",
    "createdBy": "identityA",
    "createdByType": "Application",
    "lastModifiedAt": "2021-01-22T13:29:03.001Z",
    "lastModifiedBy": "identityB",
    "lastModifiedByType": "User"
  },
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  },
  "type": "Microsoft.NetworkCloud/virtualMachines"
}

Definitions

Name	Description
Azure.ResourceManager.CommonTypes.ExtendedLocation	The complex type of the extended location.
createdByType	The type of identity that created the resource.
DefaultGateway	The indicator of whether this is the default gateway. Only one of the attached networks (including the CloudServicesNetwork attachment) for a single machine may be specified as True.
ErrorAdditionalInfo	The resource management error additional info.
ErrorDetail	The error detail.
ErrorResponse	Error response
ExtendedLocationType	The type of the extended location.
ImageRepositoryCredentials	ImageRepositoryCredentials represents the credentials used to login to the image repository.
ManagedServiceIdentity	Managed service identity (system assigned and/or user assigned identities)
ManagedServiceIdentityType	Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
NetworkAttachment	NetworkAttachment represents the single network attachment.
OsDisk	OsDisk represents configuration of the boot disk.
OsDiskCreateOption	The strategy for creating the OS disk.
OsDiskDeleteOption	The strategy for deleting the OS disk.
SshPublicKey	SshPublicKey represents the public key used to authenticate with a resource through SSH.
StorageProfile	StorageProfile represents information about a disk.
systemData	Metadata pertaining to creation and last modification of the resource.
UserAssignedIdentity	User assigned identity properties
VirtualMachine	VirtualMachine represents the on-premises Network Cloud virtual machine.
VirtualMachineBootMethod	Selects the boot method for the virtual machine.
VirtualMachineDetailedStatus	The more detailed status of the virtual machine.
VirtualMachineDeviceModelType	The type of the device model to use.
VirtualMachineIPAllocationMethod	The IP allocation mechanism for the virtual machine. Dynamic and Static are only valid for l3Network which may also specify Disabled. Otherwise, Disabled is the only permitted value.
VirtualMachineIsolateEmulatorThread	Field Deprecated, the value will be ignored if provided. The indicator of whether one of the specified CPU cores is isolated to run the emulator thread for this virtual machine.
VirtualMachinePlacementHint	VirtualMachinePlacementHint represents a single scheduling hint of the virtual machine.
VirtualMachinePlacementHintPodAffinityScope	The scope for the virtual machine affinity or anti-affinity placement hint. It should always be "Machine" in the case of node affinity.
VirtualMachinePlacementHintType	The specification of whether this hint supports affinity or anti-affinity with the referenced resources.
VirtualMachinePowerState	The power state of the virtual machine.
VirtualMachineProvisioningState	The provisioning state of the virtual machine.
VirtualMachineSchedulingExecution	The indicator of whether the hint is a hard or soft requirement during scheduling.
VirtualMachineVirtioInterfaceType	Field Deprecated, use virtualizationModel instead. The type of the virtio interface.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Object

The complex type of the extended location.

Name	Type	Description
name	string	The name of the extended location.
type	ExtendedLocationType	The type of the extended location.

createdByType

Enumeration

The type of identity that created the resource.

Value	Description
User
Application
ManagedIdentity
Key

DefaultGateway

Enumeration

The indicator of whether this is the default gateway. Only one of the attached networks (including the CloudServicesNetwork attachment) for a single machine may be specified as True.

Value	Description
True	This is the default gateway.
False	This is not the default gateway.

ErrorAdditionalInfo

Object

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

ErrorDetail

Object

The error detail.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	ErrorDetail[]	The error details.
message	string	The error message.
target	string	The error target.

ErrorResponse

Object

Error response

Name	Type	Description
error	ErrorDetail	The error object.

ExtendedLocationType

Enumeration

The type of the extended location.

Value	Description
EdgeZone	Azure Edge Zones location type
CustomLocation	Azure Custom Locations type

ImageRepositoryCredentials

Object

ImageRepositoryCredentials represents the credentials used to login to the image repository.

Name	Type	Description
password	string (password) minLength: 1	The password or token used to access an image in the target repository.
registryUrl	string	The URL of the authentication server used to validate the repository credentials.
username	string minLength: 1	The username used to access an image in the target repository.

ManagedServiceIdentity

Object

Managed service identity (system assigned and/or user assigned identities)

Name	Type	Description
principalId	string (uuid)	The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
tenantId	string (uuid)	The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
type	ManagedServiceIdentityType	Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
userAssignedIdentities	<string,  UserAssignedIdentity>	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.

ManagedServiceIdentityType

Enumeration

Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).

Value	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

NetworkAttachment

Object

NetworkAttachment represents the single network attachment.

Name	Type	Description
attachedNetworkId	string (arm-id)	The resource ID of the associated network attached to the virtual machine. It can be one of cloudServicesNetwork, l3Network, l2Network or trunkedNetwork resources.
defaultGateway	DefaultGateway	The indicator of whether this is the default gateway. Only one of the attached networks (including the CloudServicesNetwork attachment) for a single machine may be specified as True.
ipAllocationMethod	VirtualMachineIPAllocationMethod	The IP allocation mechanism for the virtual machine. Dynamic and Static are only valid for l3Network which may also specify Disabled. Otherwise, Disabled is the only permitted value.
ipv4Address	string	The IPv4 address of the virtual machine. This field is used only if the attached network has IPAllocationType of IPV4 or DualStack. If IPAllocationMethod is: Static - this field must contain a user specified IPv4 address from within the subnet specified in the attached network. Dynamic - this field is read-only, but will be populated with an address from within the subnet specified in the attached network. Disabled - this field will be empty.
ipv6Address	string	The IPv6 address of the virtual machine. This field is used only if the attached network has IPAllocationType of IPV6 or DualStack. If IPAllocationMethod is: Static - this field must contain an IPv6 address range from within the range specified in the attached network. Dynamic - this field is read-only, but will be populated with an range from within the subnet specified in the attached network. Disabled - this field will be empty.
macAddress	string	The MAC address of the interface for the virtual machine that corresponds to this network attachment.
networkAttachmentName	string maxLength: 15	The associated network's interface name. If specified, the network attachment name has a maximum length of 15 characters and must be unique to this virtual machine. If the user doesn’t specify this value, the default interface name of the network resource will be used. For a CloudServicesNetwork resource, this name will be ignored.

OsDisk

Object

OsDisk represents configuration of the boot disk.

Name	Type	Default value	Description
createOption	OsDiskCreateOption	Ephemeral	The strategy for creating the OS disk.
deleteOption	OsDiskDeleteOption	Delete	The strategy for deleting the OS disk.
diskSizeGB	integer (int64)		The size of the disk. Required if the createOption is Ephemeral. Allocations are measured in gibibytes.

OsDiskCreateOption

Enumeration

The strategy for creating the OS disk.

Value	Description
Ephemeral	The Os Disk will be created on ephemeral storage.
Persistent	The Os Disk is on persistent storage.

OsDiskDeleteOption

Enumeration

The strategy for deleting the OS disk.

Value	Description
Delete	The Os Disk will be deleted when the virtual machine is deleted.

SshPublicKey

Object

SshPublicKey represents the public key used to authenticate with a resource through SSH.

Name	Type	Description
keyData	string minLength: 1	The SSH public key data.

StorageProfile

Object

StorageProfile represents information about a disk.

Name	Type	Description
osDisk	OsDisk	The disk to use with this virtual machine.
volumeAttachments	string[]	The resource IDs of volumes that are requested to be attached to the virtual machine.

systemData

Object

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string (date-time)	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string (date-time)	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.

UserAssignedIdentity

Object

User assigned identity properties

Name	Type	Description
clientId	string (uuid)	The client ID of the assigned identity.
principalId	string (uuid)	The principal ID of the assigned identity.

VirtualMachine

Object

VirtualMachine represents the on-premises Network Cloud virtual machine.

Name	Type	Default value	Description
etag	string		"If etag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.")
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation		The extended location of the resource. This property is required when creating the resource.
id	string (arm-id)		Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity		The managed service identities assigned to this resource.
location	string		The geo-location where the resource lives
name	string		The name of the resource
properties.adminUsername	string minLength: 1 maxLength: 32 pattern: ^[a-z_][a-z0-9_]{0,31}$		The name of the administrator to which the ssh public keys will be added into the authorized keys.
properties.availabilityZone	string		The cluster availability zone containing this virtual machine.
properties.bareMetalMachineId	string (arm-id)		The resource ID of the bare metal machine that hosts the virtual machine.
properties.bootMethod	VirtualMachineBootMethod	UEFI	Selects the boot method for the virtual machine.
properties.cloudServicesNetworkAttachment	NetworkAttachment		The cloud service network that provides platform-level services for the virtual machine.
properties.clusterId	string (arm-id)		The resource ID of the cluster the virtual machine is created for.
properties.consoleExtendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation		The extended location to use for creation of a VM console resource.
properties.cpuCores	integer (int64) minimum: 2		The number of CPU cores in the virtual machine.
properties.detailedStatus	VirtualMachineDetailedStatus		The more detailed status of the virtual machine.
properties.detailedStatusMessage	string		The descriptive message about the current detailed status.
properties.isolateEmulatorThread	VirtualMachineIsolateEmulatorThread	True	Field Deprecated, the value will be ignored if provided. The indicator of whether one of the specified CPU cores is isolated to run the emulator thread for this virtual machine.
properties.memorySizeGB	integer (int64) minimum: 1		The memory size of the virtual machine. Allocations are measured in gibibytes.
properties.networkAttachments	NetworkAttachment[]		The list of network attachments to the virtual machine.
properties.networkData	string		Field Deprecated: The Base64 encoded cloud-init network data. The networkDataContent property will be used in preference to this property.
properties.networkDataContent	string (password)		The Base64 encoded cloud-init network data.
properties.placementHints	VirtualMachinePlacementHint[]		The scheduling hints for the virtual machine.
properties.powerState	VirtualMachinePowerState		The power state of the virtual machine.
properties.provisioningState	VirtualMachineProvisioningState		The provisioning state of the virtual machine.
properties.sshPublicKeys	SshPublicKey[]		The list of ssh public keys. Each key will be added to the virtual machine using the cloud-init ssh_authorized_keys mechanism for the adminUsername.
properties.storageProfile	StorageProfile		The storage profile that specifies size and other parameters about the disks related to the virtual machine.
properties.userData	string		Field Deprecated: The Base64 encoded cloud-init user data. The userDataContent property will be used in preference to this property.
properties.userDataContent	string (password)		The Base64 encoded cloud-init user data.
properties.virtioInterface	VirtualMachineVirtioInterfaceType	Modern	Field Deprecated, use virtualizationModel instead. The type of the virtio interface.
properties.vmDeviceModel	VirtualMachineDeviceModelType	T2	The type of the device model to use.
properties.vmImage	string		The virtual machine image that is currently provisioned to the OS disk, using the full url and tag notation used to pull the image.
properties.vmImageRepositoryCredentials	ImageRepositoryCredentials		The credentials used to login to the image repository that has access to the specified image.
properties.volumes	string[]		The resource IDs of volumes that are attached to the virtual machine.
systemData	systemData		Azure Resource Manager metadata containing createdBy and modifiedBy information.
tags	object		Resource tags.
type	string		The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

VirtualMachineBootMethod

Enumeration

Selects the boot method for the virtual machine.

Value	Description
BIOS	BIOS boot mode.
UEFI	UEFI boot mode.

VirtualMachineDetailedStatus

Enumeration

The more detailed status of the virtual machine.

Value	Description
Available	The Available status.
Error	The Error status.
Provisioning	The Provisioning status.
Running	The Running status.
Scheduling	The Scheduling status.
Stopped	The Stopped status.
Terminating	The Terminating status.
Unknown	The Unknown status.

VirtualMachineDeviceModelType

Enumeration

The type of the device model to use.

Value	Description
T1	The T1 device model.
T2	The T2 device model.
T3	The T3 device model.

VirtualMachineIPAllocationMethod

Enumeration

The IP allocation mechanism for the virtual machine. Dynamic and Static are only valid for l3Network which may also specify Disabled. Otherwise, Disabled is the only permitted value.

Value	Description
Dynamic	Dynamic VM IP allocation.
Static	Static VM IP allocation.
Disabled	No VM IP allocation.

VirtualMachineIsolateEmulatorThread

Enumeration

Field Deprecated, the value will be ignored if provided. The indicator of whether one of the specified CPU cores is isolated to run the emulator thread for this virtual machine.

Value	Description
False	Do not isolate the emulator thread.
True	Isolate the emulator thread.

VirtualMachinePlacementHint

Object

VirtualMachinePlacementHint represents a single scheduling hint of the virtual machine.

Name	Type	Description
hintType	VirtualMachinePlacementHintType	The specification of whether this hint supports affinity or anti-affinity with the referenced resources.
resourceId	string (arm-id)	The resource ID of the target object that the placement hints will be checked against, e.g., the bare metal node to host the virtual machine.
schedulingExecution	VirtualMachineSchedulingExecution	The indicator of whether the hint is a hard or soft requirement during scheduling.
scope	VirtualMachinePlacementHintPodAffinityScope	The scope for the virtual machine affinity or anti-affinity placement hint. It should always be "Machine" in the case of node affinity.

VirtualMachinePlacementHintPodAffinityScope

Enumeration

The scope for the virtual machine affinity or anti-affinity placement hint. It should always be "Machine" in the case of node affinity.

Value	Description
Machine	The virtual machine placement hint is scoped to the bare metal machine.
Rack	The virtual machine placement hint is scoped to the rack.

VirtualMachinePlacementHintType

Enumeration

The specification of whether this hint supports affinity or anti-affinity with the referenced resources.

Value	Description
Affinity	The virtual machine has affinity with the referenced resources.
AntiAffinity	The virtual machine has anti-affinity with the referenced resources.

VirtualMachinePowerState

Enumeration

The power state of the virtual machine.

Value	Description
Off	The virtual machine is powered off.
On	The virtual machine is powered on.
Unknown	The virtual machine power state is unknown.

VirtualMachineProvisioningState

Enumeration

The provisioning state of the virtual machine.

Value	Description
Accepted	The Accepted status.
Canceled	The Canceled status.
Failed	The Failed status.
Provisioning	The Provisioning status.
Succeeded	The Succeeded status.

VirtualMachineSchedulingExecution

Enumeration

The indicator of whether the hint is a hard or soft requirement during scheduling.

Value	Description
Hard	The hint is a requirement during scheduling.
Soft	The hint is applied using a best-effort approach during scheduling.

VirtualMachineVirtioInterfaceType

Enumeration

Field Deprecated, use virtualizationModel instead. The type of the virtio interface.

Value	Description
Modern	Modern virtio interface.
Transitional	Transitional virtio interface.