Virtual Machine Scale Sets - Create Or Update

Služba:: Compute

Verze rozhraní API:: 2025-11-01

Vytvoření nebo aktualizace škálovací sady virtuálních počítačů

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}?api-version=2025-11-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
vmScaleSetName	path	True	string	Název škálovací sady virtuálních počítačů
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
If-Match		string	Značky ETag transformace. Tuto hodnotu vynecháte, pokud chcete aktuální prostředek vždy přepsat. Zadejte naposledy zobrazenou hodnotu značky ETag, abyste zabránili náhodnému přepsání souběžných změn.
If-None-Match		string	Pokud chcete povolit vytvoření nové sady záznamů, nastavte na *, ale chcete-li zabránit aktualizaci existující sady záznamů. Jiné hodnoty budou mít za následek chybu ze serveru, protože nejsou podporované.

Text požadavku

Name	Vyžadováno	Typ	Description
location	True	string	Geografické umístění, ve kterém se nachází zdroj
extendedLocation		ExtendedLocation	Rozšířené umístění škálovací sady virtuálních počítačů.
identity		VirtualMachineScaleSetIdentity	Identita škálovací sady virtuálních počítačů, pokud je nakonfigurovaná.
placement		Placement	Část Umístění určuje uživatelem definovaná omezení pro umístění hardwaru škálovací sady virtuálních počítačů. Minimální verze API: 2025-04-01.
plan		Plan	Určuje informace o imagi marketplace použité k vytvoření virtuálního počítače. Tento prvek se používá jenom pro image z marketplace. Než budete moct použít image z marketplace z rozhraní API, musíte image povolit pro programové použití. Na webu Azure Portal vyhledejte image marketplace, kterou chcete použít, a potom klikněte na Chcete nasadit programově, začněte –>. Zadejte požadované informace a klikněte na Uložit.
properties.additionalCapabilities		AdditionalCapabilities	Určuje další možnosti povolené nebo zakázané na virtuálních počítačích ve škálovací sadě virtuálních počítačů. Například: jestli mají virtuální počítače možnost podporovat připojení spravovaných datových disků s typem účtu úložiště UltraSSD_LRS.
properties.automaticRepairsPolicy		AutomaticRepairsPolicy	Zásady pro automatické opravy
properties.constrainedMaximumCapacity		boolean	Volitelná vlastnost, která musí být buď nastavena na Hodnotu True, nebo vynechána.
properties.doNotRunExtensionsOnOverprovisionedVMs		boolean	Pokud je povolené nadměrné zřízení, rozšíření se spustí jenom na požadovaném počtu virtuálních počítačů, které se nakonec uchovávají. Tato vlastnost proto zajistí, že se rozšíření nespustí na nadbytečných nadsaděných virtuálních počítačích.
properties.externalHealthPolicy		ExternalHealthPolicy	Specifikuje externí zdravotní politiku pro škálovací sadu virtuálních strojů.
properties.highSpeedInterconnectPlacement		HighSpeedInterconnectPlacement	Určuje umístění vysokorychlostního propojení pro škálovací sadu virtuálních počítačů.
properties.hostGroup		SubResource	Určuje informace o vyhrazené skupině hostitelů, ve které se nachází škálovací sada virtuálních počítačů. Minimální verze api: 2020-06-01.
properties.lifecycleHooksProfile		LifecycleHooksProfile	Specifikuje profil hooků životního cyklu pro škálovací sadu virtuálních strojů.
properties.orchestrationMode		OrchestrationMode	Určuje režim orchestrace pro škálovací sadu virtuálních počítačů.
properties.overprovision		boolean	Určuje, jestli má být škálovací sada virtuálních počítačů nadměrně zřízená.
properties.platformFaultDomainCount		integer (int32)	Počet domén selhání pro každou skupinu umístění
properties.priorityMixPolicy		PriorityMixPolicy	Určuje požadované cíle pro kombinování spotových a běžných virtuálních počítačů s prioritou ve stejné instanci VMSS Flex.
properties.proximityPlacementGroup		SubResource	Určuje informace o skupině umístění bezkontaktní komunikace, ke které by měla být přiřazena škálovací sada virtuálních počítačů. Minimální verze api: 2018-04-01.
properties.resiliencyPolicy		ResiliencyPolicy	Zásady odolnosti
properties.scaleInPolicy		ScaleInPolicy	Určuje zásady použité při škálování virtuálních počítačů ve škálovací sadě virtuálních počítačů.
properties.scheduledEventsPolicy		ScheduledEventsPolicy	Zásada ScheduledEvents.
properties.singlePlacementGroup		boolean	Pokud je pravda, omezuje škálovací sadu na jednu skupinu umístění, maximální velikost 100 virtuálních počítačů. POZNÁMKA: Pokud je singlePlacementGroup true, může být změněn na false. Pokud je však singlePlacementGroup false, nemusí být změněn na hodnotu true.
properties.skuProfile		SkuProfile	Určuje profil skladové položky pro škálovací sadu virtuálních počítačů.
properties.spotRestorePolicy		SpotRestorePolicy	Určuje vlastnosti spotového obnovení pro škálovací sadu virtuálních počítačů.
properties.upgradePolicy		UpgradePolicy	Zásady upgradu.
properties.virtualMachineProfile		VirtualMachineScaleSetVMProfile	Profil virtuálního počítače.
properties.zonalPlatformFaultDomainAlignMode		ZonalPlatformFaultDomainAlignMode	Určuje režim zarovnání mezi výpočetní sadou virtuálních počítačů a počtem domén selhání úložiště.
properties.zoneBalance		boolean	Jestli chcete vynutit výhradně i distribuci virtuálních počítačů mezi x zónami v případě výpadku zóny. Vlastnost zoneBalance lze nastavit pouze v případě, že vlastnost zóny škálovací sady obsahuje více než jednu zónu. Pokud nejsou zadány žádné zóny nebo pouze jedna zóna, vlastnost zoneBalance by neměla být nastavena.
sku		Sku	Skladová položka škálovací sady virtuálních počítačů.
tags		object	Značky prostředků
zones		string[]	Zóny dostupnosti.

Odpovědi

Name	Typ	Description
200 OK	VirtualMachineScaleSet	Operace aktualizace prostředku VirtualMachineScaleSet byla úspěšná
201 Created	VirtualMachineScaleSet	Operace vytvoření prostředku VirtualMachineScaleSet byla úspěšná Hlavičky Location: string Retry-After: integer
Other Status Codes	CloudError	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

VirtualMachineScaleSet

Operace aktualizace prostředku VirtualMachineScaleSet byla úspěšná

201 Created

VirtualMachineScaleSet

Operace vytvoření prostředku VirtualMachineScaleSet byla úspěšná

Hlavičky

Location: string
Retry-After: integer

Other Status Codes

CloudError

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Create a custom-image scale set from an unmanaged generalized os image.

Create a platform-image scale set with unmanaged os disks.

Create a scale set containing disks with storage fault domain alignment.

Create a scale set from a custom image.

Create a scale set from a generalized shared image.

Create a scale set from a specialized shared image.

Create a scale set where nic config has DisableTcpStateTracking property

Create a scale set with a marketplace image plan.

Create a scale set with an azure application gateway.

Create a scale set with an azure load balancer.

Create a scale set with Application Profile

Create a scale set with automatic repairs enabled

Create a scale set with Automatic Zone Rebalancing enabled

Create a scale set with boot diagnostics.

Create a scale set with Disk Controller Type

Create a scale set with DiskEncryptionSet resource in os disk and data disk.

Create a scale set with empty data disks on each vm.

Create a scale set with ephemeral os disk provisioning in Nvme disk using placement property.

Create a scale set with ephemeral os disks using placement property and enableFullCaching set to true.

Create a scale set with ephemeral os disks using placement property.

Create a scale set with ephemeral os disks.

Create a scale set with extension time budget.

Create a scale set with external health policy enabled

Create a scale set with Fpga Network Interfaces.

Create a scale set with Host Encryption using encryptionAtHost property.

Create a scale set with managed boot diagnostics.

Create a scale set with Max Instance Percent Per Zone Policy enabled

Create a scale set with Network Interfaces with public ip address dns settings.

Create a scale set with OperationRecoverySettings enabled

Create a scale set with OS image scheduled events enabled.

Create a scale set with password authentication.

Create a scale set with placement policy 'Auto'

Create a scale set with premium storage.

Create a scale set with priority mix policy

Create a scale set with ProxyAgent Settings of enabled and mode.

Create a scale set with Resilient VM Creation enabled

Create a scale set with Resilient VM Deletion enabled

Create a scale set with scaleInPolicy.

Create a scale set with Security Posture Reference

Create a scale set with SecurityType as ConfidentialVM

Create a scale set with SecurityType as ConfidentialVM and NonPersistedTPM securityEncryptionType

Create a scale set with Service Artifact Reference

Create a scale set with sku profile

Create a scale set with sku profile and prioritized allocation strategy

Create a scale set with spot restore policy

Create a scale set with ssh authentication.

Create a scale set with terminate scheduled events enabled.

Create a scale set with Uefi Settings of secureBoot and vTPM.

Create a scale set with userData.

Create a scale set with virtual machines in different zones.

Create a scale set with vm size properties

Create a scale set with zonalPlatformFaultDomainAlignMode as Aligned

Create a virtual machine scale set with high-speed interconnect placement.

Create a virtual machine scale set with LifecycleHooksProfile.

Create a VMSS with an extension that has suppressFailures enabled

Create a VMSS with an extension with protectedSettingsFromKeyVault

Create a zones-auto scale set with Max Zone Count

Create or update a scale set with capacity reservation.

