Virtual Machine Scale Sets - Get

Servizio:

Compute

Versione API:

2024-07-01

Visualizzare informazioni su un set di scalabilità di macchine virtuali.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse.
subscriptionId	path	True	string	Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
vmScaleSetName	path	True	string	Nome del set di scalabilità di macchine virtuali.
api-version	query	True	string	Versione dell'API client.
$expand	query		ExpandTypesForGetVMScaleSets	Espressione di espansione da applicare all'operazione. 'UserData' recupera la proprietà UserData del set di scalabilità di macchine virtuali fornito dall'utente durante l'operazione di creazione/aggiornamento del set di scalabilità di macchine virtuali

Risposte

Nome	Tipo	Descrizione
200 OK	VirtualMachineScaleSet	OK
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get a virtual machine scale set

Get a virtual machine scale set placed on a dedicated host group through automatic placement.

Get a virtual machine scale set with UserData

Get VM scale set VM with Disk Controller Type

Get a virtual machine scale set

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet?api-version=2024-07-01&$expand=userData

Java

/**
 * Samples for VirtualMachineScaleSets GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get.json
     */
    /**
     * Sample code: Get a virtual machine scale set.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAVirtualMachineScaleSet(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachineScaleSets().getByResourceGroupWithResponse(
            "myResourceGroup", "myVirtualMachineScaleSet", null, com.azure.core.util.Context.NONE);
    }
}

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

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_scale_set_get.py

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


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.virtual_machine_scale_sets.get(
        resource_group_name="myResourceGroup",
        vm_scale_set_name="myVirtualMachineScaleSet",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get.json
if __name__ == "__main__":
    main()

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

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get.json
func ExampleVirtualMachineScaleSetsClient_Get_getAVirtualMachineScaleSet() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewVirtualMachineScaleSetsClient().Get(ctx, "myResourceGroup", "myVirtualMachineScaleSet", &armcompute.VirtualMachineScaleSetsClientGetOptions{Expand: nil})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.VirtualMachineScaleSet = armcompute.VirtualMachineScaleSet{
	// 	Name: to.Ptr("myVirtualMachineScaleSet"),
	// 	Type: to.Ptr("Microsoft.Compute/virtualMachineScaleSets"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Etag: to.Ptr("\"1\""),
	// 	Properties: &armcompute.VirtualMachineScaleSetProperties{
	// 		DoNotRunExtensionsOnOverprovisionedVMs: to.Ptr(false),
	// 		HostGroup: &armcompute.SubResource{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup"),
	// 		},
	// 		Overprovision: to.Ptr(false),
	// 		PlatformFaultDomainCount: to.Ptr[int32](1),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		SinglePlacementGroup: to.Ptr(false),
	// 		TimeCreated: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-06-27T01:02:38.313Z"); return t}()),
	// 		UpgradePolicy: &armcompute.UpgradePolicy{
	// 			AutomaticOSUpgradePolicy: &armcompute.AutomaticOSUpgradePolicy{
	// 				EnableAutomaticOSUpgrade: to.Ptr(false),
	// 			},
	// 			Mode: to.Ptr(armcompute.UpgradeModeAutomatic),
	// 		},
	// 		VirtualMachineProfile: &armcompute.VirtualMachineScaleSetVMProfile{
	// 			ApplicationProfile: &armcompute.ApplicationProfile{
	// 				GalleryApplications: []*armcompute.VMGalleryApplication{
	// 					{
	// 						ConfigurationReference: to.Ptr("https://mystorageaccount.blob.core.windows.net/configurations/settings.config"),
	// 						Order: to.Ptr[int32](1),
	// 						PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0"),
	// 						Tags: to.Ptr("myTag1"),
	// 					},
	// 					{
	// 						PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"),
	// 				}},
	// 			},
	// 			NetworkProfile: &armcompute.VirtualMachineScaleSetNetworkProfile{
	// 				NetworkInterfaceConfigurations: []*armcompute.VirtualMachineScaleSetNetworkConfiguration{
	// 					{
	// 						Name: to.Ptr("myNic"),
	// 						Properties: &armcompute.VirtualMachineScaleSetNetworkConfigurationProperties{
	// 							IPConfigurations: []*armcompute.VirtualMachineScaleSetIPConfiguration{
	// 								{
	// 									Name: to.Ptr("myIPConfig"),
	// 									Properties: &armcompute.VirtualMachineScaleSetIPConfigurationProperties{
	// 										Primary: to.Ptr(true),
	// 										Subnet: &armcompute.APIEntityReference{
	// 											ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet"),
	// 										},
	// 									},
	// 							}},
	// 							NetworkSecurityGroup: &armcompute.SubResource{
	// 								ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkSecurityGroups/myNetworkSecurityGroup"),
	// 							},
	// 							Primary: to.Ptr(true),
	// 						},
	// 				}},
	// 			},
	// 			OSProfile: &armcompute.VirtualMachineScaleSetOSProfile{
	// 				AdminUsername: to.Ptr("admin"),
	// 				ComputerNamePrefix: to.Ptr("myVirtualMachineScaleSet"),
	// 				LinuxConfiguration: &armcompute.LinuxConfiguration{
	// 					DisablePasswordAuthentication: to.Ptr(false),
	// 				},
	// 			},
	// 			StorageProfile: &armcompute.VirtualMachineScaleSetStorageProfile{
	// 				DataDisks: []*armcompute.VirtualMachineScaleSetDataDisk{
	// 				},
	// 				ImageReference: &armcompute.ImageReference{
	// 					Offer: to.Ptr("databricks"),
	// 					Publisher: to.Ptr("azuredatabricks"),
	// 					SKU: to.Ptr("databricksworker"),
	// 					Version: to.Ptr("3.15.2"),
	// 				},
	// 				OSDisk: &armcompute.VirtualMachineScaleSetOSDisk{
	// 					Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 					DiskSizeGB: to.Ptr[int32](30),
	// 					ManagedDisk: &armcompute.VirtualMachineScaleSetManagedDiskParameters{
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 					},
	// 				},
	// 			},
	// 			TimeCreated: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-09-27T01:03:40.313Z"); return t}()),
	// 			UserData: to.Ptr("RXhhbXBsZSBVc2VyRGF0YQ=="),
	// 		},
	// 	},
	// 	SKU: &armcompute.SKU{
	// 		Name: to.Ptr("Standard_D2s_v3"),
	// 		Capacity: to.Ptr[int64](4),
	// 		Tier: to.Ptr("Standard"),
	// 	},
	// }
}

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

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Display information about a virtual machine scale set.
 *
 * @summary Display information about a virtual machine scale set.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get.json
 */
async function getAVirtualMachineScaleSet() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const vmScaleSetName = "myVirtualMachineScaleSet";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachineScaleSets.get(resourceGroupName, vmScaleSetName);
  console.log(result);
}

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.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/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get.json
// this example is just showing the usage of "VirtualMachineScaleSets_Get" 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 = "myVirtualMachineScaleSet";
NullableResponse<VirtualMachineScaleSetResource> response = await collection.GetIfExistsAsync(virtualMachineScaleSetName);
VirtualMachineScaleSetResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // 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

Risposta di esempio

Codice di stato:

200

{
  "name": "myVirtualMachineScaleSet",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "location": "westus",
  "tags": {
    "myTag1": "tagValue1"
  },
  "sku": {
    "name": "Standard_D2s_v3",
    "tier": "Standard",
    "capacity": 4
  },
  "etag": "\"1\"",
  "properties": {
    "singlePlacementGroup": false,
    "upgradePolicy": {
      "mode": "Automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": false
      }
    },
    "virtualMachineProfile": {
      "storageProfile": {
        "osDisk": {
          "createOption": "FromImage",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS"
          },
          "diskSizeGB": 30
        },
        "imageReference": {
          "publisher": "azuredatabricks",
          "offer": "databricks",
          "sku": "databricksworker",
          "version": "3.15.2"
        },
        "dataDisks": []
      },
      "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"
          }
        ]
      },
      "userData": "RXhhbXBsZSBVc2VyRGF0YQ==",
      "osProfile": {
        "computerNamePrefix": "myVirtualMachineScaleSet",
        "adminUsername": "admin",
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "myNic",
            "properties": {
              "primary": true,
              "ipConfigurations": [
                {
                  "name": "myIPConfig",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet"
                    }
                  }
                }
              ],
              "networkSecurityGroup": {
                "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkSecurityGroups/myNetworkSecurityGroup"
              }
            }
          }
        ]
      },
      "timeCreated": "2023-09-27T01:03:40.3138469+00:00"
    },
    "provisioningState": "succeeded",
    "overprovision": false,
    "doNotRunExtensionsOnOverprovisionedVMs": false,
    "platformFaultDomainCount": 1,
    "hostGroup": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup"
    },
    "timeCreated": "2021-06-27T01:02:38.3138469+00:00"
  }
}

Get a virtual machine scale set placed on a dedicated host group through automatic placement.

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet?api-version=2024-07-01&$expand=userData

Java

/**
 * Samples for VirtualMachineScaleSets GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_AutoPlacedOnDedicatedHostGroup.json
     */
    /**
     * Sample code: Get a virtual machine scale set placed on a dedicated host group through automatic placement.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAVirtualMachineScaleSetPlacedOnADedicatedHostGroupThroughAutomaticPlacement(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachineScaleSets().getByResourceGroupWithResponse(
            "myResourceGroup", "myVirtualMachineScaleSet", null, com.azure.core.util.Context.NONE);
    }
}

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

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_scale_set_get_auto_placed_on_dedicated_host_group.py

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


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.virtual_machine_scale_sets.get(
        resource_group_name="myResourceGroup",
        vm_scale_set_name="myVirtualMachineScaleSet",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_AutoPlacedOnDedicatedHostGroup.json
if __name__ == "__main__":
    main()

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

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_AutoPlacedOnDedicatedHostGroup.json
func ExampleVirtualMachineScaleSetsClient_Get_getAVirtualMachineScaleSetPlacedOnADedicatedHostGroupThroughAutomaticPlacement() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewVirtualMachineScaleSetsClient().Get(ctx, "myResourceGroup", "myVirtualMachineScaleSet", &armcompute.VirtualMachineScaleSetsClientGetOptions{Expand: nil})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.VirtualMachineScaleSet = armcompute.VirtualMachineScaleSet{
	// 	Name: to.Ptr("myVirtualMachineScaleSet"),
	// 	Type: to.Ptr("Microsoft.Compute/virtualMachineScaleSets"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet"),
	// 	Location: to.Ptr("West US"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Properties: &armcompute.VirtualMachineScaleSetProperties{
	// 		DoNotRunExtensionsOnOverprovisionedVMs: to.Ptr(false),
	// 		HostGroup: &armcompute.SubResource{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup"),
	// 		},
	// 		Overprovision: to.Ptr(false),
	// 		PlatformFaultDomainCount: to.Ptr[int32](1),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		SinglePlacementGroup: to.Ptr(false),
	// 		UpgradePolicy: &armcompute.UpgradePolicy{
	// 			AutomaticOSUpgradePolicy: &armcompute.AutomaticOSUpgradePolicy{
	// 				EnableAutomaticOSUpgrade: to.Ptr(false),
	// 			},
	// 			Mode: to.Ptr(armcompute.UpgradeModeAutomatic),
	// 		},
	// 		VirtualMachineProfile: &armcompute.VirtualMachineScaleSetVMProfile{
	// 			NetworkProfile: &armcompute.VirtualMachineScaleSetNetworkProfile{
	// 				NetworkInterfaceConfigurations: []*armcompute.VirtualMachineScaleSetNetworkConfiguration{
	// 					{
	// 						Name: to.Ptr("myNic"),
	// 						Properties: &armcompute.VirtualMachineScaleSetNetworkConfigurationProperties{
	// 							IPConfigurations: []*armcompute.VirtualMachineScaleSetIPConfiguration{
	// 								{
	// 									Name: to.Ptr("myIPConfig"),
	// 									Properties: &armcompute.VirtualMachineScaleSetIPConfigurationProperties{
	// 										Primary: to.Ptr(true),
	// 										Subnet: &armcompute.APIEntityReference{
	// 											ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet"),
	// 										},
	// 									},
	// 							}},
	// 							NetworkSecurityGroup: &armcompute.SubResource{
	// 								ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkSecurityGroups/myNetworkSecurityGroup"),
	// 							},
	// 							Primary: to.Ptr(true),
	// 						},
	// 				}},
	// 			},
	// 			OSProfile: &armcompute.VirtualMachineScaleSetOSProfile{
	// 				AdminUsername: to.Ptr("admin"),
	// 				ComputerNamePrefix: to.Ptr("myVirtualMachineScaleSet"),
	// 				LinuxConfiguration: &armcompute.LinuxConfiguration{
	// 					DisablePasswordAuthentication: to.Ptr(false),
	// 				},
	// 			},
	// 			StorageProfile: &armcompute.VirtualMachineScaleSetStorageProfile{
	// 				DataDisks: []*armcompute.VirtualMachineScaleSetDataDisk{
	// 				},
	// 				ImageReference: &armcompute.ImageReference{
	// 					Offer: to.Ptr("databricks"),
	// 					Publisher: to.Ptr("azuredatabricks"),
	// 					SKU: to.Ptr("databricksworker"),
	// 					Version: to.Ptr("3.15.2"),
	// 				},
	// 				OSDisk: &armcompute.VirtualMachineScaleSetOSDisk{
	// 					Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 					DiskSizeGB: to.Ptr[int32](30),
	// 					ManagedDisk: &armcompute.VirtualMachineScaleSetManagedDiskParameters{
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 					},
	// 				},
	// 			},
	// 		},
	// 	},
	// 	SKU: &armcompute.SKU{
	// 		Name: to.Ptr("Standard_D2s_v3"),
	// 		Capacity: to.Ptr[int64](4),
	// 		Tier: to.Ptr("Standard"),
	// 	},
	// }
}

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

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Display information about a virtual machine scale set.
 *
 * @summary Display information about a virtual machine scale set.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_AutoPlacedOnDedicatedHostGroup.json
 */
async function getAVirtualMachineScaleSetPlacedOnADedicatedHostGroupThroughAutomaticPlacement() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const vmScaleSetName = "myVirtualMachineScaleSet";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachineScaleSets.get(resourceGroupName, vmScaleSetName);
  console.log(result);
}

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.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/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_AutoPlacedOnDedicatedHostGroup.json
// this example is just showing the usage of "VirtualMachineScaleSets_Get" 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 = "myVirtualMachineScaleSet";
NullableResponse<VirtualMachineScaleSetResource> response = await collection.GetIfExistsAsync(virtualMachineScaleSetName);
VirtualMachineScaleSetResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // 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

Risposta di esempio

Codice di stato:

200