Create a custom-image scale set from an unmanaged generalized os image.

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "osDisk": {
          "caching": "ReadWrite",
          "image": {
            "uri": "http://{existing-storage-account-name}.blob.core.windows.net/{existing-container-name}/{existing-generalized-os-image-blob-name}.vhd"
          },
          "createOption": "FromImage",
          "name": "osDisk"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_CustomImageFromAnUnmanagedGeneralizedOsImage.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Name = "osDisk",
                    Caching = CachingType.ReadWrite,
                    ImageUri = new Uri("http://{existing-storage-account-name}.blob.core.windows.net/{existing-container-name}/{existing-generalized-os-image-blob-name}.vhd"),
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d6e9ab29-f8c9-4792-978c-ae2c07b98f17",
    "virtualMachineProfile": {
      "storageProfile": {
        "osDisk": {
          "osType": "Windows",
          "caching": "ReadWrite",
          "image": {
            "uri": "https://{existing-storage-account-name}.blob.core.windows.net/system/Microsoft.Compute/Images/vhds/{existing-generalized-os-image-blob-name}.vhd"
          },
          "createOption": "FromImage",
          "name": "osDisk"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d6e9ab29-f8c9-4792-978c-ae2c07b98f17",
    "virtualMachineProfile": {
      "storageProfile": {
        "osDisk": {
          "osType": "Windows",
          "caching": "ReadWrite",
          "image": {
            "uri": "https://{existing-storage-account-name}.blob.core.windows.net/system/Microsoft.Compute/Images/vhds/{existing-generalized-os-image-blob-name}.vhd"
          },
          "createOption": "FromImage",
          "name": "osDisk"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a platform-image scale set with unmanaged os disks.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "createOption": "FromImage",
          "name": "osDisk",
          "vhdContainers": [
            "http://{existing-storage-account-name-0}.blob.core.windows.net/vhdContainer",
            "http://{existing-storage-account-name-1}.blob.core.windows.net/vhdContainer",
            "http://{existing-storage-account-name-2}.blob.core.windows.net/vhdContainer",
            "http://{existing-storage-account-name-3}.blob.core.windows.net/vhdContainer",
            "http://{existing-storage-account-name-4}.blob.core.windows.net/vhdContainer"
          ]
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_PlatformImageWithUnmanagedOsDisks.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Name = "osDisk",
                    Caching = CachingType.ReadWrite,
                    VhdContainers = { "http://{existing-storage-account-name-0}.blob.core.windows.net/vhdContainer", "http://{existing-storage-account-name-1}.blob.core.windows.net/vhdContainer", "http://{existing-storage-account-name-2}.blob.core.windows.net/vhdContainer", "http://{existing-storage-account-name-3}.blob.core.windows.net/vhdContainer", "http://{existing-storage-account-name-4}.blob.core.windows.net/vhdContainer" },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "77b7df9a-32fe-45e3-8911-60ac9c9b9c64",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "vhdContainers": [
            "http://{existing-storage-account-name}.blob.core.windows.net/vhds"
          ],
          "name": "osDisk",
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "77b7df9a-32fe-45e3-8911-60ac9c9b9c64",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "vhdContainers": [
            "http://{existing-storage-account-name}.blob.core.windows.net/vhds"
          ],
          "name": "osDisk",
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set containing disks with storage fault domain alignment.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage",
          "storageFaultDomainAlignment": "BestEffortAligned"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      }
    },
    "zonalPlatformFaultDomainAlignMode": "Aligned"
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithStorageFaultDomainAlignment.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        ScheduledEventsPolicy = new ScheduledEventsPolicy
        {
            UserInitiatedRedeploy = new UserInitiatedRedeploy
            {
                AutomaticallyApprove = true,
            },
            AutomaticallyApprove = true,
            ScheduledEventsAdditionalPublishingTargetsEventGridAndResourceGraph = new EventGridAndResourceGraph
            {
                IsEnabled = true,
            },
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    StorageFaultDomainAlignment = StorageFaultDomainAlignmentType.BestEffortAligned,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
        ZonalPlatformFaultDomainAlignMode = ZonalPlatformFaultDomainAlignMode.Aligned,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "storageFaultDomainAlignment": "BestEffortAligned",
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      }
    },
    "provisioningState": "Creating",
    "zonalPlatformFaultDomainAlignMode": "Aligned"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "storageFaultDomainAlignment": "BestEffortAligned",
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      }
    },
    "provisioningState": "Creating",
    "zonalPlatformFaultDomainAlignMode": "Aligned"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set from a custom image.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/{existing-custom-image-name}"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_FromACustomImage.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/{existing-custom-image-name}"),
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/nsgcustom"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/nsgcustom"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set from a generalized shared image.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/mySharedGallery/images/mySharedImage"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_FromAGeneralizedSharedImage.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/mySharedGallery/images/mySharedImage"),
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/mySharedGallery/images/mySharedImage"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/mySharedGallery/images/mySharedImage"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set from a specialized shared image.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/mySharedGallery/images/mySharedImage"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_FromASpecializedSharedImage.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/mySharedGallery/images/mySharedImage"),
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/mySharedGallery/images/mySharedImage"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/mySharedGallery/images/mySharedImage"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set where nic config has DisableTcpStateTracking property

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/{existing-custom-image-name}"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{nicConfig1-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "disableTcpStateTracking": true,
              "enableAcceleratedNetworking": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          },
          {
            "name": "{nicConfig2-name}",
            "properties": {
              "primary": false,
              "enableAcceleratedNetworking": false,
              "enableIPForwarding": false,
              "disableTcpStateTracking": false,
              "ipConfigurations": [
                {
                  "name": "{nicConfig2-name}",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name2}"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_FromWithDisableTcpStateTrackingNetworkInterface.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/{existing-custom-image-name}"),
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{nicConfig1-name}")
                {
                Primary = true,
                EnableAcceleratedNetworking = true,
                IsTcpStateTrackingDisabled = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }, new VirtualMachineScaleSetNetworkConfiguration("{nicConfig2-name}")
                {
                Primary = false,
                EnableAcceleratedNetworking = false,
                IsTcpStateTrackingDisabled = false,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{nicConfig2-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name2}"),
                Primary = true,
                PrivateIPAddressVersion = IPVersion.IPv4,
                }},
                EnableIPForwarding = false,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/nsgcustom"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{nicConfig1-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "disableTcpStateTracking": true,
              "ipConfigurations": [
                {
                  "name": "{nicConfig1-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": true
            }
          },
          {
            "name": "{nicConfig2-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": false,
              "enableFpga": false,
              "disableTcpStateTracking": false,
              "ipConfigurations": [
                {
                  "name": "{nicConfig2-name}",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name2}"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/nsgcustom"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{nicConfig1-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "disableTcpStateTracking": true,
              "ipConfigurations": [
                {
                  "name": "{nicConfig1-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": true
            }
          },
          {
            "name": "{nicConfig2-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": false,
              "enableFpga": false,
              "disableTcpStateTracking": false,
              "ipConfigurations": [
                {
                  "name": "{nicConfig2-name}",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name2}"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with a marketplace image plan.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows2016",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "windows-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "plan": {
    "publisher": "microsoft-ads",
    "product": "windows-data-science-vm",
    "name": "windows2016"
  },
  "location": "westus"
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithAMarketplaceImagePlan.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Plan = new ComputePlan
    {
        Name = "windows2016",
        Publisher = "microsoft-ads",
        Product = "windows-data-science-vm",
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "microsoft-ads",
                    Offer = "windows-data-science-vm",
                    Sku = "windows2016",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Create a scale set with an azure application gateway.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "applicationGatewayBackendAddressPools": [
                      {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/applicationGateways/{existing-application-gateway-name}/backendAddressPools/{existing-backend-address-pool-name}"
                      }
                    ],
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithAzureApplicationGateway.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                ApplicationGatewayBackendAddressPools = {new WritableSubResource
                {
                Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/applicationGateways/{existing-application-gateway-name}/backendAddressPools/{existing-backend-address-pool-name}"),
                }},
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "a0134477-b9d9-484b-b0e3-205c1c089ffa",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "applicationGatewayBackendAddressPools": [
                      {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/applicationGateways/nsgExistingAppGw/backendAddressPools/appGatewayBackendPool"
                      }
                    ],
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "a0134477-b9d9-484b-b0e3-205c1c089ffa",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "applicationGatewayBackendAddressPools": [
                      {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/applicationGateways/nsgExistingAppGw/backendAddressPools/appGatewayBackendPool"
                      }
                    ],
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with an azure load balancer.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    },
                    "publicIPAddressConfiguration": {
                      "name": "{vmss-name}",
                      "properties": {
                        "publicIPAddressVersion": "IPv4"
                      }
                    },
                    "loadBalancerInboundNatPools": [
                      {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/{existing-load-balancer-name}/inboundNatPools/{existing-nat-pool-name}"
                      }
                    ],
                    "loadBalancerBackendAddressPools": [
                      {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/{existing-load-balancer-name}/backendAddressPools/{existing-backend-address-pool-name}"
                      }
                    ]
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithAzureLoadBalancer.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                PublicIPAddressConfiguration = new VirtualMachineScaleSetPublicIPAddressConfiguration("{vmss-name}")
                {
                PublicIPAddressVersion = IPVersion.IPv4,
                },
                LoadBalancerBackendAddressPools = {new WritableSubResource
                {
                Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/{existing-load-balancer-name}/backendAddressPools/{existing-backend-address-pool-name}"),
                }},
                LoadBalancerInboundNatPools = {new WritableSubResource
                {
                Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/{existing-load-balancer-name}/inboundNatPools/{existing-nat-pool-name}"),
                }},
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "ec0b21ca-51ec-414b-9323-f236ffc21479",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "loadBalancerInboundNatPools": [
                      {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/myLb/inboundNatPools/lbNatPool"
                      }
                    ],
                    "loadBalancerBackendAddressPools": [
                      {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/myLb/backendAddressPools/lbBackendPool"
                      }
                    ],
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "ec0b21ca-51ec-414b-9323-f236ffc21479",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "loadBalancerInboundNatPools": [
                      {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/myLb/inboundNatPools/lbNatPool"
                      }
                    ],
                    "loadBalancerBackendAddressPools": [
                      {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/myLb/backendAddressPools/lbBackendPool"
                      }
                    ],
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with Application Profile

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "applicationProfile": {
        "galleryApplications": [
          {
            "tags": "myTag1",
            "order": 1,
            "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0",
            "configurationReference": "https://mystorageaccount.blob.core.windows.net/configurations/settings.config",
            "treatFailureAsDeploymentFailure": true,
            "enableAutomaticUpgrade": false
          },
          {
            "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithApplicationProfile.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            GalleryApplications = {new VirtualMachineGalleryApplication("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0")
            {
            Tags = "myTag1",
            Order = 1,
            ConfigurationReference = "https://mystorageaccount.blob.core.windows.net/configurations/settings.config",
            TreatFailureAsDeploymentFailure = true,
            EnableAutomaticUpgrade = false,
            }, new VirtualMachineGalleryApplication("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1")},
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "ffb27c5c-39a5-4d4e-b307-b32598689813",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "applicationProfile": {
        "galleryApplications": [
          {
            "tags": "myTag1",
            "order": 1,
            "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0",
            "configurationReference": "https://mystorageaccount.blob.core.windows.net/configurations/settings.config"
          },
          {
            "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "ffb27c5c-39a5-4d4e-b307-b32598689813",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "applicationProfile": {
        "galleryApplications": [
          {
            "tags": "myTag1",
            "order": 1,
            "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0",
            "configurationReference": "https://mystorageaccount.blob.core.windows.net/configurations/settings.config"
          },
          {
            "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with automatic repairs enabled

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true,
          "scheduledEventsApiVersion": "2020-07-01"
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      },
      "allInstancesDown": {
        "automaticallyApprove": true
      }
    },
    "automaticRepairsPolicy": {
      "enabled": true,
      "gracePeriod": "PT10M"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithAutomaticRepairs.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        ScheduledEventsPolicy = new ScheduledEventsPolicy
        {
            UserInitiatedRedeploy = new UserInitiatedRedeploy
            {
                AutomaticallyApprove = true,
            },
            AutomaticallyApprove = true,
            ScheduledEventsAdditionalPublishingTargetsEventGridAndResourceGraph = new EventGridAndResourceGraph
            {
                IsEnabled = true,
                ScheduledEventsApiVersion = "2020-07-01",
            },
            AllInstancesDown = new AllInstancesDown
            {
                AutomaticallyApprove = true,
            },
        },
        AutomaticRepairsPolicy = new AutomaticRepairsPolicy
        {
            Enabled = true,
            GracePeriod = "PT10M",
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true,
          "scheduledEventsApiVersion": "2020-07-01"
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      },
      "allInstancesDown": {
        "automaticallyApprove": true
      }
    },
    "automaticRepairsPolicy": {
      "enabled": true,
      "gracePeriod": "PT10M"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true,
          "scheduledEventsApiVersion": "2020-07-01"
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      },
      "allInstancesDown": {
        "automaticallyApprove": true
      }
    },
    "automaticRepairsPolicy": {
      "enabled": true,
      "gracePeriod": "PT10M"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with Automatic Zone Rebalancing enabled

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": false,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "automaticZoneRebalancingPolicy": {
        "enabled": true,
        "rebalanceStrategy": "Recreate",
        "rebalanceBehavior": "CreateBeforeDelete"
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithAutomaticZoneRebalancingPolicy.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = false,
        ResiliencyPolicy = new ResiliencyPolicy
        {
            AutomaticZoneRebalancingPolicy = new AutomaticZoneRebalancingPolicy
            {
                Enabled = true,
                RebalanceStrategy = VmssRebalanceStrategy.Recreate,
                RebalanceBehavior = VmssRebalanceBehavior.CreateBeforeDelete,
            },
        },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "automaticZoneRebalancingPolicy": {
        "enabled": true,
        "rebalanceStrategy": "Recreate",
        "rebalanceBehavior": "CreateBeforeDelete"
      }
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "automaticZoneRebalancingPolicy": {
        "enabled": true,
        "rebalanceStrategy": "Recreate",
        "rebalanceBehavior": "CreateBeforeDelete"
      }
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with boot diagnostics.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://{existing-storage-account-name}.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithBootDiagnostics.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            BootDiagnostics = new BootDiagnostics
            {
                Enabled = true,
                StorageUri = new Uri("http://{existing-storage-account-name}.blob.core.windows.net"),
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with Disk Controller Type

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true,
          "scheduledEventsApiVersion": "2020-07-01"
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      },
      "allInstancesDown": {
        "automaticallyApprove": true
      }
    },
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        },
        "diskControllerType": "NVMe"
      },
      "userData": "RXhhbXBsZSBVc2VyRGF0YQ==",
      "hardwareProfile": {
        "vmSizeProperties": {
          "vCPUsAvailable": 1,
          "vCPUsPerCore": 1
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithDiskControllerType.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        ScheduledEventsPolicy = new ScheduledEventsPolicy
        {
            UserInitiatedRedeploy = new UserInitiatedRedeploy
            {
                AutomaticallyApprove = true,
            },
            AutomaticallyApprove = true,
            ScheduledEventsAdditionalPublishingTargetsEventGridAndResourceGraph = new EventGridAndResourceGraph
            {
                IsEnabled = true,
                ScheduledEventsApiVersion = "2020-07-01",
            },
            AllInstancesDown = new AllInstancesDown
            {
                AutomaticallyApprove = true,
            },
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
                DiskControllerType = "NVMe",
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            UserData = "RXhhbXBsZSBVc2VyRGF0YQ==",
            HardwareVmSizeProperties = new VirtualMachineSizeProperties
            {
                VCpusAvailable = 1,
                VCpusPerCore = 1,
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        },
        "diskControllerType": "NVMe"
      },
      "hardwareProfile": {
        "vmSizeProperties": {
          "vCPUsAvailable": 1,
          "vCPUsPerCore": 1
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true,
          "scheduledEventsApiVersion": "2020-07-01"
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      },
      "allInstancesDown": {
        "automaticallyApprove": true
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        },
        "diskControllerType": "SCSI"
      },
      "hardwareProfile": {
        "vmSizeProperties": {
          "vCPUsAvailable": 1,
          "vCPUsPerCore": 1
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true,
          "scheduledEventsApiVersion": "2020-07-01"
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      },
      "allInstancesDown": {
        "automaticallyApprove": true
      }
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with DiskEncryptionSet resource in os disk and data disk.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/{existing-custom-image-name}"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS",
            "diskEncryptionSet": {
              "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
            }
          },
          "createOption": "FromImage"
        },
        "dataDisks": [
          {
            "caching": "ReadWrite",
            "managedDisk": {
              "storageAccountType": "Standard_LRS",
              "diskEncryptionSet": {
                "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
              }
            },
            "diskSizeGB": 1023,
            "createOption": "Empty",
            "lun": 0
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "location": "westus"
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithDiskEncryptionSetResource.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_DS1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/{existing-custom-image-name}"),
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                        DiskEncryptionSetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
                    },
                },
                DataDisks = {new VirtualMachineScaleSetDataDisk(0, DiskCreateOptionType.Empty)
                {
                Caching = CachingType.ReadWrite,
                DiskSizeGB = 1023,
                ManagedDisk = new VirtualMachineScaleSetManagedDisk
                {
                StorageAccountType = StorageAccountType.StandardLrs,
                DiskEncryptionSetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
                },
                }},
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/nsgcustom"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS",
            "diskEncryptionSet": {
              "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
            }
          },
          "createOption": "FromImage"
        },
        "dataDisks": [
          {
            "caching": "ReadWrite",
            "managedDisk": {
              "storageAccountType": "Standard_LRS",
              "diskEncryptionSet": {
                "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
              }
            },
            "diskSizeGB": 1023,
            "createOption": "Empty",
            "lun": 0
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/nsgcustom"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS",
            "diskEncryptionSet": {
              "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
            }
          },
          "createOption": "FromImage"
        },
        "dataDisks": [
          {
            "caching": "ReadWrite",
            "managedDisk": {
              "storageAccountType": "Standard_LRS",
              "diskEncryptionSet": {
                "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
              }
            },
            "diskSizeGB": 1023,
            "createOption": "Empty",
            "lun": 0
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with empty data disks on each vm.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D2_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage",
          "diskSizeGB": 512
        },
        "dataDisks": [
          {
            "diskSizeGB": 1023,
            "createOption": "Empty",
            "lun": 0
          },
          {
            "diskSizeGB": 1023,
            "createOption": "Empty",
            "lun": 1
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithEmptyDataDisksOnEachVm.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D2_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    DiskSizeGB = 512,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
                DataDisks = {new VirtualMachineScaleSetDataDisk(0, DiskCreateOptionType.Empty)
                {
                DiskSizeGB = 1023,
                }, new VirtualMachineScaleSetDataDisk(1, DiskCreateOptionType.Empty)
                {
                DiskSizeGB = 1023,
                }},
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D2_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "8042c376-4690-4c47-9fa2-fbdad70e32fa",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage",
          "diskSizeGB": 512
        },
        "dataDisks": [
          {
            "caching": "None",
            "managedDisk": {
              "storageAccountType": "Standard_LRS"
            },
            "createOption": "Empty",
            "lun": 0,
            "diskSizeGB": 1023
          },
          {
            "caching": "None",
            "managedDisk": {
              "storageAccountType": "Standard_LRS"
            },
            "createOption": "Empty",
            "lun": 1,
            "diskSizeGB": 1023
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Succeeded"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D2_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "8042c376-4690-4c47-9fa2-fbdad70e32fa",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage",
          "diskSizeGB": 512
        },
        "dataDisks": [
          {
            "caching": "None",
            "managedDisk": {
              "storageAccountType": "Standard_LRS"
            },
            "createOption": "Empty",
            "lun": 0,
            "diskSizeGB": 1023
          },
          {
            "caching": "None",
            "managedDisk": {
              "storageAccountType": "Standard_LRS"
            },
            "createOption": "Empty",
            "lun": 1,
            "diskSizeGB": 1023
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with ephemeral os disk provisioning in Nvme disk using placement property.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows2016",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "windows-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local",
            "placement": "NvmeDisk"
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "plan": {
    "publisher": "microsoft-ads",
    "product": "windows-data-science-vm",
    "name": "windows2016"
  },
  "location": "westus"
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_CreateA_WithDiffOsDiskUsingDiffDiskPlacementAsNvmeDisk.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_DS1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Plan = new ComputePlan
    {
        Name = "windows2016",
        Publisher = "microsoft-ads",
        Product = "windows-data-science-vm",
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "microsoft-ads",
                    Offer = "windows-data-science-vm",
                    Sku = "windows2016",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadOnly,
                    DiffDiskSettings = new DiffDiskSettings
                    {
                        Option = DiffDiskOption.Local,
                        Placement = DiffDiskPlacement.NvmeDisk,
                    },
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local",
            "placement": "NvmeDisk"
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local",
            "placement": "NvmeDisk"
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Create a scale set with ephemeral os disks using placement property and enableFullCaching set to true.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows2016",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "windows-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local",
            "placement": "ResourceDisk",
            "enableFullCaching": true
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "plan": {
    "publisher": "microsoft-ads",
    "product": "windows-data-science-vm",
    "name": "windows2016"
  },
  "location": "westus"
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_CreateA_WithDiffOsDiskUsingDiffDiskPlacementAndFullCachingEnabled.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_DS1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Plan = new ComputePlan
    {
        Name = "windows2016",
        Publisher = "microsoft-ads",
        Product = "windows-data-science-vm",
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "microsoft-ads",
                    Offer = "windows-data-science-vm",
                    Sku = "windows2016",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadOnly,
                    DiffDiskSettings = new DiffDiskSettings
                    {
                        Option = DiffDiskOption.Local,
                        Placement = DiffDiskPlacement.ResourceDisk,
                        EnableFullCaching = true,
                    },
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local",
            "placement": "ResourceDisk"
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local",
            "placement": "ResourceDisk"
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Create a scale set with ephemeral os disks using placement property.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows2016",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "windows-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local",
            "placement": "ResourceDisk"
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "plan": {
    "publisher": "microsoft-ads",
    "product": "windows-data-science-vm",
    "name": "windows2016"
  },
  "location": "westus"
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_CreateA_WithDiffOsDiskUsingDiffDiskPlacement.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_DS1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Plan = new ComputePlan
    {
        Name = "windows2016",
        Publisher = "microsoft-ads",
        Product = "windows-data-science-vm",
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "microsoft-ads",
                    Offer = "windows-data-science-vm",
                    Sku = "windows2016",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadOnly,
                    DiffDiskSettings = new DiffDiskSettings
                    {
                        Option = DiffDiskOption.Local,
                        Placement = DiffDiskPlacement.ResourceDisk,
                    },
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local",
            "placement": "ResourceDisk"
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local",
            "placement": "ResourceDisk"
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Create a scale set with ephemeral os disks.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows2016",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "windows-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local"
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "plan": {
    "publisher": "microsoft-ads",
    "product": "windows-data-science-vm",
    "name": "windows2016"
  },
  "location": "westus"
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithDiffOsDisk.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_DS1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Plan = new ComputePlan
    {
        Name = "windows2016",
        Publisher = "microsoft-ads",
        Product = "windows-data-science-vm",
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "microsoft-ads",
                    Offer = "windows-data-science-vm",
                    Sku = "windows2016",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadOnly,
                    DiffDiskSettings = new DiffDiskSettings
                    {
                        Option = DiffDiskOption.Local,
                    },
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local"
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "diffDiskSettings": {
            "option": "Local"
          },
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Create a scale set with extension time budget.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://{existing-storage-account-name}.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "extensionProfile": {
        "extensions": [
          {
            "name": "{extension-name}",
            "properties": {
              "autoUpgradeMinorVersion": false,
              "publisher": "{extension-Publisher}",
              "type": "{extension-Type}",
              "typeHandlerVersion": "{handler-version}",
              "settings": {}
            }
          }
        ],
        "extensionsTimeBudget": "PT1H20M"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithExtensionsTimeBudget.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            BootDiagnostics = new BootDiagnostics
            {
                Enabled = true,
                StorageUri = new Uri("http://{existing-storage-account-name}.blob.core.windows.net"),
            },
            ExtensionProfile = new VirtualMachineScaleSetExtensionProfile
            {
                Extensions = {new VirtualMachineScaleSetExtensionData
                {
                Publisher = "{extension-Publisher}",
                ExtensionType = "{extension-Type}",
                TypeHandlerVersion = "{handler-version}",
                AutoUpgradeMinorVersion = false,
                Settings = BinaryData.FromObjectAsJson(new object()),
                }},
                ExtensionsTimeBudget = "PT1H20M",
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "extensionProfile": {
        "extensions": [
          {
            "name": "{extension-name}",
            "properties": {
              "autoUpgradeMinorVersion": false,
              "publisher": "{extension-Publisher}",
              "type": "{extension-Type}",
              "typeHandlerVersion": "{handler-version}",
              "settings": {}
            }
          }
        ],
        "extensionsTimeBudget": "PT1H20M"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "extensionProfile": {
        "extensions": [
          {
            "name": "{extension-name}",
            "properties": {
              "autoUpgradeMinorVersion": false,
              "publisher": "{extension-Publisher}",
              "type": "{extension-Type}",
              "typeHandlerVersion": "{handler-version}",
              "settings": {}
            }
          }
        ],
        "extensionsTimeBudget": "PT1H20M"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with external health policy enabled

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true,
          "scheduledEventsApiVersion": "2020-07-01"
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      },
      "allInstancesDown": {
        "automaticallyApprove": true
      }
    },
    "externalHealthPolicy": {
      "enabled": true,
      "expiryDuration": "PT10M",
      "gracePeriod": "PT4H"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithExternalHealthPolicy.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        ScheduledEventsPolicy = new ScheduledEventsPolicy
        {
            UserInitiatedRedeploy = new UserInitiatedRedeploy
            {
                AutomaticallyApprove = true,
            },
            AutomaticallyApprove = true,
            ScheduledEventsAdditionalPublishingTargetsEventGridAndResourceGraph = new EventGridAndResourceGraph
            {
                IsEnabled = true,
                ScheduledEventsApiVersion = "2020-07-01",
            },
            AllInstancesDown = new AllInstancesDown
            {
                AutomaticallyApprove = true,
            },
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
        ExternalHealthPolicy = new ExternalHealthPolicy
        {
            Enabled = true,
            ExpiryDuration = XmlConvert.ToTimeSpan("PT10M"),
            GracePeriod = XmlConvert.ToTimeSpan("PT4H"),
        },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true,
          "scheduledEventsApiVersion": "2020-07-01"
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      },
      "allInstancesDown": {
        "automaticallyApprove": true
      }
    },
    "externalHealthPolicy": {
      "enabled": true,
      "expiryDuration": "PT10M",
      "gracePeriod": "PT4H"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true,
          "scheduledEventsApiVersion": "2020-07-01"
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      },
      "allInstancesDown": {
        "automaticallyApprove": true
      }
    },
    "externalHealthPolicy": {
      "enabled": true,
      "expiryDuration": "PT10M",
      "gracePeriod": "PT4H"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with Fpga Network Interfaces.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/{existing-custom-image-name}"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          },
          {
            "name": "{fpgaNic-Name}",
            "properties": {
              "primary": false,
              "enableAcceleratedNetworking": false,
              "enableIPForwarding": false,
              "enableFpga": true,
              "ipConfigurations": [
                {
                  "name": "{fpgaNic-Name}",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name}"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_FromWithFpgaNetworkInterface.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/{existing-custom-image-name}"),
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }, new VirtualMachineScaleSetNetworkConfiguration("{fpgaNic-Name}")
                {
                Primary = false,
                EnableAcceleratedNetworking = false,
                EnableFpga = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{fpgaNic-Name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name}"),
                Primary = true,
                PrivateIPAddressVersion = IPVersion.IPv4,
                }},
                EnableIPForwarding = false,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/nsgcustom"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          },
          {
            "name": "{fpgaNic-Name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": false,
              "enableFpga": true,
              "ipConfigurations": [
                {
                  "name": "{fpgaNic-Name}",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name}"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/nsgcustom"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          },
          {
            "name": "{fpgaNic-Name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": false,
              "enableFpga": true,
              "ipConfigurations": [
                {
                  "name": "{fpgaNic-Name}",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name}"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with Host Encryption using encryptionAtHost property.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows2016",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "windows-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "encryptionAtHost": true
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "plan": {
    "publisher": "microsoft-ads",
    "product": "windows-data-science-vm",
    "name": "windows2016"
  },
  "location": "westus"
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithEncryptionAtHost.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_DS1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Plan = new ComputePlan
    {
        Name = "windows2016",
        Publisher = "microsoft-ads",
        Product = "windows-data-science-vm",
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "microsoft-ads",
                    Offer = "windows-data-science-vm",
                    Sku = "windows2016",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadOnly,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            SecurityProfile = new SecurityProfile
            {
                EncryptionAtHost = true,
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "encryptionAtHost": true,
        "securityType": "Standard"
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "plan": {
    "publisher": "microsoft-ads",
    "product": "standard-data-science-vm",
    "name": "standard-data-science-vm"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "standard-data-science-vm",
          "publisher": "microsoft-ads",
          "version": "latest",
          "offer": "standard-data-science-vm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "encryptionAtHost": true,
        "securityType": "Standard"
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Create a scale set with managed boot diagnostics.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithManagedBootDiagnostics.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            BootDiagnostics = new BootDiagnostics
            {
                Enabled = true,
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with Max Instance Percent Per Zone Policy enabled

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": false,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "zoneAllocationPolicy": {
        "maxInstancePercentPerZonePolicy": {
          "enabled": true,
          "value": 50
        }
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithMaxInstancePercentPerZonePolicy.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = false,
        ResiliencyPolicy = new ResiliencyPolicy
        {
            ZoneAllocationPolicy = new ZoneAllocationPolicy
            {
                MaxInstancePercentPerZonePolicy = new MaxInstancePercentPerZonePolicy
                {
                    Enabled = true,
                    Value = 50,
                },
            },
        },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "zoneAllocationPolicy": {
        "maxInstancePercentPerZonePolicy": {
          "enabled": true,
          "value": 50
        }
      }
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "zoneAllocationPolicy": {
        "maxInstancePercentPerZonePolicy": {
          "enabled": true,
          "value": 50
        }
      }
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with Network Interfaces with public ip address dns settings.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/{existing-custom-image-name}"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{nicConfig1-name}",
            "tags": {
              "nicTag": "tag"
            },
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "disableTcpStateTracking": true,
              "enableAcceleratedNetworking": true,
              "auxiliaryMode": "AcceleratedConnections",
              "auxiliarySku": "A1",
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          },
          {
            "name": "{nicConfig2-name}",
            "properties": {
              "primary": false,
              "enableAcceleratedNetworking": false,
              "enableIPForwarding": false,
              "disableTcpStateTracking": false,
              "ipConfigurations": [
                {
                  "name": "{nicConfig2-name}",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name2}"
                    },
                    "privateIPAddressVersion": "IPv4",
                    "publicIPAddressConfiguration": {
                      "name": "publicip",
                      "tags": {
                        "pipTag": "tag"
                      },
                      "properties": {
                        "idleTimeoutInMinutes": 10,
                        "dnsSettings": {
                          "domainNameLabel": "vmsstestlabel01",
                          "domainNameLabelScope": "NoReuse"
                        }
                      }
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_FromWithNetworkInterfaceWithDnsSettings.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/{existing-custom-image-name}"),
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{nicConfig1-name}")
                {
                Tags =
                {
                ["nicTag"] = "tag"
                },
                Primary = true,
                EnableAcceleratedNetworking = true,
                IsTcpStateTrackingDisabled = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                AuxiliaryMode = ComputeNetworkInterfaceAuxiliaryMode.AcceleratedConnections,
                AuxiliarySku = ComputeNetworkInterfaceAuxiliarySku.A1,
                }, new VirtualMachineScaleSetNetworkConfiguration("{nicConfig2-name}")
                {
                Primary = false,
                EnableAcceleratedNetworking = false,
                IsTcpStateTrackingDisabled = false,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{nicConfig2-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name2}"),
                Primary = true,
                PublicIPAddressConfiguration = new VirtualMachineScaleSetPublicIPAddressConfiguration("publicip")
                {
                Tags =
                {
                ["pipTag"] = "tag"
                },
                IdleTimeoutInMinutes = 10,
                DnsSettings = new VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings("vmsstestlabel01")
                {
                DomainNameLabelScope = DomainNameLabelScopeType.NoReuse,
                },
                },
                PrivateIPAddressVersion = IPVersion.IPv4,
                }},
                EnableIPForwarding = false,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/nsgcustom"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{nicConfig1-name}",
            "tags": {
              "nicTag": "tag"
            },
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "disableTcpStateTracking": true,
              "ipConfigurations": [
                {
                  "name": "{nicConfig1-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4",
                    "publicIPAddressConfiguration": {
                      "name": "publicip",
                      "tags": {
                        "pipTag": "tag"
                      },
                      "properties": {
                        "idleTimeoutInMinutes": 10,
                        "dnsSettings": {
                          "domainNameLabel": "vmsstestlabel01",
                          "domainNameLabelScope": "TenantReuse"
                        }
                      }
                    }
                  }
                }
              ],
              "enableAcceleratedNetworking": true,
              "auxiliaryMode": "AcceleratedConnections",
              "auxiliarySku": "A1"
            }
          },
          {
            "name": "{nicConfig2-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": false,
              "enableFpga": false,
              "disableTcpStateTracking": false,
              "ipConfigurations": [
                {
                  "name": "{nicConfig2-name}",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name2}"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "afa2afa8-9e49-48fb-9d18-c86323b5d064",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/nsgcustom"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{nicConfig1-name}",
            "tags": {
              "nicTag": "tag"
            },
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "disableTcpStateTracking": true,
              "ipConfigurations": [
                {
                  "name": "{nicConfig1-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": true,
              "auxiliaryMode": "AcceleratedConnections",
              "auxiliarySku": "A1"
            }
          },
          {
            "name": "{nicConfig2-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": false,
              "enableFpga": false,
              "disableTcpStateTracking": false,
              "ipConfigurations": [
                {
                  "name": "{nicConfig2-name}",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-fpga-subnet-name2}"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with OperationRecoverySettings enabled

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": false,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "operationRecoverySettings": {
        "restartRecoveryPolicy": {
          "enabled": true
        },
        "startRecoveryPolicy": {
          "enabled": true
        },
        "reimageRecoveryPolicy": {
          "enabled": true
        }
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithOperationRecoverySettings.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = false,
        ResiliencyPolicy = new ResiliencyPolicy
        {
            OperationRecoverySettings = new OperationRecoverySettings
            {
                RestartRecoveryPolicyEnabled = true,
                StartRecoveryPolicyEnabled = true,
                ReimageRecoveryPolicyEnabled = true,
            },
        },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "operationRecoverySettings": {
        "restartRecoveryPolicy": {
          "enabled": true
        },
        "startRecoveryPolicy": {
          "enabled": true
        },
        "reimageRecoveryPolicy": {
          "enabled": true
        }
      }
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "operationRecoverySettings": {
        "restartRecoveryPolicy": {
          "enabled": true
        },
        "startRecoveryPolicy": {
          "enabled": true
        },
        "reimageRecoveryPolicy": {
          "enabled": true
        }
      }
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with OS image scheduled events enabled.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      },
      "scheduledEventsProfile": {
        "osImageNotificationProfile": {
          "enable": true,
          "notBeforeTimeout": "PT15M"
        }
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithOSImageScheduledEventEnabled.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            ScheduledEventsProfile = new ComputeScheduledEventsProfile
            {
                OSImageNotificationProfile = new OSImageNotificationProfile
                {
                    NotBeforeTimeout = "PT15M",
                    Enable = true,
                },
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "scheduledEventsProfile": {
        "osImageNotificationProfile": {
          "enable": true,
          "notBeforeTimeout": "PT15M"
        }
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "scheduledEventsProfile": {
        "osImageNotificationProfile": {
          "enable": true,
          "notBeforeTimeout": "PT15M"
        }
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with password authentication.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithPasswordAuthentication.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "ffb27c5c-39a5-4d4e-b307-b32598689813",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "ffb27c5c-39a5-4d4e-b307-b32598689813",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with placement policy 'Auto'

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": false,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "placement": {
    "zonePlacementPolicy": "Auto",
    "includeZones": [
      "1",
      "3"
    ]
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithPlacement.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = false,
    },
    Placement = new VirtualMachinePlacement
    {
        ZonePlacementPolicy = "Auto",
        IncludeZones = { "1", "3" },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "placement": {
    "zonePlacementPolicy": "Auto",
    "includeZones": [
      "1",
      "3"
    ]
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "placement": {
    "zonePlacementPolicy": "Auto",
    "includeZones": [
      "1",
      "3"
    ]
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with premium storage.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithPremiumStorage.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.PremiumLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "19fd38a2-f50a-42c6-9dc7-3f9cf3791225",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "19fd38a2-f50a-42c6-9dc7-3f9cf3791225",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with priority mix policy

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_A8m_v2"
  },
  "location": "westus",
  "properties": {
    "orchestrationMode": "Flexible",
    "platformFaultDomainCount": 1,
    "priorityMixPolicy": {
      "baseRegularPriorityCount": 10,
      "regularPriorityPercentageAboveBase": 50
    },
    "virtualMachineProfile": {
      "priority": "Spot",
      "storageProfile": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-focal",
          "sku": "20_04-lts-gen2",
          "version": "latest"
        },
        "osDisk": {
          "createOption": "FromImage",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          }
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "enableAcceleratedNetworking": false,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    },
                    "primary": true,
                    "applicationGatewayBackendAddressPools": [],
                    "loadBalancerBackendAddressPools": [],
                    "publicIPAddressConfiguration": {
                      "name": "{vmss-name}",
                      "properties": {
                        "idleTimeoutInMinutes": 15
                      }
                    }
                  }
                }
              ]
            }
          }
        ],
        "networkApiVersion": "2020-11-01"
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithPriorityMixPolicy.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_A8m_v2",
        Tier = "Standard",
        Capacity = 2L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "Canonical",
                    Offer = "0001-com-ubuntu-server-focal",
                    Sku = "20_04-lts-gen2",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                EnableAcceleratedNetworking = false,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                Primary = true,
                PublicIPAddressConfiguration = new VirtualMachineScaleSetPublicIPAddressConfiguration("{vmss-name}")
                {
                IdleTimeoutInMinutes = 15,
                },
                ApplicationGatewayBackendAddressPools = {},
                LoadBalancerBackendAddressPools = {},
                }},
                EnableIPForwarding = true,
                }},
                NetworkApiVersion = NetworkApiVersion.v2020_11_01,
            },
            Priority = VirtualMachinePriorityType.Spot,
        },
        PlatformFaultDomainCount = 1,
        OrchestrationMode = OrchestrationMode.Flexible,
        PriorityMixPolicy = new VirtualMachineScaleSetPriorityMixPolicy
        {
            BaseRegularPriorityCount = 10,
            RegularPriorityPercentageAboveBase = 50,
        },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_A8m_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "orchestrationMode": "Flexible",
    "platformFaultDomainCount": 1,
    "priorityMixPolicy": {
      "baseRegularPriorityCount": 10,
      "regularPriorityPercentageAboveBase": 50
    },
    "virtualMachineProfile": {
      "priority": "Spot",
      "storageProfile": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-focal",
          "sku": "20_04-lts-gen2",
          "version": "latest"
        },
        "osDisk": {
          "createOption": "FromImage",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          }
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "enableAcceleratedNetworking": false,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    },
                    "primary": true,
                    "applicationGatewayBackendAddressPools": [],
                    "loadBalancerBackendAddressPools": [],
                    "publicIPAddressConfiguration": {
                      "name": "{vmss-name}",
                      "properties": {
                        "idleTimeoutInMinutes": 15
                      }
                    }
                  }
                }
              ]
            }
          }
        ],
        "networkApiVersion": "2020-11-01"
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    }
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_A8m_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "orchestrationMode": "Flexible",
    "platformFaultDomainCount": 1,
    "priorityMixPolicy": {
      "baseRegularPriorityCount": 10,
      "regularPriorityPercentageAboveBase": 50
    },
    "virtualMachineProfile": {
      "priority": "Spot",
      "storageProfile": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-focal",
          "sku": "20_04-lts-gen2",
          "version": "latest"
        },
        "osDisk": {
          "createOption": "FromImage",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          }
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "enableAcceleratedNetworking": false,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    },
                    "primary": true,
                    "applicationGatewayBackendAddressPools": [],
                    "loadBalancerBackendAddressPools": [],
                    "publicIPAddressConfiguration": {
                      "name": "{vmss-name}",
                      "properties": {
                        "idleTimeoutInMinutes": 15
                      }
                    }
                  }
                }
              ]
            }
          }
        ],
        "networkApiVersion": "2020-11-01"
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    }
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with ProxyAgent Settings of enabled and mode.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D2s_v3"
  },
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-jammy",
          "sku": "22_04-lts-gen2",
          "version": "latest"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "proxyAgentSettings": {
          "enabled": true,
          "addProxyAgentExtension": true,
          "wireServer": {
            "inVMAccessControlProfileReferenceId": "/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.Compute/galleries/{gallery-name}/inVMAccessControlProfiles/{profile-name}/versions/{version}"
          },
          "imds": {
            "inVMAccessControlProfileReferenceId": "/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.Compute/galleries/{gallery-name}/inVMAccessControlProfiles/{profile-name}/versions/{version}"
          }
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "location": "westus"
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithProxyAgentSettings.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D2s_v3",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "Canonical",
                    Offer = "0001-com-ubuntu-server-jammy",
                    Sku = "22_04-lts-gen2",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadOnly,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardSsdLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            SecurityProfile = new SecurityProfile
            {
                ProxyAgentSettings = new ProxyAgentSettings
                {
                    Enabled = true,
                    WireServer = new HostEndpointSettings
                    {
                        InVmAccessControlProfileReferenceId = "/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.Compute/galleries/{gallery-name}/inVMAccessControlProfiles/{profile-name}/versions/{version}",
                    },
                    Imds = new HostEndpointSettings
                    {
                        InVmAccessControlProfileReferenceId = "/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.Compute/galleries/{gallery-name}/inVMAccessControlProfiles/{profile-name}/versions/{version}",
                    },
                    AddProxyAgentExtension = true,
                },
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D2s_v3"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-jammy",
          "sku": "22_04-lts-gen2",
          "version": "latest"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "proxyAgentSettings": {
          "enabled": true,
          "addProxyAgentExtension": true,
          "wireServer": {
            "inVMAccessControlProfileReferenceId": "/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.Compute/galleries/{gallery-name}/inVMAccessControlProfiles/{profile-name}/versions/{version}"
          },
          "imds": {
            "inVMAccessControlProfileReferenceId": "/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.Compute/galleries/{gallery-name}/inVMAccessControlProfiles/{profile-name}/versions/{version}"
          }
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D2s_v3"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-jammy",
          "sku": "22_04-lts-gen2",
          "version": "latest"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "proxyAgentSettings": {
          "enabled": true,
          "addProxyAgentExtension": true,
          "wireServer": {
            "inVMAccessControlProfileReferenceId": "/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.Compute/galleries/{gallery-name}/inVMAccessControlProfiles/{profile-name}/versions/{version}"
          },
          "imds": {
            "inVMAccessControlProfileReferenceId": "/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.Compute/galleries/{gallery-name}/inVMAccessControlProfiles/{profile-name}/versions/{version}"
          }
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Create a scale set with Resilient VM Creation enabled

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": false,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "resilientVMCreationPolicy": {
        "enabled": true
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithResilientVMCreationPolicy.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = false,
        ResiliencyPolicy = new ResiliencyPolicy
        {
            ResilientVmCreationPolicyEnabled = true,
        },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "resilientVMCreationPolicy": {
        "enabled": true
      }
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "resilientVMCreationPolicy": {
        "enabled": true
      }
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with Resilient VM Deletion enabled

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": false,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "resilientVMDeletionPolicy": {
        "enabled": true
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithResilientVMDeletionPolicy.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = false,
        ResiliencyPolicy = new ResiliencyPolicy
        {
            ResilientVmDeletionPolicyEnabled = true,
        },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "resilientVMDeletionPolicy": {
        "enabled": true
      }
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "resilientVMDeletionPolicy": {
        "enabled": true
      }
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with scaleInPolicy.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scaleInPolicy": {
      "rules": [
        "OldestVM"
      ],
      "prioritizeUnhealthyVMs": true,
      "forceDeletion": true
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithScaleInPolicy.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
        ScaleInPolicy = new ScaleInPolicy
        {
            Rules = { VirtualMachineScaleSetScaleInRule.OldestVm },
            ForceDeletion = true,
            PrioritizeUnhealthyVms = true,
        },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scaleInPolicy": {
      "rules": [
        "OldestVM"
      ],
      "prioritizeUnhealthyVMs": true,
      "forceDeletion": true
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scaleInPolicy": {
      "rules": [
        "OldestVM"
      ],
      "prioritizeUnhealthyVMs": true,
      "forceDeletion": true
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with Security Posture Reference

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_A1"
  },
  "location": "eastus2euap",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "securityPostureReference": {
        "id": "/CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{major.minor.patch}|{major.*}|latest"
      },
      "storageProfile": {
        "imageReference": {
          "sku": "2022-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "createOption": "FromImage",
          "name": "osDisk"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithSecurityPostureReference.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("eastus2euap"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_A1",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Automatic,
            AutomaticOSUpgradePolicy = new AutomaticOSUpgradePolicy
            {
                EnableAutomaticOSUpgrade = true,
            },
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2022-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Name = "osDisk",
                    Caching = CachingType.ReadWrite,
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            SecurityPostureReference = new ComputeSecurityPostureReference(new ResourceIdentifier("/CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{major.minor.patch}|{major.*}|latest")),
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_A1"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d12ccb3d-ab15-4794-9836-c4196392e9f2",
    "virtualMachineProfile": {
      "securityPostureReference": {
        "id": "/CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{major.minor.patch}|{major.*}|latest"
      },
      "storageProfile": {
        "imageReference": {
          "sku": "2022-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "name": "osDisk",
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      }
    },
    "provisioningState": "Creating"
  },
  "location": "eastus2euap",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_A1"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d12ccb3d-ab15-4794-9836-c4196392e9f2",
    "virtualMachineProfile": {
      "securityPostureReference": {
        "id": "/CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{major.minor.patch}|{major.*}|latest"
      },
      "storageProfile": {
        "imageReference": {
          "sku": "2022-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "name": "osDisk",
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      }
    },
    "provisioningState": "Creating"
  },
  "location": "eastus2euap",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with SecurityType as ConfidentialVM

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DC2as_v5"
  },
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows-cvm",
          "publisher": "MicrosoftWindowsServer",
          "version": "17763.2183.2109130127",
          "offer": "2019-datacenter-cvm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS",
            "securityProfile": {
              "securityEncryptionType": "VMGuestStateOnly"
            }
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "uefiSettings": {
          "secureBootEnabled": true,
          "vTpmEnabled": true
        },
        "securityType": "ConfidentialVM"
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "location": "westus"
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithSecurityTypeConfidentialVM.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_DC2as_v5",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "2019-datacenter-cvm",
                    Sku = "windows-cvm",
                    Version = "17763.2183.2109130127",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadOnly,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardSsdLrs,
                        SecurityProfile = new VirtualMachineDiskSecurityProfile
                        {
                            SecurityEncryptionType = SecurityEncryptionType.VmGuestStateOnly,
                        },
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            SecurityProfile = new SecurityProfile
            {
                UefiSettings = new UefiSettings
                {
                    IsSecureBootEnabled = true,
                    IsVirtualTpmEnabled = true,
                },
                SecurityType = SecurityType.ConfidentialVm,
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DC2as_v5"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows-cvm",
          "publisher": "MicrosoftWindowsServer",
          "version": "17763.2183.2109130127",
          "offer": "2019-datacenter-cvm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS",
            "securityProfile": {
              "securityEncryptionType": "VMGuestStateOnly"
            }
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "uefiSettings": {
          "secureBootEnabled": true,
          "vTpmEnabled": true
        },
        "securityType": "ConfidentialVM"
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DC2as_v5"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows-cvm",
          "publisher": "MicrosoftWindowsServer",
          "version": "17763.2183.2109130127",
          "offer": "2019-datacenter-cvm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS",
            "securityProfile": {
              "securityEncryptionType": "VMGuestStateOnly"
            }
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "uefiSettings": {
          "secureBootEnabled": true,
          "vTpmEnabled": true
        },
        "securityType": "ConfidentialVM"
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Create a scale set with SecurityType as ConfidentialVM and NonPersistedTPM securityEncryptionType

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DC2es_v5"
  },
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "linux-cvm",
          "publisher": "UbuntuServer",
          "version": "17763.2183.2109130127",
          "offer": "2022-datacenter-cvm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS",
            "securityProfile": {
              "securityEncryptionType": "NonPersistedTPM"
            }
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "uefiSettings": {
          "secureBootEnabled": false,
          "vTpmEnabled": true
        },
        "securityType": "ConfidentialVM"
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "location": "westus"
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithSecurityTypeConfidentialVMWithNonPersistedTPM.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_DC2es_v5",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "UbuntuServer",
                    Offer = "2022-datacenter-cvm",
                    Sku = "linux-cvm",
                    Version = "17763.2183.2109130127",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadOnly,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardSsdLrs,
                        SecurityProfile = new VirtualMachineDiskSecurityProfile
                        {
                            SecurityEncryptionType = SecurityEncryptionType.NonPersistedTPM,
                        },
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            SecurityProfile = new SecurityProfile
            {
                UefiSettings = new UefiSettings
                {
                    IsSecureBootEnabled = false,
                    IsVirtualTpmEnabled = true,
                },
                SecurityType = SecurityType.ConfidentialVm,
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DC2es_v5"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "linux-cvm",
          "publisher": "UbuntuServer",
          "version": "17763.2183.2109130127",
          "offer": "2022-datacenter-cvm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS",
            "securityProfile": {
              "securityEncryptionType": "NonPersistedTPM"
            }
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "uefiSettings": {
          "secureBootEnabled": false,
          "vTpmEnabled": true
        },
        "securityType": "ConfidentialVM"
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DC2es_v5"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "linux-cvm",
          "publisher": "UbuntuServer",
          "version": "17763.2183.2109130127",
          "offer": "2022-datacenter-cvm"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS",
            "securityProfile": {
              "securityEncryptionType": "NonPersistedTPM"
            }
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "uefiSettings": {
          "secureBootEnabled": false,
          "vTpmEnabled": true
        },
        "securityType": "ConfidentialVM"
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Create a scale set with Service Artifact Reference

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_A1"
  },
  "location": "eastus2euap",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "serviceArtifactReference": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName/serviceArtifacts/serviceArtifactName/vmArtifactsProfiles/vmArtifactsProfilesName"
      },
      "storageProfile": {
        "imageReference": {
          "sku": "2022-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "createOption": "FromImage",
          "name": "osDisk"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithServiceArtifactReference.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("eastus2euap"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_A1",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Automatic,
            AutomaticOSUpgradePolicy = new AutomaticOSUpgradePolicy
            {
                EnableAutomaticOSUpgrade = true,
            },
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2022-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Name = "osDisk",
                    Caching = CachingType.ReadWrite,
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            ServiceArtifactReferenceId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName/serviceArtifacts/serviceArtifactName/vmArtifactsProfiles/vmArtifactsProfilesName"),
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_A1"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "77b7df9a-32fe-45e3-8911-60ac9c9b9c64",
    "virtualMachineProfile": {
      "serviceArtifactReference": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName/serviceArtifacts/serviceArtifactName/vmArtifactsProfiles/vmArtifactsProfilesName"
      },
      "storageProfile": {
        "imageReference": {
          "sku": "2022-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "name": "osDisk",
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      }
    },
    "provisioningState": "Creating"
  },
  "location": "eastus2euap",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_A1"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "77b7df9a-32fe-45e3-8911-60ac9c9b9c64",
    "virtualMachineProfile": {
      "serviceArtifactReference": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName/serviceArtifacts/serviceArtifactName/vmArtifactsProfiles/vmArtifactsProfilesName"
      },
      "storageProfile": {
        "imageReference": {
          "sku": "2022-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "name": "osDisk",
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      }
    },
    "provisioningState": "Creating"
  },
  "location": "eastus2euap",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with sku profile

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "capacity": 10,
    "name": "Mix"
  },
  "location": "westus",
  "properties": {
    "singlePlacementGroup": false,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      },
      "priority": "Spot",
      "evictionPolicy": "Deallocate",
      "billingProfile": {
        "maxPrice": -1
      }
    },
    "orchestrationMode": "Flexible",
    "priorityMixPolicy": {
      "baseRegularPriorityCount": 4,
      "regularPriorityPercentageAboveBase": 50
    },
    "skuProfile": {
      "vmSizes": [
        {
          "name": "Standard_D8s_v5"
        },
        {
          "name": "Standard_E16s_v5"
        },
        {
          "name": "Standard_D2s_v5"
        }
      ],
      "allocationStrategy": "CapacityOptimized"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithSkuProfile.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Mix",
        Capacity = 10L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            Priority = VirtualMachinePriorityType.Spot,
            EvictionPolicy = VirtualMachineEvictionPolicyType.Deallocate,
            BillingMaxPrice = -1,
        },
        SinglePlacementGroup = false,
        OrchestrationMode = OrchestrationMode.Flexible,
        PriorityMixPolicy = new VirtualMachineScaleSetPriorityMixPolicy
        {
            BaseRegularPriorityCount = 4,
            RegularPriorityPercentageAboveBase = 50,
        },
        SkuProfile = new ComputeSkuProfile
        {
            VmSizes = {new ComputeSkuProfileVmSize
            {
            Name = "Standard_D8s_v5",
            }, new ComputeSkuProfileVmSize
            {
            Name = "Standard_E16s_v5",
            }, new ComputeSkuProfileVmSize
            {
            Name = "Standard_D2s_v5",
            }},
            AllocationStrategy = ComputeAllocationStrategy.CapacityOptimized,
        },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "capacity": 10,
    "name": "Mix"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "priority": "Spot",
      "evictionPolicy": "Deallocate",
      "billingProfile": {
        "maxPrice": -1
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "orchestrationMode": "Flexible",
    "priorityMixPolicy": {
      "baseRegularPriorityCount": 4,
      "regularPriorityPercentageAboveBase": 50
    },
    "skuProfile": {
      "vmSizes": [
        {
          "name": "Standard_D8s_v5"
        },
        {
          "name": "Standard_E16s_v5"
        },
        {
          "name": "Standard_D2s_v5"
        }
      ],
      "allocationStrategy": "CapacityOptimized"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "capacity": 10,
    "name": "Mix"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "priority": "Spot",
      "evictionPolicy": "Deallocate",
      "billingProfile": {
        "maxPrice": -1
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "orchestrationMode": "Flexible",
    "priorityMixPolicy": {
      "baseRegularPriorityCount": 4,
      "regularPriorityPercentageAboveBase": 50
    },
    "skuProfile": {
      "vmSizes": [
        {
          "name": "Standard_D8s_v5"
        },
        {
          "name": "Standard_E16s_v5"
        },
        {
          "name": "Standard_D2s_v5"
        }
      ],
      "allocationStrategy": "CapacityOptimized"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with sku profile and prioritized allocation strategy

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "capacity": 10,
    "name": "Mix"
  },
  "location": "westus",
  "properties": {
    "singlePlacementGroup": false,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      },
      "priority": "Spot",
      "evictionPolicy": "Deallocate",
      "billingProfile": {
        "maxPrice": -1
      }
    },
    "orchestrationMode": "Flexible",
    "priorityMixPolicy": {
      "baseRegularPriorityCount": 4,
      "regularPriorityPercentageAboveBase": 50
    },
    "skuProfile": {
      "vmSizes": [
        {
          "name": "Standard_D8s_v5",
          "rank": 0
        },
        {
          "name": "Standard_E16s_v5",
          "rank": 1
        },
        {
          "name": "Standard_D2s_v5",
          "rank": 2
        }
      ],
      "allocationStrategy": "Prioritized"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithSkuProfile_Prioritized.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Mix",
        Capacity = 10L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            Priority = VirtualMachinePriorityType.Spot,
            EvictionPolicy = VirtualMachineEvictionPolicyType.Deallocate,
            BillingMaxPrice = -1,
        },
        SinglePlacementGroup = false,
        OrchestrationMode = OrchestrationMode.Flexible,
        PriorityMixPolicy = new VirtualMachineScaleSetPriorityMixPolicy
        {
            BaseRegularPriorityCount = 4,
            RegularPriorityPercentageAboveBase = 50,
        },
        SkuProfile = new ComputeSkuProfile
        {
            VmSizes = {new ComputeSkuProfileVmSize
            {
            Name = "Standard_D8s_v5",
            Rank = 0,
            }, new ComputeSkuProfileVmSize
            {
            Name = "Standard_E16s_v5",
            Rank = 1,
            }, new ComputeSkuProfileVmSize
            {
            Name = "Standard_D2s_v5",
            Rank = 2,
            }},
            AllocationStrategy = ComputeAllocationStrategy.Prioritized,
        },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "capacity": 10,
    "name": "Mix"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "priority": "Spot",
      "evictionPolicy": "Deallocate",
      "billingProfile": {
        "maxPrice": -1
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "orchestrationMode": "Flexible",
    "priorityMixPolicy": {
      "baseRegularPriorityCount": 4,
      "regularPriorityPercentageAboveBase": 50
    },
    "skuProfile": {
      "vmSizes": [
        {
          "name": "Standard_D8s_v5",
          "rank": 0
        },
        {
          "name": "Standard_E16s_v5",
          "rank": 1
        },
        {
          "name": "Standard_D2s_v5",
          "rank": 2
        }
      ],
      "allocationStrategy": "Prioritized"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "capacity": 10,
    "name": "Mix"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "priority": "Spot",
      "evictionPolicy": "Deallocate",
      "billingProfile": {
        "maxPrice": -1
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "orchestrationMode": "Flexible",
    "priorityMixPolicy": {
      "baseRegularPriorityCount": 4,
      "regularPriorityPercentageAboveBase": 50
    },
    "skuProfile": {
      "vmSizes": [
        {
          "name": "Standard_D8s_v5",
          "rank": 0
        },
        {
          "name": "Standard_E16s_v5",
          "rank": 1
        },
        {
          "name": "Standard_D2s_v5",
          "rank": 2
        }
      ],
      "allocationStrategy": "Prioritized"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with spot restore policy

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_A8m_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      },
      "priority": "Spot",
      "evictionPolicy": "Deallocate",
      "billingProfile": {
        "maxPrice": -1
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "spotRestorePolicy": {
      "enabled": true,
      "restoreTimeout": "PT1H"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithSpotRestorePolicy.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_A8m_v2",
        Tier = "Standard",
        Capacity = 2L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            Priority = VirtualMachinePriorityType.Spot,
            EvictionPolicy = VirtualMachineEvictionPolicyType.Deallocate,
            BillingMaxPrice = -1,
        },
        Overprovision = true,
        SpotRestorePolicy = new SpotRestorePolicy
        {
            Enabled = true,
            RestoreTimeout = "PT1H",
        },
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_A8m_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "priority": "Spot",
      "evictionPolicy": "Deallocate",
      "billingProfile": {
        "maxPrice": -1
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "spotRestorePolicy": {
      "enabled": true,
      "restoreTimeout": "PT1H"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_A8m_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "priority": "Spot",
      "evictionPolicy": "Deallocate",
      "billingProfile": {
        "maxPrice": -1
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "spotRestorePolicy": {
      "enabled": true,
      "restoreTimeout": "PT1H"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with ssh authentication.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "linuxConfiguration": {
          "ssh": {
            "publicKeys": [
              {
                "path": "/home/{your-username}/.ssh/authorized_keys",
                "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCeClRAk2ipUs/l5voIsDC5q9RI+YSRd1Bvd/O+axgY4WiBzG+4FwJWZm/mLLe5DoOdHQwmU2FrKXZSW4w2sYE70KeWnrFViCOX5MTVvJgPE8ClugNl8RWth/tU849DvM9sT7vFgfVSHcAS2yDRyDlueii+8nF2ym8XWAPltFVCyLHRsyBp5YPqK8JFYIa1eybKsY3hEAxRCA+/7bq8et+Gj3coOsuRmrehav7rE6N12Pb80I6ofa6SM5XNYq4Xk0iYNx7R3kdz0Jj9XgZYWjAHjJmT0gTRoOnt6upOuxK7xI/ykWrllgpXrCPu3Ymz+c+ujaqcxDopnAl2lmf69/J1"
              }
            ]
          },
          "disablePasswordAuthentication": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithSshAuthentication.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                LinuxConfiguration = new LinuxConfiguration
                {
                    IsPasswordAuthenticationDisabled = true,
                    SshPublicKeys = {new SshPublicKeyConfiguration
                    {
                    Path = "/home/{your-username}/.ssh/authorized_keys",
                    KeyData = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCeClRAk2ipUs/l5voIsDC5q9RI+YSRd1Bvd/O+axgY4WiBzG+4FwJWZm/mLLe5DoOdHQwmU2FrKXZSW4w2sYE70KeWnrFViCOX5MTVvJgPE8ClugNl8RWth/tU849DvM9sT7vFgfVSHcAS2yDRyDlueii+8nF2ym8XWAPltFVCyLHRsyBp5YPqK8JFYIa1eybKsY3hEAxRCA+/7bq8et+Gj3coOsuRmrehav7rE6N12Pb80I6ofa6SM5XNYq4Xk0iYNx7R3kdz0Jj9XgZYWjAHjJmT0gTRoOnt6upOuxK7xI/ykWrllgpXrCPu3Ymz+c+ujaqcxDopnAl2lmf69/J1",
                    }},
                },
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "fb73af19-0090-467c-9ced-b00bceab1c45",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "16.04-LTS",
          "publisher": "Canonical",
          "version": "latest",
          "offer": "UbuntuServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "ssh": {
            "publicKeys": [
              {
                "path": "/home/{your-username}/.ssh/authorized_keys",
                "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCeClRAk2ipUs/l5voIsDC5q9RI+YSRd1Bvd/O+axgY4WiBzG+4FwJWZm/mLLe5DoOdHQwmU2FrKXZSW4w2sYE70KeWnrFViCOX5MTVvJgPE8ClugNl8RWth/tU849DvM9sT7vFgfVSHcAS2yDRyDlueii+8nF2ym8XWAPltFVCyLHRsyBp5YPqK8JFYIa1eybKsY3hEAxRCA+/7bq8et+Gj3coOsuRmrehav7rE6N12Pb80I6ofa6SM5XNYq4Xk0iYNx7R3kdz0Jj9XgZYWjAHjJmT0gTRoOnt6upOuxK7xI/ykWrllgpXrCPu3Ymz+c+ujaqcxDopnAl2lmf69/J1"
              }
            ]
          },
          "disablePasswordAuthentication": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "fb73af19-0090-467c-9ced-b00bceab1c45",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "16.04-LTS",
          "publisher": "Canonical",
          "version": "latest",
          "offer": "UbuntuServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "linuxConfiguration": {
          "ssh": {
            "publicKeys": [
              {
                "path": "/home/{your-username}/.ssh/authorized_keys",
                "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCeClRAk2ipUs/l5voIsDC5q9RI+YSRd1Bvd/O+axgY4WiBzG+4FwJWZm/mLLe5DoOdHQwmU2FrKXZSW4w2sYE70KeWnrFViCOX5MTVvJgPE8ClugNl8RWth/tU849DvM9sT7vFgfVSHcAS2yDRyDlueii+8nF2ym8XWAPltFVCyLHRsyBp5YPqK8JFYIa1eybKsY3hEAxRCA+/7bq8et+Gj3coOsuRmrehav7rE6N12Pb80I6ofa6SM5XNYq4Xk0iYNx7R3kdz0Jj9XgZYWjAHjJmT0gTRoOnt6upOuxK7xI/ykWrllgpXrCPu3Ymz+c+ujaqcxDopnAl2lmf69/J1"
              }
            ]
          },
          "disablePasswordAuthentication": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with terminate scheduled events enabled.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      },
      "scheduledEventsProfile": {
        "terminateNotificationProfile": {
          "enable": true,
          "notBeforeTimeout": "PT5M"
        }
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithTerminateScheduledEventEnabled.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            ScheduledEventsProfile = new ComputeScheduledEventsProfile
            {
                TerminateNotificationProfile = new TerminateNotificationProfile
                {
                    NotBeforeTimeout = "PT5M",
                    Enable = true,
                },
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "scheduledEventsProfile": {
        "terminateNotificationProfile": {
          "enable": true,
          "notBeforeTimeout": "PT5M"
        }
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "scheduledEventsProfile": {
        "terminateNotificationProfile": {
          "enable": true,
          "notBeforeTimeout": "PT5M"
        }
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with Uefi Settings of secureBoot and vTPM.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D2s_v3"
  },
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows10-tvm",
          "publisher": "MicrosoftWindowsServer",
          "version": "18363.592.2001092016",
          "offer": "windowsserver-gen2preview-preview"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "uefiSettings": {
          "secureBootEnabled": true,
          "vTpmEnabled": true
        },
        "securityType": "TrustedLaunch"
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  },
  "location": "westus"
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithUefiSettings.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D2s_v3",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "windowsserver-gen2preview-preview",
                    Sku = "windows10-tvm",
                    Version = "18363.592.2001092016",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadOnly,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardSsdLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            SecurityProfile = new SecurityProfile
            {
                UefiSettings = new UefiSettings
                {
                    IsSecureBootEnabled = true,
                    IsVirtualTpmEnabled = true,
                },
                SecurityType = SecurityType.TrustedLaunch,
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D2s_v3"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows10-tvm",
          "publisher": "MicrosoftWindowsServer",
          "version": "18363.592.2001092016",
          "offer": "windowsserver-gen2preview-preview"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "uefiSettings": {
          "secureBootEnabled": true,
          "vTpmEnabled": true
        },
        "securityType": "TrustedLaunch"
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D2s_v3"
  },
  "name": "{vmss-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "b9e23088-6ffc-46e0-9e02-b0a6eeef47db",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "windows10-tvm",
          "publisher": "MicrosoftWindowsServer",
          "version": "18363.592.2001092016",
          "offer": "windowsserver-gen2preview-preview"
        },
        "osDisk": {
          "caching": "ReadOnly",
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "securityProfile": {
        "uefiSettings": {
          "secureBootEnabled": true,
          "vTpmEnabled": true
        },
        "securityType": "TrustedLaunch"
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus"
}

Create a scale set with userData.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "upgradePolicy": {
      "mode": "Manual"
    },
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "userData": "RXhhbXBsZSBVc2VyRGF0YQ==",
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithUserData.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            UserData = "RXhhbXBsZSBVc2VyRGF0YQ==",
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with virtual machines in different zones.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_A1_v2"
  },
  "location": "centralus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage",
          "diskSizeGB": 512
        },
        "dataDisks": [
          {
            "diskSizeGB": 1023,
            "createOption": "Empty",
            "lun": 0
          },
          {
            "diskSizeGB": 1023,
            "createOption": "Empty",
            "lun": 1
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Automatic"
    }
  },
  "zones": [
    "1",
    "3"
  ]
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithVMsInDifferentZones.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("centralus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_A1_v2",
        Tier = "Standard",
        Capacity = 2L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Automatic,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    DiskSizeGB = 512,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
                DataDisks = {new VirtualMachineScaleSetDataDisk(0, DiskCreateOptionType.Empty)
                {
                DiskSizeGB = 1023,
                }, new VirtualMachineScaleSetDataDisk(1, DiskCreateOptionType.Empty)
                {
                DiskSizeGB = 1023,
                }},
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
    },
    Zones = { "1", "3" },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_A1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": false,
    "overprovision": true,
    "uniqueId": "8042c376-4690-4c47-9fa2-fbdad70e32fa",
    "zoneBalance": false,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage",
          "diskSizeGB": 512
        },
        "dataDisks": [
          {
            "caching": "None",
            "managedDisk": {
              "storageAccountType": "Standard_LRS"
            },
            "createOption": "Empty",
            "lun": 0,
            "diskSizeGB": 1023
          },
          {
            "caching": "None",
            "managedDisk": {
              "storageAccountType": "Standard_LRS"
            },
            "createOption": "Empty",
            "lun": 1,
            "diskSizeGB": 1023
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Automatic"
    },
    "provisioningState": "Succeeded"
  },
  "zones": [
    "1",
    "3"
  ],
  "location": "centralus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_A1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": false,
    "overprovision": true,
    "uniqueId": "8042c376-4690-4c47-9fa2-fbdad70e32fa",
    "zoneBalance": false,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage",
          "diskSizeGB": 512
        },
        "dataDisks": [
          {
            "caching": "None",
            "managedDisk": {
              "storageAccountType": "Standard_LRS"
            },
            "createOption": "Empty",
            "lun": 0,
            "diskSizeGB": 1023
          },
          {
            "caching": "None",
            "managedDisk": {
              "storageAccountType": "Standard_LRS"
            },
            "createOption": "Empty",
            "lun": 1,
            "diskSizeGB": 1023
          }
        ]
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Automatic"
    },
    "provisioningState": "Creating"
  },
  "zones": [
    "1",
    "3"
  ],
  "location": "centralus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with vm size properties

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "upgradePolicy": {
      "mode": "Manual"
    },
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "userData": "RXhhbXBsZSBVc2VyRGF0YQ==",
      "hardwareProfile": {
        "vmSizeProperties": {
          "vCPUsAvailable": 1,
          "vCPUsPerCore": 1
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithVMSizeProperties.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            UserData = "RXhhbXBsZSBVc2VyRGF0YQ==",
            HardwareVmSizeProperties = new VirtualMachineSizeProperties
            {
                VCpusAvailable = 1,
                VCpusPerCore = 1,
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "hardwareProfile": {
        "vmSizeProperties": {
          "vCPUsAvailable": 1,
          "vCPUsPerCore": 1
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "hardwareProfile": {
        "vmSizeProperties": {
          "vCPUsAvailable": 1,
          "vCPUsPerCore": 1
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a scale set with zonalPlatformFaultDomainAlignMode as Aligned

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      }
    },
    "zonalPlatformFaultDomainAlignMode": "Aligned"
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithZonalPlatformFaultDomainAlignMode.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        ScheduledEventsPolicy = new ScheduledEventsPolicy
        {
            UserInitiatedRedeploy = new UserInitiatedRedeploy
            {
                AutomaticallyApprove = true,
            },
            AutomaticallyApprove = true,
            ScheduledEventsAdditionalPublishingTargetsEventGridAndResourceGraph = new EventGridAndResourceGraph
            {
                IsEnabled = true,
            },
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = true,
        ZonalPlatformFaultDomainAlignMode = ZonalPlatformFaultDomainAlignMode.Aligned,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      }
    },
    "provisioningState": "Creating",
    "zonalPlatformFaultDomainAlignMode": "Aligned"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      }
    },
    "provisioningState": "Creating",
    "zonalPlatformFaultDomainAlignMode": "Aligned"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a virtual machine scale set with high-speed interconnect placement.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "orchestrationMode": "Flexible",
    "highSpeedInterconnectPlacement": "None",
    "platformFaultDomainCount": 1,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-focal",
          "sku": "20_04-lts-gen2",
          "version": "latest"
        },
        "osDisk": {
          "createOption": "FromImage",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          }
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "enableAcceleratedNetworking": false,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    },
                    "primary": true,
                    "applicationGatewayBackendAddressPools": [],
                    "loadBalancerBackendAddressPools": [],
                    "publicIPAddressConfiguration": {
                      "name": "{vmss-name}",
                      "properties": {
                        "idleTimeoutInMinutes": 15
                      }
                    }
                  }
                }
              ]
            }
          }
        ],
        "networkApiVersion": "2020-11-01"
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithHighSpeedInterconnectPlacement.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 2L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "Canonical",
                    Offer = "0001-com-ubuntu-server-focal",
                    Sku = "20_04-lts-gen2",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                EnableAcceleratedNetworking = false,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                Primary = true,
                PublicIPAddressConfiguration = new VirtualMachineScaleSetPublicIPAddressConfiguration("{vmss-name}")
                {
                IdleTimeoutInMinutes = 15,
                },
                ApplicationGatewayBackendAddressPools = {},
                LoadBalancerBackendAddressPools = {},
                }},
                EnableIPForwarding = true,
                }},
                NetworkApiVersion = NetworkApiVersion.v2020_11_01,
            },
        },
        PlatformFaultDomainCount = 1,
        OrchestrationMode = OrchestrationMode.Flexible,
        HighSpeedInterconnectPlacement = HighSpeedInterconnectPlacement.None,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": false,
    "highSpeedInterconnectPlacement": "None",
    "orchestrationMode": "Flexible",
    "platformFaultDomainCount": 1,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-focal",
          "sku": "20_04-lts-gen2",
          "version": "latest"
        },
        "osDisk": {
          "createOption": "FromImage",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          }
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "enableAcceleratedNetworking": false,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    },
                    "primary": true,
                    "applicationGatewayBackendAddressPools": [],
                    "loadBalancerBackendAddressPools": [],
                    "publicIPAddressConfiguration": {
                      "name": "{vmss-name}",
                      "properties": {
                        "idleTimeoutInMinutes": 15
                      }
                    }
                  }
                }
              ]
            }
          }
        ],
        "networkApiVersion": "2020-11-01"
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    }
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 2,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": false,
    "highSpeedInterconnectPlacement": "None",
    "orchestrationMode": "Flexible",
    "platformFaultDomainCount": 1,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-focal",
          "sku": "20_04-lts-gen2",
          "version": "latest"
        },
        "osDisk": {
          "createOption": "FromImage",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          }
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "enableAcceleratedNetworking": false,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    },
                    "primary": true,
                    "applicationGatewayBackendAddressPools": [],
                    "loadBalancerBackendAddressPools": [],
                    "publicIPAddressConfiguration": {
                      "name": "{vmss-name}",
                      "properties": {
                        "idleTimeoutInMinutes": 15
                      }
                    }
                  }
                }
              ]
            }
          }
        ],
        "networkApiVersion": "2020-11-01"
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    }
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a virtual machine scale set with LifecycleHooksProfile.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/2e2e3046-f85f-4966-8fd2-5fd7bf6ea717/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 4,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "lifecycleHooksProfile": {
      "lifecycleHooks": [
        {
          "type": "UpgradeAutoOSRollingBatchStarting",
          "waitDuration": "PT20M",
          "defaultAction": "Approve"
        }
      ]
    },
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithLifecycleHooksProfile.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "2e2e3046-f85f-4966-8fd2-5fd7bf6ea717";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 4L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        LifecycleHooks = {new LifecycleHook
        {
        VmScaleSetLifecycleHookEventType = VmScaleSetLifecycleHookEventType.UpgradeAutoOSRollingBatchStarting,
        WaitDuration = XmlConvert.ToTimeSpan("PT20M"),
        DefaultAction = LifecycleHookAction.Approve,
        }},
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 4,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/2e2e3046-f85f-4966-8fd2-5fd7bf6ea717/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "lifecycleHooksProfile": {
      "lifecycleHooks": [
        {
          "type": "UpgradeAutoOSRollingBatchStarting",
          "waitDuration": "PT20M",
          "defaultAction": "Approve"
        }
      ]
    },
    "provisioningState": "Updating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/2e2e3046-f85f-4966-8fd2-5fd7bf6ea717/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 4,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/2e2e3046-f85f-4966-8fd2-5fd7bf6ea717/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      }
    },
    "lifecycleHooksProfile": {
      "lifecycleHooks": [
        {
          "type": "UpgradeAutoOSRollingBatchStarting",
          "waitDuration": "PT20M",
          "defaultAction": "Approve"
        }
      ]
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/2e2e3046-f85f-4966-8fd2-5fd7bf6ea717/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a VMSS with an extension that has suppressFailures enabled

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://{existing-storage-account-name}.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "extensionProfile": {
        "extensions": [
          {
            "name": "{extension-name}",
            "properties": {
              "autoUpgradeMinorVersion": false,
              "publisher": "{extension-Publisher}",
              "type": "{extension-Type}",
              "typeHandlerVersion": "{handler-version}",
              "settings": {},
              "suppressFailures": true
            }
          }
        ]
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithExtensionsSuppressFailuresEnabled.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            BootDiagnostics = new BootDiagnostics
            {
                Enabled = true,
                StorageUri = new Uri("http://{existing-storage-account-name}.blob.core.windows.net"),
            },
            ExtensionProfile = new VirtualMachineScaleSetExtensionProfile
            {
                Extensions = {new VirtualMachineScaleSetExtensionData
                {
                Publisher = "{extension-Publisher}",
                ExtensionType = "{extension-Type}",
                TypeHandlerVersion = "{handler-version}",
                AutoUpgradeMinorVersion = false,
                Settings = BinaryData.FromObjectAsJson(new object()),
                SuppressFailures = true,
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "extensionProfile": {
        "extensions": [
          {
            "name": "{extension-name}",
            "properties": {
              "autoUpgradeMinorVersion": false,
              "publisher": "{extension-Publisher}",
              "type": "{extension-Type}",
              "typeHandlerVersion": "{handler-version}",
              "settings": {},
              "suppressFailures": true
            }
          }
        ]
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "extensionProfile": {
        "extensions": [
          {
            "name": "{extension-name}",
            "properties": {
              "autoUpgradeMinorVersion": false,
              "publisher": "{extension-Publisher}",
              "type": "{extension-Type}",
              "typeHandlerVersion": "{handler-version}",
              "settings": {},
              "suppressFailures": true
            }
          }
        ]
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a VMSS with an extension with protectedSettingsFromKeyVault

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://{existing-storage-account-name}.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "extensionProfile": {
        "extensions": [
          {
            "name": "{extension-name}",
            "properties": {
              "autoUpgradeMinorVersion": false,
              "publisher": "{extension-Publisher}",
              "type": "{extension-Type}",
              "typeHandlerVersion": "{handler-version}",
              "settings": {},
              "protectedSettingsFromKeyVault": {
                "sourceVault": {
                  "id": "/subscriptions/a53f7094-a16c-47af-abe4-b05c05d0d79a/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/kvName"
                },
                "secretUrl": "https://kvName.vault.azure.net/secrets/secretName/79b88b3a6f5440ffb2e73e44a0db712e"
              }
            }
          }
        ]
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithProtectedSettingsFromKeyVault.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            BootDiagnostics = new BootDiagnostics
            {
                Enabled = true,
                StorageUri = new Uri("http://{existing-storage-account-name}.blob.core.windows.net"),
            },
            ExtensionProfile = new VirtualMachineScaleSetExtensionProfile
            {
                Extensions = {new VirtualMachineScaleSetExtensionData
                {
                Publisher = "{extension-Publisher}",
                ExtensionType = "{extension-Type}",
                TypeHandlerVersion = "{handler-version}",
                AutoUpgradeMinorVersion = false,
                Settings = BinaryData.FromObjectAsJson(new object()),
                KeyVaultProtectedSettings = new KeyVaultSecretReference(new Uri("https://kvName.vault.azure.net/secrets/secretName/79b88b3a6f5440ffb2e73e44a0db712e"), new WritableSubResource
                {
                Id = new ResourceIdentifier("/subscriptions/a53f7094-a16c-47af-abe4-b05c05d0d79a/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/kvName"),
                }),
                }},
            },
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "extensionProfile": {
        "extensions": [
          {
            "name": "{extension-name}",
            "properties": {
              "autoUpgradeMinorVersion": false,
              "publisher": "{extension-Publisher}",
              "type": "{extension-Type}",
              "typeHandlerVersion": "{handler-version}",
              "settings": {},
              "protectedSettingsFromKeyVault": {
                "sourceVault": {
                  "id": "/subscriptions/a53f7094-a16c-47af-abe4-b05c05d0d79a/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/kvName"
                },
                "secretUrl": "https://kvName.vault.azure.net/secrets/secretName/79b88b3a6f5440ffb2e73e44a0db712e"
              }
            }
          }
        ]
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "storageUri": "http://nsgdiagnostic.blob.core.windows.net",
          "enabled": true
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "extensionProfile": {
        "extensions": [
          {
            "name": "{extension-name}",
            "properties": {
              "autoUpgradeMinorVersion": false,
              "publisher": "{extension-Publisher}",
              "type": "{extension-Type}",
              "typeHandlerVersion": "{handler-version}",
              "settings": {},
              "protectedSettingsFromKeyVault": {
                "sourceVault": {
                  "id": "/subscriptions/a53f7094-a16c-47af-abe4-b05c05d0d79a/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/kvName"
                },
                "secretUrl": "https://kvName.vault.azure.net/secrets/secretName/79b88b3a6f5440ffb2e73e44a0db712e"
              }
            }
          }
        ]
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create a zones-auto scale set with Max Zone Count

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": false,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "zoneAllocationPolicy": {
        "maxZoneCount": 2
      }
    }
  },
  "placement": {
    "zonePlacementPolicy": "Auto"
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithMaxZoneCount.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_D1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
        },
        Overprovision = false,
        ResiliencyPolicy = new ResiliencyPolicy
        {
            ZoneAllocationPolicy = new ZoneAllocationPolicy
            {
                MaxZoneCount = 2,
            },
        },
    },
    Placement = new VirtualMachinePlacement
    {
        ZonePlacementPolicy = "Auto",
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "zoneAllocationPolicy": {
        "maxZoneCount": 2
      }
    },
    "provisioningState": "Creating"
  },
  "placement": {
    "zonePlacementPolicy": "Auto"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_D1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": false,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "resiliencyPolicy": {
      "zoneAllocationPolicy": {
        "maxZoneCount": 2
      }
    },
    "provisioningState": "Creating"
  },
  "placement": {
    "zonePlacementPolicy": "Auto"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Create or update a scale set with capacity reservation.

Ukázkový požadavek

HTTP
dotnet

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}?api-version=2025-11-01

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "location": "westus",
  "properties": {
    "overprovision": true,
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "adminPassword": "{your-password}"
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"
                    }
                  }
                }
              ]
            }
          }
        ]
      },
      "capacityReservation": {
        "capacityReservationGroup": {
          "id": "subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/CapacityReservationGroups/{crgName}"
        }
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    }
  }
}

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithCapacityReservation.json
// this example is just showing the usage of "VirtualMachineScaleSets_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 = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this VirtualMachineScaleSetResource
VirtualMachineScaleSetCollection collection = resourceGroupResource.GetVirtualMachineScaleSets();

// invoke the operation
string virtualMachineScaleSetName = "{vmss-name}";
VirtualMachineScaleSetData data = new VirtualMachineScaleSetData(new AzureLocation("westus"))
{
    Sku = new ComputeSku
    {
        Name = "Standard_DS1_v2",
        Tier = "Standard",
        Capacity = 3L,
    },
    Properties = new VirtualMachineScaleSetProperties
    {
        UpgradePolicy = new VirtualMachineScaleSetUpgradePolicy
        {
            Mode = VirtualMachineScaleSetUpgradeMode.Manual,
        },
        VirtualMachineProfile = new VirtualMachineScaleSetVmProfile
        {
            OSProfile = new VirtualMachineScaleSetOSProfile
            {
                ComputerNamePrefix = "{vmss-name}",
                AdminUsername = "{your-username}",
                AdminPassword = "{your-password}",
            },
            StorageProfile = new VirtualMachineScaleSetStorageProfile
            {
                ImageReference = new ImageReference
                {
                    Publisher = "MicrosoftWindowsServer",
                    Offer = "WindowsServer",
                    Sku = "2016-Datacenter",
                    Version = "latest",
                },
                OSDisk = new VirtualMachineScaleSetOSDisk(DiskCreateOptionType.FromImage)
                {
                    Caching = CachingType.ReadWrite,
                    ManagedDisk = new VirtualMachineScaleSetManagedDisk
                    {
                        StorageAccountType = StorageAccountType.StandardLrs,
                    },
                },
            },
            NetworkProfile = new VirtualMachineScaleSetNetworkProfile
            {
                NetworkInterfaceConfigurations = {new VirtualMachineScaleSetNetworkConfiguration("{vmss-name}")
                {
                Primary = true,
                IPConfigurations = {new VirtualMachineScaleSetIPConfiguration("{vmss-name}")
                {
                SubnetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/{existing-virtual-network-name}/subnets/{existing-subnet-name}"),
                }},
                EnableIPForwarding = true,
                }},
            },
            CapacityReservationGroupId = new ResourceIdentifier("subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/CapacityReservationGroups/{crgName}"),
        },
        Overprovision = true,
    },
};
ArmOperation<VirtualMachineScaleSetResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualMachineScaleSetName, data);
VirtualMachineScaleSetResource 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
VirtualMachineScaleSetData 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