{
  "name": "myVirtualMachineScaleSet",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "location": "West US",
  "tags": {
    "myTag1": "tagValue1"
  },
  "sku": {
    "name": "Standard_D2s_v3",
    "tier": "Standard",
    "capacity": 4
  },
  "properties": {
    "singlePlacementGroup": false,
    "upgradePolicy": {
      "mode": "Automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": false
      }
    },
    "virtualMachineProfile": {
      "storageProfile": {
        "osDisk": {
          "createOption": "FromImage",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS"
          },
          "diskSizeGB": 30
        },
        "imageReference": {
          "publisher": "azuredatabricks",
          "offer": "databricks",
          "sku": "databricksworker",
          "version": "3.15.2"
        },
        "dataDisks": []
      },
      "osProfile": {
        "computerNamePrefix": "myVirtualMachineScaleSet",
        "adminUsername": "admin",
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "myNic",
            "properties": {
              "primary": true,
              "ipConfigurations": [
                {
                  "name": "myIPConfig",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet"
                    }
                  }
                }
              ],
              "networkSecurityGroup": {
                "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkSecurityGroups/myNetworkSecurityGroup"
              }
            }
          }
        ]
      }
    },
    "provisioningState": "succeeded",
    "overprovision": false,
    "doNotRunExtensionsOnOverprovisionedVMs": false,
    "platformFaultDomainCount": 1,
    "hostGroup": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup"
    }
  }
}

Get a virtual machine scale set with UserData

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet?api-version=2024-07-01&$expand=userData

Java

import com.azure.resourcemanager.compute.models.ExpandTypesForGetVMScaleSets;

/**
 * Samples for VirtualMachineScaleSets GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_WithUserData.json
     */
    /**
     * Sample code: Get a virtual machine scale set with UserData.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAVirtualMachineScaleSetWithUserData(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachineScaleSets().getByResourceGroupWithResponse(
            "myResourceGroup", "myVirtualMachineScaleSet", ExpandTypesForGetVMScaleSets.USER_DATA,
            com.azure.core.util.Context.NONE);
    }
}

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

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_scale_set_get_with_user_data.py

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


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.virtual_machine_scale_sets.get(
        resource_group_name="myResourceGroup",
        vm_scale_set_name="myVirtualMachineScaleSet",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_WithUserData.json
if __name__ == "__main__":
    main()

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

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_WithUserData.json
func ExampleVirtualMachineScaleSetsClient_Get_getAVirtualMachineScaleSetWithUserData() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewVirtualMachineScaleSetsClient().Get(ctx, "myResourceGroup", "myVirtualMachineScaleSet", &armcompute.VirtualMachineScaleSetsClientGetOptions{Expand: to.Ptr(armcompute.ExpandTypesForGetVMScaleSetsUserData)})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.VirtualMachineScaleSet = armcompute.VirtualMachineScaleSet{
	// 	Name: to.Ptr("myVirtualMachineScaleSet"),
	// 	Type: to.Ptr("Microsoft.Compute/virtualMachineScaleSets"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Properties: &armcompute.VirtualMachineScaleSetProperties{
	// 		DoNotRunExtensionsOnOverprovisionedVMs: to.Ptr(false),
	// 		HostGroup: &armcompute.SubResource{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup"),
	// 		},
	// 		Overprovision: to.Ptr(false),
	// 		PlatformFaultDomainCount: to.Ptr[int32](1),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		SinglePlacementGroup: to.Ptr(false),
	// 		UpgradePolicy: &armcompute.UpgradePolicy{
	// 			AutomaticOSUpgradePolicy: &armcompute.AutomaticOSUpgradePolicy{
	// 				EnableAutomaticOSUpgrade: to.Ptr(false),
	// 			},
	// 			Mode: to.Ptr(armcompute.UpgradeModeAutomatic),
	// 		},
	// 		VirtualMachineProfile: &armcompute.VirtualMachineScaleSetVMProfile{
	// 			ApplicationProfile: &armcompute.ApplicationProfile{
	// 				GalleryApplications: []*armcompute.VMGalleryApplication{
	// 					{
	// 						ConfigurationReference: to.Ptr("https://mystorageaccount.blob.core.windows.net/configurations/settings.config"),
	// 						Order: to.Ptr[int32](1),
	// 						PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0"),
	// 						Tags: to.Ptr("myTag1"),
	// 					},
	// 					{
	// 						PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"),
	// 				}},
	// 			},
	// 			NetworkProfile: &armcompute.VirtualMachineScaleSetNetworkProfile{
	// 				NetworkInterfaceConfigurations: []*armcompute.VirtualMachineScaleSetNetworkConfiguration{
	// 					{
	// 						Name: to.Ptr("myNic"),
	// 						Properties: &armcompute.VirtualMachineScaleSetNetworkConfigurationProperties{
	// 							IPConfigurations: []*armcompute.VirtualMachineScaleSetIPConfiguration{
	// 								{
	// 									Name: to.Ptr("myIPConfig"),
	// 									Properties: &armcompute.VirtualMachineScaleSetIPConfigurationProperties{
	// 										Primary: to.Ptr(true),
	// 										Subnet: &armcompute.APIEntityReference{
	// 											ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet"),
	// 										},
	// 									},
	// 							}},
	// 							NetworkSecurityGroup: &armcompute.SubResource{
	// 								ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkSecurityGroups/myNetworkSecurityGroup"),
	// 							},
	// 							Primary: to.Ptr(true),
	// 						},
	// 				}},
	// 			},
	// 			OSProfile: &armcompute.VirtualMachineScaleSetOSProfile{
	// 				AdminUsername: to.Ptr("admin"),
	// 				ComputerNamePrefix: to.Ptr("myVirtualMachineScaleSet"),
	// 				LinuxConfiguration: &armcompute.LinuxConfiguration{
	// 					DisablePasswordAuthentication: to.Ptr(false),
	// 				},
	// 			},
	// 			StorageProfile: &armcompute.VirtualMachineScaleSetStorageProfile{
	// 				DataDisks: []*armcompute.VirtualMachineScaleSetDataDisk{
	// 				},
	// 				ImageReference: &armcompute.ImageReference{
	// 					Offer: to.Ptr("databricks"),
	// 					Publisher: to.Ptr("azuredatabricks"),
	// 					SKU: to.Ptr("databricksworker"),
	// 					Version: to.Ptr("3.15.2"),
	// 				},
	// 				OSDisk: &armcompute.VirtualMachineScaleSetOSDisk{
	// 					Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 					DiskSizeGB: to.Ptr[int32](30),
	// 					ManagedDisk: &armcompute.VirtualMachineScaleSetManagedDiskParameters{
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 					},
	// 				},
	// 			},
	// 			UserData: to.Ptr("RXhhbXBsZSBVc2VyRGF0YQ=="),
	// 		},
	// 	},
	// 	SKU: &armcompute.SKU{
	// 		Name: to.Ptr("Standard_D2s_v3"),
	// 		Capacity: to.Ptr[int64](4),
	// 		Tier: to.Ptr("Standard"),
	// 	},
	// }
}

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

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Display information about a virtual machine scale set.
 *
 * @summary Display information about a virtual machine scale set.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_WithUserData.json
 */
async function getAVirtualMachineScaleSetWithUserData() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const vmScaleSetName = "myVirtualMachineScaleSet";
  const expand = "userData";
  const options = { expand };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachineScaleSets.get(
    resourceGroupName,
    vmScaleSetName,
    options,
  );
  console.log(result);
}

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.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/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_WithUserData.json
// this example is just showing the usage of "VirtualMachineScaleSets_Get" 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 = "myVirtualMachineScaleSet";
VirtualMachineScaleSetGetExpand? expand = VirtualMachineScaleSetGetExpand.UserData;
NullableResponse<VirtualMachineScaleSetResource> response = await collection.GetIfExistsAsync(virtualMachineScaleSetName, expand: expand);
VirtualMachineScaleSetResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // 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

Risposta di esempio

Codice di stato:

200

{
  "name": "myVirtualMachineScaleSet",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "location": "westus",
  "tags": {
    "myTag1": "tagValue1"
  },
  "sku": {
    "name": "Standard_D2s_v3",
    "tier": "Standard",
    "capacity": 4
  },
  "properties": {
    "singlePlacementGroup": false,
    "upgradePolicy": {
      "mode": "Automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": false
      }
    },
    "virtualMachineProfile": {
      "storageProfile": {
        "osDisk": {
          "createOption": "FromImage",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS"
          },
          "diskSizeGB": 30
        },
        "imageReference": {
          "publisher": "azuredatabricks",
          "offer": "databricks",
          "sku": "databricksworker",
          "version": "3.15.2"
        },
        "dataDisks": []
      },
      "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"
          }
        ]
      },
      "userData": "RXhhbXBsZSBVc2VyRGF0YQ==",
      "osProfile": {
        "computerNamePrefix": "myVirtualMachineScaleSet",
        "adminUsername": "admin",
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "myNic",
            "properties": {
              "primary": true,
              "ipConfigurations": [
                {
                  "name": "myIPConfig",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet"
                    }
                  }
                }
              ],
              "networkSecurityGroup": {
                "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkSecurityGroups/myNetworkSecurityGroup"
              }
            }
          }
        ]
      }
    },
    "provisioningState": "succeeded",
    "overprovision": false,
    "doNotRunExtensionsOnOverprovisionedVMs": false,
    "platformFaultDomainCount": 1,
    "hostGroup": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup"
    }
  }
}

Get VM scale set VM with Disk Controller Type

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet?api-version=2024-07-01&$expand=userData

Java

import com.azure.resourcemanager.compute.models.ExpandTypesForGetVMScaleSets;

/**
 * Samples for VirtualMachineScaleSets GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_WithDiskControllerType.json
     */
    /**
     * Sample code: Get VM scale set VM with Disk Controller Type.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getVMScaleSetVMWithDiskControllerType(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachineScaleSets().getByResourceGroupWithResponse(
            "myResourceGroup", "myVirtualMachineScaleSet", ExpandTypesForGetVMScaleSets.USER_DATA,
            com.azure.core.util.Context.NONE);
    }
}

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

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_scale_set_get_with_disk_controller_type.py

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


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.virtual_machine_scale_sets.get(
        resource_group_name="myResourceGroup",
        vm_scale_set_name="myVirtualMachineScaleSet",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_WithDiskControllerType.json
if __name__ == "__main__":
    main()

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

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_WithDiskControllerType.json
func ExampleVirtualMachineScaleSetsClient_Get_getVmScaleSetVmWithDiskControllerType() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewVirtualMachineScaleSetsClient().Get(ctx, "myResourceGroup", "myVirtualMachineScaleSet", &armcompute.VirtualMachineScaleSetsClientGetOptions{Expand: to.Ptr(armcompute.ExpandTypesForGetVMScaleSetsUserData)})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.VirtualMachineScaleSet = armcompute.VirtualMachineScaleSet{
	// 	Name: to.Ptr("myVirtualMachineScaleSet"),
	// 	Type: to.Ptr("Microsoft.Compute/virtualMachineScaleSets"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Properties: &armcompute.VirtualMachineScaleSetProperties{
	// 		DoNotRunExtensionsOnOverprovisionedVMs: to.Ptr(false),
	// 		HostGroup: &armcompute.SubResource{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup"),
	// 		},
	// 		Overprovision: to.Ptr(false),
	// 		PlatformFaultDomainCount: to.Ptr[int32](1),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		SinglePlacementGroup: to.Ptr(false),
	// 		UpgradePolicy: &armcompute.UpgradePolicy{
	// 			AutomaticOSUpgradePolicy: &armcompute.AutomaticOSUpgradePolicy{
	// 				EnableAutomaticOSUpgrade: to.Ptr(false),
	// 			},
	// 			Mode: to.Ptr(armcompute.UpgradeModeAutomatic),
	// 		},
	// 		VirtualMachineProfile: &armcompute.VirtualMachineScaleSetVMProfile{
	// 			ApplicationProfile: &armcompute.ApplicationProfile{
	// 				GalleryApplications: []*armcompute.VMGalleryApplication{
	// 					{
	// 						ConfigurationReference: to.Ptr("https://mystorageaccount.blob.core.windows.net/configurations/settings.config"),
	// 						Order: to.Ptr[int32](1),
	// 						PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0"),
	// 						Tags: to.Ptr("myTag1"),
	// 					},
	// 					{
	// 						PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"),
	// 				}},
	// 			},
	// 			NetworkProfile: &armcompute.VirtualMachineScaleSetNetworkProfile{
	// 				NetworkInterfaceConfigurations: []*armcompute.VirtualMachineScaleSetNetworkConfiguration{
	// 					{
	// 						Name: to.Ptr("myNic"),
	// 						Properties: &armcompute.VirtualMachineScaleSetNetworkConfigurationProperties{
	// 							IPConfigurations: []*armcompute.VirtualMachineScaleSetIPConfiguration{
	// 								{
	// 									Name: to.Ptr("myIPConfig"),
	// 									Properties: &armcompute.VirtualMachineScaleSetIPConfigurationProperties{
	// 										Primary: to.Ptr(true),
	// 										Subnet: &armcompute.APIEntityReference{
	// 											ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet"),
	// 										},
	// 									},
	// 							}},
	// 							NetworkSecurityGroup: &armcompute.SubResource{
	// 								ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkSecurityGroups/myNetworkSecurityGroup"),
	// 							},
	// 							Primary: to.Ptr(true),
	// 						},
	// 				}},
	// 			},
	// 			OSProfile: &armcompute.VirtualMachineScaleSetOSProfile{
	// 				AdminUsername: to.Ptr("admin"),
	// 				ComputerNamePrefix: to.Ptr("myVirtualMachineScaleSet"),
	// 				LinuxConfiguration: &armcompute.LinuxConfiguration{
	// 					DisablePasswordAuthentication: to.Ptr(false),
	// 				},
	// 			},
	// 			StorageProfile: &armcompute.VirtualMachineScaleSetStorageProfile{
	// 				DataDisks: []*armcompute.VirtualMachineScaleSetDataDisk{
	// 				},
	// 				DiskControllerType: to.Ptr("NVMe"),
	// 				ImageReference: &armcompute.ImageReference{
	// 					Offer: to.Ptr("databricks"),
	// 					Publisher: to.Ptr("azuredatabricks"),
	// 					SKU: to.Ptr("databricksworker"),
	// 					Version: to.Ptr("3.15.2"),
	// 				},
	// 				OSDisk: &armcompute.VirtualMachineScaleSetOSDisk{
	// 					Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 					DiskSizeGB: to.Ptr[int32](30),
	// 					ManagedDisk: &armcompute.VirtualMachineScaleSetManagedDiskParameters{
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 					},
	// 				},
	// 			},
	// 			UserData: to.Ptr("RXhhbXBsZSBVc2VyRGF0YQ=="),
	// 		},
	// 	},
	// 	SKU: &armcompute.SKU{
	// 		Name: to.Ptr("Standard_D2s_v3"),
	// 		Capacity: to.Ptr[int64](4),
	// 		Tier: to.Ptr("Standard"),
	// 	},
	// }
}

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

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Display information about a virtual machine scale set.
 *
 * @summary Display information about a virtual machine scale set.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_WithDiskControllerType.json
 */
async function getVMScaleSetVMWithDiskControllerType() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const vmScaleSetName = "myVirtualMachineScaleSet";
  const expand = "userData";
  const options = { expand };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachineScaleSets.get(
    resourceGroupName,
    vmScaleSetName,
    options,
  );
  console.log(result);
}

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.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/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Get_WithDiskControllerType.json
// this example is just showing the usage of "VirtualMachineScaleSets_Get" 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 = "myVirtualMachineScaleSet";
VirtualMachineScaleSetGetExpand? expand = VirtualMachineScaleSetGetExpand.UserData;
NullableResponse<VirtualMachineScaleSetResource> response = await collection.GetIfExistsAsync(virtualMachineScaleSetName, expand: expand);
VirtualMachineScaleSetResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // 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