Ukázková odpověď

Stavový kód:: 200

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "capacityReservation": {
        "capacityReservationGroup": {
          "id": "subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/CapacityReservationGroups/{crgName}"
        }
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Stavový kód:: 201

{
  "sku": {
    "tier": "Standard",
    "capacity": 3,
    "name": "Standard_DS1_v2"
  },
  "name": "{vmss-name}",
  "properties": {
    "singlePlacementGroup": true,
    "overprovision": true,
    "uniqueId": "d053ec5a-8da6-495f-ab13-38216503c6d7",
    "virtualMachineProfile": {
      "storageProfile": {
        "imageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS"
          },
          "createOption": "FromImage"
        }
      },
      "osProfile": {
        "computerNamePrefix": "{vmss-name}",
        "adminUsername": "{your-username}",
        "secrets": [],
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "{vmss-name}",
            "properties": {
              "dnsSettings": {
                "dnsServers": []
              },
              "primary": true,
              "enableIPForwarding": true,
              "ipConfigurations": [
                {
                  "name": "{vmss-name}",
                  "properties": {
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/nsgExistingVnet/subnets/nsgExistingSubnet"
                    },
                    "privateIPAddressVersion": "IPv4"
                  }
                }
              ],
              "enableAcceleratedNetworking": false
            }
          }
        ]
      },
      "capacityReservation": {
        "capacityReservationGroup": {
          "id": "subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/CapacityReservationGroups/{crgName}"
        }
      },
      "securityProfile": {
        "securityType": "Standard"
      }
    },
    "upgradePolicy": {
      "mode": "Manual"
    },
    "provisioningState": "Creating"
  },
  "location": "westus",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
}

Definice

Name	Description
AdditionalCapabilities	Povolí nebo zakáže funkci na virtuálním počítači nebo škálovací sadě virtuálních počítačů.
AdditionalUnattendContent	Specifikuje další XML formátované informace, které lze zahrnout do Unattend.xml souboru, který používá Windows Setup. Obsah se definuje nastavením názvu, názvu komponenty a předáním, ve kterém se obsah použije.
AllInstancesDown	Určuje, zda mají být naplánované události automaticky schváleny, když jsou všechny instance mimo provoz.
AllocationStrategy	Určuje strategii přidělování pro škálovací sadu virtuálních počítačů, na základě které budou virtuální počítače přiděleny.
ApiEntityReference	Referenční informace k entitě rozhraní API.
ApiError	Chyba rozhraní API.
ApiErrorBase	Chybová základna API.
ApplicationProfile	Obsahuje seznam aplikací galerie, které by měly být zpřístupněny virtuálnímu počítači nebo službě VMSS.
AutomaticOSUpgradePolicy	Parametry konfigurace používané k automatickému upgradu operačního systému.
AutomaticRepairsPolicy	Určuje parametry konfigurace pro automatické opravy ve škálovací sadě virtuálních počítačů.
AutomaticZoneRebalancingPolicy	Parametry konfigurace použité při automatickém vyrovnávání az.
BillingProfile	Určuje podrobnosti související s fakturací spotového virtuálního počítače Azure nebo VMSS. Minimální verze api: 2019-03-01.
BootDiagnostics	Diagnostika spouštění je funkce ladění, která umožňuje zobrazit výstup konzoly a snímek obrazovky pro diagnostiku stavu virtuálního počítače. Výstup protokolu konzoly můžete snadno zobrazit. Azure také umožňuje vidět screenshot VM z hypervisoru.
CachingTypes	Určuje požadavky na ukládání do mezipaměti. Možné hodnoty jsou: None,ReadOnly,ReadWrite. Výchozí hodnoty jsou: Žádné pro úložiště Standard. Jen pro čtení pro úložiště Premium
CapacityReservationProfile	Parametry profilu rezervace kapacity.
CloudError	Chybová odpověď ze služby Compute.
Common.UserAssignedIdentitiesValue
ComponentNames
createdByType	Typ identity, která prostředek vytvořila.
DeleteOptions	Určení toho, co se stane se síťovým rozhraním při odstranění virtuálního počítače
DiagnosticsProfile	Určuje stav nastavení diagnostiky spouštění. Minimální verze api: 2015-06-15.
DiffDiskOptions	Určuje možnost dočasného disku pro disk operačního systému.
DiffDiskPlacement	Určuje dočasné umístění disku pro disk operačního systému. Tuto vlastnost může uživatel použít v požadavku k výběru umístění, tj. disku mezipaměti, disku prostředků nebo místa na disku nvme pro zřizování disku dočasného operačního systému. Pro více informací o požadavcích na velikost disku Ephemeral OS prosím viz požadavky na velikost disku Ephemeral OS pro Windows VM na https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements a Linux VM na https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Minimální verze api pro NvmeDisk: 2024-03-01.
DiffDiskSettings	Popisuje parametry dočasných nastavení disku, které lze zadat pro disk s operačním systémem. Poznámka: Nastavení dočasného disku lze zadat pouze pro spravovaný disk.
DiskControllerTypes	Určuje typ řadiče disku nakonfigurovaného pro virtuální počítač a VirtualMachineScaleSet. Tato vlastnost je podporována pouze pro virtuální stroje, jejichž operační systém a VM SKU podporují Generation 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), zkontrolujte prosím schopnost HyperVGenerations, která byla vrácena jako součást VM sku v reakci na Microsoft. API Compute SKU pro danou oblast obsahuje V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Další informace o podporovaných typech řadiče disku naleznete v tématu https://aka.ms/azure-diskcontrollertypes.
DiskCreateOptionTypes	Určuje způsob vytvoření disku virtuálního počítače. Možné hodnoty jsou Attach: Tato hodnota se používá při použití specializovaného disku k vytvoření virtuálního počítače. FromImage: Tato hodnota se používá při použití image k vytvoření virtuálního počítače. Pokud používáte image platformy, měli byste také použít element imageReference popsaný výše. Pokud používáte image marketplace, měli byste také použít dříve popsaný prvek plánu. Prázdné: Tato hodnota se používá při vytváření prázdného datového disku. Kopírovat: Tato hodnota slouží k vytvoření datového disku ze snímku nebo jiného disku. Obnovení: Tato hodnota slouží k vytvoření datového disku z bodu obnovení disku.
DiskDeleteOptionTypes	Určuje chování spravovaného disku při odstranění virtuálního počítače, například jestli je spravovaný disk odstraněný nebo odpojený. Podporované hodnoty jsou: Delete. Pokud se tato hodnota použije, spravovaný disk se odstraní při odstranění virtuálního počítače. Odpojit. Pokud se tato hodnota použije, spravovaný disk se zachová po odstranění virtuálního počítače. Minimální verze api: 2021-03-01.
DiskEncryptionSetParameters	Popisuje parametr sady prostředků sady prostředků spravovaného zákazníkem pro šifrování disků, který lze zadat pro disk. Poznámka: ID prostředku sady šifrování disku lze zadat pouze pro spravovaný disk. Další podrobnosti najdete v https://aka.ms/mdssewithcmkoverview.
DomainNameLabelScopeTypes	Obor popisku názvu domény. Zřetězení popisku názvu domény hash, který se vygeneroval podle zásad z oboru popisku názvu domény a indexu virtuálního počítače, bude popisky názvů domén prostředků PublicIPAddress, které se vytvoří.
EncryptionIdentity	Určuje spravovanou identitu používanou službou ADE k získání přístupového tokenu pro operace služby KeyVault.
EventGridAndResourceGraph	Určuje konfiguraci související s naplánovanými událostmi eventGridAndResourceGraph.
ExtendedLocation	Komplexní typ rozšířeného umístění.
ExtendedLocationTypes	Typ rozšířeného umístění.
ExternalHealthPolicy	Specifikuje externí zdravotní politiku pro škálovací sadu virtuálních strojů.
HighSpeedInterconnectPlacement	Určuje umístění vysokorychlostního propojení pro škálovací sadu virtuálních počítačů.
HostEndpointSettings	Určuje konkrétní nastavení koncového bodu hostitele.
ImageReference	Určuje informace o obrázku, který se má použít. Můžete zadat informace o imagích platformy, imagích marketplace nebo imagích virtuálních počítačů. Tento prvek se vyžaduje, pokud chcete použít image platformy, image marketplace nebo image virtuálního počítače, ale nepoužívá se v jiných operacích vytváření. POZNÁMKA: Odkaz na image a nabídka lze nastavit pouze při vytváření škálovací sady.
InnerError	Podrobnosti vnitřní chyby.
IPVersion	K dispozici od verze Api-Version 2017-03-30 dále představuje, jestli je konkrétní konfigurace ip adres IPv4 nebo IPv6. Výchozí hodnota se považuje za protokol IPv4. Možné hodnoty jsou: IPv4 a IPv6.
KeyVaultSecretReference	Popisuje odkaz na Key Vault Secret
LifecycleHook	Popisuje háček na životní cyklus.
LifecycleHookAction	Akce, která bude aplikována na cílový zdroj v události lifecycle cyklu virtuálního stroje, pokud platforma nedostane odpověď od zákazníka na cílový zdroj před čekáním na dozadu.
LifecycleHooksProfile	Specifikuje profil hooků životního cyklu pro škálovací sadu virtuálních strojů.
LinuxConfiguration	Určuje nastavení operačního systému Linux na virtuálním počítači. Pro seznam podporovaných linuxových distribucí viz Linux on Azure-Endorsed Distributions.
LinuxPatchAssessmentMode	Určuje režim posouzení oprav hosta virtuálního počítače pro virtuální počítač IaaS. Možné hodnoty: imageDefault – řídíte načasování posouzení oprav na virtuálním počítači. AutomaticByPlatform – platforma aktivuje pravidelná hodnocení oprav. Vlastnost provisionVMAgent musí být true.
LinuxPatchSettings	Určuje nastavení související s opravami hosta virtuálního počítače v Linuxu.
LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Určuje nastavení restartování pro všechny operace instalace oprav AutomaticByPlatform.
LinuxVMGuestPatchAutomaticByPlatformSettings	Určuje další nastavení, která se použijí při výběru režimu oprav AutomaticByPlatform v nastavení opravy Linuxu.
LinuxVMGuestPatchMode	Určuje režim oprav hosta virtuálního počítače na virtuální počítač IaaS nebo virtuální počítače přidružené ke škálovací sadě virtuálních počítačů s orchestrationMode jako flexibilní. Možné hodnoty: imageDefault – použije se výchozí konfigurace oprav virtuálního počítače. AutomaticByPlatform – virtuální počítač se automaticky aktualizuje platformou. Vlastnost provisionVMAgent musí být pravdivá.
MaxInstancePercentPerZonePolicy	Parametry konfigurace používané k omezení počtu virtuálních počítačů na zónu dostupnosti ve škálovací sadě virtuálních počítačů.
Mode	Určuje režim, na který se bude agent Proxy Agent spouštět, pokud je tato funkce povolená. ProxyAgent se začne auditovat nebo monitorovat, ale nebude vynucovat řízení přístupu nad požadavky na koncové body hostitele v režimu auditování, zatímco v režimu vynucení vynutí řízení přístupu. Výchozí hodnota je Režim vynucení.
Modes	Určuje režim provádění. V režimu auditování systém funguje, jako by vynucovala zásady řízení přístupu, včetně generování položek odepření přístupu v protokolech, ale ve skutečnosti neodmítá žádné požadavky na koncové body hostitele. V režimu vynucení systém vynucuje řízení přístupu a jedná se o doporučený režim operace.
NetworkApiVersion	specifikuje Microsoft. Verze Network API používaná při vytváření síťových zdrojů v konfiguracích síťového rozhraní
NetworkInterfaceAuxiliaryMode	Určuje, zda je pro prostředek síťového rozhraní povolen pomocný režim.
NetworkInterfaceAuxiliarySku	Určuje, zda je pro prostředek síťového rozhraní povolena skladová položka Pomocné položky.
OperatingSystemTypes	Tato vlastnost umožňuje určit typ operačního systému, který je součástí disku při vytváření virtuálního počítače z vlastní image. Možné hodnoty jsou: Windows,Linux.
OperationRecoverySettings	Konfigurační parametry používané pro nastavení obnovy operace na škálovací sadě virtuálních strojů.
OrchestrationMode	Určuje režim orchestrace pro škálovací sadu virtuálních počítačů.
OSImageNotificationProfile
PassNames
PatchSettings	Specifikuje nastavení týkající se hostování VM na Windows.
Placement	Popisuje uživatelem definovaná omezení pro umístění hardwaru prostředků.
Plan	Určuje informace o imagi marketplace použité k vytvoření virtuálního počítače. Tento prvek se používá jenom pro image z marketplace. Než budete moct použít image z marketplace z rozhraní API, musíte image povolit pro programové použití. Na webu Azure Portal vyhledejte image marketplace, kterou chcete použít, a potom klikněte na Chcete nasadit programově, začněte –>. Zadejte požadované informace a klikněte na Uložit.
PriorityMixPolicy	Určuje cílové rozdělení pro spotové a běžné virtuální počítače s prioritou ve škálovací sadě s flexibilním režimem orchestrace. S touto vlastností může zákazník zadat základní počet běžných virtuálních počítačů s prioritou vytvořených při horizontálním navýšení kapacity instance flex VMSS a rozdělení mezi spotové a běžné virtuální počítače s prioritou po dosažení tohoto základního cíle.
ProtocolTypes	Určuje protokol naslouchacího procesu WinRM. Možné hodnoty jsou: http,https.
ProxyAgentSettings	Určuje nastavení ProxyAgent pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Minimální verze rozhraní API: 2023-09-01.
PublicIPAddressSku	Popisuje skladovou položku veřejné IP adresy. Dá se nastavit jenom s orchestrationMode jako flexibilní.
PublicIPAddressSkuName	Zadání názvu skladové položky veřejné IP adresy
PublicIPAddressSkuTier	Zadání úrovně skladové položky veřejné IP adresy
RebalanceBehavior	Typ chování vyrovnávání, které se použije k opětovnému vytvoření virtuálních počítačů ve škálovací sadě napříč zónami dostupnosti. Výchozí a podporovaná hodnota je teď CreateBeforeDelete.
RebalanceStrategy	Typ strategie vyrovnávání, která se použije k vyrovnávání virtuálních počítačů ve škálovací sadě napříč zónami dostupnosti. Výchozí a podporovaná hodnota je teď znovu vytvoření.
ReimageRecoveryPolicy	Konfigurační parametry použité při obnově reimage.
RepairAction	Typ akce opravy (nahrazení, restartování, obnovení image), která se použije k opravě virtuálních počítačů, které nejsou v pořádku ve škálovací sadě. Výchozí hodnota je nahrazena.
ResiliencyPolicy	Popisuje politiku odolnosti - AutomaticZoneRebalancingPolicy, ResilientVMCreationPolicy, ResilientVMDeletionPolicy a OperationRecoverySettings (verze > 2025-11-01).
ResilientVMCreationPolicy	Parametry konfigurace použité při vytváření odolných virtuálních počítačů.
ResilientVMDeletionPolicy	Parametry konfigurace použité při odstraňování odolných virtuálních počítačů.
ResourceIdentityType	Typ identity používané pro virtuální počítač. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere všechny identity z virtuálního počítače.
RestartRecoveryPolicy	Konfigurační parametry použité při obnově restartu.
RollingUpgradePolicy	Parametry konfigurace použité při postupném upgradu.
ScaleInPolicy	Popisuje zásadu horizontálního snížení kapacity pro škálovací sadu virtuálních počítačů.
ScheduledEventsAdditionalPublishingTargets
ScheduledEventsPolicy	Určuje konfigurace související s plánovanými událostmi ScheduledDeploy, Reboot a ScheduledEventsAdditionalPublishingTargets.
ScheduledEventsProfile
SecurityEncryptionTypes	Určuje Typ šifrování spravovaného disku. Je nastavena na DiskWithVMGuestState pro šifrování spravovaného disku spolu s objekty blob VMGuestState, VMGuestStateOnly pro šifrování pouze objektu blob VMGuestState a NonPersistedTPM pro neuchovávání stavu firmwaru v objektu blob VMGuestState. Poznámka: lze nastavit pouze pro důvěrné virtuální počítače.
SecurityPostureReference	Určuje stav zabezpečení, který se má použít ve škálovací sadě. Minimální verze api: 2023-03-01
SecurityProfile	Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů.
SecurityTypes	Specifikuje VM securityType; UefiSettings jsou povoleny pouze při nastavení na TrustedLaunch nebo ConfidentialVM a vrací standardní hodnotu od verze API 2025-11-01.
ServiceArtifactReference	Určuje ID odkazu na artefakt služby použité k nastavení stejné verze image pro všechny virtuální počítače ve škálovací sadě při použití nejnovější verze image. Minimální verze api: 2022-11-01
SettingNames	Určuje název nastavení, na které se obsah vztahuje. Možné hodnoty jsou: FirstLogonCommands a AutoLogon.
Sku	Popisuje skladovou položku škálovací sady virtuálních počítačů. POZNÁMKA: Pokud nová skladová položka virtuálního počítače není na hardwaru aktuálně zapnutá, musíte virtuální počítače ve škálovací sadě uvolnit před úpravou názvu skladové položky.
SkuProfile	Určuje profil skladové položky pro škálovací sadu virtuálních počítačů. U této vlastnosti může zákazník zadat seznam velikostí virtuálních počítačů a strategii přidělení.
SkuProfileVMSize	Určuje velikost virtuálního počítače.
SpotRestorePolicy	Určuje spotovéTry-Restore vlastnosti škálovací sady virtuálních počítačů. U této vlastnosti může zákazník povolit nebo zakázat automatické obnovení vyřazených instancí spotových virtuálních počítačů VMSS na základě dostupnosti kapacity a cenového omezení.
SshConfiguration	SSH konfigurace pro linuxové VM běžící na Azure
SshPublicKey	Obsahuje informace o veřejném klíči certifikátu SSH a cestě na virtuálním počítači s Linuxem, kde je veřejný klíč umístěný.
StartRecoveryPolicy	Konfigurační parametry použité při obnově startu.
StorageAccountTypes	Určuje typ účtu úložiště pro spravovaný disk. Typ účtu úložiště spravovaného disku s operačním systémem se dá nastavit jenom při vytváření škálovací sady. POZNÁMKA: UltraSSD_LRS lze použít pouze s datovými disky. Nejde ho použít s diskem s operačním systémem. Standard_LRS používá hdd úrovně Standard. StandardSSD_LRS používá SSD úrovně Standard. Premium_LRS používá SSD úrovně Premium. UltraSSD_LRS používá disk Úrovně Ultra. Premium_ZRS používá zónově redundantní úložiště SSD úrovně Premium. StandardSSD_ZRS používá zónově redundantní úložiště SSD úrovně Standard. Pro více informací o discích podporovaných pro Windows Virtual Machines viz https://docs.microsoft.com/azure/virtual-machines/windows/disks-types a pro Linux Virtual Machines https://docs.microsoft.com/azure/virtual-machines/linux/disks-types
StorageFaultDomainAlignmentType	Specifikuje typ zarovnání domény chyb úložiště pro disk.
SubResource
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
TerminateNotificationProfile
UefiSettings	Určuje nastavení zabezpečení, jako je zabezpečené spouštění a vTPM použité při vytváření virtuálního počítače. Minimální verze api: 2020-12-01.
UpgradeMode	Určuje režim upgradu na virtuální počítače ve škálovací sadě. Možné hodnoty: Ruční – řídíte aplikaci aktualizací virtuálních počítačů ve škálovací sadě. Provedete to pomocí akce manualUpgrade. Automatické – Všechny virtuální počítače ve škálovací sadě se automaticky aktualizují současně.
UpgradePolicy	Popisuje zásady upgradu – automatické, ruční nebo postupné.
UserInitiatedReboot	Určuje konfigurace související s naplánovanými událostmi související s restartováním.
UserInitiatedRedeploy	Určuje opětovné nasazení souvisejících konfigurací souvisejících s naplánovanými událostmi.
VaultCertificate	Popisuje jediný odkaz na certifikát v Key Vault a kde by měl být certifikát umístěn ve VM.
VaultSecretGroup	Popisuje sadu certifikátů, které jsou všechny ve stejném Key Vault.
VirtualHardDisk	Popisuje identifikátor URI disku.
VirtualMachineEvictionPolicyTypes	Určuje zásady vyřazení pro spotový virtuální počítač/VMSS Azure
VirtualMachinePriorityTypes	Určuje prioritu pro samostatný virtuální počítač nebo virtuální počítače ve škálovací sadě. Výčet "Nízký" bude v budoucnu zastaralý, použijte prosím "Spot" jako výčet pro nasazení spotového virtuálního počítače/VMSS Azure.
VirtualMachineScaleSet	Popisuje škálovací sadu virtuálních počítačů.
VirtualMachineScaleSetDataDisk	Popisuje datový disk škálovací sady virtuálních počítačů.
VirtualMachineScaleSetExtension	Popisuje rozšíření škálovací sady virtuálních počítačů.
VirtualMachineScaleSetExtensionProfile	Popisuje profil rozšíření škálovací sady virtuálních počítačů.
VirtualMachineScaleSetHardwareProfile	Určuje nastavení hardwaru pro škálovací sadu virtuálních počítačů.
VirtualMachineScaleSetIdentity	Identita škálovací sady virtuálních počítačů
VirtualMachineScaleSetIPConfiguration	Popisuje konfiguraci PROTOKOLU IP profilu sítě škálovací sady virtuálních počítačů.
VirtualMachineScaleSetIpTag	Obsahuje značku IP přidruženou k veřejné IP adrese.
VirtualMachineScaleSetManagedDiskParameters	Popisuje parametry spravovaného disku ScaleSet.
VirtualMachineScaleSetNetworkConfiguration	Popisuje síťové konfigurace síťového profilu škálovací sady virtuálních počítačů.
VirtualMachineScaleSetNetworkConfigurationDnsSettings	Popisuje nastavení DNS konfigurace sítě škálovacích sad virtuálních počítačů.
VirtualMachineScaleSetNetworkProfile	Popisuje profil sítě škálovací sady virtuálních počítačů.
VirtualMachineScaleSetOSDisk	Popisuje disk operačního systému škálovací sady virtuálních počítačů.
VirtualMachineScaleSetOSProfile	Popisuje profil operačního systému škálovací sady virtuálních počítačů.
VirtualMachineScaleSetPublicIPAddressConfiguration	Popisuje konfiguraci PublicIPAddress konfigurace IP adres škálovací sady virtuálních počítačů.
VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings	Popisuje nastavení DNS konfigurace sítě škálovacích sad virtuálních počítačů.
VirtualMachineScaleSetScaleInRules
VirtualMachineScaleSetStorageProfile	Popisuje profil úložiště škálovací sady virtuálních počítačů.
VirtualMachineScaleSetVMProfile	Popisuje profil virtuálního počítače škálovací sady virtuálních počítačů.
VMDiskSecurityProfile	Určuje nastavení profilu zabezpečení pro spravovaný disk. Poznámka: Lze ho nastavit pouze pro důvěrné virtuální počítače.
VMGalleryApplication	Určuje požadované informace pro odkaz na verzi aplikace v galerii výpočetních prostředků.
VMScaleSetLifecycleHookEventType	Specifikuje scénář, ve kterém má zákazník zájem přijímat události lifecycle hooku na škálování sady virtuálních strojů.
VMSizeProperties	Určuje nastavení vlastnosti velikosti virtuálního počítače na virtuálním počítači.
WindowsConfiguration	Specifikuje nastavení operačního systému Windows na virtuálním stroji.
WindowsPatchAssessmentMode	Určuje režim posouzení oprav hosta virtuálního počítače pro virtuální počítač IaaS. Možné hodnoty: imageDefault – řídíte načasování posouzení oprav na virtuálním počítači. AutomaticByPlatform – platforma aktivuje pravidelná hodnocení oprav. Vlastnost provisionVMAgent musí být true.
WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Určuje nastavení restartování pro všechny operace instalace oprav AutomaticByPlatform.
WindowsVMGuestPatchAutomaticByPlatformSettings	Specifikuje další nastavení, která se mají aplikovat, když je v nastavení patch v nastavení Windows zvolen režim záplat AutomaticByPlatform.
WindowsVMGuestPatchMode	Určuje režim oprav hosta virtuálního počítače na virtuální počítač IaaS nebo virtuální počítače přidružené ke škálovací sadě virtuálních počítačů s orchestrationMode jako flexibilní. Možné hodnoty: Ruční – řídíte použití oprav na virtuální počítač. Provedete to ručním použitím oprav uvnitř virtuálního počítače. V tomto režimu jsou automatické aktualizace zakázány; Vlastnost WindowsConfiguration.enableAutomaticUpdates musí být false. AutomaticByOS – operační systém automaticky aktualizuje virtuální počítač. Vlastnost WindowsConfiguration.enableAutomaticUpdates musí být true. AutomaticByPlatform – virtuální počítač se automaticky aktualizuje platformou. Vlastnosti provisionVMAgent a WindowsConfiguration.enableAutomaticUpdates musí být pravdivé.
WinRMConfiguration	Popisuje konfiguraci vzdálené správy Windows VM
WinRMListener	Popisuje protokol a otisk palce Windows Remote Management posluchače
ZonalPlatformFaultDomainAlignMode	Určuje režim zarovnání mezi výpočetní sadou virtuálních počítačů a počtem domén selhání úložiště.
ZoneAllocationPolicy	Parametry konfigurace pro přidělování zón škálovací sady virtuálních počítačů.
ZonePlacementPolicyType	Určuje zásadu pro umístění zdroje v zóně dostupnosti. Možné hodnoty jsou: Any (používá se pro Virtual Machines), Auto (používá se pro Virtual Machine Scale Sets) - Dostupnostní zóna bude automaticky vybrána systémem jako součást tvorby zdrojů.