Risposta di esempio

Codice di stato:

200

{
  "name": "myVirtualMachineScaleSet",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "location": "westus",
  "tags": {
    "myTag1": "tagValue1"
  },
  "sku": {
    "name": "Standard_D2s_v3",
    "tier": "Standard",
    "capacity": 4
  },
  "properties": {
    "singlePlacementGroup": false,
    "upgradePolicy": {
      "mode": "Automatic",
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": false
      }
    },
    "virtualMachineProfile": {
      "storageProfile": {
        "osDisk": {
          "createOption": "FromImage",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS"
          },
          "diskSizeGB": 30
        },
        "imageReference": {
          "publisher": "azuredatabricks",
          "offer": "databricks",
          "sku": "databricksworker",
          "version": "3.15.2"
        },
        "dataDisks": [],
        "diskControllerType": "NVMe"
      },
      "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"
          }
        ]
      },
      "userData": "RXhhbXBsZSBVc2VyRGF0YQ==",
      "osProfile": {
        "computerNamePrefix": "myVirtualMachineScaleSet",
        "adminUsername": "admin",
        "linuxConfiguration": {
          "disablePasswordAuthentication": false
        }
      },
      "networkProfile": {
        "networkInterfaceConfigurations": [
          {
            "name": "myNic",
            "properties": {
              "primary": true,
              "ipConfigurations": [
                {
                  "name": "myIPConfig",
                  "properties": {
                    "primary": true,
                    "subnet": {
                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet"
                    }
                  }
                }
              ],
              "networkSecurityGroup": {
                "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkSecurityGroups/myNetworkSecurityGroup"
              }
            }
          }
        ]
      }
    },
    "provisioningState": "succeeded",
    "overprovision": false,
    "doNotRunExtensionsOnOverprovisionedVMs": false,
    "platformFaultDomainCount": 1,
    "hostGroup": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup"
    }
  }
}

Definizioni

Nome	Descrizione
AdditionalCapabilities	Abilita o disabilita una funzionalità nella macchina virtuale o nel set di scalabilità di macchine virtuali.
AdditionalUnattendContent	Specifica informazioni aggiuntive in formato XML che possono essere incluse nel file Unattend.xml, utilizzato dal programma di installazione di Windows. Il contenuto viene definito impostando il nome, il nome del componente e il passaggio in cui viene applicato il contenuto.
AllocationStrategy	Specifica la strategia di allocazione per il set di scalabilità di macchine virtuali in base alla quale verranno allocate le macchine virtuali.
ApiEntityReference	Informazioni di riferimento sulle entità API.
ApiError	Errore dell'API.
ApiErrorBase	Base degli errori api.
ApplicationProfile	Contiene l'elenco delle applicazioni della raccolta che devono essere rese disponibili per la macchina virtuale/set di scalabilità di macchine virtuali
AutomaticOSUpgradePolicy	Parametri di configurazione usati per eseguire l'aggiornamento automatico del sistema operativo.
AutomaticRepairsPolicy	Specifica i parametri di configurazione per le riparazioni automatiche nel set di scalabilità di macchine virtuali.
BillingProfile	Specifica i dettagli relativi alla fatturazione di una macchina virtuale spot di Azure o del set di scalabilità di macchine virtuali. Versione minima api: 2019-03-01.
BootDiagnostics	Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output e lo screenshot della console per diagnosticare lo stato della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.
CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. I valori predefiniti sono: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
CapacityReservationProfile	Parametri di un profilo di prenotazione della capacità.
CloudError	Risposta di errore dal servizio di calcolo.
ComponentNames	Nome del componente. Attualmente, l'unico valore consentito è Microsoft-Windows-Shell-Setup.
DeleteOptions	Specificare cosa accade all'indirizzo IP pubblico quando la macchina virtuale viene eliminata
DiagnosticsProfile	Specifica lo stato delle impostazioni di diagnostica di avvio. Versione minima api: 2015-06-15.
DiffDiskOptions	Specifica le impostazioni temporanee del disco per il disco del sistema operativo.
DiffDiskPlacement	Specifica il posizionamento temporaneo del disco per il disco del sistema operativo. Questa proprietà può essere usata dall'utente nella richiesta per scegliere il percorso, ad esempio il disco della cache, il disco delle risorse o lo spazio su disco nvme per il provisioning temporaneo del disco del sistema operativo. Per altre informazioni sui requisiti delle dimensioni del disco del sistema operativo temporaneo, vedere Requisiti delle dimensioni del disco del sistema operativo temporaneo per la macchina virtuale Windows in https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e macchina virtuale Linux all'indirizzo https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Versione minima api per NvmeDisk: 2024-03-01.
DiffDiskSettings	Descrive i parametri delle impostazioni temporanee del disco che possono essere specificate per il disco del sistema operativo. Nota: Le impostazioni temporanee del disco possono essere specificate solo per il disco gestito.
DiskControllerTypes
DiskCreateOptionTypes	Specifica la modalità di creazione delle macchine virtuali nel set di scalabilità. L'unico valore consentito è: FromImage. Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, si usa anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, si usa anche l'elemento di piano descritto in precedenza.
DiskDeleteOptionTypes	Specifica se il disco del sistema operativo deve essere eliminato o scollegato dopo l'eliminazione di VMSS Flex (questa funzionalità è disponibile solo per VMSS con OrchestrationMode flessibile). Valori possibili: Elimina Se si usa questo valore, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale VmSS Flex. Scollegare Se si usa questo valore, il disco del sistema operativo viene mantenuto dopo l'eliminazione della macchina virtuale Flex di VMSS. Il valore predefinito è impostato su Elimina. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per disco del sistema operativo temporaneo.
DiskEncryptionSetParameters	Descrive il parametro dell'ID risorsa del set di crittografia dischi gestiti dal cliente che può essere specificato per il disco. Nota: L'ID risorsa del set di crittografia del disco può essere specificato solo per il disco gestito. Per altri dettagli, vedere https://aka.ms/mdssewithcmkoverview.
DomainNameLabelScopeTypes	Ambito dell'etichetta nome di dominio. La concatenazione dell'etichetta del nome di dominio con hash generata in base ai criteri dall'ambito dell'etichetta del nome di dominio e l'indice vm saranno le etichette dei nomi di dominio delle risorse PublicIPAddress che verranno create
EncryptionIdentity	Specifica l'identità gestita usata da ADE per ottenere il token di accesso per le operazioni dell'insieme di credenziali delle chiavi.
EventGridAndResourceGraph	Specifica le configurazioni correlate agli eventi pianificati correlate a eventGridAndResourceGraph.
ExpandTypesForGetVMScaleSets	Espressione di espansione da applicare all'operazione. 'UserData' recupera la proprietà UserData del set di scalabilità di macchine virtuali fornito dall'utente durante l'operazione di creazione/aggiornamento del set di scalabilità di macchine virtuali
ExtendedLocation	Tipo complesso della posizione estesa.
ExtendedLocationTypes	Tipo della posizione estesa.
ImageReference	Specifica le informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini delle macchine virtuali. Questo elemento è obbligatorio quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione. NOTA: l'autore e l'offerta di riferimento delle immagini possono essere impostati solo quando si crea il set di scalabilità.
InnerError	Dettagli dell'errore interno.
IPVersion	Disponibile da Api-Version 2019-07-01 e versioni successive, indica se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito è IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.
KeyVaultSecretReference	Descrive un riferimento al segreto dell'insieme di credenziali delle chiavi
LinuxConfiguration	Specifica le impostazioni del sistema operativo Linux nella macchina virtuale. Per un elenco delle distribuzioni Linux supportate, vedere Linux in distribuzioni Azure-Endorsed.
LinuxPatchAssessmentMode	Specifica la modalità di valutazione della patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
LinuxPatchSettings	Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Linux.
LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.
LinuxVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive da applicare quando la modalità patch AutomaticByPlatform è selezionata nelle impostazioni della patch linux.
LinuxVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: ImageDefault: viene usata la configurazione di applicazione di patch predefinita della macchina virtuale. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. La proprietà provisionVMAgent deve essere true
Mode	Specifica la modalità su cui Verrà eseguito ProxyAgent se la funzionalità è abilitata. ProxyAgent inizierà a controllare o monitorare ma non a imporre il controllo di accesso sulle richieste agli endpoint host in modalità di controllo, mentre in modalità di imposizione applichererà il controllo di accesso. Il valore predefinito è Imponi modalità.
NetworkApiVersion	specifica la versione dell'API Microsoft.Network usata durante la creazione di risorse di rete nelle configurazioni dell'interfaccia di rete per il set di scalabilità di macchine virtuali con modalità di orchestrazione "Flessibile"
NetworkInterfaceAuxiliaryMode	Specifica se la modalità ausiliaria è abilitata per la risorsa interfaccia di rete.
NetworkInterfaceAuxiliarySku	Specifica se lo SKU ausiliario è abilitato per la risorsa interfaccia di rete.
OperatingSystemTypes	Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco se si crea una macchina virtuale da un'immagine utente o un disco rigido virtuale specializzato. I valori possibili sono: Windows,Linux.
OrchestrationMode	Specifica la modalità di orchestrazione per il set di scalabilità di macchine virtuali.
OSImageNotificationProfile
PassNames	Nome del pass. Attualmente, l'unico valore consentito è OobeSystem.
PatchSettings	Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.
Plan	Specifica informazioni sull'immagine del marketplace usata per creare la macchina virtuale. Questo elemento viene usato solo per le immagini del Marketplace. Prima di poter usare un'immagine del marketplace da un'API, è necessario abilitare l'immagine per l'uso a livello di codice. Nel portale di Azure individuare l'immagine del Marketplace che si vuole usare e quindi fare clic su Si vuole distribuire a livello di codice, Introduzione ->. Immettere le informazioni necessarie e quindi fare clic su Salva.
PriorityMixPolicy	Specifica le divisioni di destinazione per le macchine virtuali con priorità spot e regolare all'interno di un set di scalabilità con modalità di orchestrazione flessibile. Con questa proprietà, il cliente è in grado di specificare il numero di base di macchine virtuali con priorità regolare create quando l'istanza flex vmSS aumenta e la divisione tra macchine virtuali con priorità spot e regolare dopo il raggiungimento di questa destinazione di base.
ProtocolTypes	Specifica il protocollo del listener WinRM. I valori possibili sono: http,https.
ProxyAgentSettings	Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale. Versione minima api: 2023-09-01.
PublicIPAddressSku	Descrive lo SKU dell'indirizzo IP pubblico. Può essere impostato solo con OrchestrationMode come flessibile.
PublicIPAddressSkuName	Specificare il nome dello SKU IP pubblico
PublicIPAddressSkuTier	Specificare il livello SKU DELL'INDIRIZZO IP pubblico
RepairAction	Tipo di azione di ripristino (sostituzione, riavvio, ricreazione immagine) che verrà usata per ripristinare macchine virtuali non integre nel set di scalabilità. Il valore predefinito è replace.
ResiliencyPolicy	Descrive un criterio di resilienza: resilientVMCreationPolicy e/o resilientVMDeletionPolicy.
ResilientVMCreationPolicy	I parametri di configurazione usati durante l'esecuzione della creazione di macchine virtuali resilienti.
ResilientVMDeletionPolicy	Parametri di configurazione usati durante l'esecuzione dell'eliminazione resiliente della macchina virtuale.
ResourceIdentityType	Tipo di identità usato per il set di scalabilità di macchine virtuali. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà tutte le identità dal set di scalabilità di macchine virtuali.
RollingUpgradePolicy	Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza.
ScaleInPolicy	Descrive un criterio di scalabilità orizzontale per un set di scalabilità di macchine virtuali.
ScheduledEventsAdditionalPublishingTargets
ScheduledEventsPolicy	Specifica le configurazioni correlate a Redeploy, Reboot e ScheduledEventsAdditionalPublishingTargets Scheduled Event.
ScheduledEventsProfile
securityEncryptionTypes	Specifica encryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostato solo per le macchine virtuali riservate.
SecurityPostureReference	Specifica il comportamento di sicurezza da usare nel set di scalabilità. Versione minima api: 2023-03-01
SecurityProfile	Specifica le impostazioni del profilo di sicurezza per la macchina virtuale o il set di scalabilità di macchine virtuali.
SecurityTypes	Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.
ServiceArtifactReference	Specifica l'ID di riferimento dell'artefatto del servizio usato per impostare la stessa versione dell'immagine per tutte le macchine virtuali nel set di scalabilità quando si usa la versione dell'immagine 'latest'. Versione minima api: 2022-11-01
SettingNames	Specifica il nome dell'impostazione a cui si applica il contenuto. I valori possibili sono: FirstLogonCommands e AutoLogon.
Sku	Descrive uno SKU del set di scalabilità di macchine virtuali. NOTA: se il nuovo SKU della macchina virtuale non è supportato nell'hardware in cui è attualmente attivo il set di scalabilità, è necessario deallocare le macchine virtuali nel set di scalabilità prima di modificare il nome dello SKU.
SkuProfile	Specifica il profilo sku per il set di scalabilità di macchine virtuali. Con questa proprietà il cliente è in grado di specificare un elenco di dimensioni delle macchine virtuali e una strategia di allocazione.
SkuProfileVMSize	Specifica le dimensioni della macchina virtuale.
SpotRestorePolicy	Specifica le proprietà spot-Try-Restore per il set di scalabilità di macchine virtuali. Con questa proprietà il cliente può abilitare o disabilitare il ripristino automatico delle istanze di macchine virtuali Spot VMSS rimosse in modo opportunistico in base alla disponibilità della capacità e al vincolo dei prezzi.
SshConfiguration	Configurazione SSH per macchine virtuali basate su Linux in esecuzione in Azure
SshPublicKey	Contiene informazioni sulla chiave pubblica del certificato SSH e sul percorso nella macchina virtuale Linux in cui viene inserita la chiave pubblica.
StorageAccountTypes	Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con dischi dati, non può essere usato con il disco del sistema operativo.
SubResource
TerminateNotificationProfile
UefiSettings	Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale. Versione minima api: 2020-12-01.
UpgradeMode	Specifica la modalità di un aggiornamento alle macchine virtuali nel set di scalabilità. I valori possibili sono: manuale: è possibile controllare l'applicazione degli aggiornamenti alle macchine virtuali nel set di scalabilità. A tale scopo, usare l'azione manualUpgrade. automatico: tutte le macchine virtuali nel set di scalabilità vengono aggiornate automaticamente contemporaneamente.
UpgradePolicy	Descrive un criterio di aggiornamento: automatico, manuale o in sequenza.
UserAssignedIdentities	Elenco di identità utente associate alla macchina virtuale. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
UserInitiatedReboot	Specifica le configurazioni correlate agli eventi pianificati correlati al riavvio.
UserInitiatedRedeploy	Specifica le configurazioni correlate all'evento pianificato correlate alla ridistribuitura.
VaultCertificate	Descrive un singolo riferimento al certificato in un insieme di credenziali delle chiavi e dove risiede il certificato nella macchina virtuale.
VaultSecretGroup	Descrive un set di certificati che si trovano tutti nello stesso insieme di credenziali delle chiavi.
VirtualHardDisk	Descrive l'URI di un disco.
VirtualMachineEvictionPolicyTypes	Specifica i criteri di rimozione per la macchina virtuale Spot di Azure e il set di scalabilità spot di Azure. Per le macchine virtuali Spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2019-03-01. Per i set di scalabilità spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2017-10-30-preview.
VirtualMachinePriorityTypes	Specifica la priorità per le macchine virtuali nel set di scalabilità. Versione minima api: 2017-10-30-preview.
VirtualMachineScaleSet	Descrive un set di scalabilità di macchine virtuali.
VirtualMachineScaleSetDataDisk	Descrive un disco dati del set di scalabilità di macchine virtuali.
VirtualMachineScaleSetExtension	Descrive un'estensione del set di scalabilità di macchine virtuali.
VirtualMachineScaleSetExtensionProfile	Descrive un profilo di estensione del set di scalabilità di macchine virtuali.
VirtualMachineScaleSetHardwareProfile	Specifica le impostazioni hardware per il set di scalabilità di macchine virtuali.
VirtualMachineScaleSetIdentity	Identità per il set di scalabilità di macchine virtuali.
VirtualMachineScaleSetIPConfiguration	Descrive la configurazione IP di un profilo di rete del set di scalabilità di macchine virtuali.
VirtualMachineScaleSetIpTag	Contiene il tag IP associato all'indirizzo IP pubblico.
VirtualMachineScaleSetManagedDiskParameters	Descrive i parametri di un disco gestito scaleset.
VirtualMachineScaleSetNetworkConfiguration	Descrive le configurazioni di rete del profilo di rete di un set di scalabilità di macchine virtuali.
VirtualMachineScaleSetNetworkConfigurationDnsSettings	Descrive le impostazioni DNS di una configurazione DNS dei set di scalabilità di macchine virtuali.
VirtualMachineScaleSetNetworkProfile	Descrive un profilo di rete del set di scalabilità di macchine virtuali.
VirtualMachineScaleSetOSDisk	Descrive un disco del sistema operativo del set di scalabilità di macchine virtuali.
VirtualMachineScaleSetOSProfile	Descrive un profilo del sistema operativo del set di scalabilità di macchine virtuali.
VirtualMachineScaleSetPublicIPAddressConfiguration	Descrive la configurazione publicIPAddress di un set di scalabilità di macchine virtuali
VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings	Descrive le impostazioni DNS di una configurazione DNS dei set di scalabilità di macchine virtuali.
VirtualMachineScaleSetScaleInRules	Regole da seguire durante il ridimensionamento di un set di scalabilità di macchine virtuali. I valori possibili sono: Impostazione predefinita Quando viene ridimensionato un set di scalabilità di macchine virtuali, il set di scalabilità verrà prima bilanciato tra le zone se si tratta di un set di scalabilità di zona. Quindi, verrà bilanciato tra domini di errore il più possibile. All'interno di ogni dominio di errore, le macchine virtuali scelte per la rimozione saranno quelle più recenti che non sono protette dal ridimensionamento. OldestVM Quando viene ridimensionato un set di scalabilità di macchine virtuali, verranno scelte le macchine virtuali meno recenti non protette dal ridimensionamento per la rimozione. Per i set di scalabilità di macchine virtuali di zona, il set di scalabilità verrà prima bilanciato tra le zone. All'interno di ogni zona, verranno scelte le macchine virtuali meno recenti che non sono protette per la rimozione. NewestVM Quando viene ridimensionato un set di scalabilità di macchine virtuali, verranno scelte le macchine virtuali più recenti non protette dal ridimensionamento per la rimozione. Per i set di scalabilità di macchine virtuali di zona, il set di scalabilità verrà prima bilanciato tra le zone. All'interno di ogni zona, verranno scelte le macchine virtuali più recenti che non sono protette per la rimozione.
VirtualMachineScaleSetStorageProfile	Descrive un profilo di archiviazione del set di scalabilità di macchine virtuali.
VirtualMachineScaleSetVMProfile	Descrive un profilo di macchina virtuale del set di scalabilità di macchine virtuali.
VMDiskSecurityProfile	Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostato solo per le macchine virtuali riservate.
VMGalleryApplication	Specifica le informazioni necessarie per fare riferimento a una versione dell'applicazione della raccolta di calcolo
VMSizeProperties	Specifica le impostazioni delle proprietà dimensioni macchina virtuale nella macchina virtuale.
WindowsConfiguration	Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.
WindowsPatchAssessmentMode	Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.
WindowsVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive da applicare quando la modalità patch AutomaticByPlatform è selezionata nelle impostazioni della patch di Windows.
WindowsVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: manuale: è possibile controllare l'applicazione di patch a una macchina virtuale. A tale scopo, applicare manualmente le patch all'interno della macchina virtuale. In questa modalità gli aggiornamenti automatici sono disabilitati; La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere false AutomaticByOS: la macchina virtuale verrà aggiornata automaticamente dal sistema operativo. La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere true. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. Le proprietà provisionVMAgent e WindowsConfiguration.enableAutomaticUpdates devono essere true
WinRMConfiguration	Descrive la configurazione di Gestione remota Windows della macchina virtuale
WinRMListener	Descrive il protocollo e l'identificazione personale del listener di Gestione remota Windows
ZonalPlatformFaultDomainAlignMode	Specifica la modalità di allineamento tra il calcolo del set di scalabilità di macchine virtuali e il numero di domini di errore di archiviazione.