AdditionalCapabilities

Objekt

Povolí nebo zakáže funkci na virtuálním počítači nebo škálovací sadě virtuálních počítačů.

Name	Typ	Description
enableFips1403Encryption	boolean	Příznak umožňuje použití kryptografie kompatibilní se standardem FIPS 140-3 v protectedSettings rozšíření. Další informace najdete tady: https://aka.ms/linuxagentfipssupport.
hibernationEnabled	boolean	Příznak, který povolí nebo zakáže funkci hibernace na virtuálním počítači.
ultraSSDEnabled	boolean	Příznak, který povolí nebo zakáže schopnost mít jeden nebo více spravovaných datových disků s typem účtu úložiště UltraSSD_LRS na virtuálním počítači nebo VMSS. Spravované disky s typem účtu úložiště UltraSSD_LRS lze přidat do virtuálního počítače nebo škálovací sady virtuálních počítačů pouze v případě, že je tato vlastnost povolená.

AdditionalUnattendContent

Objekt

Specifikuje další XML formátované informace, které lze zahrnout do Unattend.xml souboru, který používá Windows Setup. Obsah se definuje nastavením názvu, názvu komponenty a předáním, ve kterém se obsah použije.

Name	Typ	Description
componentName	ComponentNames	Název komponenty. V současnosti je jedinou povolenou hodnotou Microsoft-Windows-Shell-Setup.
content	string	Určuje formátovaný obsah XML, který je přidán do souboru unattend.xml pro zadanou cestu a součást. Xml musí být menší než 4 kB a musí obsahovat kořenový prvek pro nastavení nebo funkci, která se vkládá.
passName	PassNames	Název pass. V současné době je jedinou povolenou hodnotou OobeSystem.
settingName	SettingNames	Určuje název nastavení, na které se obsah vztahuje. Možné hodnoty jsou: FirstLogonCommands a AutoLogon.

AllInstancesDown

Objekt

Určuje, zda mají být naplánované události automaticky schváleny, když jsou všechny instance mimo provoz.

Name	Typ	Description
automaticallyApprove	boolean	Určuje, zda mají být naplánované události automaticky schváleny, když jsou všechny instance mimo provoz. jeho výchozí hodnota je true

AllocationStrategy

Výčet

Určuje strategii přidělování pro škálovací sadu virtuálních počítačů, na základě které budou virtuální počítače přiděleny.

Hodnota	Description
LowestPrice
CapacityOptimized
Prioritized

ApiEntityReference

Objekt

Referenční informace k entitě rozhraní API.

Name	Typ	Description
id	string	ID prostředku ARM ve tvaru /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Objekt

Chyba rozhraní API.

Name	Typ	Description
code	string	Kód chyby.
details	ApiErrorBase[]	Podrobnosti o chybě rozhraní API
innererror	InnerError	Vnitřní chyba Api
message	string	Chybová zpráva.
target	string	Cíl konkrétní chyby.

ApiErrorBase

Objekt

Chybová základna API.

Name	Typ	Description
code	string	Kód chyby.
message	string	Chybová zpráva.
target	string	Cíl konkrétní chyby.

ApplicationProfile

Objekt

Obsahuje seznam aplikací galerie, které by měly být zpřístupněny virtuálnímu počítači nebo službě VMSS.

Name	Typ	Description
galleryApplications	VMGalleryApplication[]	Určuje aplikace galerie, které mají být zpřístupněny virtuálnímu počítači nebo VMSS.

AutomaticOSUpgradePolicy

Objekt

Parametry konfigurace používané k automatickému upgradu operačního systému.

Name	Typ	Description
disableAutomaticRollback	boolean	Určuje, jestli má být funkce vrácení image operačního systému zakázaná. Výchozí hodnota je nepravda.
enableAutomaticOSUpgrade	boolean	Označuje, jestli se upgrady operačního systému mají automaticky použít u instancí škálovací sady, a to v případě, že bude k dispozici novější verze image operačního systému. Výchozí hodnota je nepravda. Pokud je tato hodnota nastavena na hodnotu true pro škálovací sady založené na Windows, enableAutomaticUpdates je automaticky nastavena na false a nelze ji nastavit na true.
osRollingUpgradeDeferral	boolean	Určuje, jestli by se u automatického upgradu operačního systému mělo provést odložení. Odložené upgrady operačního systému budou posílat upřesňující oznámení na základě jednotlivých virtuálních počítačů, že upgrade operačního systému z postupných upgradů je příchozí, prostřednictvím značky IMDS Platform.PendingOSUpgrade. Upgrade se pak odrazí, dokud se upgrade neschválí prostřednictvím volání ApproveRollingUpgrade.
useRollingUpgradePolicy	boolean	Označuje, jestli se při automatickém upgradu operačního systému mají používat zásady postupného upgradu. Výchozí hodnota je nepravda. Pokud v sadě VMSS není definovaná žádná zásada, automatický upgrade operačního systému se vrátí k výchozím zásadám.

AutomaticRepairsPolicy

Objekt

Určuje parametry konfigurace pro automatické opravy ve škálovací sadě virtuálních počítačů.

Name	Typ	Description
enabled	boolean	Určuje, jestli se mají ve škálovací sadě virtuálních počítačů povolit automatické opravy. Výchozí hodnota je false.
gracePeriod	string	Doba, po kterou jsou automatické opravy pozastavené kvůli změně stavu na virtuálním počítači. Čas odkladu začíná po dokončení změny stavu. To pomáhá vyhnout se předčasně nebo náhodným opravám. Doba trvání by měla být zadána ve formátu ISO 8601. Minimální povolená doba odkladu je 10 minut (PT10M), což je také výchozí hodnota. Maximální povolená doba odkladu je 90 minut (PT90M).
repairAction	RepairAction	Typ akce opravy (nahrazení, restartování, obnovení image), která se použije k opravě virtuálních počítačů, které nejsou v pořádku ve škálovací sadě. Výchozí hodnota je nahrazena.

AutomaticZoneRebalancingPolicy

Objekt

Parametry konfigurace použité při automatickém vyrovnávání az.

Name	Typ	Description
enabled	boolean	Určuje, jestli má být ve škálovací sadě virtuálních počítačů povolené automatické vyrovnávání dostupnosti. Výchozí hodnota je false.
rebalanceBehavior	RebalanceBehavior	Typ chování vyrovnávání, které se použije k opětovnému vytvoření virtuálních počítačů ve škálovací sadě napříč zónami dostupnosti. Výchozí a podporovaná hodnota je teď CreateBeforeDelete.
rebalanceStrategy	RebalanceStrategy	Typ strategie vyrovnávání, která se použije k vyrovnávání virtuálních počítačů ve škálovací sadě napříč zónami dostupnosti. Výchozí a podporovaná hodnota je teď znovu vytvoření.

BillingProfile

Objekt

Určuje podrobnosti související s fakturací spotového virtuálního počítače Azure nebo VMSS. Minimální verze api: 2019-03-01.

Name	Typ	Description
maxPrice	number (double)	Určuje maximální cenu, kterou jste ochotni zaplatit za spotový virtuální počítač nebo službu VMSS Azure. Tato cena je v amerických dolarech. Tato cena se porovná s aktuální spotovou cenou Azure pro velikost virtuálního počítače. Ceny se také porovnávají v době vytvoření/aktualizace spotového virtuálního počítače nebo VMSS Azure a operace bude úspěšná, pouze pokud je maximální cena vyšší než aktuální spotová cena Azure. Maximální cena se použije také k vyřazení spotového virtuálního počítače nebo služby VMSS Azure, pokud aktuální spotová cena Azure po vytvoření virtuálního počítače nebo VMSS překročí maximální cenu. Možné hodnoty: - Jakákoli desetinná hodnota větší než nula. Příklad: 0.01538 -1 – označuje výchozí cenu, která se má up-to na vyžádání. Maximální cenu můžete nastavit na -1, aby bylo možné označit, že spotový virtuální počítač nebo VMSS Azure by se neměl vyřakovat z důvodů ceny. Výchozí maximální cena je také -1, pokud ji neposkytujete. Minimální verze api: 2019-03-01.

BootDiagnostics

Objekt

Diagnostika spouštění je funkce ladění, která umožňuje zobrazit výstup konzoly a snímek obrazovky pro diagnostiku stavu virtuálního počítače. Výstup protokolu konzoly můžete snadno zobrazit. Azure také umožňuje vidět screenshot VM z hypervisoru.

Name	Typ	Description
enabled	boolean	Určuje, jestli má být na virtuálním počítači povolená diagnostika spouštění.
storageUri	string	Identifikátor URI účtu úložiště, který se má použít k umístění výstupu konzoly a snímku obrazovky. Pokud se při povolování diagnostiky spouštění nezadá identifikátor STORAGEURI, použije se spravované úložiště.

CachingTypes

Výčet

Určuje požadavky na ukládání do mezipaměti. Možné hodnoty jsou: None,ReadOnly,ReadWrite. Výchozí hodnoty jsou: Žádné pro úložiště Standard. Jen pro čtení pro úložiště Premium

Hodnota	Description
None
ReadOnly
ReadWrite

CapacityReservationProfile

Objekt

Parametry profilu rezervace kapacity.

Name	Typ	Description
capacityReservationGroup	SubResource	Určuje ID prostředku skupiny rezervací kapacity, které by se mělo použít k přidělování instancí virtuálních počítačů nebo škálovací sady za předpokladu, že byla rezervována dostatečná kapacita. Další podrobnosti najdete v https://aka.ms/CapacityReservation.

CloudError

Objekt

Chybová odpověď ze služby Compute.

Name	Typ	Description
error	ApiError	Chyba rozhraní API.

Common.UserAssignedIdentitiesValue

Objekt

Name	Typ	Description
clientId	string	ID klienta identity přiřazené uživatelem.
principalId	string	ID objektu zabezpečení identity přiřazené uživatelem.

ComponentNames

Výčet

Hodnota	Description
Microsoft-Windows-Shell-Setup

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DeleteOptions

Výčet

Určení toho, co se stane se síťovým rozhraním při odstranění virtuálního počítače

Hodnota	Description
Delete
Detach

DiagnosticsProfile

Objekt

Určuje stav nastavení diagnostiky spouštění. Minimální verze api: 2015-06-15.

Name	Typ	Description
bootDiagnostics	BootDiagnostics	Diagnostika spouštění je funkce ladění, která umožňuje zobrazit výstup konzoly a snímek obrazovky pro diagnostiku stavu virtuálního počítače. POZNÁMKA: Pokud je zadaný identifikátor STORAGEURI, ujistěte se, že je účet úložiště ve stejné oblasti a předplatném jako virtuální počítač. Výstup protokolu konzoly můžete snadno zobrazit. Azure také umožňuje vidět screenshot VM z hypervisoru.

DiffDiskOptions

Výčet

Určuje možnost dočasného disku pro disk operačního systému.

Hodnota	Description
Local

DiffDiskPlacement

Výčet

Určuje dočasné umístění disku pro disk operačního systému. Tuto vlastnost může uživatel použít v požadavku k výběru umístění, tj. disku mezipaměti, disku prostředků nebo místa na disku nvme pro zřizování disku dočasného operačního systému. Pro více informací o požadavcích na velikost disku Ephemeral OS prosím viz požadavky na velikost disku Ephemeral OS pro Windows VM na https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements a Linux VM na https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Minimální verze api pro NvmeDisk: 2024-03-01.

Hodnota	Description
CacheDisk
ResourceDisk
NvmeDisk

DiffDiskSettings

Objekt

Popisuje parametry dočasných nastavení disku, které lze zadat pro disk s operačním systémem. Poznámka: Nastavení dočasného disku lze zadat pouze pro spravovaný disk.

Name	Typ	Description
enableFullCaching	boolean	Specifikuje, zda má být pro tento VM povolen plný cache, což umožní ukládat disk OS lokálně na hostiteli a učinit tento VM odolnějším vůči výpadkům úložiště
option	DiffDiskOptions	Určuje dočasné nastavení disku pro disk operačního systému.
placement	DiffDiskPlacement	Určuje dočasné umístění disku pro disk operačního systému. Možné hodnoty jsou: CacheDisk,ResourceDisk,NvmeDisk. Výchozí chování je: CacheDisk pokud je nakonfigurovaná pro velikost virtuálního počítače, jinak ResourceDisk nebo NvmeDisk. Informace o velikosti virtuálních počítačů najdete v dokumentaci k velikosti virtuálního počítače s Windows na https://docs.microsoft.com/azure/virtual-machines/windows/sizes a virtuálním počítači s Linuxem v https://docs.microsoft.com/azure/virtual-machines/linux/sizes a zkontrolujte, které velikosti virtuálních počítačů zpřístupňují disk mezipaměti. Minimální verze api pro NvmeDisk: 2024-03-01.

DiskControllerTypes

Výčet

Určuje typ řadiče disku nakonfigurovaného pro virtuální počítač a VirtualMachineScaleSet. Tato vlastnost je podporována pouze pro virtuální stroje, jejichž operační systém a VM SKU podporují Generation 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), zkontrolujte prosím schopnost HyperVGenerations, která byla vrácena jako součást VM sku v reakci na Microsoft. API Compute SKU pro danou oblast obsahuje V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Další informace o podporovaných typech řadiče disku naleznete v tématu https://aka.ms/azure-diskcontrollertypes.

Hodnota	Description
SCSI
NVMe

DiskCreateOptionTypes

Výčet

Určuje způsob vytvoření disku virtuálního počítače. Možné hodnoty jsou Attach: Tato hodnota se používá při použití specializovaného disku k vytvoření virtuálního počítače. FromImage: Tato hodnota se používá při použití image k vytvoření virtuálního počítače. Pokud používáte image platformy, měli byste také použít element imageReference popsaný výše. Pokud používáte image marketplace, měli byste také použít dříve popsaný prvek plánu. Prázdné: Tato hodnota se používá při vytváření prázdného datového disku. Kopírovat: Tato hodnota slouží k vytvoření datového disku ze snímku nebo jiného disku. Obnovení: Tato hodnota slouží k vytvoření datového disku z bodu obnovení disku.

Hodnota	Description
FromImage
Empty
Attach
Copy
Restore

DiskDeleteOptionTypes

Výčet

Určuje chování spravovaného disku při odstranění virtuálního počítače, například jestli je spravovaný disk odstraněný nebo odpojený. Podporované hodnoty jsou: Delete. Pokud se tato hodnota použije, spravovaný disk se odstraní při odstranění virtuálního počítače. Odpojit. Pokud se tato hodnota použije, spravovaný disk se zachová po odstranění virtuálního počítače. Minimální verze api: 2021-03-01.

Hodnota	Description
Delete
Detach

DiskEncryptionSetParameters

Objekt

Popisuje parametr sady prostředků sady prostředků spravovaného zákazníkem pro šifrování disků, který lze zadat pro disk. Poznámka: ID prostředku sady šifrování disku lze zadat pouze pro spravovaný disk. Další podrobnosti najdete v https://aka.ms/mdssewithcmkoverview.

Name	Typ	Description
id	string	ID prostředku

DomainNameLabelScopeTypes

Výčet

Obor popisku názvu domény. Zřetězení popisku názvu domény hash, který se vygeneroval podle zásad z oboru popisku názvu domény a indexu virtuálního počítače, bude popisky názvů domén prostředků PublicIPAddress, které se vytvoří.

Hodnota	Description
TenantReuse
SubscriptionReuse
ResourceGroupReuse
NoReuse

EncryptionIdentity

Objekt

Určuje spravovanou identitu používanou službou ADE k získání přístupového tokenu pro operace služby KeyVault.

Name	Typ	Description
userAssignedIdentityResourceId	string	Určuje ID prostředku ARM jedné z identit uživatelů přidružených k virtuálnímu počítači.

EventGridAndResourceGraph

Objekt

Určuje konfiguraci související s naplánovanými událostmi eventGridAndResourceGraph.

Name	Typ	Description
enable	boolean	Určuje, jestli je pro konfigurace související s naplánovanou událostí povolená služba Event Grid a graf prostředků.
scheduledEventsApiVersion	string	Určuje verzi rozhraní api-version, která určuje, která verze schématu konfigurace naplánovaných událostí bude doručena.