AdditionalCapabilities

Abilita o disabilita una funzionalità nella macchina virtuale o nel set di scalabilità di macchine virtuali.

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

AdditionalUnattendContent

Specifica informazioni aggiuntive in formato XML che possono essere incluse nel file Unattend.xml, utilizzato dal programma di installazione di Windows. Il contenuto viene definito impostando il nome, il nome del componente e il passaggio in cui viene applicato il contenuto.

Nome	Tipo	Descrizione
componentName	ComponentNames	Nome del componente. Attualmente, l'unico valore consentito è Microsoft-Windows-Shell-Setup.
content	string	Specifica il contenuto in formato XML aggiunto al file unattend.xml per il percorso e il componente specificati. Il codice XML deve essere minore di 4 KB e deve includere l'elemento radice per l'impostazione o la funzionalità da inserire.
passName	PassNames	Nome del pass. Attualmente, l'unico valore consentito è OobeSystem.
settingName	SettingNames	Specifica il nome dell'impostazione a cui si applica il contenuto. I valori possibili sono: FirstLogonCommands e AutoLogon.

AllocationStrategy

Specifica la strategia di allocazione per il set di scalabilità di macchine virtuali in base alla quale verranno allocate le macchine virtuali.

Nome	Tipo	Descrizione
CapacityOptimized	string
LowestPrice	string

ApiEntityReference

Informazioni di riferimento sulle entità API.

Nome	Tipo	Descrizione
id	string	ID risorsa ARM sotto forma di /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Errore dell'API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ApiErrorBase[]	Dettagli dell'errore dell'API
innererror	InnerError	Errore interno dell'API
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

ApiErrorBase

Base degli errori api.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

ApplicationProfile

Contiene l'elenco delle applicazioni della raccolta che devono essere rese disponibili per la macchina virtuale/set di scalabilità di macchine virtuali

Nome	Tipo	Descrizione
galleryApplications	VMGalleryApplication[]	Specifica le applicazioni della raccolta che devono essere rese disponibili per la macchina virtuale/set di scalabilità di macchine virtuali

AutomaticOSUpgradePolicy

Parametri di configurazione usati per eseguire l'aggiornamento automatico del sistema operativo.

Nome	Tipo	Descrizione
disableAutomaticRollback	boolean	Indica se la funzionalità di rollback dell'immagine del sistema operativo deve essere disabilitata. Il valore predefinito è false.
enableAutomaticOSUpgrade	boolean	Indica se gli aggiornamenti del sistema operativo devono essere applicati automaticamente alle istanze del set di scalabilità in sequenza quando diventa disponibile una versione più recente dell'immagine del sistema operativo. Il valore predefinito è false. Se è impostato su true per i set di scalabilità basati su Windows, enableAutomaticUpdates viene impostato automaticamente su false e non può essere impostato su true.
osRollingUpgradeDeferral	boolean	Indica se l'aggiornamento automatico del sistema operativo deve essere sottoposto a rinvio. Gli aggiornamenti posticipati del sistema operativo invieranno notifiche avanzate per ogni macchina virtuale che un aggiornamento del sistema operativo dagli aggiornamenti in sequenza è in ingresso, tramite il tag IMDS 'Platform.PendingOSUpgrade'. L'aggiornamento quindi rinvia fino a quando l'aggiornamento non viene approvato tramite una chiamata ApproveRollingUpgrade.
useRollingUpgradePolicy	boolean	Indica se i criteri di aggiornamento in sequenza devono essere usati durante l'aggiornamento automatico del sistema operativo. Il valore predefinito è false. L'aggiornamento automatico del sistema operativo eseguirà il fallback ai criteri predefiniti se non sono definiti criteri nel set di scalabilità di macchine virtuali.

AutomaticRepairsPolicy

Specifica i parametri di configurazione per le riparazioni automatiche nel set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
enabled	boolean	Specifica se le riparazioni automatiche devono essere abilitate nel set di scalabilità di macchine virtuali. Il valore predefinito è false.
gracePeriod	string	Periodo di tempo per il quale le riparazioni automatiche vengono sospese a causa di una modifica dello stato nella macchina virtuale. Il tempo di tolleranza inizia dopo il completamento della modifica dello stato. Ciò consente di evitare riparazioni premature o accidentali. La durata dell'ora deve essere specificata nel formato ISO 8601. Il periodo di tolleranza minimo consentito è 10 minuti (PT10M), che è anche il valore predefinito. Il periodo di tolleranza massimo consentito è 90 minuti (PT90M).
repairAction	RepairAction	Tipo di azione di ripristino (sostituzione, riavvio, ricreazione immagine) che verrà usata per ripristinare macchine virtuali non integre nel set di scalabilità. Il valore predefinito è replace.

BillingProfile

Specifica i dettagli relativi alla fatturazione di una macchina virtuale spot di Azure o del set di scalabilità di macchine virtuali. Versione minima api: 2019-03-01.

Nome	Tipo	Descrizione
maxPrice	number	Specifica il prezzo massimo che si vuole pagare per una macchina virtuale/set di scalabilità di macchine virtuali spot di Azure. Questo prezzo è in dollari USA. Questo prezzo verrà confrontato con il prezzo corrente di Azure Spot per le dimensioni della macchina virtuale. Inoltre, i prezzi vengono confrontati al momento della creazione/aggiornamento di macchine virtuali spot di Azure/SET di scalabilità di macchine virtuali e l'operazione avrà esito positivo solo se il prezzo maxPrice è maggiore del prezzo corrente di Azure Spot. MaxPrice verrà usato anche per rimuovere una macchina virtuale/set di scalabilità di macchine virtuali spot di Azure se il prezzo corrente di Azure Spot supera il valore maxPrice dopo la creazione di macchine virtuali/set di scalabilità di macchine virtuali. I valori possibili sono: - Qualsiasi valore decimale maggiore di zero. Esempio: 0.01538 -1 : indica il prezzo predefinito da up-to su richiesta. È possibile impostare maxPrice su -1 per indicare che la macchina virtuale/set di scalabilità di macchine virtuali spot di Azure non deve essere eliminata per motivi di prezzo. Inoltre, il prezzo massimo predefinito è -1 se non è fornito dall'utente. Versione minima api: 2019-03-01.

BootDiagnostics

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

Nome	Tipo	Descrizione
enabled	boolean	Indica se la diagnostica di avvio deve essere abilitata nella macchina virtuale.
storageUri	string	URI dell'account di archiviazione da usare per inserire l'output e lo screenshot della console. Se storageUri non viene specificato durante l'abilitazione della diagnostica di avvio, verrà usata l'archiviazione gestita.

CachingTypes

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

Nome	Tipo	Descrizione
None	string
ReadOnly	string
ReadWrite	string

CapacityReservationProfile

Parametri di un profilo di prenotazione della capacità.

Nome	Tipo	Descrizione
capacityReservationGroup	SubResource	Specifica l'ID risorsa del gruppo di prenotazioni di capacità che deve essere usato per allocare la macchina virtuale o le istanze di vm del set di scalabilità a condizione che sia stata riservata una capacità sufficiente. Per altri dettagli, vedere https://aka.ms/CapacityReservation.

CloudError

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore dell'API.

ComponentNames

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

Nome	Tipo	Descrizione
Microsoft-Windows-Shell-Setup	string

DeleteOptions

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

Nome	Tipo	Descrizione
Delete	string
Detach	string

DiagnosticsProfile

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

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

DiffDiskOptions

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

Nome	Tipo	Descrizione
Local	string

DiffDiskPlacement

Specifica il posizionamento temporaneo del disco per il disco del sistema operativo. Questa proprietà può essere usata dall'utente nella richiesta per scegliere il percorso, ad esempio il disco della cache, il disco delle risorse o lo spazio su disco nvme per il provisioning temporaneo del disco del sistema operativo. Per altre informazioni sui requisiti delle dimensioni del disco del sistema operativo temporaneo, vedere Requisiti delle dimensioni del disco del sistema operativo temporaneo per la macchina virtuale Windows in https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e macchina virtuale Linux all'indirizzo https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Versione minima api per NvmeDisk: 2024-03-01.

Nome	Tipo	Descrizione
CacheDisk	string
NvmeDisk	string
ResourceDisk	string

DiffDiskSettings

Descrive i parametri delle impostazioni temporanee del disco che possono essere specificate per il disco del sistema operativo. Nota: Le impostazioni temporanee del disco possono essere specificate solo per il disco gestito.

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

DiskControllerTypes

Nome	Tipo	Descrizione
NVMe	string
SCSI	string

DiskCreateOptionTypes

Specifica la modalità di creazione delle macchine virtuali nel set di scalabilità. L'unico valore consentito è: FromImage. Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, si usa anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, si usa anche l'elemento di piano descritto in precedenza.

Nome	Tipo	Descrizione
Attach	string
Copy	string
Empty	string
FromImage	string
Restore	string

DiskDeleteOptionTypes

Specifica se il disco del sistema operativo deve essere eliminato o scollegato dopo l'eliminazione di VMSS Flex (questa funzionalità è disponibile solo per VMSS con OrchestrationMode flessibile).

Valori possibili:

Elimina Se si usa questo valore, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale VmSS Flex.

Scollegare Se si usa questo valore, il disco del sistema operativo viene mantenuto dopo l'eliminazione della macchina virtuale Flex di VMSS.

Il valore predefinito è impostato su Elimina. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per disco del sistema operativo temporaneo.

Nome	Tipo	Descrizione
Delete	string
Detach	string

DiskEncryptionSetParameters