ExtendedLocation

Objekt

Komplexní typ rozšířeného umístění.

Name	Typ	Description
name	string	Název rozšířeného umístění.
type	ExtendedLocationTypes	Typ rozšířeného umístění.

ExtendedLocationTypes

Výčet

Typ rozšířeného umístění.

Hodnota	Description
EdgeZone

ExternalHealthPolicy

Objekt

Specifikuje externí zdravotní politiku pro škálovací sadu virtuálních strojů.

Name	Typ	Description
enabled	boolean	Pokud je to pravda, externí zdraví je pro tuto škálu umožněno. Nelze nastavit na true v případech, kdy je aktivní jiný zdroj monitorování stavu (rozšíření ApplicationHealth nebo SLB). Výchozí nastavení je „false“.
expiryDuration	string (duration)	Definuje, jak dlouho bude na VM trvat stav zdraví nastavený External Health API. Pokud signál není v této době přijat/aktualizován, stav VM bude označen jako "neznámý". Používá formát ISO 8601. Minimum: 5 minut (PT5M), Maximum: 3 hodiny (PT3H).
gracePeriod	string (duration)	Doba odchůdky pro nově vytvořené VM nebo při prvním aplikaci externí zdravotní politiky na VMSS. Používá formát ISO 8601. Minimum: 5 minut (PT5M), maximum: 4 hodiny (PT4H).

HighSpeedInterconnectPlacement

Výčet

Určuje umístění vysokorychlostního propojení pro škálovací sadu virtuálních počítačů.

Hodnota	Description
None	Žádné umístění vysokorychlostního propojení
Trunk	Umístění vysokorychlostního propojení kmene

HostEndpointSettings

Objekt

Určuje konkrétní nastavení koncového bodu hostitele.

Name	Typ	Description
inVMAccessControlProfileReferenceId	string	Specifikuje ID zdroje InVMAccessControlProfileVersion ve formátu /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft. Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}
mode	Modes	Určuje režim provádění. V režimu auditování systém funguje, jako by vynucovala zásady řízení přístupu, včetně generování položek odepření přístupu v protokolech, ale ve skutečnosti neodmítá žádné požadavky na koncové body hostitele. V režimu vynucení systém vynucuje řízení přístupu a jedná se o doporučený režim operace.

ImageReference

Objekt

Určuje informace o obrázku, který se má použít. Můžete zadat informace o imagích platformy, imagích marketplace nebo imagích virtuálních počítačů. Tento prvek se vyžaduje, pokud chcete použít image platformy, image marketplace nebo image virtuálního počítače, ale nepoužívá se v jiných operacích vytváření. POZNÁMKA: Odkaz na image a nabídka lze nastavit pouze při vytváření škálovací sady.

Name	Typ	Description
communityGalleryImageId	string	Zadali jsme jedinečné ID image galerie komunity pro nasazení virtuálního počítače. To se dá načíst z volání GET galerie komunity.
exactVersion	string	Určuje v desetinných číslech verzi bitové kopie platformy nebo bitové kopie marketplace použité k vytvoření virtuálního počítače. Toto pole pouze pro čtení se liší od pole "version" pouze v případě, že hodnota zadaná v poli "version" je "latest".
id	string	ID prostředku
offer	string	Určuje nabídku image platformy nebo image marketplace použité k vytvoření virtuálního počítače.
publisher	string	Image publisher.
sharedGalleryImageId	string	Zadali jste jedinečné ID image sdílené galerie pro nasazení virtuálního počítače. To se dá načíst z volání GET sdíleného obrázku galerie.
sku	string	Skladová položka image.
version	string	Určuje verzi image platformy nebo image marketplace, která se používá k vytvoření virtuálního počítače. Povolené formáty jsou Major.Minor.Build nebo Latest. Hlavní, Vedlejší a Build jsou desetinná čísla. Zadejte nejnovější verzi image, která je k dispozici v době nasazení. I když použijete nejnovější verzi, image virtuálního počítače se po nasazení automaticky neaktualizuje, i když bude k dispozici nová verze. Prosím, nepoužívejte pole 'version' pro nasazování obrázků galerie, obraz galerie by měl vždy používat pole 'id' pro nasazení, pro použití 'nejaktuálnější' verze obrázku galerie stačí nastavit '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/galleries/{galleryName}/images/{imageName}' v poli 'id' bez zadání verze.

InnerError

Objekt

Podrobnosti vnitřní chyby.

Name	Typ	Description
errordetail	string	Vnitřní chybová zpráva nebo výpis výjimky.
exceptiontype	string	Typ výjimky.

IPVersion

Výčet

K dispozici od verze Api-Version 2017-03-30 dále představuje, jestli je konkrétní konfigurace ip adres IPv4 nebo IPv6. Výchozí hodnota se považuje za protokol IPv4. Možné hodnoty jsou: IPv4 a IPv6.

Hodnota	Description
IPv4
IPv6

KeyVaultSecretReference

Objekt

Popisuje odkaz na Key Vault Secret

Name	Typ	Description
secretUrl	string	URL odkazující na tajemství v Key Vault.
sourceVault	SubResource	Relativní URL Key Vault obsahující tajemství.

LifecycleHook

Objekt

Popisuje háček na životní cyklus.

Name	Typ	Description
defaultAction	LifecycleHookAction	Specifikuje akci, která bude aplikována na cílový zdroj v události lifecycle lifecycle virtuálního stroje, pokud platforma nedostane odpověď od zákazníka na cílový zdroj před waitUntil.
type	VMScaleSetLifecycleHookEventType	Specifikuje typ lifecycle háku.
waitDuration	string (duration)	Specifikuje dobu, po kterou čeká na odpověď od zákazníka událost lifecycle setu virtuálního stroje, která je odeslána zákazníkovi. Mělo by to být ve formátu ISO 8601.

LifecycleHookAction

Výčet

Akce, která bude aplikována na cílový zdroj v události lifecycle cyklu virtuálního stroje, pokud platforma nedostane odpověď od zákazníka na cílový zdroj před čekáním na dozadu.

Hodnota	Description
Approve	Lifecycle hook cílového zdroje v události lifecycle hook bude schválen.
Reject	Hook na životní cyklus cílového zdroje v události životního cyklu bude odmítnut.

LifecycleHooksProfile

Objekt

Specifikuje profil hooků životního cyklu pro škálovací sadu virtuálních strojů.

Name	Typ	Description
lifecycleHooks	LifecycleHook[]	Specifikuje lifecyklové háky konfigurované pro škálovací sadu virtuálních strojů.

LinuxConfiguration

Objekt

Určuje nastavení operačního systému Linux na virtuálním počítači. Pro seznam podporovaných linuxových distribucí viz Linux on Azure-Endorsed Distributions.

Name	Typ	Description
disablePasswordAuthentication	boolean	Určuje, jestli se má zakázat ověřování heslem.
enableVMAgentPlatformUpdates	boolean	Určuje, jestli jsou pro virtuální počítač s Linuxem povolené aktualizace platformy VMAgent. Výchozí hodnota je nepravda.
patchSettings	LinuxPatchSettings	[Funkce Preview] Určuje nastavení související s opravami hosta virtuálního počítače v Linuxu.
provisionVMAgent	boolean	Určuje, jestli má být na virtuálním počítači zřízen agent virtuálního počítače. Pokud tato vlastnost není zadána v textu požadavku, výchozí chování je nastavit ji na true. Tím zajistíte, že je na virtuálním počítači nainstalovaný agent virtuálního počítače, aby bylo možné rozšíření přidat do virtuálního počítače později.
ssh	SshConfiguration	Určuje konfiguraci klíče ssh pro operační systém Linux.

LinuxPatchAssessmentMode

Výčet

Určuje režim posouzení oprav hosta virtuálního počítače pro virtuální počítač IaaS.

Možné hodnoty:

imageDefault – řídíte načasování posouzení oprav na virtuálním počítači.

AutomaticByPlatform – platforma aktivuje pravidelná hodnocení oprav. Vlastnost provisionVMAgent musí být true.

Hodnota	Description
ImageDefault
AutomaticByPlatform

LinuxPatchSettings

Objekt

Určuje nastavení související s opravami hosta virtuálního počítače v Linuxu.

Name	Typ	Description
assessmentMode	LinuxPatchAssessmentMode	Určuje režim posouzení oprav hosta virtuálního počítače pro virtuální počítač IaaS. Možné hodnoty: imageDefault – řídíte načasování posouzení oprav na virtuálním počítači. AutomaticByPlatform – platforma aktivuje pravidelná hodnocení oprav. Vlastnost provisionVMAgent musí být true.
automaticByPlatformSettings	LinuxVMGuestPatchAutomaticByPlatformSettings	Určuje další nastavení pro režim oprav AutomaticByPlatform v opravách hosta virtuálního počítače v Linuxu.
patchMode	LinuxVMGuestPatchMode	Určuje režim oprav hosta virtuálního počítače na virtuální počítač IaaS nebo virtuální počítače přidružené ke škálovací sadě virtuálních počítačů s orchestrationMode jako flexibilní. Možné hodnoty: imageDefault – použije se výchozí konfigurace oprav virtuálního počítače. AutomaticByPlatform – virtuální počítač se automaticky aktualizuje platformou. Vlastnost provisionVMAgent musí být pravdivá.

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

Výčet

Určuje nastavení restartování pro všechny operace instalace oprav AutomaticByPlatform.

Hodnota	Description
Unknown
IfRequired
Never
Always

LinuxVMGuestPatchAutomaticByPlatformSettings

Objekt

Určuje další nastavení, která se použijí při výběru režimu oprav AutomaticByPlatform v nastavení opravy Linuxu.

Name	Typ	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	Umožňuje zákazníkovi naplánovat opravy bez náhodných upgradů.
rebootSetting	LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Určuje nastavení restartování pro všechny operace instalace oprav AutomaticByPlatform.

LinuxVMGuestPatchMode

Výčet

Určuje režim oprav hosta virtuálního počítače na virtuální počítač IaaS nebo virtuální počítače přidružené ke škálovací sadě virtuálních počítačů s orchestrationMode jako flexibilní.

Možné hodnoty:

imageDefault – použije se výchozí konfigurace oprav virtuálního počítače.

AutomaticByPlatform – virtuální počítač se automaticky aktualizuje platformou. Vlastnost provisionVMAgent musí být pravdivá.

Hodnota	Description
ImageDefault
AutomaticByPlatform

MaxInstancePercentPerZonePolicy

Objekt

Parametry konfigurace používané k omezení počtu virtuálních počítačů na zónu dostupnosti ve škálovací sadě virtuálních počítačů.

Name	Typ	Description
enabled	boolean	Určuje, jestli má být ve škálovací sadě virtuálních počítačů povolená maxInstancePercentPerZonePolicy.
value	integer (int32) maximum: 100	Omezte počet instancí v každé zóně jako procento celkové kapacity škálovací sady virtuálních počítačů.

Mode

Výčet

Určuje režim, na který se bude agent Proxy Agent spouštět, pokud je tato funkce povolená. ProxyAgent se začne auditovat nebo monitorovat, ale nebude vynucovat řízení přístupu nad požadavky na koncové body hostitele v režimu auditování, zatímco v režimu vynucení vynutí řízení přístupu. Výchozí hodnota je Režim vynucení.

Hodnota	Description
Audit
Enforce

Modes

Výčet

Určuje režim provádění. V režimu auditování systém funguje, jako by vynucovala zásady řízení přístupu, včetně generování položek odepření přístupu v protokolech, ale ve skutečnosti neodmítá žádné požadavky na koncové body hostitele. V režimu vynucení systém vynucuje řízení přístupu a jedná se o doporučený režim operace.

Hodnota	Description
Audit
Enforce
Disabled

NetworkApiVersion

Výčet

specifikuje Microsoft. Verze Network API používaná při vytváření síťových zdrojů v konfiguracích síťového rozhraní

Hodnota	Description
2020-11-01
2022-11-01

NetworkInterfaceAuxiliaryMode

Výčet

Určuje, zda je pro prostředek síťového rozhraní povolen pomocný režim.

Hodnota	Description
None
AcceleratedConnections
Floating

NetworkInterfaceAuxiliarySku

Výčet

Určuje, zda je pro prostředek síťového rozhraní povolena skladová položka Pomocné položky.

Hodnota	Description
None
A1
A2
A4
A8

OperatingSystemTypes

Výčet

Tato vlastnost umožňuje určit typ operačního systému, který je součástí disku při vytváření virtuálního počítače z vlastní image. Možné hodnoty jsou: Windows,Linux.

Hodnota	Description
Windows
Linux

OperationRecoverySettings

Objekt

Konfigurační parametry používané pro nastavení obnovy operace na škálovací sadě virtuálních strojů.

Name	Typ	Description
reimageRecoveryPolicy	ReimageRecoveryPolicy	Konfigurační parametry používané pro politiku obnovy reimage.
restartRecoveryPolicy	RestartRecoveryPolicy	Konfigurační parametry používané pro politiku obnovy restartu.
startRecoveryPolicy	StartRecoveryPolicy	Konfigurační parametry používané pro politiku obnovy startu.

OrchestrationMode

Výčet

Určuje režim orchestrace pro škálovací sadu virtuálních počítačů.

Hodnota	Description
Uniform
Flexible

OSImageNotificationProfile

Objekt

Name	Typ	Description
enable	boolean	Určuje, jestli je povolená nebo zakázaná událost naplánované image operačního systému.
notBeforeTimeout	string	Doba, po kterou se virtuální počítač znovu zmage nebo upgrade operačního systému bude muset potenciálně schválit událost naplánované image operačního systému před automatickým schválením události (vypršel časový limit). Konfigurace je zadána ve formátu ISO 8601 a hodnota musí být 15 minut (PT15M).

PassNames

Výčet

Hodnota	Description
OobeSystem

PatchSettings

Objekt

Specifikuje nastavení týkající se hostování VM na Windows.

Name	Typ	Description
assessmentMode	WindowsPatchAssessmentMode	Určuje režim posouzení oprav hosta virtuálního počítače pro virtuální počítač IaaS. Možné hodnoty: imageDefault – řídíte načasování posouzení oprav na virtuálním počítači. AutomaticByPlatform – platforma aktivuje pravidelná hodnocení oprav. Vlastnost provisionVMAgent musí být true.
automaticByPlatformSettings	WindowsVMGuestPatchAutomaticByPlatformSettings	Specifikuje další nastavení pro režim záplat AutomaticByPlatform ve VM Guest Patching na Windows.
enableHotpatching	boolean	Umožňuje zákazníkům opravovat své Azure VM bez nutnosti restartu. Pro enableHotpatching musí být provisionVMAgent nastaven na true a patchMode musí být nastaven na AutomaticByPlatform.
patchMode	WindowsVMGuestPatchMode	Určuje režim oprav hosta virtuálního počítače na virtuální počítač IaaS nebo virtuální počítače přidružené ke škálovací sadě virtuálních počítačů s orchestrationMode jako flexibilní. Možné hodnoty: Ruční – řídíte použití oprav na virtuální počítač. Provedete to ručním použitím oprav uvnitř virtuálního počítače. V tomto režimu jsou automatické aktualizace zakázány; Vlastnost WindowsConfiguration.enableAutomaticUpdates musí být false. AutomaticByOS – operační systém automaticky aktualizuje virtuální počítač. Vlastnost WindowsConfiguration.enableAutomaticUpdates musí být true. AutomaticByPlatform – virtuální počítač se automaticky aktualizuje platformou. Vlastnosti provisionVMAgent a WindowsConfiguration.enableAutomaticUpdates musí být pravdivé.

Placement

Objekt

Popisuje uživatelem definovaná omezení pro umístění hardwaru prostředků.

Name	Typ	Description
excludeZones	string[]	Tato vlastnost doplňuje vlastnost zonePlacementPolicy. Pokud je parametr zonePlacementPolicy nastaven na hodnotu Any/Auto, nesmí být zóna dostupnosti vybraná systémem uvedena v seznamu zón dostupnosti předaných parametrem excludeZones. Pokud možnost excludeZones není k dispozici, budou všechny zóny dostupnosti v oblasti považovány za výběr.
includeZones	string[]	Tato vlastnost doplňuje vlastnost zonePlacementPolicy. Pokud je parametr zonePlacementPolicy nastavený na hodnotu Any/Auto, musí být zóna dostupnosti vybraná systémem obsažena v seznamu zón dostupnosti předaných parametrem includeZones. Pokud není k dispozici includeZones, budou všechny zóny dostupnosti v oblasti považovány za výběr.
zonePlacementPolicy	ZonePlacementPolicyType	Určuje zásadu pro umístění zdroje v zóně dostupnosti. Možné hodnoty jsou: Any (používá se pro Virtual Machines), Auto (používá se pro Virtual Machine Scale Sets) - Dostupnostní zóna bude automaticky vybrána systémem jako součást tvorby zdrojů.

Plan

Objekt

Určuje informace o imagi marketplace použité k vytvoření virtuálního počítače. Tento prvek se používá jenom pro image z marketplace. Než budete moct použít image z marketplace z rozhraní API, musíte image povolit pro programové použití. Na webu Azure Portal vyhledejte image marketplace, kterou chcete použít, a potom klikněte na Chcete nasadit programově, začněte –>. Zadejte požadované informace a klikněte na Uložit.

Name	Typ	Description
name	string	ID plánu.
product	string	Určuje produkt image z marketplace. Jedná se o stejnou hodnotu jako Offer pod elementem imageReference.
promotionCode	string	Kód povýšení.
publisher	string	ID vydavatele.

PriorityMixPolicy

Objekt

Určuje cílové rozdělení pro spotové a běžné virtuální počítače s prioritou ve škálovací sadě s flexibilním režimem orchestrace. S touto vlastností může zákazník zadat základní počet běžných virtuálních počítačů s prioritou vytvořených při horizontálním navýšení kapacity instance flex VMSS a rozdělení mezi spotové a běžné virtuální počítače s prioritou po dosažení tohoto základního cíle.

Name	Typ	Description
baseRegularPriorityCount	integer (int32)	Základní počet běžných virtuálních počítačů s prioritou, které se vytvoří v této škálovací sadě při horizontálním navýšení kapacity.
regularPriorityPercentageAboveBase	integer (int32) maximum: 100	Procento instancí virtuálních počítačů po dosažení základního běžného počtu priorit, které se očekává, že budou používat pravidelnou prioritu.

ProtocolTypes

Výčet

Určuje protokol naslouchacího procesu WinRM. Možné hodnoty jsou: http,https.

Hodnota	Description
Http
Https

ProxyAgentSettings

Objekt

Určuje nastavení ProxyAgent pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Minimální verze rozhraní API: 2023-09-01.

Name	Typ	Description
addProxyAgentExtension	boolean	Určete, zda se má implicitně nainstalovat rozšíření ProxyAgent. Tato možnost je v současné době dostupná pouze pro operační systém Linux.
enabled	boolean	Určuje, jestli má být na virtuálním počítači nebo škálovací sadě virtuálních počítačů povolená funkce ProxyAgent.
imds	HostEndpointSettings	Určuje nastavení koncového bodu IMDS při vytváření virtuálního počítače nebo škálovací sady virtuálních počítačů. Minimální verze api: 2024-03-01.
keyIncarnationId	integer (int32)	Zvýšení hodnoty této vlastnosti umožňuje uživatelům resetovat klíč použitý k zabezpečení komunikačního kanálu mezi hostem a hostitelem.
mode	Mode	Určuje režim, na který se bude agent Proxy Agent spouštět. Upozornění: Tato vlastnost je zastaralá, v nastavení konkrétního hostitelského bodu zadejte režim.
wireServer	HostEndpointSettings	Určuje nastavení koncového bodu Wire Serveru při vytváření virtuálního počítače nebo škálovací sady virtuálních počítačů. Minimální verze api: 2024-03-01.

PublicIPAddressSku

Objekt

Popisuje skladovou položku veřejné IP adresy. Dá se nastavit jenom s orchestrationMode jako flexibilní.

Name	Typ	Description
name	PublicIPAddressSkuName	Zadání názvu skladové položky veřejné IP adresy
tier	PublicIPAddressSkuTier	Zadání úrovně skladové položky veřejné IP adresy

PublicIPAddressSkuName

Výčet

Zadání názvu skladové položky veřejné IP adresy

Hodnota	Description
Basic
Standard

PublicIPAddressSkuTier

Výčet

Zadání úrovně skladové položky veřejné IP adresy

Hodnota	Description
Regional
Global

RebalanceBehavior

Výčet

Typ chování vyrovnávání, které se použije k opětovnému vytvoření virtuálních počítačů ve škálovací sadě napříč zónami dostupnosti. Výchozí a podporovaná hodnota je teď CreateBeforeDelete.

Hodnota	Description
CreateBeforeDelete

RebalanceStrategy

Výčet

Typ strategie vyrovnávání, která se použije k vyrovnávání virtuálních počítačů ve škálovací sadě napříč zónami dostupnosti. Výchozí a podporovaná hodnota je teď znovu vytvoření.

Hodnota	Description
Recreate

ReimageRecoveryPolicy

Objekt

Konfigurační parametry použité při obnově reimage.

Name	Typ	Description
enabled	boolean	Specifikuje, zda by měla být povolena obnova po reimage. Výchozí hodnota je false.

RepairAction

Výčet

Typ akce opravy (nahrazení, restartování, obnovení image), která se použije k opravě virtuálních počítačů, které nejsou v pořádku ve škálovací sadě. Výchozí hodnota je nahrazena.

Hodnota	Description
Replace
Restart
Reimage

ResiliencyPolicy

Objekt

Popisuje politiku odolnosti - AutomaticZoneRebalancingPolicy, ResilientVMCreationPolicy, ResilientVMDeletionPolicy a OperationRecoverySettings (verze > 2025-11-01).

Name	Typ	Description
automaticZoneRebalancingPolicy	AutomaticZoneRebalancingPolicy	Parametry konfigurace použité při automatickém vyrovnávání az.
operationRecoverySettings	OperationRecoverySettings	Konfigurační parametry používané pro nastavení obnovy provozu.
resilientVMCreationPolicy	ResilientVMCreationPolicy	Parametry konfigurace použité při vytváření odolných virtuálních počítačů.
resilientVMDeletionPolicy	ResilientVMDeletionPolicy	Parametry konfigurace použité při odstraňování odolných virtuálních počítačů.
zoneAllocationPolicy	ZoneAllocationPolicy	Konfigurační parametry používané při přidělování zón.

ResilientVMCreationPolicy

Objekt

Parametry konfigurace použité při vytváření odolných virtuálních počítačů.

Name	Typ	Description
enabled	boolean	Určuje, jestli se má ve škálovací sadě virtuálních počítačů povolit vytvoření odolného virtuálního počítače. Výchozí hodnota je false.

ResilientVMDeletionPolicy

Objekt

Parametry konfigurace použité při odstraňování odolných virtuálních počítačů.

Name	Typ	Description
enabled	boolean	Určuje, jestli má být ve škálovací sadě virtuálních počítačů povolené odstranění odolného virtuálního počítače. Výchozí hodnota je false.

ResourceIdentityType

Výčet

Typ identity používané pro virtuální počítač. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere všechny identity z virtuálního počítače.

Hodnota	Description
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned
None

RestartRecoveryPolicy

Objekt

Konfigurační parametry použité při obnově restartu.

Name	Typ	Description
enabled	boolean	Specifikuje, zda by mělo být povoleno obnovení restartu. Výchozí hodnota je false.

RollingUpgradePolicy

Objekt

Parametry konfigurace použité při postupném upgradu.

Name	Typ	Description
enableCrossZoneUpgrade	boolean	Povolte VMSS ignorovat hranice AZ při vytváření dávek upgradu. Zvažte aktualizaci domény a maxBatchInstancePercent k určení velikosti dávky.
maxBatchInstancePercent	integer (int32) minimum: 5 maximum: 100	Maximální procento celkových instancí virtuálních počítačů, které budou upgradovány současně postupným upgradem v jedné dávce. Vzhledem k tomu, že se jedná o maximum, instance, které nejsou v pořádku v předchozích nebo budoucích dávkách, můžou způsobit snížení procenta instancí v dávce, aby se zajistila vyšší spolehlivost. Výchozí hodnota pro tento parametr je 20%.
maxSurge	boolean	Vytvořte nové virtuální počítače pro upgrade škálovací sady místo aktualizace existujících virtuálních počítačů. Existující virtuální počítače budou odstraněny po vytvoření nových virtuálních počítačů pro každou dávku.
maxUnhealthyInstancePercent	integer (int32) minimum: 5 maximum: 100	Maximální procento celkových instancí virtuálních počítačů ve škálovací sadě, které může být současně v pořádku, buď v důsledku upgradu, nebo zjištěním stavu, který není v pořádku, kontroluje stav virtuálního počítače před přerušením postupného upgradu. Toto omezení se zkontroluje před spuštěním jakékoli dávky. Výchozí hodnota pro tento parametr je 20%.
maxUnhealthyUpgradedInstancePercent	integer (int32) maximum: 100	Maximální procento upgradovanýchinstancích Tato kontrola proběhne po upgradu každé dávky. Pokud se toto procento někdy překročí, průběžná aktualizace se přeruší. Výchozí hodnota pro tento parametr je 20%.
pauseTimeBetweenBatches	string	Doba čekání mezi dokončením aktualizace pro všechny virtuální počítače v jedné dávce a spuštěním další dávky. Doba trvání by měla být zadána ve formátu ISO 8601. Výchozí hodnota je 0 sekund (PT0S).
prioritizeUnhealthyInstances	boolean	Upgradujte všechny instance, které nejsou v pořádku, ve škálovací sadě před všemi instancemi, které jsou v pořádku.
rollbackFailedInstancesOnPolicyBreach	boolean	Vrácení neúspěšných instancí do předchozího modelu v případě porušení zásad postupného upgradu

ScaleInPolicy

Objekt

Popisuje zásadu horizontálního snížení kapacity pro škálovací sadu virtuálních počítačů.

Name	Typ	Description
forceDeletion	boolean	Tato vlastnost umožňuje určit, jestli virtuální počítače zvolené k odebrání musí být vynucené odstranění, když se škálovací sada virtuálních počítačů škáluje. (Funkce ve verzi Preview)
prioritizeUnhealthyVMs	boolean	Tato vlastnost umožňuje určit prioritu odstranění nezdravých a neaktivních virtuálních počítačů, když se škálovací sada virtuálních počítačů škáluje. (Funkce ve verzi Preview)
rules	VirtualMachineScaleSetScaleInRules[]	Pravidla, která se mají dodržovat při škálování ve škálovací sadě virtuálních počítačů. Možné hodnoty: Výchozí Když je škálovací sada virtuálních počítačů škálovací sada škálovaná, bude škálovací sada nejprve vyvážená napříč zónami, pokud se jedná o zónovou škálovací sadu. Pak bude vyvážená napříč doménami selhání co nejvíce. V rámci každé domény selhání budou virtuální počítače vybrané k odebrání nejnovějšími počítači, které nejsou chráněné před horizontálním navýšením kapacity. Při škálování škálovací sady virtuálních počítačů se pro odebrání vyberou nejstarší virtuální počítače, které nejsou chráněné proti horizontálnímu snížení kapacity. V případě zónových škálovacích sad virtuálních počítačů bude škálovací sada nejprve vyvážená napříč zónami. V každé zóně se pro odebrání vyberou nejstarší virtuální počítače, které nejsou chráněné. nejnovější virtuální počítače Pokud se škálovací sada virtuálních počítačů škáluje na více systémů, zvolí se k odebrání nejnovějších virtuálních počítačů, které nejsou chráněné proti horizontálnímu snížení kapacity. V případě zónových škálovacích sad virtuálních počítačů bude škálovací sada nejprve vyvážená napříč zónami. V každé zóně se pro odebrání vyberou nejnovější virtuální počítače, které nejsou chráněné.

ScheduledEventsAdditionalPublishingTargets

Objekt

Name	Typ	Description
eventGridAndResourceGraph	EventGridAndResourceGraph	Parametry konfigurace použité při vytváření nastavení plánované události EventGridAndResourceGraph.

ScheduledEventsPolicy

Objekt

Určuje konfigurace související s plánovanými událostmi ScheduledDeploy, Reboot a ScheduledEventsAdditionalPublishingTargets.

Name	Typ	Description
allInstancesDown	AllInstancesDown	Parametry konfigurace použité při vytváření vytváření nastavení naplánované události AllInstancesDown.
scheduledEventsAdditionalPublishingTargets	ScheduledEventsAdditionalPublishingTargets	Parametry konfigurace použité při publikování scheduledEventsAdditionalPublishingTargets.
userInitiatedReboot	UserInitiatedReboot	Parametry konfigurace použité při vytváření nastavení naplánované události userInitiatedReboot.
userInitiatedRedeploy	UserInitiatedRedeploy	Parametry konfigurace použité při vytváření nastavení naplánované události userInitiatedRedeploy.

ScheduledEventsProfile

Objekt

Name	Typ	Description
osImageNotificationProfile	OSImageNotificationProfile	Určuje konfigurace související s událostmi naplánované image operačního systému.
terminateNotificationProfile	TerminateNotificationProfile	Určuje konfigurace související s naplánovanou událostí ukončení.

SecurityEncryptionTypes

Výčet

Určuje Typ šifrování spravovaného disku. Je nastavena na DiskWithVMGuestState pro šifrování spravovaného disku spolu s objekty blob VMGuestState, VMGuestStateOnly pro šifrování pouze objektu blob VMGuestState a NonPersistedTPM pro neuchovávání stavu firmwaru v objektu blob VMGuestState. Poznámka: lze nastavit pouze pro důvěrné virtuální počítače.

Hodnota	Description
VMGuestStateOnly
DiskWithVMGuestState
NonPersistedTPM

SecurityPostureReference

Objekt

Určuje stav zabezpečení, který se má použít ve škálovací sadě. Minimální verze api: 2023-03-01

Name	Typ	Description
excludeExtensions	string[]	Seznam názvů rozšíření virtuálních počítačů, které se mají vyloučit při použití stavu zabezpečení
id	string	ID odkazu na stav zabezpečení ve formě /CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{major.minor.patch}\|latest
isOverridable	boolean	Určuje, jestli uživatel může přepsat stav zabezpečení.

SecurityProfile

Objekt

Určuje nastavení profilu zabezpečení pro virtuální počítač nebo škálovací sadu virtuálních počítačů.

Name	Typ	Description
encryptionAtHost	boolean	Tuto vlastnost může uživatel v požadavku použít k povolení nebo zakázání šifrování hostitele pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Tím povolíte šifrování pro všechny disky, včetně samotného prostředku nebo dočasného disku v hostiteli. Výchozí chování je: Šifrování v hostiteli bude zakázáno, pokud není tato vlastnost nastavena na true pro prostředek.
encryptionIdentity	EncryptionIdentity	Určuje spravovanou identitu používanou službou ADE k získání přístupového tokenu pro operace služby KeyVault.
proxyAgentSettings	ProxyAgentSettings	Určuje nastavení proxyagentu při vytváření virtuálního počítače. Minimální verze rozhraní API: 2023-09-01.
securityType	SecurityTypes	Určuje typ zabezpečení virtuálního počítače. Aby bylo možné povolit UefiSettings, musí být nastavená na libovolnou zadanou hodnotu. Výchozí chování je: UefiSettings nebude povolena, pokud tato vlastnost není nastavena a není Standard. Pokud není specifikováno, Standard bude vrácen od verze API 2025-11-01.
uefiSettings	UefiSettings	Určuje nastavení zabezpečení, jako je zabezpečené spouštění a vTPM použité při vytváření virtuálního počítače. Minimální verze api: 2020-12-01.

SecurityTypes

Výčet

Specifikuje VM securityType; UefiSettings jsou povoleny pouze při nastavení na TrustedLaunch nebo ConfidentialVM a vrací standardní hodnotu od verze API 2025-11-01.

Hodnota	Description
Standard	Označuje VM bez funkcí UEFI, jako je SecureBoot nebo vTPM; vrácena jako výchozí hodnota, pokud Security Type není specifikován.
TrustedLaunch
ConfidentialVM

ServiceArtifactReference

Objekt

Určuje ID odkazu na artefakt služby použité k nastavení stejné verze image pro všechny virtuální počítače ve škálovací sadě při použití nejnovější verze image. Minimální verze api: 2022-11-01

Name	Typ	Description
id	string	Referenční ID artefaktu služby je ve formě /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft. Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

SettingNames

Výčet

Určuje název nastavení, na které se obsah vztahuje. Možné hodnoty jsou: FirstLogonCommands a AutoLogon.

Hodnota	Description
AutoLogon
FirstLogonCommands

Sku

Objekt

Popisuje skladovou položku škálovací sady virtuálních počítačů. POZNÁMKA: Pokud nová skladová položka virtuálního počítače není na hardwaru aktuálně zapnutá, musíte virtuální počítače ve škálovací sadě uvolnit před úpravou názvu skladové položky.

Name	Typ	Description
capacity	integer (int64)	Určuje počet virtuálních počítačů ve škálovací sadě.
name	string	Název skladové položky.
tier	string	Určuje úroveň virtuálních počítačů ve škálovací sadě. Možné hodnoty: Standard Basic

SkuProfile

Objekt

Určuje profil skladové položky pro škálovací sadu virtuálních počítačů. U této vlastnosti může zákazník zadat seznam velikostí virtuálních počítačů a strategii přidělení.

Name	Typ	Description
allocationStrategy	AllocationStrategy	Určuje strategii přidělování pro škálovací sadu virtuálních počítačů, na základě které budou virtuální počítače přiděleny.
vmSizes	SkuProfileVMSize[]	Určuje velikosti virtuálních počítačů pro škálovací sadu virtuálních počítačů.

SkuProfileVMSize

Objekt

Určuje velikost virtuálního počítače.

Name	Typ	Description
name	string	Určuje název velikosti virtuálního počítače.
rank	integer (int32)	Určuje pořadí (prioritu a.k.a) přidružené k velikosti virtuálního počítače.

SpotRestorePolicy

Objekt

Určuje spotovéTry-Restore vlastnosti škálovací sady virtuálních počítačů. U této vlastnosti může zákazník povolit nebo zakázat automatické obnovení vyřazených instancí spotových virtuálních počítačů VMSS na základě dostupnosti kapacity a cenového omezení.

Name	Typ	Description
enabled	boolean	Povolí funkci Spot-Try-Restore, ve které se vyřazované instance spotové služby VMSS SPOT pokusí obnovit oportunisticky na základě dostupnosti kapacity a cenových omezení.
restoreTimeout	string	Hodnota časového limitu vyjádřená jako doba trvání iso 8601, po které se platforma nebude pokoušet obnovit spotové instance VMSS

SshConfiguration

Objekt

SSH konfigurace pro linuxové VM běžící na Azure

Name	Typ	Description
publicKeys	SshPublicKey[]	Seznam veřejných klíčů SSH sloužících k ověřování pomocí virtuálních počítačů založených na Linuxu.

SshPublicKey

Objekt

Obsahuje informace o veřejném klíči certifikátu SSH a cestě na virtuálním počítači s Linuxem, kde je veřejný klíč umístěný.

Name	Typ	Description
keyData	string	Certifikát veřejného klíče SSH použitý k ověření s virtuálním počítačem přes SSH. Klíč musí být minimálně 2048bitový a ve formátu ssh-rsa. Pro vytváření ssh klíčů viz [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).
path	string	Určuje úplnou cestu na vytvořeném virtuálním počítači, kde je uložený veřejný klíč SSH. Pokud soubor již existuje, zadaný klíč se připojí k souboru. Příklad: /home/user/.ssh/authorized_keys

StartRecoveryPolicy

Objekt

Konfigurační parametry použité při obnově startu.

Name	Typ	Description
enabled	boolean	Specifikuje, zda by měl být povolen start recovery. Výchozí hodnota je false.

StorageAccountTypes

Výčet

Určuje typ účtu úložiště pro spravovaný disk. Typ účtu úložiště spravovaného disku s operačním systémem se dá nastavit jenom při vytváření škálovací sady. POZNÁMKA: UltraSSD_LRS lze použít pouze s datovými disky. Nejde ho použít s diskem s operačním systémem. Standard_LRS používá hdd úrovně Standard. StandardSSD_LRS používá SSD úrovně Standard. Premium_LRS používá SSD úrovně Premium. UltraSSD_LRS používá disk Úrovně Ultra. Premium_ZRS používá zónově redundantní úložiště SSD úrovně Premium. StandardSSD_ZRS používá zónově redundantní úložiště SSD úrovně Standard. Pro více informací o discích podporovaných pro Windows Virtual Machines viz https://docs.microsoft.com/azure/virtual-machines/windows/disks-types a pro Linux Virtual Machines https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

Hodnota	Description
Standard_LRS
Premium_LRS
StandardSSD_LRS
UltraSSD_LRS
Premium_ZRS
StandardSSD_ZRS
PremiumV2_LRS

StorageFaultDomainAlignmentType

Výčet

Specifikuje typ zarovnání domény chyb úložiště pro disk.

Hodnota	Description
Aligned	Chybové domény diskového úložiště jsou mapovány na výpočetní chybové domény. Nasazení selže, pokud disk nepodporuje dostatek chybových domén.
BestEffortAligned	Pokuste se mapovat domény poruch úložiště na domény výpočetních poruch. Disky nejsou zarovnány, pokud disk nepodporuje dostatek domén poruch.

SubResource

Objekt

Name	Typ	Description
id	string	ID prostředku

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

TerminateNotificationProfile

Objekt

Name	Typ	Description
enable	boolean	Určuje, jestli je povolená nebo zakázaná událost Ukončit naplánovanou událost.
notBeforeTimeout	string	Konfigurovatelná doba odstranění virtuálního počítače bude muset potenciálně schválit naplánovanou událost ukončení před automatickým schválením události (vypršel časový limit). Konfigurace musí být zadána ve formátu ISO 8601, výchozí hodnota je 5 minut (PT5M).

UefiSettings

Objekt

Určuje nastavení zabezpečení, jako je zabezpečené spouštění a vTPM použité při vytváření virtuálního počítače. Minimální verze api: 2020-12-01.

Name	Typ	Description
secureBootEnabled	boolean	Určuje, jestli má být na virtuálním počítači povolené zabezpečené spouštění. Minimální verze api: 2020-12-01.
vTpmEnabled	boolean	Určuje, jestli má být na virtuálním počítači povolený virtuální počítač vTPM. Minimální verze api: 2020-12-01.

UpgradeMode

Výčet

Určuje režim upgradu na virtuální počítače ve škálovací sadě.

Možné hodnoty:

Ruční – řídíte aplikaci aktualizací virtuálních počítačů ve škálovací sadě. Provedete to pomocí akce manualUpgrade.

Automatické – Všechny virtuální počítače ve škálovací sadě se automaticky aktualizují současně.

Hodnota	Description
Automatic
Manual
Rolling

UpgradePolicy

Objekt

Popisuje zásady upgradu – automatické, ruční nebo postupné.

Name	Typ	Description
automaticOSUpgradePolicy	AutomaticOSUpgradePolicy	Parametry konfigurace používané k provádění automatického upgradu operačního systému
mode	UpgradeMode	Určuje režim upgradu na virtuální počítače ve škálovací sadě. Možné hodnoty: Ruční – řídíte aplikaci aktualizací virtuálních počítačů ve škálovací sadě. Provedete to pomocí akce manualUpgrade. Automatické – Všechny virtuální počítače ve škálovací sadě se automaticky aktualizují současně.
rollingUpgradePolicy	RollingUpgradePolicy	Parametry konfigurace použité při postupném upgradu.

UserInitiatedReboot

Objekt

Určuje konfigurace související s naplánovanými událostmi související s restartováním.

Name	Typ	Description
automaticallyApprove	boolean	Určuje konfigurace související s naplánovanou událostí restartování.

UserInitiatedRedeploy

Objekt

Určuje opětovné nasazení souvisejících konfigurací souvisejících s naplánovanými událostmi.

Name	Typ	Description
automaticallyApprove	boolean	Určuje konfiguraci související s naplánovanou událostí opětovné nasazení.

VaultCertificate

Objekt

Popisuje jediný odkaz na certifikát v Key Vault a kde by měl být certifikát umístěn ve VM.

Name	Typ	Description
certificateStore	string	U Windows VM specifikuje úložiště certifikátů na virtuálním stroji, do kterého by měl být certifikát přidán. Zadané úložiště certifikátů je implicitně v účtu LocalMachine. Pro virtuální počítače s Linuxem se soubor certifikátu umístí do adresáře /var/lib/waagent s názvem souboru <UppercaseThumbprint>.crt pro soubor certifikátu X509 a <UpperCaseThumbprint>.prv pro privátní klíč. Oba tyto soubory jsou formátovány .pem.
certificateUrl	string	Toto je URL certifikátu, který byl nahrán do Key Vault jako tajemství. Pro přidání tajemství do Key Vault viz Přidejte klíč nebo tajemství do key vault. V tomto případě musí být váš certifikát kódováním Base64 následujícího objektu JSON, který je kódován v kódování UTF-8: Následujte tyto kroky: "data":"<>", "dataType":"pfx", "heslo":"<heslo-souboru-pfx>" } Pro instalaci certifikátů na virtuální stroj se doporučuje použít rozšíření Azure Key Vault pro Linux nebo rozšíření Azure Key Vault pro Windows.

VaultSecretGroup

Objekt

Popisuje sadu certifikátů, které jsou všechny ve stejném Key Vault.

Name	Typ	Description
sourceVault	SubResource	Relativní URL Key Vault, která obsahuje všechny certifikáty v VaultCertificates.
vaultCertificates	VaultCertificate[]	Seznam odkazů na trezor klíčů ve službě SourceVault, které obsahují certifikáty.

VirtualHardDisk

Objekt

Popisuje identifikátor URI disku.

Name	Typ	Description
uri	string	Určuje identifikátor URI virtuálního pevného disku.

VirtualMachineEvictionPolicyTypes

Výčet

Určuje zásady vyřazení pro spotový virtuální počítač/VMSS Azure

Hodnota	Description
Deallocate
Delete

VirtualMachinePriorityTypes

Výčet

Určuje prioritu pro samostatný virtuální počítač nebo virtuální počítače ve škálovací sadě. Výčet "Nízký" bude v budoucnu zastaralý, použijte prosím "Spot" jako výčet pro nasazení spotového virtuálního počítače/VMSS Azure.

Hodnota	Description
Regular
Low
Spot

VirtualMachineScaleSet

Objekt

Popisuje škálovací sadu virtuálních počítačů.

Name	Typ	Description
etag	string	Vlastnost Etag je vrácená v části Create/Update/Get odpovědi na VMSS, aby ji zákazník mohl do hlavičky zadat, aby zajistil optimistické aktualizace.
extendedLocation	ExtendedLocation	Rozšířené umístění škálovací sady virtuálních počítačů.
id	string	Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	VirtualMachineScaleSetIdentity	Identita škálovací sady virtuálních počítačů, pokud je nakonfigurovaná.
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
placement	Placement	Část Umístění určuje uživatelem definovaná omezení pro umístění hardwaru škálovací sady virtuálních počítačů. Minimální verze API: 2025-04-01.
plan	Plan	Určuje informace o imagi marketplace použité k vytvoření virtuálního počítače. Tento prvek se používá jenom pro image z marketplace. Než budete moct použít image z marketplace z rozhraní API, musíte image povolit pro programové použití. Na webu Azure Portal vyhledejte image marketplace, kterou chcete použít, a potom klikněte na Chcete nasadit programově, začněte –>. Zadejte požadované informace a klikněte na Uložit.
properties.additionalCapabilities	AdditionalCapabilities	Určuje další možnosti povolené nebo zakázané na virtuálních počítačích ve škálovací sadě virtuálních počítačů. Například: jestli mají virtuální počítače možnost podporovat připojení spravovaných datových disků s typem účtu úložiště UltraSSD_LRS.
properties.automaticRepairsPolicy	AutomaticRepairsPolicy	Zásady pro automatické opravy
properties.constrainedMaximumCapacity	boolean	Volitelná vlastnost, která musí být buď nastavena na Hodnotu True, nebo vynechána.
properties.doNotRunExtensionsOnOverprovisionedVMs	boolean	Pokud je povolené nadměrné zřízení, rozšíření se spustí jenom na požadovaném počtu virtuálních počítačů, které se nakonec uchovávají. Tato vlastnost proto zajistí, že se rozšíření nespustí na nadbytečných nadsaděných virtuálních počítačích.
properties.externalHealthPolicy	ExternalHealthPolicy	Specifikuje externí zdravotní politiku pro škálovací sadu virtuálních strojů.
properties.highSpeedInterconnectPlacement	HighSpeedInterconnectPlacement	Určuje umístění vysokorychlostního propojení pro škálovací sadu virtuálních počítačů.
properties.hostGroup	SubResource	Určuje informace o vyhrazené skupině hostitelů, ve které se nachází škálovací sada virtuálních počítačů. Minimální verze api: 2020-06-01.
properties.lifecycleHooksProfile	LifecycleHooksProfile	Specifikuje profil hooků životního cyklu pro škálovací sadu virtuálních strojů.
properties.orchestrationMode	OrchestrationMode	Určuje režim orchestrace pro škálovací sadu virtuálních počítačů.
properties.overprovision	boolean	Určuje, jestli má být škálovací sada virtuálních počítačů nadměrně zřízená.
properties.platformFaultDomainCount	integer (int32)	Počet domén selhání pro každou skupinu umístění
properties.priorityMixPolicy	PriorityMixPolicy	Určuje požadované cíle pro kombinování spotových a běžných virtuálních počítačů s prioritou ve stejné instanci VMSS Flex.
properties.provisioningState	string	Stav zřizování, který se zobrazí pouze v odpovědi.
properties.proximityPlacementGroup	SubResource	Určuje informace o skupině umístění bezkontaktní komunikace, ke které by měla být přiřazena škálovací sada virtuálních počítačů. Minimální verze api: 2018-04-01.
properties.resiliencyPolicy	ResiliencyPolicy	Zásady odolnosti
properties.scaleInPolicy	ScaleInPolicy	Určuje zásady použité při škálování virtuálních počítačů ve škálovací sadě virtuálních počítačů.
properties.scheduledEventsPolicy	ScheduledEventsPolicy	Zásada ScheduledEvents.
properties.singlePlacementGroup	boolean	Pokud je pravda, omezuje škálovací sadu na jednu skupinu umístění, maximální velikost 100 virtuálních počítačů. POZNÁMKA: Pokud je singlePlacementGroup true, může být změněn na false. Pokud je však singlePlacementGroup false, nemusí být změněn na hodnotu true.
properties.skuProfile	SkuProfile	Určuje profil skladové položky pro škálovací sadu virtuálních počítačů.
properties.spotRestorePolicy	SpotRestorePolicy	Určuje vlastnosti spotového obnovení pro škálovací sadu virtuálních počítačů.
properties.timeCreated	string (date-time)	Určuje čas vytvoření prostředku škálovací sady virtuálních počítačů. Minimální verze api: 2021-11-01.
properties.uniqueId	string	Určuje ID, které jednoznačně identifikuje škálovací sadu virtuálních počítačů.
properties.upgradePolicy	UpgradePolicy	Zásady upgradu.
properties.virtualMachineProfile	VirtualMachineScaleSetVMProfile	Profil virtuálního počítače.
properties.zonalPlatformFaultDomainAlignMode	ZonalPlatformFaultDomainAlignMode	Určuje režim zarovnání mezi výpočetní sadou virtuálních počítačů a počtem domén selhání úložiště.
properties.zoneBalance	boolean	Jestli chcete vynutit výhradně i distribuci virtuálních počítačů mezi x zónami v případě výpadku zóny. Vlastnost zoneBalance lze nastavit pouze v případě, že vlastnost zóny škálovací sady obsahuje více než jednu zónu. Pokud nejsou zadány žádné zóny nebo pouze jedna zóna, vlastnost zoneBalance by neměla být nastavena.
sku	Sku	Skladová položka škálovací sady virtuálních počítačů.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Například "Microsoft. Compute/virtualMachines" nebo "Microsoft. Úložiště/úložištěÚčty"
zones	string[]	Zóny dostupnosti.

VirtualMachineScaleSetDataDisk

Objekt

Popisuje datový disk škálovací sady virtuálních počítačů.

Name	Typ	Description
caching	CachingTypes	Určuje požadavky na ukládání do mezipaměti. Možné hodnoty jsou: None,ReadOnly,ReadWrite. Výchozí hodnoty jsou: None pro úložiště úrovně Standard. Jen pro čtení pro Premium Storage.
createOption	DiskCreateOptionTypes	Možnost vytvoření.
deleteOption	DiskDeleteOptionTypes	Určuje, jestli se má datový disk odstranit nebo odpojit po odstranění flex VMSS (tato funkce je dostupná jenom pro VMSS s flexibilním orchestrationModem). Možné hodnoty: Odstranit Pokud se tato hodnota použije, datový disk se odstraní při odstranění virtuálního počítače VMSS Flex. Odpojit Pokud se tato hodnota použije, datový disk se zachovají po odstranění virtuálního počítače VMSS Flex. Výchozí hodnota je nastavena na Odstranit.
diskIOPSReadWrite	integer (int64)	Určuje Read-Write IOPS spravovaného disku. Mělo by se použít pouze v případě, že je storageAccountType UltraSSD_LRS. Pokud nezadáte, přiřadí se výchozí hodnota na základě diskuSizeGB.
diskMBpsReadWrite	integer (int64)	Určuje šířku pásma v MB za sekundu pro spravovaný disk. Mělo by se použít pouze v případě, že je storageAccountType UltraSSD_LRS. Pokud nezadáte, přiřadí se výchozí hodnota na základě diskuSizeGB.
diskSizeGB	integer (int32)	Určuje velikost prázdného datového disku v gigabajtech. Tento prvek lze použít k přepsání velikosti disku v imagi virtuálního počítače. Vlastnost diskSizeGB je počet bajtů x 1024^3 disku a hodnota nemůže být větší než 1023.
lun	integer (int32)	Určuje počet logických jednotek datového disku. Tato hodnota se používá k identifikaci datových disků v rámci virtuálního počítače, a proto musí být jedinečná pro každý datový disk připojený k virtuálnímu počítači.
managedDisk	VirtualMachineScaleSetManagedDiskParameters	Parametry spravovaného disku.
name	string	Název disku.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Specifikuje typ zarovnání domény chyb úložiště pro disk.
writeAcceleratorEnabled	boolean	Určuje, jestli má být na disku povolený nebo zakázaný writeAccelerator.

VirtualMachineScaleSetExtension

Objekt

Popisuje rozšíření škálovací sady virtuálních počítačů.

Name	Typ	Description
id	string	ID prostředku
name	string	Název prostředku
properties.autoUpgradeMinorVersion	boolean	Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.
properties.enableAutomaticUpgrade	boolean	Určuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze rozšíření.
properties.forceUpdateTag	string	Pokud je zadána hodnota a liší se od předchozí hodnoty, bude obslužná rutina rozšíření nucena aktualizovat i v případě, že konfigurace rozšíření nebyla změněna.
properties.protectedSettings		Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení.
properties.protectedSettingsFromKeyVault	KeyVaultSecretReference	Nastavení chráněná rozšířeními, která jsou předána odkazem, a spotřebovaná z trezoru klíčů
properties.provisionAfterExtensions	string[]	Kolekce názvů rozšíření, po kterých je potřeba toto rozšíření zřídit.
properties.provisioningState	string	Stav zřizování, který se zobrazí pouze v odpovědi.
properties.publisher	string	Název vydavatele obslužné rutiny rozšíření.
properties.settings		Veřejná nastavení formátovaná json pro rozšíření
properties.suppressFailures	boolean	Určuje, jestli se potlačí selhání vyplývající z rozšíření (provozní selhání, jako je například nepřipojování k virtuálnímu počítači, nebudou potlačována bez ohledu na tuto hodnotu). Výchozí hodnota je false.
properties.type	string	Určuje typ rozšíření; Příkladem je CustomScriptExtension.
properties.typeHandlerVersion	string	Určuje verzi obslužné rutiny skriptu.
type	string	Typ zdroje

VirtualMachineScaleSetExtensionProfile

Objekt

Popisuje profil rozšíření škálovací sady virtuálních počítačů.

Name	Typ	Description
extensions	VirtualMachineScaleSetExtension[]	Prostředky podřízeného rozšíření škálovací sady virtuálních počítačů.
extensionsTimeBudget	string	Určuje čas přidělení pro spuštění všech rozšíření. Doba trvání by měla být mezi 15 minut a 120 minut (včetně) a měla by být zadána ve formátu ISO 8601. Výchozí hodnota je 90 minut (PT1H30M). Minimální verze api: 2020-06-01.

VirtualMachineScaleSetHardwareProfile

Objekt

Určuje nastavení hardwaru pro škálovací sadu virtuálních počítačů.

Name	Typ	Description
vmSizeProperties	VMSizeProperties	Určuje vlastnosti pro přizpůsobení velikosti virtuálního počítače. Minimální verze api: 2021-11-01. Další podrobnosti najdete v pokynech v přizpůsobení virtuálního počítače.

VirtualMachineScaleSetIdentity

Objekt

Identita škálovací sady virtuálních počítačů

Name	Typ	Description
principalId	string	ID objektu zabezpečení identity škálovací sady virtuálních počítačů. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem.
tenantId	string	ID tenanta přidružené ke škálovací sadě virtuálních počítačů. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem.
type	ResourceIdentityType	Typ identity používané pro škálovací sadu virtuálních počítačů. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere všechny identity ze škálovací sady virtuálních počítačů.
userAssignedIdentities	<string, Common.UserAssignedIdentitiesValue>	Seznam identit uživatelů přidružených ke škálovací sadě virtuálních počítačů. Klíčové odkazy ve slovníku uživatelské identity budou ARM resource id ve formě: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}'.

VirtualMachineScaleSetIPConfiguration

Objekt

Popisuje konfiguraci PROTOKOLU IP profilu sítě škálovací sady virtuálních počítačů.