Descrive il parametro dell'ID risorsa del set di crittografia dischi gestiti dal cliente che può essere specificato per il disco. Nota: L'ID risorsa del set di crittografia del disco può essere specificato solo per il disco gestito. Per altri dettagli, vedere https://aka.ms/mdssewithcmkoverview.

Nome	Tipo	Descrizione
id	string	ID risorsa

DomainNameLabelScopeTypes

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

Nome	Tipo	Descrizione
NoReuse	string
ResourceGroupReuse	string
SubscriptionReuse	string
TenantReuse	string

EncryptionIdentity

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

Nome	Tipo	Descrizione
userAssignedIdentityResourceId	string	Specifica l'ID risorsa ARM di una delle identità utente associate alla macchina virtuale.

EventGridAndResourceGraph

Specifica le configurazioni correlate agli eventi pianificati correlate a eventGridAndResourceGraph.

Nome	Tipo	Descrizione
enable	boolean	Specifica se griglia di eventi e grafico delle risorse è abilitato per le configurazioni correlate agli eventi pianificati.

ExpandTypesForGetVMScaleSets

Espressione di espansione da applicare all'operazione. 'UserData' recupera la proprietà UserData del set di scalabilità di macchine virtuali fornito dall'utente durante l'operazione di creazione/aggiornamento del set di scalabilità di macchine virtuali

Nome	Tipo	Descrizione
userData	string

ExtendedLocation

Tipo complesso della posizione estesa.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	ExtendedLocationTypes	Tipo della posizione estesa.

ExtendedLocationTypes

Tipo della posizione estesa.

Nome	Tipo	Descrizione
EdgeZone	string

ImageReference

Specifica le informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini delle macchine virtuali. Questo elemento è obbligatorio quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione. NOTA: l'autore e l'offerta di riferimento delle immagini possono essere impostati solo quando si crea il set di scalabilità.

Nome	Tipo	Descrizione
communityGalleryImageId	string	È stato specificato l'ID univoco dell'immagine della raccolta della community per la distribuzione di macchine virtuali. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta della community.
exactVersion	string	Specifica in numeri decimali la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. Questo campo di sola lettura è diverso da 'version', solo se il valore specificato nel campo 'version' è 'latest'.
id	string	ID risorsa
offer	string	Specifica l'offerta dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale.
publisher	string	Autore dell'immagine.
sharedGalleryImageId	string	È stato specificato l'ID univoco dell'immagine della raccolta condivisa per la distribuzione della macchina virtuale. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta condivisa.
sku	string	SKU dell'immagine.
version	string	Specifica la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. I formati consentiti sono Major.Minor.Build o 'latest'. Major, Minor e Build sono numeri decimali. Specificare 'latest' per usare la versione più recente di un'immagine disponibile in fase di distribuzione. Anche se si usa 'latest', l'immagine della macchina virtuale non verrà aggiornata automaticamente dopo la distribuzione anche se diventa disponibile una nuova versione. Non usare il campo 'version' per la distribuzione di immagini della raccolta, l'immagine della raccolta deve usare sempre il campo 'id' per la distribuzione, per usare la versione più recente dell'immagine della raccolta, è sufficiente impostare '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}' nel campo 'id' senza input della versione.

InnerError

Dettagli dell'errore interno.

Nome	Tipo	Descrizione
errordetail	string	Messaggio di errore interno o dump delle eccezioni.
exceptiontype	string	Tipo di eccezione.

IPVersion

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

Nome	Tipo	Descrizione
IPv4	string
IPv6	string

KeyVaultSecretReference

Descrive un riferimento al segreto dell'insieme di credenziali delle chiavi

Nome	Tipo	Descrizione
secretUrl	string	URL che fa riferimento a un segreto in un insieme di credenziali delle chiavi.
sourceVault	SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente il segreto.

LinuxConfiguration

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