Name	Typ	Description
name	string	Název konfigurace PROTOKOLU IP.
properties.applicationGatewayBackendAddressPools	SubResource[]	Určuje pole odkazů na back-endové fondy adres aplikačních bran. Škálovací sada může odkazovat na back-endové fondy adres více aplikačních bran. Více škálovacích sad nemůže používat stejnou aplikační bránu.
properties.applicationSecurityGroups	SubResource[]	Určuje pole odkazů na skupinu zabezpečení aplikace.
properties.loadBalancerBackendAddressPools	SubResource[]	Určuje pole odkazů na back-endové fondy adres nástrojů pro vyrovnávání zatížení. Škálovací sada může odkazovat na back-endové fondy adres jednoho veřejného a jednoho interního nástroje pro vyrovnávání zatížení. Více škálovacích sad nemůže použít stejný nástroj pro vyrovnávání zatížení skladové položky Basic.
properties.loadBalancerInboundNatPools	SubResource[]	Určuje pole odkazů na příchozí fondy Nat nástrojů pro vyrovnávání zatížení. Škálovací sada může odkazovat na příchozí fondy nat jednoho veřejného a jednoho interního nástroje pro vyrovnávání zatížení. Více škálovacích sad nemůže použít stejný nástroj pro vyrovnávání zatížení skladové položky Basic.
properties.primary	boolean	Určuje primární síťové rozhraní v případě, že má virtuální počítač více než 1 síťové rozhraní.
properties.privateIPAddressVersion	IPVersion	K dispozici od verze Api-Version 2017-03-30 dále představuje, jestli je konkrétní konfigurace ip adres IPv4 nebo IPv6. Výchozí hodnota se považuje za protokol IPv4. Možné hodnoty jsou: IPv4 a IPv6.
properties.publicIPAddressConfiguration	VirtualMachineScaleSetPublicIPAddressConfiguration	PublicIPAddressConfiguration.
properties.subnet	ApiEntityReference	Určuje identifikátor podsítě.

VirtualMachineScaleSetIpTag

Objekt

Obsahuje značku IP přidruženou k veřejné IP adrese.

Name	Typ	Description
ipTagType	string	Typ značky IP. Příklad: FirstPartyUsage.
tag	string	Značka IP přidružené k veřejné IP adrese. Příklad: SQL, Storage atd.

VirtualMachineScaleSetManagedDiskParameters

Objekt

Popisuje parametry spravovaného disku ScaleSet.

Name	Typ	Description
diskEncryptionSet	DiskEncryptionSetParameters	Určuje ID prostředku spravovaného disku spravovaného zákazníkem pro spravovaný disk.
securityProfile	VMDiskSecurityProfile	Určuje profil zabezpečení spravovaného disku.
storageAccountType	StorageAccountTypes	Určuje typ účtu úložiště pro spravovaný disk. POZNÁMKA: UltraSSD_LRS lze použít pouze s datovými disky, nelze jej použít s diskem s operačním systémem.

VirtualMachineScaleSetNetworkConfiguration

Objekt

Popisuje síťové konfigurace síťového profilu škálovací sady virtuálních počítačů.

Name	Typ	Description
name	string	Název konfigurace sítě.
properties.auxiliaryMode	NetworkInterfaceAuxiliaryMode	Určuje, zda je pro prostředek síťového rozhraní povolen pomocný režim.
properties.auxiliarySku	NetworkInterfaceAuxiliarySku	Určuje, zda je pro prostředek síťového rozhraní povolena skladová položka Pomocné položky.
properties.deleteOption	DeleteOptions	Určení toho, co se stane se síťovým rozhraním při odstranění virtuálního počítače
properties.disableTcpStateTracking	boolean	Určuje, jestli je síťové rozhraní pro sledování stavu tcp zakázané.
properties.dnsSettings	VirtualMachineScaleSetNetworkConfigurationDnsSettings	Nastavení DNS, která se mají použít v síťových rozhraních.
properties.enableAcceleratedNetworking	boolean	Určuje, jestli je síťové rozhraní akcelerované síťové připojení.
properties.enableFpga	boolean	Určuje, jestli je síťové rozhraní s povoleným síťovým rozhraním FPGA.
properties.enableIPForwarding	boolean	Určuje, jestli je u této síťové karty povolené předávání IP.
properties.ipConfigurations	VirtualMachineScaleSetIPConfiguration[]	Určuje konfigurace PROTOKOLU IP síťového rozhraní.
properties.networkSecurityGroup	SubResource	Skupina zabezpečení sítě.
properties.primary	boolean	Určuje primární síťové rozhraní v případě, že má virtuální počítač více než 1 síťové rozhraní.
tags	object	Značky prostředků použité na adresu networkInterface vytvořenou touto NetworkInterfaceConfiguration

VirtualMachineScaleSetNetworkConfigurationDnsSettings

Objekt

Popisuje nastavení DNS konfigurace sítě škálovacích sad virtuálních počítačů.

Name	Typ	Description
dnsServers	string[]	Seznam IP adres serverů DNS

VirtualMachineScaleSetNetworkProfile

Objekt

Popisuje profil sítě škálovací sady virtuálních počítačů.

Name	Typ	Description
healthProbe	ApiEntityReference	Odkaz na sondu nástroje pro vyrovnávání zatížení sloužící k určení stavu instance ve škálovací sadě virtuálních počítačů. Odkaz bude ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}.
networkApiVersion	NetworkApiVersion	určuje verzi rozhraní Microsoft.Network API použitou při vytváření síťových prostředků v konfiguracích síťového rozhraní pro škálovací sadu virtuálních počítačů s flexibilním režimem orchestrace.
networkInterfaceConfigurations	VirtualMachineScaleSetNetworkConfiguration[]	Seznam konfigurací sítě.

VirtualMachineScaleSetOSDisk

Objekt

Popisuje disk operačního systému škálovací sady virtuálních počítačů.

Name	Typ	Description
caching	CachingTypes	Určuje požadavky na ukládání do mezipaměti. Možné hodnoty jsou: None,ReadOnly,ReadWrite. Výchozí hodnoty jsou: None pro úložiště úrovně Standard. Jen pro čtení pro Premium Storage.
createOption	DiskCreateOptionTypes	Určuje způsob vytvoření virtuálních počítačů ve škálovací sadě. Jediná povolená hodnota je: FromImage. Tato hodnota se používá při vytváření virtuálního počítače pomocí image. Pokud používáte image platformy, použijete také element imageReference popsaný výše. Pokud používáte image marketplace, použijete také dříve popsaný prvek plánu.
deleteOption	DiskDeleteOptionTypes	Určuje, jestli se má disk s operačním systémem odstranit nebo odpojit po odstranění flex sady VMSS (tato funkce je dostupná jenom pro VMSS s flexibilním režimem OrchestraationMode). Možné hodnoty: Odstranit Pokud se tato hodnota použije, disk s operačním systémem se odstraní při odstranění virtuálního počítače VMSS Flex. Odpojit Pokud se tato hodnota použije, disk s operačním systémem se zachová po odstranění virtuálního počítače VMSS Flex. Výchozí hodnota je nastavena na Odstranit. Pro dočasný disk s operačním systémem je výchozí hodnota nastavena na Delete. Uživatel nemůže změnit možnost odstranění dočasného disku s operačním systémem.
diffDiskSettings	DiffDiskSettings	Určuje dočasné nastavení disku pro disk operačního systému používaný škálovací sadou virtuálních počítačů.
diskSizeGB	integer (int32)	Určuje velikost prázdného datového disku v gigabajtech. Tento prvek lze použít k přepsání velikosti disku v imagi virtuálního počítače. Vlastnost diskSizeGB je počet bajtů x 1024^3 disku a hodnota nemůže být větší než 1023.
image	VirtualHardDisk	Určuje informace o nespravované imagi uživatele, na které se má škálovací sada založit.
managedDisk	VirtualMachineScaleSetManagedDiskParameters	Parametry spravovaného disku.
name	string	Název disku.
osType	OperatingSystemTypes	Tato vlastnost umožňuje určit typ operačního systému, který je součástí disku při vytváření virtuálního počítače z image uživatele nebo specializovaného virtuálního pevného disku. Možné hodnoty jsou: Windows,Linux.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Specifikuje typ zarovnání domény chyb úložiště pro disk.
vhdContainers	string[]	Určuje adresy URL kontejneru, které se používají k ukládání disků operačního systému pro škálovací sadu.
writeAcceleratorEnabled	boolean	Určuje, jestli má být na disku povolený nebo zakázaný writeAccelerator.

VirtualMachineScaleSetOSProfile

Objekt

Popisuje profil operačního systému škálovací sady virtuálních počítačů.

Name	Typ	Description
adminPassword	string (password)	Určuje heslo účtu správce. Minimální délka (Windows): 8 znaků Minimální délka (Linux): 6 znaků Maximální délka (Windows): 123 znaků Maximální délka (Linux): 72 znaků požadavky na složitost : 3 z následujících 4 podmínek je potřeba splnit. Má menší znaky. Obsahuje horní znaky. Má číslici. Má speciální znak (shoda regulárních výrazů [\W_]) Nepovolené hodnoty: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Heslo!", "Heslo1", "Heslo22", "iloveyou!" Pro resetování hesla viz Jak resetovat službu Remote Desktop nebo její přihlašovací heslo ve Windows VM Pro resetování kořenového hesla viz Spravovat uživatele, SSH a kontrolovat nebo opravovat disky na Azure Linux VM pomocí rozšíření VMAccess
adminUsername	string	Určuje název účtu správce. Windows-only omezení: Nemůže končit na "." Nepovolené hodnoty: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5". Minimální délka (Linux): 1 znak Maximální délka (Linux): 64 znaků Max-length (Windows): 20 znaků
allowExtensionOperations	boolean	Určuje, jestli se mají ve škálovací sadě virtuálních počítačů povolit operace rozšíření. Tato možnost může být nastavena pouze na Hodnotu False, pokud ve škálovací sadě virtuálních počítačů nejsou k dispozici žádná rozšíření.
computerNamePrefix	string	Určuje předponu názvu počítače pro všechny virtuální počítače ve škálovací sadě. Předpony názvu počítače musí mít délku 1 až 15 znaků.
customData	string	Určuje řetězec s kódováním base-64 vlastních dat. Kódovaný řetězec base-64 je dekódován do binárního pole, které je uloženo jako soubor na virtuálním počítači. Maximální délka binárního pole je 65535 bajtů. Informace o použití cloud-init pro virtuální počítač najdete v tématu Použití cloud-init k přizpůsobení virtuálního počítače s Linuxem během vytváření
linuxConfiguration	LinuxConfiguration	Určuje nastavení operačního systému Linux na virtuálním počítači. Pro seznam podporovaných linuxových distribucí viz Linux on Azure-Endorsed Distributions.
requireGuestProvisionSignal	boolean	Volitelná vlastnost, která musí být buď nastavena na Hodnotu True, nebo vynechána.
secrets	VaultSecretGroup[]	Určuje sadu certifikátů, které by se měly nainstalovat na virtuální počítače ve škálovací sadě. Pro instalaci certifikátů na virtuální stroj se doporučuje použít rozšíření Azure Key Vault pro Linux nebo rozšíření Azure Key Vault pro Windows.
windowsConfiguration	WindowsConfiguration	Specifikuje nastavení operačního systému Windows na virtuálním stroji.

VirtualMachineScaleSetPublicIPAddressConfiguration

Objekt

Popisuje konfiguraci PublicIPAddress konfigurace IP adres škálovací sady virtuálních počítačů.

Name	Typ	Description
name	string	Název konfigurace veřejné IP adresy.
properties.deleteOption	DeleteOptions	Zadejte, co se stane s veřejnou IP adresou při odstranění virtuálního počítače.
properties.dnsSettings	VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings	Nastavení dns, které se použije na veřejných IP adresách .
properties.idleTimeoutInMinutes	integer (int32)	Časový limit nečinnosti veřejné IP adresy.
properties.ipTags	VirtualMachineScaleSetIpTag[]	Seznam značek IP adres přidružených k veřejné IP adrese
properties.publicIPAddressVersion	IPVersion	K dispozici od verze Api-Version 2019-07-01 dále představuje, jestli je konkrétní konfigurace ip adres IPv4 nebo IPv6. Výchozí hodnota se považuje za protokol IPv4. Možné hodnoty jsou: IPv4 a IPv6.
properties.publicIPPrefix	SubResource	PublicIPPrefix, ze kterého chcete přidělit veřejné IP adresy.
sku	PublicIPAddressSku	Popisuje skladovou položku veřejné IP adresy. Dá se nastavit jenom s orchestrationMode jako flexibilní.
tags	object	Značky prostředků použité na veřejnou IP adresu vytvořenou tímto PublicIPAddressConfiguration

VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings

Objekt

Popisuje nastavení DNS konfigurace sítě škálovacích sad virtuálních počítačů.

Name	Typ	Description
domainNameLabel	string	Popisek názvu domény. Zřetězení popisku názvu domény a indexu virtuálního počítače bude popisky názvů domén prostředků PublicIPAddress, které se vytvoří.
domainNameLabelScope	DomainNameLabelScopeTypes	Obor popisku názvu domény. Zřetězení popisku názvu domény hash, který se vygeneroval podle zásad z oboru popisku názvu domény a indexu virtuálního počítače, bude popisky názvů domén prostředků PublicIPAddress, které se vytvoří.

VirtualMachineScaleSetScaleInRules

Výčet

Hodnota	Description
Default
OldestVM
NewestVM

VirtualMachineScaleSetStorageProfile

Objekt

Popisuje profil úložiště škálovací sady virtuálních počítačů.

Name	Typ	Description
dataDisks	VirtualMachineScaleSetDataDisk[]	Určuje parametry, které se používají k přidání datových disků do virtuálních počítačů ve škálovací sadě. Pro více informací o discích viz O discích a VHD pro Azure virtuální stroje.
diskControllerType	DiskControllerTypes	Určuje typ řadiče disku nakonfigurovaný pro virtuální počítače ve škálovací sadě. Minimální verze api: 2022-08-01
imageReference	ImageReference	Určuje informace o obrázku, který se má použít. Můžete zadat informace o imagích platformy, imagích marketplace nebo imagích virtuálních počítačů. Tento prvek se vyžaduje, pokud chcete použít image platformy, image marketplace nebo image virtuálního počítače, ale nepoužívá se v jiných operacích vytváření.
osDisk	VirtualMachineScaleSetOSDisk	Určuje informace o disku operačního systému používaného virtuálními počítači ve škálovací sadě. Pro více informací o discích viz O discích a VHD pro Azure virtuální stroje.

VirtualMachineScaleSetVMProfile

Objekt

Popisuje profil virtuálního počítače škálovací sady virtuálních počítačů.

Name	Typ	Description
applicationProfile	ApplicationProfile	Určuje aplikace galerie, které mají být zpřístupněny virtuálnímu počítači nebo VMSS.
billingProfile	BillingProfile	Určuje podrobnosti související s fakturací spotových virtuálních počítačů Azure. Minimální verze api: 2019-03-01.
capacityReservation	CapacityReservationProfile	Určuje podrobnosti související s rezervací kapacity škálovací sady. Minimální verze api: 2021-04-01.
diagnosticsProfile	DiagnosticsProfile	Určuje stav nastavení diagnostiky spouštění. Minimální verze api: 2015-06-15.
evictionPolicy	VirtualMachineEvictionPolicyTypes	Určuje zásady vyřazení pro virtuální počítač Azure Spot a škálovací sadu Azure Spot. U spotových virtuálních počítačů Azure se podporují zrušení přidělení i odstranění a minimální verze api-version je 2019-03-01. U spotových škálovacích sad Azure se podporují zrušení přidělení i odstranění a minimální verze api-version je 2017-10-30-preview.
extensionProfile	VirtualMachineScaleSetExtensionProfile	Určuje kolekci nastavení pro rozšíření nainstalovaná na virtuálních počítačích ve škálovací sadě.
hardwareProfile	VirtualMachineScaleSetHardwareProfile	Určuje podrobnosti související s hardwarovým profilem škálovací sady. Minimální verze api: 2021-11-01.
licenseType	string	Určuje, že použitá image nebo disk byly licencované místně. Možné hodnoty operačního systému Windows Server jsou: Windows_Client Windows_Server Možné hodnoty operačního systému Linux Server jsou: RHEL_BYOS (pro RHEL) SLES_BYOS (pro SUSE) Pro více informací viz Azure Benefit hybridního využití pro Windows Server Azure Výhoda hybridního použití pro Linux Server Minimální verze api: 2015-06-15
networkProfile	VirtualMachineScaleSetNetworkProfile	Určuje vlastnosti síťových rozhraní virtuálních počítačů ve škálovací sadě.
osProfile	VirtualMachineScaleSetOSProfile	Určuje nastavení operačního systému pro virtuální počítače ve škálovací sadě.
priority	VirtualMachinePriorityTypes	Určuje prioritu pro virtuální počítače ve škálovací sadě. Minimální verze api: 2017-10-30-preview.
scheduledEventsProfile	ScheduledEventsProfile	Určuje konfigurace související s naplánovanou událostí.
securityPostureReference	SecurityPostureReference	Určuje stav zabezpečení, který se má použít ve škálovací sadě. Minimální verze api: 2023-03-01
securityProfile	SecurityProfile	Určuje nastavení profilu souvisejícího se zabezpečením pro virtuální počítače ve škálovací sadě.
serviceArtifactReference	ServiceArtifactReference	Určuje ID odkazu na artefakt služby použité k nastavení stejné verze image pro všechny virtuální počítače ve škálovací sadě při použití nejnovější verze image. Minimální verze api: 2022-11-01
storageProfile	VirtualMachineScaleSetStorageProfile	Určuje nastavení úložiště pro disky virtuálního počítače.
timeCreated	string (date-time)	Určuje čas vytvoření tohoto profilu virtuálního počítače pro škálovací sadu virtuálních počítačů. Tato hodnota se při vytváření nebo aktualizaci profilu virtuálního počítače VMSS přidá do značek virtuálních počítačů VMSS Flex. Minimální verze rozhraní API pro tuto vlastnost je 2023-09-01.
userData	string	UserData pro virtuální počítače ve škálovací sadě, které musí být zakódované v base-64. Zákazník by zde neměl předávat žádné tajné kódy. Minimální verze api: 2021-03-01.

VMDiskSecurityProfile

Objekt

Určuje nastavení profilu zabezpečení pro spravovaný disk. Poznámka: Lze ho nastavit pouze pro důvěrné virtuální počítače.

Name	Typ	Description
diskEncryptionSet	DiskEncryptionSetParameters	Určuje ID prostředku sady prostředků spravovaného zákazníkem spravovaného disku pro spravovaný disk, který se používá pro šifrovaný disk s důvěrným operačním systémem důvěrného virtuálního počítače a objekt blob VMGuest.
securityEncryptionType	SecurityEncryptionTypes	Určuje Typ šifrování spravovaného disku. Je nastavena na DiskWithVMGuestState pro šifrování spravovaného disku spolu s objekty blob VMGuestState, VMGuestStateOnly pro šifrování pouze objektu blob VMGuestState a NonPersistedTPM pro neuchovávání stavu firmwaru v objektu blob VMGuestState. Poznámka: lze nastavit pouze pro důvěrné virtuální počítače.

VMGalleryApplication

Objekt

Určuje požadované informace pro odkaz na verzi aplikace v galerii výpočetních prostředků.

Name	Typ	Description
configurationReference	string	Volitelné, Určuje identifikátor URI objektu blob Azure, který nahradí výchozí konfiguraci balíčku, pokud je k dispozici.
enableAutomaticUpgrade	boolean	Pokud je nastavená hodnota true, když je v PIR/SIG k dispozici nová verze aplikace galerie, automaticky se aktualizuje pro virtuální počítač nebo VMSS.
order	integer (int32)	Volitelné, Určuje pořadí, ve kterém se balíčky musí nainstalovat.
packageReferenceId	string	Specifikuje ID zdroje GalleryApplicationVersion ve formě /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft. Compute/galleries/{galleryName}/applications/{application}/versions/{version}
tags	string	Volitelné, Určuje předávací hodnotu pro obecnější kontext.
treatFailureAsDeploymentFailure	boolean	Volitelné, pokud je true, selhání jakékoli operace v aplikaci VmApplication selže při nasazení.

VMScaleSetLifecycleHookEventType

Výčet

Specifikuje scénář, ve kterém má zákazník zájem přijímat události lifecycle hooku na škálování sady virtuálních strojů.

Hodnota	Description
UpgradeAutoOSScheduling	Událost lifecycle hook odeslána zákazníkovi před zahájením operace Auto OS Upgrade na škálovací sadě virtuálního stroje.
UpgradeAutoOSRollingBatchStarting	Událost lifecycle hook odeslaná zákazníkovi před zahájením upgradu na dávce virtuálních strojů patřících do škálování virtuálních strojů nastavených během operace Auto OS Upgrade.

VMSizeProperties

Objekt

Určuje nastavení vlastnosti velikosti virtuálního počítače na virtuálním počítači.

Name	Typ	Description
vCPUsAvailable	integer (int32)	Určuje počet virtuálních procesorů dostupných pro virtuální počítač. Pokud tato vlastnost není v textu požadavku zadána, výchozí chování je nastavit ji na hodnotu virtuálních procesorů dostupných pro danou velikost virtuálního počítače v odpovědi rozhraní API Vypsat všechny dostupné velikosti virtuálních počítačů v oblasti.
vCPUsPerCore	integer (int32)	Určuje poměr virtuálních procesorů k fyzickému jádru. Pokud tato vlastnost není zadána v textu požadavku výchozí chování je nastavena na hodnotu vCPUsPerCore pro velikost virtuálního počítače vystavené v odpovědi rozhraní API Vypsat všechny dostupné velikosti virtuálních počítačů v oblasti. Nastavení této vlastnosti na hodnotu 1 také znamená, že hyper-threading je zakázán.

WindowsConfiguration

Objekt

Specifikuje nastavení operačního systému Windows na virtuálním stroji.

Name	Typ	Description
additionalUnattendContent	AdditionalUnattendContent[]	Specifikuje další informace kódované v XML formátu base-64, které lze zahrnout do Unattend.xml souboru, který používá Windows Setup.
enableAutomaticUpdates	boolean	Označuje, zda jsou automatické aktualizace povoleny pro virtuální stroj Windows. Výchozí hodnota je true. U škálovacích sad virtuálních počítačů je možné tuto vlastnost aktualizovat a aktualizace se projeví při opětovném zřízení operačního systému.
enableVMAgentPlatformUpdates	boolean	Označuje, zda jsou pro virtuální počítač se systémem Windows povoleny aktualizace platformy VMAgent.
patchSettings	PatchSettings	[Ukázkový film] Specifikuje nastavení týkající se hostování VM na Windows.
provisionVMAgent	boolean	Určuje, jestli má být na virtuálním počítači zřízen agent virtuálního počítače. Pokud tato vlastnost není zadána v textu požadavku, je nastavena na true ve výchozím nastavení. Tím zajistíte, že je na virtuálním počítači nainstalovaný agent virtuálního počítače, aby bylo možné rozšíření přidat do virtuálního počítače později.
timeZone	string	Určuje časové pásmo virtuálního počítače. např. "Pacific Standard Time". Možné hodnoty mohou být TimeZoneInfo.Id hodnoty z časových pásem vrácených TimeZoneInfo.GetSystemTimeZones.
winRM	WinRMConfiguration	Specifikuje Windows Remote Management posluchače. To umožňuje vzdálený Windows PowerShell.

WindowsPatchAssessmentMode

Výčet

Hodnota	Description
ImageDefault
AutomaticByPlatform

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

Výčet

Určuje nastavení restartování pro všechny operace instalace oprav AutomaticByPlatform.

Hodnota	Description
Unknown
IfRequired
Never
Always

WindowsVMGuestPatchAutomaticByPlatformSettings

Objekt

Specifikuje další nastavení, která se mají aplikovat, když je v nastavení patch v nastavení Windows zvolen režim záplat AutomaticByPlatform.

Name	Typ	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	Umožňuje zákazníkovi naplánovat opravy bez náhodných upgradů.
rebootSetting	WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Určuje nastavení restartování pro všechny operace instalace oprav AutomaticByPlatform.

WindowsVMGuestPatchMode

Výčet

Určuje režim oprav hosta virtuálního počítače na virtuální počítač IaaS nebo virtuální počítače přidružené ke škálovací sadě virtuálních počítačů s orchestrationMode jako flexibilní.

Možné hodnoty:

Ruční – řídíte použití oprav na virtuální počítač. Provedete to ručním použitím oprav uvnitř virtuálního počítače. V tomto režimu jsou automatické aktualizace zakázány; Vlastnost WindowsConfiguration.enableAutomaticUpdates musí být false.

AutomaticByOS – operační systém automaticky aktualizuje virtuální počítač. Vlastnost WindowsConfiguration.enableAutomaticUpdates musí být true.

AutomaticByPlatform – virtuální počítač se automaticky aktualizuje platformou. Vlastnosti provisionVMAgent a WindowsConfiguration.enableAutomaticUpdates musí být pravdivé.

Hodnota	Description
Manual
AutomaticByOS
AutomaticByPlatform

WinRMConfiguration

Objekt

Popisuje konfiguraci vzdálené správy Windows VM

Name	Typ	Description
listeners	WinRMListener[]	Seznam Windows vzdálených posluchačů

WinRMListener

Objekt

Popisuje protokol a otisk palce Windows Remote Management posluchače

Name	Typ	Description
certificateUrl	string	Toto je URL certifikátu, který byl nahrán do Key Vault jako tajemství. Pro přidání tajemství do Key Vault viz Přidejte klíč nebo tajemství do key vault. V tomto případě musí být váš certifikát kódováním Base64 následujícího objektu JSON, který je kódován v UTF-8: Následujte tyto kroky: "data":"<>", "dataType":"pfx", "heslo":"<heslo-souboru-pfx>" } Pro instalaci certifikátů na virtuální stroj se doporučuje použít rozšíření Azure Key Vault pro Linux nebo rozšíření Azure Key Vault pro Windows.
protocol	ProtocolTypes	Určuje protokol naslouchacího procesu WinRM. Možné hodnoty jsou: http,https.

ZonalPlatformFaultDomainAlignMode

Výčet

Určuje režim zarovnání mezi výpočetní sadou virtuálních počítačů a počtem domén selhání úložiště.

Hodnota	Description
Aligned
Unaligned
BestEffortAligned	Přeložte zarovnání na VMSS. VMSS zarovnává disky, které podporují dostatek domén s chybami úložiště, zatímco ostatní nechává zarovnané.

ZoneAllocationPolicy

Objekt

Parametry konfigurace pro přidělování zón škálovací sady virtuálních počítačů.

Name	Typ	Description
maxInstancePercentPerZonePolicy	MaxInstancePercentPerZonePolicy	Parametry konfigurace používané k omezení počtu virtuálních počítačů na zónu dostupnosti ve škálovací sadě virtuálních počítačů.
maxZoneCount	integer (int32)	Maximální počet zón dostupnosti, které se mají použít, pokud je ZonePlacementPolicy nastavena na "Auto". Pokud nezadáte, použijí se všechny zóny dostupnosti.

ZonePlacementPolicyType

Výčet

Určuje zásadu pro umístění zdroje v zóně dostupnosti. Možné hodnoty jsou: Any (používá se pro Virtual Machines), Auto (používá se pro Virtual Machine Scale Sets) - Dostupnostní zóna bude automaticky vybrána systémem jako součást tvorby zdrojů.

Hodnota	Description
Any
Auto	Automatické umístění zón ve škálovací sadě virtuálních počítačů.