Nome	Tipo	Descrizione
disablePasswordAuthentication	boolean	Specifica se l'autenticazione della password deve essere disabilitata.
enableVMAgentPlatformUpdates	boolean	Indica se gli aggiornamenti della piattaforma VMAgent sono abilitati per la macchina virtuale Linux. Il valore predefinito è false.
patchSettings	LinuxPatchSettings	[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Linux.
provisionVMAgent	boolean	Indica se è necessario eseguire il provisioning dell'agente di macchine virtuali nella macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito consiste nell'impostarlo su true. In questo modo si garantisce che l'agente di macchine virtuali sia installato nella macchina virtuale in modo che le estensioni possano essere aggiunte alla macchina virtuale in un secondo momento.
ssh	SshConfiguration	Specifica la configurazione della chiave SSH per un sistema operativo Linux.

LinuxPatchAssessmentMode

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

I valori possibili sono:

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

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

Nome	Tipo	Descrizione
AutomaticByPlatform	string
ImageDefault	string

LinuxPatchSettings

Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Linux.

Nome	Tipo	Descrizione
assessmentMode	LinuxPatchAssessmentMode	Specifica la modalità di valutazione della patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
automaticByPlatformSettings	LinuxVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nell'applicazione di patch guest alle macchine virtuali in Linux.
patchMode	LinuxVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: ImageDefault: viene usata la configurazione di applicazione di patch predefinita della macchina virtuale. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. La proprietà provisionVMAgent deve essere true

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

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

Nome	Tipo	Descrizione
Always	string
IfRequired	string
Never	string
Unknown	string

LinuxVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive da applicare quando la modalità patch AutomaticByPlatform è selezionata nelle impostazioni della patch linux.

Nome	Tipo	Descrizione
bypassPlatformSafetyChecksOnUserSchedule	boolean	Consente al cliente di pianificare l'applicazione di patch senza aggiornamenti accidentali
rebootSetting	LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.

LinuxVMGuestPatchMode

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

I valori possibili sono:

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

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

Nome	Tipo	Descrizione
AutomaticByPlatform	string
ImageDefault	string

Mode

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

Nome	Tipo	Descrizione
Audit	string
Enforce	string

NetworkApiVersion

specifica la versione dell'API Microsoft.Network usata durante la creazione di risorse di rete nelle configurazioni dell'interfaccia di rete per il set di scalabilità di macchine virtuali con modalità di orchestrazione "Flessibile"

Nome	Tipo	Descrizione
2020-11-01	string

NetworkInterfaceAuxiliaryMode

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

Nome	Tipo	Descrizione
AcceleratedConnections	string
Floating	string
None	string

NetworkInterfaceAuxiliarySku

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

Nome	Tipo	Descrizione
A1	string
A2	string
A4	string
A8	string
None	string

OperatingSystemTypes

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

Nome	Tipo	Descrizione
Linux	string
Windows	string

OrchestrationMode

Specifica la modalità di orchestrazione per il set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
Flexible	string
Uniform	string

OSImageNotificationProfile

Nome	Tipo	Descrizione
enable	boolean	Specifica se l'evento Pianificato immagine del sistema operativo è abilitato o disabilitato.
notBeforeTimeout	string	Tempo durante la ricreazione dell'immagine di una macchina virtuale o l'aggiornamento del sistema operativo dovrà potenzialmente approvare l'evento pianificato dell'immagine del sistema operativo prima dell'approvazione automatica dell'evento (timeout). La configurazione viene specificata in formato ISO 8601 e il valore deve essere 15 minuti (PT15M)

PassNames

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

Nome	Tipo	Descrizione
OobeSystem	string

PatchSettings

Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.

Nome	Tipo	Descrizione
assessmentMode	WindowsPatchAssessmentMode	Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
automaticByPlatformSettings	WindowsVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nell'applicazione di patch guest alle macchine virtuali in Windows.
enableHotpatching	boolean	Consente ai clienti di applicare patch alle macchine virtuali di Azure senza richiedere un riavvio. Per enableHotpatching, 'provisionVMAgent' deve essere impostato su true e 'patchMode' deve essere impostato su 'AutomaticByPlatform'.
patchMode	WindowsVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: manuale: è possibile controllare l'applicazione di patch a una macchina virtuale. A tale scopo, applicare manualmente le patch all'interno della macchina virtuale. In questa modalità gli aggiornamenti automatici sono disabilitati; La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere false AutomaticByOS: la macchina virtuale verrà aggiornata automaticamente dal sistema operativo. La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere true. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. Le proprietà provisionVMAgent e WindowsConfiguration.enableAutomaticUpdates devono essere true

Plan

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

Nome	Tipo	Descrizione
name	string	ID del piano.
product	string	Specifica il prodotto dell'immagine dal marketplace. Si tratta dello stesso valore di Offer nell'elemento imageReference.
promotionCode	string	Codice promozionale.
publisher	string	ID editore.

PriorityMixPolicy

Specifica le divisioni di destinazione per le macchine virtuali con priorità spot e regolare all'interno di un set di scalabilità con modalità di orchestrazione flessibile. Con questa proprietà, il cliente è in grado di specificare il numero di base di macchine virtuali con priorità regolare create quando l'istanza flex vmSS aumenta e la divisione tra macchine virtuali con priorità spot e regolare dopo il raggiungimento di questa destinazione di base.

Nome	Tipo	Descrizione
baseRegularPriorityCount	integer	Numero di base di macchine virtuali con priorità regolare che verranno create in questo set di scalabilità man mano che aumenta il numero di istanze.
regularPriorityPercentageAboveBase	integer	Percentuale di istanze di macchina virtuale, dopo che è stato raggiunto il numero di priorità regolare di base, che si prevede di usare la priorità regolare.

ProtocolTypes

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

Nome	Tipo	Descrizione
Http	string
Https	string

ProxyAgentSettings

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

Nome	Tipo	Descrizione
enabled	boolean	Specifica se la funzionalità ProxyAgent deve essere abilitata nella macchina virtuale o nel set di scalabilità di macchine virtuali.
keyIncarnationId	integer	Aumentare il valore di questa proprietà consente all'utente di reimpostare la chiave usata per proteggere il canale di comunicazione tra guest e host.
mode	Mode	Specifica la modalità su cui Verrà eseguito ProxyAgent se la funzionalità è abilitata. ProxyAgent inizierà a controllare o monitorare ma non a imporre il controllo di accesso sulle richieste agli endpoint host in modalità di controllo, mentre in modalità di imposizione applichererà il controllo di accesso. Il valore predefinito è Imponi modalità.

PublicIPAddressSku

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

Nome	Tipo	Descrizione
name	PublicIPAddressSkuName	Specificare il nome dello SKU IP pubblico
tier	PublicIPAddressSkuTier	Specificare il livello SKU DELL'INDIRIZZO IP pubblico

PublicIPAddressSkuName

Specificare il nome dello SKU IP pubblico

Nome	Tipo	Descrizione
Basic	string
Standard	string

PublicIPAddressSkuTier

Specificare il livello SKU DELL'INDIRIZZO IP pubblico

Nome	Tipo	Descrizione
Global	string
Regional	string

RepairAction

Tipo di azione di ripristino (sostituzione, riavvio, ricreazione immagine) che verrà usata per ripristinare macchine virtuali non integre nel set di scalabilità. Il valore predefinito è replace.

Nome	Tipo	Descrizione
Reimage	string
Replace	string
Restart	string

ResiliencyPolicy

Descrive un criterio di resilienza: resilientVMCreationPolicy e/o resilientVMDeletionPolicy.

Nome	Tipo	Descrizione
resilientVMCreationPolicy	ResilientVMCreationPolicy	I parametri di configurazione usati durante l'esecuzione della creazione di macchine virtuali resilienti.
resilientVMDeletionPolicy	ResilientVMDeletionPolicy	Parametri di configurazione usati durante l'esecuzione dell'eliminazione resiliente della macchina virtuale.

ResilientVMCreationPolicy

I parametri di configurazione usati durante l'esecuzione della creazione di macchine virtuali resilienti.

Nome	Tipo	Descrizione
enabled	boolean	Specifica se la creazione di macchine virtuali resilienti deve essere abilitata nel set di scalabilità di macchine virtuali. Il valore predefinito è false.

ResilientVMDeletionPolicy

Parametri di configurazione usati durante l'esecuzione dell'eliminazione resiliente della macchina virtuale.

Nome	Tipo	Descrizione
enabled	boolean	Specifica se l'eliminazione resiliente della macchina virtuale deve essere abilitata nel set di scalabilità di macchine virtuali. Il valore predefinito è false.

ResourceIdentityType

Tipo di identità usato per il set di scalabilità di macchine virtuali. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà tutte le identità dal set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

RollingUpgradePolicy

Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza.

Nome	Tipo	Descrizione
enableCrossZoneUpgrade	boolean	Consentire al set di scalabilità di macchine virtuali di ignorare i limiti az durante la creazione di batch di aggiornamento. Prendere in considerazione il dominio di aggiornamento e maxBatchInstancePercent per determinare le dimensioni del batch.
maxBatchInstancePercent	integer	Percentuale massima delle istanze totali di macchine virtuali che verranno aggiornate contemporaneamente dall'aggiornamento in sequenza in un unico batch. Poiché si tratta di un valore massimo, le istanze non integre nei batch precedenti o futuri possono causare la diminuzione della percentuale di istanze in un batch per garantire una maggiore affidabilità. Il valore predefinito per questo parametro è 20%.
maxSurge	boolean	Creare nuove macchine virtuali per aggiornare il set di scalabilità anziché aggiornare le macchine virtuali esistenti. Le macchine virtuali esistenti verranno eliminate dopo la creazione delle nuove macchine virtuali per ogni batch.
maxUnhealthyInstancePercent	integer	Percentuale massima delle istanze totali della macchina virtuale nel set di scalabilità che possono essere contemporaneamente non integre, in seguito all'aggiornamento o rilevate in uno stato non integro dai controlli di integrità della macchina virtuale prima dell'interruzione dell'aggiornamento in sequenza. Questo vincolo verrà controllato prima di avviare qualsiasi batch. Il valore predefinito per questo parametro è 20%.
maxUnhealthyUpgradedInstancePercent	integer	Percentuale massima di istanze di macchina virtuale aggiornate che possono essere trovate in uno stato non integro. Questo controllo verrà eseguito dopo l'aggiornamento di ogni batch. Se questa percentuale viene mai superata, l'aggiornamento in sequenza viene interrotto. Il valore predefinito per questo parametro è 20%.
pauseTimeBetweenBatches	string	Tempo di attesa tra il completamento dell'aggiornamento per tutte le macchine virtuali in un batch e l'avvio del batch successivo. La durata dell'ora deve essere specificata nel formato ISO 8601. Il valore predefinito è 0 secondi (PT0S).
prioritizeUnhealthyInstances	boolean	Aggiornare tutte le istanze non integre in un set di scalabilità prima di qualsiasi istanza integra.
rollbackFailedInstancesOnPolicyBreach	boolean	Il rollback delle istanze non riuscite nel modello precedente se i criteri di aggiornamento in sequenza vengono violati.

ScaleInPolicy

Descrive un criterio di scalabilità orizzontale per un set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
forceDeletion	boolean	Questa proprietà consente di specificare se le macchine virtuali scelte per la rimozione devono essere forzate quando viene ridimensionato un set di scalabilità di macchine virtuali. (Funzionalità in anteprima)
rules	VirtualMachineScaleSetScaleInRules[]	Regole da seguire durante il ridimensionamento di un set di scalabilità di macchine virtuali. I valori possibili sono: Impostazione predefinita Quando viene ridimensionato un set di scalabilità di macchine virtuali, il set di scalabilità verrà prima bilanciato tra le zone se si tratta di un set di scalabilità di zona. Quindi, verrà bilanciato tra domini di errore il più possibile. All'interno di ogni dominio di errore, le macchine virtuali scelte per la rimozione saranno quelle più recenti che non sono protette dal ridimensionamento. OldestVM Quando viene ridimensionato un set di scalabilità di macchine virtuali, verranno scelte le macchine virtuali meno recenti non protette dal ridimensionamento per la rimozione. Per i set di scalabilità di macchine virtuali di zona, il set di scalabilità verrà prima bilanciato tra le zone. All'interno di ogni zona, verranno scelte le macchine virtuali meno recenti che non sono protette per la rimozione. NewestVM Quando viene ridimensionato un set di scalabilità di macchine virtuali, verranno scelte le macchine virtuali più recenti non protette dal ridimensionamento per la rimozione. Per i set di scalabilità di macchine virtuali di zona, il set di scalabilità verrà prima bilanciato tra le zone. All'interno di ogni zona, verranno scelte le macchine virtuali più recenti che non sono protette per la rimozione.

ScheduledEventsAdditionalPublishingTargets

Nome	Tipo	Descrizione
eventGridAndResourceGraph	EventGridAndResourceGraph	I parametri di configurazione usati durante la creazione dell'impostazione eventGridAndResourceGraph Scheduled Event.

ScheduledEventsPolicy

Specifica le configurazioni correlate a Redeploy, Reboot e ScheduledEventsAdditionalPublishingTargets Scheduled Event.

Nome	Tipo	Descrizione
scheduledEventsAdditionalPublishingTargets	ScheduledEventsAdditionalPublishingTargets	Parametri di configurazione usati durante la pubblicazione scheduledEventsAdditionalPublishingTargets.
userInitiatedReboot	UserInitiatedReboot	I parametri di configurazione usati durante la creazione di un'impostazione evento pianificata userInitiatedReboot.
userInitiatedRedeploy	UserInitiatedRedeploy	I parametri di configurazione usati durante la creazione dell'impostazione dell'evento pianificata userInitiatedRedeploy.

ScheduledEventsProfile

Nome	Tipo	Descrizione
osImageNotificationProfile	OSImageNotificationProfile	Specifica le configurazioni correlate all'evento pianificato dell'immagine del sistema operativo.
terminateNotificationProfile	TerminateNotificationProfile	Specifica le configurazioni correlate all'evento pianificato Terminate.

securityEncryptionTypes

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

Nome	Tipo	Descrizione
DiskWithVMGuestState	string
NonPersistedTPM	string
VMGuestStateOnly	string

SecurityPostureReference

Specifica il comportamento di sicurezza da usare nel set di scalabilità. Versione minima api: 2023-03-01

Nome	Tipo	Descrizione
excludeExtensions	string[]	Elenco dei nomi di estensione della macchina virtuale da escludere quando si applica il comportamento di sicurezza.
id	string	ID riferimento al comportamento di sicurezza sotto forma di /CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{major.minor.patch}|latest
isOverridable	boolean	Indica se il comportamento di sicurezza può essere sottoposto a override dall'utente.

SecurityProfile

Specifica le impostazioni del profilo di sicurezza per la macchina virtuale o il set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
encryptionAtHost	boolean	Questa proprietà può essere usata dall'utente nella richiesta per abilitare o disabilitare la crittografia host per la macchina virtuale o il set di scalabilità di macchine virtuali. In questo modo verrà abilitata la crittografia per tutti i dischi, incluso il disco Resource/Temp nell'host stesso. Il comportamento predefinito è: la crittografia dell'host verrà disabilitata a meno che questa proprietà non sia impostata su true per la risorsa.
encryptionIdentity	EncryptionIdentity	Specifica l'identità gestita usata da ADE per ottenere il token di accesso per le operazioni dell'insieme di credenziali delle chiavi.
proxyAgentSettings	ProxyAgentSettings	Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale. Versione minima api: 2023-09-01.
securityType	SecurityTypes	Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.
uefiSettings	UefiSettings	Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale. Versione minima api: 2020-12-01.

SecurityTypes

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

Nome	Tipo	Descrizione
ConfidentialVM	string
TrustedLaunch	string

ServiceArtifactReference

Specifica l'ID di riferimento dell'artefatto del servizio usato per impostare la stessa versione dell'immagine per tutte le macchine virtuali nel set di scalabilità quando si usa la versione dell'immagine 'latest'. Versione minima api: 2022-11-01

Nome	Tipo	Descrizione
id	string	ID riferimento dell'artefatto del servizio sotto forma di /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

SettingNames

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

Nome	Tipo	Descrizione
AutoLogon	string
FirstLogonCommands	string

Sku

Descrive uno SKU del set di scalabilità di macchine virtuali. NOTA: se il nuovo SKU della macchina virtuale non è supportato nell'hardware in cui è attualmente attivo il set di scalabilità, è necessario deallocare le macchine virtuali nel set di scalabilità prima di modificare il nome dello SKU.

Nome	Tipo	Descrizione
capacity	integer	Specifica il numero di macchine virtuali nel set di scalabilità.
name	string	Nome sku.
tier	string	Specifica il livello di macchine virtuali in un set di scalabilità. Valori possibili: standard Basic

SkuProfile

Specifica il profilo sku per il set di scalabilità di macchine virtuali. Con questa proprietà il cliente è in grado di specificare un elenco di dimensioni delle macchine virtuali e una strategia di allocazione.

Nome	Tipo	Descrizione
allocationStrategy	AllocationStrategy	Specifica la strategia di allocazione per il set di scalabilità di macchine virtuali in base alla quale verranno allocate le macchine virtuali.
vmSizes	SkuProfileVMSize[]	Specifica le dimensioni delle macchine virtuali per il set di scalabilità di macchine virtuali.

SkuProfileVMSize

Specifica le dimensioni della macchina virtuale.

Nome	Tipo	Descrizione
name	string	Specifica il nome delle dimensioni della macchina virtuale.

SpotRestorePolicy

Specifica le proprietà spot-Try-Restore per il set di scalabilità di macchine virtuali. Con questa proprietà il cliente può abilitare o disabilitare il ripristino automatico delle istanze di macchine virtuali Spot VMSS rimosse in modo opportunistico in base alla disponibilità della capacità e al vincolo dei prezzi.

Nome	Tipo	Descrizione
enabled	boolean	Abilita la funzionalità Spot-Try-Restore in cui verranno tentate le istanze SPOT di VMSS rimosse in modo opportunistico in base ai vincoli di disponibilità e prezzi della capacità
restoreTimeout	string	Valore di timeout espresso come durata ISO 8601 dopo la quale la piattaforma non tenterà di ripristinare le istanze SPOT di VMSS

SshConfiguration

Configurazione SSH per macchine virtuali basate su Linux in esecuzione in Azure

Nome	Tipo	Descrizione
publicKeys	SshPublicKey[]	Elenco di chiavi pubbliche SSH usate per l'autenticazione con macchine virtuali basate su Linux.

SshPublicKey

Contiene informazioni sulla chiave pubblica del certificato SSH e sul percorso nella macchina virtuale Linux in cui viene inserita la chiave pubblica.

Nome	Tipo	Descrizione
keyData	string	Certificato di chiave pubblica SSH usato per l'autenticazione con la macchina virtuale tramite ssh. La chiave deve essere almeno a 2048 bit e in formato ssh-rsa. Per la creazione di chiavi SSH, vedere [Creare chiavi SSH in Linux e Mac per macchine virtuali Linux in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).
path	string	Specifica il percorso completo nella macchina virtuale creata in cui è archiviata la chiave pubblica SSH. Se il file esiste già, la chiave specificata viene aggiunta al file. Esempio: /home/user/.ssh/authorized_keys

StorageAccountTypes

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

Nome	Tipo	Descrizione
PremiumV2_LRS	string
Premium_LRS	string
Premium_ZRS	string
StandardSSD_LRS	string
StandardSSD_ZRS	string
Standard_LRS	string
UltraSSD_LRS	string

SubResource

Nome	Tipo	Descrizione
id	string	ID risorsa

TerminateNotificationProfile

Nome	Tipo	Descrizione
enable	boolean	Specifica se l'evento Terminate Scheduled è abilitato o disabilitato.
notBeforeTimeout	string	La durata configurabile dell'eliminazione di una macchina virtuale dovrà potenzialmente approvare l'evento pianificato terminate prima che l'evento venga approvato automaticamente (timeout). La configurazione deve essere specificata in formato ISO 8601, il valore predefinito è 5 minuti (PT5M)

UefiSettings

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

Nome	Tipo	Descrizione
secureBootEnabled	boolean	Specifica se l'avvio protetto deve essere abilitato nella macchina virtuale. Versione minima api: 2020-12-01.
vTpmEnabled	boolean	Specifica se vTPM deve essere abilitato nella macchina virtuale. Versione minima api: 2020-12-01.

UpgradeMode

Specifica la modalità di un aggiornamento alle macchine virtuali nel set di scalabilità.

I valori possibili sono:

manuale: è possibile controllare l'applicazione degli aggiornamenti alle macchine virtuali nel set di scalabilità. A tale scopo, usare l'azione manualUpgrade.

automatico: tutte le macchine virtuali nel set di scalabilità vengono aggiornate automaticamente contemporaneamente.

Nome	Tipo	Descrizione
Automatic	string
Manual	string
Rolling	string

UpgradePolicy

Descrive un criterio di aggiornamento: automatico, manuale o in sequenza.

Nome	Tipo	Descrizione
automaticOSUpgradePolicy	AutomaticOSUpgradePolicy	Parametri di configurazione usati per eseguire l'aggiornamento automatico del sistema operativo.
mode	UpgradeMode	Specifica la modalità di un aggiornamento alle macchine virtuali nel set di scalabilità. I valori possibili sono: manuale: è possibile controllare l'applicazione degli aggiornamenti alle macchine virtuali nel set di scalabilità. A tale scopo, usare l'azione manualUpgrade. automatico: tutte le macchine virtuali nel set di scalabilità vengono aggiornate automaticamente contemporaneamente.
rollingUpgradePolicy	RollingUpgradePolicy	Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza.

UserAssignedIdentities

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

Nome	Tipo	Descrizione

UserInitiatedReboot

Specifica le configurazioni correlate agli eventi pianificati correlati al riavvio.

Nome	Tipo	Descrizione
automaticallyApprove	boolean	Specifica le configurazioni correlate all'evento pianificato per il riavvio.

UserInitiatedRedeploy

Specifica le configurazioni correlate all'evento pianificato correlate alla ridistribuitura.

Nome	Tipo	Descrizione
automaticallyApprove	boolean	Specifica le configurazioni correlate all'evento pianificato ridistribuire.

VaultCertificate

Descrive un singolo riferimento al certificato in un insieme di credenziali delle chiavi e dove risiede il certificato nella macchina virtuale.

Nome	Tipo	Descrizione
certificateStore	string	Per le macchine virtuali Windows, specifica l'archivio certificati nella macchina virtuale a cui aggiungere il certificato. L'archivio certificati specificato è in modo implicito nell'account LocalMachine. Per le macchine virtuali Linux, il file di certificato viene inserito nella directory /var/lib/waagent, con il nome file <UppercaseThumbprint>.crt per il file di certificato X509 e <UppercaseThumbprint>.prv per la chiave privata. Entrambi questi file sono formattati con estensione pem.
certificateUrl	string	Si tratta dell'URL di un certificato caricato in Key Vault come segreto. Per aggiungere un segreto all'insieme di credenziali delle chiavi, vedere Aggiungere una chiave o un segreto all'insieme di credenziali delle chiavi. In questo caso, il certificato deve essere La codifica Base64 dell'oggetto JSON seguente codificato in UTF-8: { "data":"", "dataType":"pfx", "password":"" } Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.

VaultSecretGroup

Descrive un set di certificati che si trovano tutti nello stesso insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
sourceVault	SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente tutti i certificati in VaultCertificates.
vaultCertificates	VaultCertificate[]	Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati.

VirtualHardDisk

Descrive l'URI di un disco.

Nome	Tipo	Descrizione
uri	string	Specifica l'URI del disco rigido virtuale.

VirtualMachineEvictionPolicyTypes

Specifica i criteri di rimozione per la macchina virtuale Spot di Azure e il set di scalabilità spot di Azure. Per le macchine virtuali Spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2019-03-01. Per i set di scalabilità spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2017-10-30-preview.

Nome	Tipo	Descrizione
Deallocate	string
Delete	string

VirtualMachinePriorityTypes

Specifica la priorità per le macchine virtuali nel set di scalabilità. Versione minima api: 2017-10-30-preview.

Nome	Tipo	Descrizione
Low	string
Regular	string
Spot	string

VirtualMachineScaleSet

Descrive un set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
etag	string	Etag è la proprietà restituita nella risposta Create/Update/Get del set di scalabilità di macchine virtuali, in modo che il cliente possa fornirlo nell'intestazione per garantire gli aggiornamenti ottimistici
extendedLocation	ExtendedLocation	Posizione estesa del set di scalabilità di macchine virtuali.
id	string	ID risorsa
identity	VirtualMachineScaleSetIdentity	Identità del set di scalabilità di macchine virtuali, se configurata.
location	string	Percorso risorsa
name	string	Nome risorsa
plan	Plan	Specifica informazioni sull'immagine del marketplace usata per creare la macchina virtuale. Questo elemento viene usato solo per le immagini del Marketplace. Prima di poter usare un'immagine del marketplace da un'API, è necessario abilitare l'immagine per l'uso a livello di codice. Nel portale di Azure individuare l'immagine del Marketplace che si vuole usare e quindi fare clic su Si vuole distribuire a livello di codice, Introduzione ->. Immettere le informazioni necessarie e quindi fare clic su Salva.
properties.additionalCapabilities	AdditionalCapabilities	Specifica funzionalità aggiuntive abilitate o disabilitate nelle macchine virtuali nel set di scalabilità di macchine virtuali. Ad esempio, se le macchine virtuali hanno la possibilità di supportare il collegamento di dischi dati gestiti con UltraSSD_LRS tipo di account di archiviazione.
properties.automaticRepairsPolicy	AutomaticRepairsPolicy	Criteri per le riparazioni automatiche.
properties.constrainedMaximumCapacity	boolean	Proprietà facoltativa che deve essere impostata su True o omessa.
properties.doNotRunExtensionsOnOverprovisionedVMs	boolean	Quando l'overprovision è abilitato, le estensioni vengono avviate solo sul numero richiesto di macchine virtuali che vengono infine mantenute. Questa proprietà garantisce quindi che le estensioni non vengano eseguite nelle macchine virtuali con provisioning eccessivo aggiuntivo.
properties.hostGroup	SubResource	Specifica informazioni sul gruppo host dedicato in cui risiede il set di scalabilità di macchine virtuali. Versione minima api: 2020-06-01.
properties.orchestrationMode	OrchestrationMode	Specifica la modalità di orchestrazione per il set di scalabilità di macchine virtuali.
properties.overprovision	boolean	Specifica se il set di scalabilità di macchine virtuali deve essere sottoposto a provisioning eccessivo.
properties.platformFaultDomainCount	integer	Numero di domini di errore per ogni gruppo di posizionamento.
properties.priorityMixPolicy	PriorityMixPolicy	Specifica le destinazioni desiderate per combinare macchine virtuali con priorità spot e regolare all'interno della stessa istanza di VMSS Flex.
properties.provisioningState	string	Stato di provisioning, visualizzato solo nella risposta.
properties.proximityPlacementGroup	SubResource	Specifica informazioni sul gruppo di posizionamento di prossimità a cui deve essere assegnato il set di scalabilità di macchine virtuali. Versione minima api: 2018-04-01.
properties.resiliencyPolicy	ResiliencyPolicy	Criteri per la resilienza
properties.scaleInPolicy	ScaleInPolicy	Specifica i criteri applicati durante il ridimensionamento nelle macchine virtuali nel set di scalabilità di macchine virtuali.
properties.scheduledEventsPolicy	ScheduledEventsPolicy	The ScheduledEventsPolicy.
properties.singlePlacementGroup	boolean	Se true, questo limita il set di scalabilità a un singolo gruppo di posizionamento, con dimensioni massime di 100 macchine virtuali. NOTA: se singlePlacementGroup è true, può essere modificato in false. Tuttavia, se singlePlacementGroup è false, potrebbe non essere modificato in true.
properties.skuProfile	SkuProfile	Specifica il profilo sku per il set di scalabilità di macchine virtuali.
properties.spotRestorePolicy	SpotRestorePolicy	Specifica le proprietà di ripristino spot per il set di scalabilità di macchine virtuali.
properties.timeCreated	string	Specifica l'ora di creazione della risorsa del set di scalabilità di macchine virtuali. Versione minima api: 2021-11-01.
properties.uniqueId	string	Specifica l'ID che identifica in modo univoco un set di scalabilità di macchine virtuali.
properties.upgradePolicy	UpgradePolicy	Criteri di aggiornamento.
properties.virtualMachineProfile	VirtualMachineScaleSetVMProfile	Profilo della macchina virtuale.
properties.zonalPlatformFaultDomainAlignMode	ZonalPlatformFaultDomainAlignMode	Specifica la modalità di allineamento tra il calcolo del set di scalabilità di macchine virtuali e il numero di domini di errore di archiviazione.
properties.zoneBalance	boolean	Se forzare rigorosamente anche la distribuzione di macchine virtuali tra zone x in caso di interruzione della zona. La proprietà zoneBalance può essere impostata solo se la proprietà zone del set di scalabilità contiene più di una zona. Se non sono specificate zone o una sola zona, la proprietà zoneBalance non deve essere impostata.
sku	Sku	SKU del set di scalabilità di macchine virtuali.
tags	object	Tag delle risorse
type	string	Tipo di risorsa
zones	string[]	Zone del set di scalabilità di macchine virtuali.

VirtualMachineScaleSetDataDisk

Descrive un disco dati del set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
caching	CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. I valori predefiniti sono: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
createOption	DiskCreateOptionTypes	Opzione di creazione.
deleteOption	DiskDeleteOptionTypes	Specifica se il disco dati deve essere eliminato o scollegato dopo l'eliminazione di VMSS Flex (questa funzionalità è disponibile solo per VMSS con Flexible OrchestrationMode). Valori possibili: Elimina Se si usa questo valore, il disco dati viene eliminato quando viene eliminata la macchina virtuale VMSS Flex. Scollegare Se si usa questo valore, il disco dati viene mantenuto dopo l'eliminazione della macchina virtuale VMSS Flex. Il valore predefinito è impostato su Elimina.
diskIOPSReadWrite	integer	Specifica il Read-Write operazioni di I/O al secondo per il disco gestito. Deve essere usato solo quando StorageAccountType è UltraSSD_LRS. Se non specificato, viene assegnato un valore predefinito in base a diskSizeGB.
diskMBpsReadWrite	integer	Specifica la larghezza di banda in MB al secondo per il disco gestito. Deve essere usato solo quando StorageAccountType è UltraSSD_LRS. Se non specificato, viene assegnato un valore predefinito in base a diskSizeGB.
diskSizeGB	integer	Specifica le dimensioni di un disco dati vuoto in gigabyte. Questo elemento può essere usato per sovrascrivere le dimensioni del disco in un'immagine di macchina virtuale. La proprietà diskSizeGB è il numero di byte x 1024^3 per il disco e il valore non può essere maggiore di 1023.
lun	integer	Specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato a una macchina virtuale.
managedDisk	VirtualMachineScaleSetManagedDiskParameters	Parametri del disco gestito.
name	string	Nome del disco.
writeAcceleratorEnabled	boolean	Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

VirtualMachineScaleSetExtension

Descrive un'estensione del set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
id	string	ID risorsa
name	string	Nome dell'estensione.
properties.autoUpgradeMinorVersion	boolean	Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true.
properties.enableAutomaticUpgrade	boolean	Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione.
properties.forceUpdateTag	string	Se viene specificato un valore ed è diverso dal valore precedente, il gestore dell'estensione verrà forzato ad aggiornare anche se la configurazione dell'estensione non è stata modificata.
properties.protectedSettings	object	L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta.
properties.protectedSettingsFromKeyVault	KeyVaultSecretReference	Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi
properties.provisionAfterExtensions	string[]	Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione.
properties.provisioningState	string	Stato di provisioning, visualizzato solo nella risposta.
properties.publisher	string	Nome del server di pubblicazione del gestore dell'estensione.
properties.settings	object	Impostazioni pubbliche in formato JSON per l'estensione.
properties.suppressFailures	boolean	Indica se gli errori derivanti dall'estensione verranno eliminati (gli errori operativi, ad esempio la mancata connessione alla macchina virtuale, non verranno eliminati indipendentemente da questo valore). Il valore predefinito è false.
properties.type	string	Specifica il tipo di estensione; un esempio è "CustomScriptExtension".
properties.typeHandlerVersion	string	Specifica la versione del gestore di script.
type	string	Tipo di risorsa

VirtualMachineScaleSetExtensionProfile

Descrive un profilo di estensione del set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
extensions	VirtualMachineScaleSetExtension[]	Risorse dell'estensione figlio del set di scalabilità di macchine virtuali.
extensionsTimeBudget	string	Specifica il tempo assegnato per l'avvio di tutte le estensioni. La durata deve essere compresa tra 15 minuti e 120 minuti (inclusi) e deve essere specificata in formato ISO 8601. Il valore predefinito è 90 minuti (PT1H30M). Versione minima api: 2020-06-01.

VirtualMachineScaleSetHardwareProfile

Specifica le impostazioni hardware per il set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
vmSizeProperties	VMSizeProperties	Specifica le proprietà per la personalizzazione delle dimensioni della macchina virtuale. Versione minima api: 2021-11-01. Per altri dettagli, seguire le istruzioni riportate in di personalizzazione della macchina virtuale.

VirtualMachineScaleSetIdentity

Identità per il set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
principalId	string	ID principale dell'identità del set di scalabilità di macchine virtuali. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string	ID tenant associato al set di scalabilità di macchine virtuali. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ResourceIdentityType	Tipo di identità usato per il set di scalabilità di macchine virtuali. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà tutte le identità dal set di scalabilità di macchine virtuali.
userAssignedIdentities	UserAssignedIdentities	Elenco delle identità utente associate al set di scalabilità di macchine virtuali. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

VirtualMachineScaleSetIPConfiguration

Descrive la configurazione IP di un profilo di rete del set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
name	string	Nome della configurazione IP.
properties.applicationGatewayBackendAddressPools	SubResource[]	Specifica una matrice di riferimenti ai pool di indirizzi back-end dei gateway applicazione. Un set di scalabilità può fare riferimento a pool di indirizzi back-end di più gateway applicazione. Più set di scalabilità non possono usare lo stesso gateway applicazione.
properties.applicationSecurityGroups	SubResource[]	Specifica una matrice di riferimenti al gruppo di sicurezza delle applicazioni.
properties.loadBalancerBackendAddressPools	SubResource[]	Specifica una matrice di riferimenti ai pool di indirizzi back-end dei servizi di bilanciamento del carico. Un set di scalabilità può fare riferimento a pool di indirizzi back-end di un servizio di bilanciamento del carico pubblico e interno. Più set di scalabilità non possono usare lo stesso servizio di bilanciamento del carico sku basic.
properties.loadBalancerInboundNatPools	SubResource[]	Specifica una matrice di riferimenti ai pool Nat in ingresso dei servizi di bilanciamento del carico. Un set di scalabilità può fare riferimento a pool NAT in ingresso di un pool pubblico e di un servizio di bilanciamento del carico interno. Più set di scalabilità non possono usare lo stesso servizio di bilanciamento del carico sku basic.
properties.primary	boolean	Specifica l'interfaccia di rete primaria nel caso in cui la macchina virtuale abbia più di 1 interfaccia di rete.
properties.privateIPAddressVersion	IPVersion	Disponibile da Api-Version 2017-03-30 e versioni successive, indica se la specifica ipconfiguration è IPv4 o IPv6. Il valore predefinito è IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.
properties.publicIPAddressConfiguration	VirtualMachineScaleSetPublicIPAddressConfiguration	PublicIPAddressConfiguration.
properties.subnet	ApiEntityReference	Specifica l'identificatore della subnet.

VirtualMachineScaleSetIpTag

Contiene il tag IP associato all'indirizzo IP pubblico.

Nome	Tipo	Descrizione
ipTagType	string	Tipo di tag IP. Esempio: FirstPartyUsage.
tag	string	Tag IP associato all'indirizzo IP pubblico. Esempio: SQL, Archiviazione e così via.

VirtualMachineScaleSetManagedDiskParameters

Descrive i parametri di un disco gestito scaleset.

Nome	Tipo	Descrizione
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.
securityProfile	VMDiskSecurityProfile	Specifica il profilo di sicurezza per il disco gestito.
storageAccountType	StorageAccountTypes	Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con dischi dati, non può essere usato con il disco del sistema operativo.

VirtualMachineScaleSetNetworkConfiguration

Descrive le configurazioni di rete del profilo di rete di un set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
name	string	Nome della configurazione di rete.
properties.auxiliaryMode	NetworkInterfaceAuxiliaryMode	Specifica se la modalità ausiliaria è abilitata per la risorsa interfaccia di rete.
properties.auxiliarySku	NetworkInterfaceAuxiliarySku	Specifica se lo SKU ausiliario è abilitato per la risorsa interfaccia di rete.
properties.deleteOption	DeleteOptions	Specificare cosa accade all'interfaccia di rete quando la macchina virtuale viene eliminata
properties.disableTcpStateTracking	boolean	Specifica se l'interfaccia di rete è disabilitata per il rilevamento dello stato TCP.
properties.dnsSettings	VirtualMachineScaleSetNetworkConfigurationDnsSettings	Impostazioni DNS da applicare alle interfacce di rete.
properties.enableAcceleratedNetworking	boolean	Specifica se l'interfaccia di rete è abilitata per la rete accelerata.
properties.enableFpga	boolean	Specifica se l'interfaccia di rete è abilitata per la rete FPGA.
properties.enableIPForwarding	boolean	Indica se l'inoltro IP è abilitato in questa scheda di interfaccia di rete.
properties.ipConfigurations	VirtualMachineScaleSetIPConfiguration[]	Specifica le configurazioni IP dell'interfaccia di rete.
properties.networkSecurityGroup	SubResource	Gruppo di sicurezza di rete.
properties.primary	boolean	Specifica l'interfaccia di rete primaria nel caso in cui la macchina virtuale abbia più di 1 interfaccia di rete.

VirtualMachineScaleSetNetworkConfigurationDnsSettings

Descrive le impostazioni DNS di una configurazione DNS dei set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
dnsServers	string[]	Elenco di indirizzi IP dei server DNS

VirtualMachineScaleSetNetworkProfile

Descrive un profilo di rete del set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
healthProbe	ApiEntityReference	Riferimento a un probe del servizio di bilanciamento del carico usato per determinare l'integrità di un'istanza nel set di scalabilità di macchine virtuali. Il riferimento sarà nel formato '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'.
networkApiVersion	NetworkApiVersion	specifica la versione dell'API Microsoft.Network usata durante la creazione di risorse di rete nelle configurazioni dell'interfaccia di rete per il set di scalabilità di macchine virtuali con modalità di orchestrazione "Flessibile"
networkInterfaceConfigurations	VirtualMachineScaleSetNetworkConfiguration[]	Elenco delle configurazioni di rete.

VirtualMachineScaleSetOSDisk

Descrive un disco del sistema operativo del set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
caching	CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. I valori predefiniti sono: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
createOption	DiskCreateOptionTypes	Specifica la modalità di creazione delle macchine virtuali nel set di scalabilità. L'unico valore consentito è: FromImage. Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, si usa anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, si usa anche l'elemento di piano descritto in precedenza.
deleteOption	DiskDeleteOptionTypes	Specifica se il disco del sistema operativo deve essere eliminato o scollegato dopo l'eliminazione di VMSS Flex (questa funzionalità è disponibile solo per VMSS con OrchestrationMode flessibile). Valori possibili: Elimina Se si usa questo valore, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale VmSS Flex. Scollegare Se si usa questo valore, il disco del sistema operativo viene mantenuto dopo l'eliminazione della macchina virtuale Flex di VMSS. Il valore predefinito è impostato su Elimina. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per disco del sistema operativo temporaneo.
diffDiskSettings	DiffDiskSettings	Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dal set di scalabilità di macchine virtuali.
diskSizeGB	integer	Specifica le dimensioni di un disco dati vuoto in gigabyte. Questo elemento può essere usato per sovrascrivere le dimensioni del disco in un'immagine di macchina virtuale. La proprietà 'diskSizeGB' è il numero di byte x 1024^3 per il disco e il valore non può essere maggiore di 1023.
image	VirtualHardDisk	Specifica informazioni sull'immagine utente non gestita su cui basare il set di scalabilità.
managedDisk	VirtualMachineScaleSetManagedDiskParameters	Parametri del disco gestito.
name	string	Nome del disco.
osType	OperatingSystemTypes	Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco se si crea una macchina virtuale da un'immagine utente o un disco rigido virtuale specializzato. I valori possibili sono: Windows,Linux.
vhdContainers	string[]	Specifica gli URL del contenitore usati per archiviare i dischi del sistema operativo per il set di scalabilità.
writeAcceleratorEnabled	boolean	Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

VirtualMachineScaleSetOSProfile

Descrive un profilo del sistema operativo del set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
adminPassword	string	Specifica la password dell'account amministratore. Lunghezza minima (Windows): 8 caratteri Lunghezza minima (Linux): 6 caratteri Lunghezza massima (Windows): 123 caratteri Lunghezza massima (Linux): 72 caratteri requisiti di complessità: è necessario soddisfare 3 su 4 condizioni seguenti Ha caratteri inferiori Ha caratteri superiori Ha una cifra Ha un carattere speciale (corrispondenza regex [\W_]) Valori non consentiti: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!" Per reimpostare la password, vedere Come reimpostare il servizio Desktop remoto o la relativa password di accesso in una macchina virtuale Windows Per reimpostare la password radice, vedere Gestire utenti, SSH e controllare o ripristinare i dischi in macchine virtuali Linux di Azure usando l'estensione VMAccess
adminUsername	string	Specifica il nome dell'account amministratore. restrizione solo Windows: Non è possibile terminare in "." Valori non consentiti: "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". lunghezza minima (Linux): 1 carattere Lunghezza massima (Linux): 64 caratteri Lunghezza massima (Windows): 20 caratteri
allowExtensionOperations	boolean	Specifica se le operazioni di estensione devono essere consentite nel set di scalabilità di macchine virtuali. Questa impostazione può essere impostata su False solo quando non sono presenti estensioni nel set di scalabilità di macchine virtuali.
computerNamePrefix	string	Specifica il prefisso del nome computer per tutte le macchine virtuali nel set di scalabilità. I prefissi dei nomi computer devono essere lunghi da 1 a 15 caratteri.
customData	string	Specifica una stringa con codifica base 64 di dati personalizzati. La stringa con codifica base 64 viene decodificata in una matrice binaria salvata come file nella macchina virtuale. La lunghezza massima della matrice binaria è di 65535 byte. Per l'uso di cloud-init per la macchina virtuale, vedere Uso di cloud-init per personalizzare una macchina virtuale Linux durante la creazione
linuxConfiguration	LinuxConfiguration	Specifica le impostazioni del sistema operativo Linux nella macchina virtuale. Per un elenco delle distribuzioni Linux supportate, vedere Linux in distribuzioni Azure-Endorsed.
requireGuestProvisionSignal	boolean	Proprietà facoltativa che deve essere impostata su True o omessa.
secrets	VaultSecretGroup[]	Specifica il set di certificati che devono essere installati nelle macchine virtuali nel set di scalabilità. Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.
windowsConfiguration	WindowsConfiguration	Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.

VirtualMachineScaleSetPublicIPAddressConfiguration

Descrive la configurazione publicIPAddress di un set di scalabilità di macchine virtuali

Nome	Tipo	Descrizione
name	string	Nome di configurazione dell'indirizzo publicIP.
properties.deleteOption	DeleteOptions	Specificare cosa accade all'indirizzo IP pubblico quando la macchina virtuale viene eliminata
properties.dnsSettings	VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings	Impostazioni DNS da applicare agli indirizzi publicIP.
properties.idleTimeoutInMinutes	integer	Timeout di inattività dell'indirizzo IP pubblico.
properties.ipTags	VirtualMachineScaleSetIpTag[]	Elenco di tag IP associati all'indirizzo IP pubblico.
properties.publicIPAddressVersion	IPVersion	Disponibile da Api-Version 2019-07-01 e versioni successive, indica se la configurazione ip specifica è IPv4 o IPv6. Il valore predefinito è IPv4. I valori possibili sono: 'IPv4' e 'IPv6'.
properties.publicIPPrefix	SubResource	PublicIPPrefix da cui allocare indirizzi publicIP.
sku	PublicIPAddressSku	Descrive lo SKU dell'indirizzo IP pubblico. Può essere impostato solo con OrchestrationMode come flessibile.

VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings

Descrive le impostazioni DNS di una configurazione DNS dei set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
domainNameLabel	string	Etichetta Nome di dominio. La concatenazione dell'etichetta del nome di dominio e dell'indice vm sarà costituita dalle etichette dei nomi di dominio delle risorse PublicIPAddress che verranno create
domainNameLabelScope	DomainNameLabelScopeTypes	Ambito dell'etichetta nome di dominio. La concatenazione dell'etichetta del nome di dominio con hash generata in base ai criteri dall'ambito dell'etichetta del nome di dominio e l'indice vm saranno le etichette dei nomi di dominio delle risorse PublicIPAddress che verranno create

VirtualMachineScaleSetScaleInRules

Regole da seguire durante il ridimensionamento di un set di scalabilità di macchine virtuali.

I valori possibili sono:

Impostazione predefinita Quando viene ridimensionato un set di scalabilità di macchine virtuali, il set di scalabilità verrà prima bilanciato tra le zone se si tratta di un set di scalabilità di zona. Quindi, verrà bilanciato tra domini di errore il più possibile. All'interno di ogni dominio di errore, le macchine virtuali scelte per la rimozione saranno quelle più recenti che non sono protette dal ridimensionamento.

OldestVM Quando viene ridimensionato un set di scalabilità di macchine virtuali, verranno scelte le macchine virtuali meno recenti non protette dal ridimensionamento per la rimozione. Per i set di scalabilità di macchine virtuali di zona, il set di scalabilità verrà prima bilanciato tra le zone. All'interno di ogni zona, verranno scelte le macchine virtuali meno recenti che non sono protette per la rimozione.

NewestVM Quando viene ridimensionato un set di scalabilità di macchine virtuali, verranno scelte le macchine virtuali più recenti non protette dal ridimensionamento per la rimozione. Per i set di scalabilità di macchine virtuali di zona, il set di scalabilità verrà prima bilanciato tra le zone. All'interno di ogni zona, verranno scelte le macchine virtuali più recenti che non sono protette per la rimozione.

Nome	Tipo	Descrizione
Default	string
NewestVM	string
OldestVM	string

VirtualMachineScaleSetStorageProfile

Descrive un profilo di archiviazione del set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
dataDisks	VirtualMachineScaleSetDataDisk[]	Specifica i parametri usati per aggiungere dischi dati alle macchine virtuali nel set di scalabilità. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.
diskControllerType	DiskControllerTypes[]	Specifica il tipo di controller del disco configurato per le macchine virtuali nel set di scalabilità. Versione minima api: 2022-08-01
imageReference	ImageReference	Specifica le informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini delle macchine virtuali. Questo elemento è obbligatorio quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione.
osDisk	VirtualMachineScaleSetOSDisk	Specifica informazioni sul disco del sistema operativo usato dalle macchine virtuali nel set di scalabilità. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

VirtualMachineScaleSetVMProfile

Descrive un profilo di macchina virtuale del set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
applicationProfile	ApplicationProfile	Specifica le applicazioni della raccolta che devono essere rese disponibili per la macchina virtuale/set di scalabilità di macchine virtuali
billingProfile	BillingProfile	Specifica i dettagli relativi alla fatturazione di un set di scalabilità di macchine virtuali spot di Azure. Versione minima api: 2019-03-01.
capacityReservation	CapacityReservationProfile	Specifica i dettagli correlati alla prenotazione della capacità di un set di scalabilità. Versione minima api: 2021-04-01.
diagnosticsProfile	DiagnosticsProfile	Specifica lo stato delle impostazioni di diagnostica di avvio. Versione minima api: 2015-06-15.
evictionPolicy	VirtualMachineEvictionPolicyTypes	Specifica i criteri di rimozione per la macchina virtuale Spot di Azure e il set di scalabilità spot di Azure. Per le macchine virtuali Spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2019-03-01. Per i set di scalabilità spot di Azure, sono supportati sia 'Deallocate' che 'Delete' e la versione minima api-version è 2017-10-30-preview.
extensionProfile	VirtualMachineScaleSetExtensionProfile	Specifica una raccolta di impostazioni per le estensioni installate nelle macchine virtuali nel set di scalabilità.
hardwareProfile	VirtualMachineScaleSetHardwareProfile	Specifica i dettagli correlati al profilo hardware di un set di scalabilità. Versione minima api: 2021-11-01.
licenseType	string	Specifica che l'immagine o il disco usato è stato concesso in licenza in locale. I valori possibili per il sistema operativo Windows Server sono: Windows_Client Windows_Server I valori possibili per il sistema operativo Linux Server sono: RHEL_BYOS (per RHEL) SLES_BYOS (per SUSE) Per altre informazioni, vedere Vantaggio Azure Hybrid Use per Windows Server Vantaggio Azure Hybrid Use per Linux Server Versione minima api: 2015-06-15
networkProfile	VirtualMachineScaleSetNetworkProfile	Specifica le proprietà delle interfacce di rete delle macchine virtuali nel set di scalabilità.
osProfile	VirtualMachineScaleSetOSProfile	Specifica le impostazioni del sistema operativo per le macchine virtuali nel set di scalabilità.
priority	VirtualMachinePriorityTypes	Specifica la priorità per le macchine virtuali nel set di scalabilità. Versione minima api: 2017-10-30-preview.
scheduledEventsProfile	ScheduledEventsProfile	Specifica le configurazioni correlate agli eventi pianificati.
securityPostureReference	SecurityPostureReference	Specifica il comportamento di sicurezza da usare nel set di scalabilità. Versione minima api: 2023-03-01
securityProfile	SecurityProfile	Specifica le impostazioni del profilo correlato alla sicurezza per le macchine virtuali nel set di scalabilità.
serviceArtifactReference	ServiceArtifactReference	Specifica l'ID di riferimento dell'artefatto del servizio usato per impostare la stessa versione dell'immagine per tutte le macchine virtuali nel set di scalabilità quando si usa la versione dell'immagine 'latest'. Versione minima api: 2022-11-01
storageProfile	VirtualMachineScaleSetStorageProfile	Specifica le impostazioni di archiviazione per i dischi delle macchine virtuali.
timeCreated	string	Specifica l'ora di creazione del profilo di macchina virtuale per il set di scalabilità di macchine virtuali. Questo valore verrà aggiunto ai tag VMSS Flex durante la creazione o l'aggiornamento del profilo di macchina virtuale VMSS. La versione minima dell'API per questa proprietà è 2023-09-01.
userData	string	UserData per le macchine virtuali nel set di scalabilità, che deve essere codificato in base 64. Il cliente non deve passare segreti qui. Versione minima api: 2021-03-01.

VMDiskSecurityProfile

Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostato solo per le macchine virtuali riservate.

Nome	Tipo	Descrizione
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito usato per il disco del sistema operativo ConfidentialVM crittografato con chiave gestita dal cliente e il BLOB VMGuest.
securityEncryptionType	securityEncryptionTypes	Specifica encryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostato solo per le macchine virtuali riservate.

VMGalleryApplication

Specifica le informazioni necessarie per fare riferimento a una versione dell'applicazione della raccolta di calcolo

Nome	Tipo	Descrizione
configurationReference	string	Facoltativo, specifica l'URI di un BLOB di Azure che sostituirà la configurazione predefinita per il pacchetto, se specificato
enableAutomaticUpgrade	boolean	Se impostato su true, quando è disponibile una nuova versione dell'applicazione della raccolta in PIR/SIG, verrà aggiornata automaticamente per la macchina virtuale/set di scalabilità di macchine virtuali
order	integer	Facoltativo, specifica l'ordine in cui devono essere installati i pacchetti
packageReferenceId	string	Specifica l'ID risorsa GalleryApplicationVersion nel formato /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/applications/{application}/versions/{version}
tags	string	Facoltativo, specifica un valore pass-through per un contesto più generico.
treatFailureAsDeploymentFailure	boolean	Facoltativo, se true, eventuali errori per qualsiasi operazione in VmApplication avranno esito negativo nella distribuzione

VMSizeProperties

Specifica le impostazioni delle proprietà dimensioni macchina virtuale nella macchina virtuale.

Nome	Tipo	Descrizione
vCPUsAvailable	integer	Specifica il numero di vCPU disponibili per la macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito consiste nell'impostarlo sul valore delle vCPU disponibili per le dimensioni della macchina virtuale esposte in risposta api di Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area.
vCPUsPerCore	integer	Specifica il rapporto tra vCPU e core fisici. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito è impostato sul valore di vCPUsPerCore per le dimensioni della macchina virtuale esposte in risposta api di Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area. L'impostazione di questa proprietà su 1 indica anche che l'hyper-threading è disabilitato.

WindowsConfiguration

Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.

Nome	Tipo	Descrizione
additionalUnattendContent	AdditionalUnattendContent[]	Specifica ulteriori informazioni in formato XML con codifica Base 64 che possono essere incluse nel file Unattend.xml, che viene utilizzato dal programma di installazione di Windows.
enableAutomaticUpdates	boolean	Indica se gli aggiornamenti automatici sono abilitati per la macchina virtuale Windows. Il valore predefinito è true. Per i set di scalabilità di macchine virtuali, questa proprietà può essere aggiornata e gli aggiornamenti avranno effetto sul reprovisioning del sistema operativo.
enableVMAgentPlatformUpdates	boolean	Indica se gli aggiornamenti della piattaforma VMAgent sono abilitati per la macchina virtuale Windows.
patchSettings	PatchSettings	[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.
provisionVMAgent	boolean	Indica se è necessario eseguire il provisioning dell'agente di macchine virtuali nella macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, viene impostata su true per impostazione predefinita. In questo modo si garantisce che l'agente di macchine virtuali sia installato nella macchina virtuale in modo che le estensioni possano essere aggiunte alla macchina virtuale in un secondo momento.
timeZone	string	Specifica il fuso orario della macchina virtuale. ad esempio "Ora solare pacifico". I valori possibili possono essere TimeZoneInfo.Id valore dai fusi orari restituiti da TimeZoneInfo.GetSystemTimeZones.
winRM	WinRMConfiguration	Specifica i listener di Gestione remota Windows. In questo modo si abilita Windows PowerShell remoto.

WindowsPatchAssessmentMode

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

I valori possibili sono:

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

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

Nome	Tipo	Descrizione
AutomaticByPlatform	string
ImageDefault	string

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

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

Nome	Tipo	Descrizione
Always	string
IfRequired	string
Never	string
Unknown	string

WindowsVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive da applicare quando la modalità patch AutomaticByPlatform è selezionata nelle impostazioni della patch di Windows.

Nome	Tipo	Descrizione
bypassPlatformSafetyChecksOnUserSchedule	boolean	Consente al cliente di pianificare l'applicazione di patch senza aggiornamenti accidentali
rebootSetting	WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.

WindowsVMGuestPatchMode

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

I valori possibili sono:

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

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

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

Nome	Tipo	Descrizione
AutomaticByOS	string
AutomaticByPlatform	string
Manual	string

WinRMConfiguration

Descrive la configurazione di Gestione remota Windows della macchina virtuale

Nome	Tipo	Descrizione
listeners	WinRMListener[]	Elenco di listener di Gestione remota Windows

WinRMListener

Descrive il protocollo e l'identificazione personale del listener di Gestione remota Windows

Nome	Tipo	Descrizione
certificateUrl	string	Si tratta dell'URL di un certificato caricato in Key Vault come segreto. Per aggiungere un segreto all'insieme di credenziali delle chiavi, vedere Aggiungere una chiave o un segreto all'insieme di credenziali delle chiavi. In questo caso, il certificato deve essere la codifica Base64 dell'oggetto JSON seguente, codificato in UTF-8: { "data":"", "dataType":"pfx", "password":"" } Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.
protocol	ProtocolTypes	Specifica il protocollo del listener WinRM. I valori possibili sono: http,https.

ZonalPlatformFaultDomainAlignMode

Specifica la modalità di allineamento tra il calcolo del set di scalabilità di macchine virtuali e il numero di domini di errore di archiviazione.

Nome	Tipo	Descrizione
Aligned	string
Unaligned	string