Virtual Machine Extension Images - Get

Service:

Compute

Version d’API:

2026-03-01

Obtient une image d’extension de machine virtuelle.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/publishers/{publisherName}/artifacttypes/vmextension/types/{type}/versions/{version}?api-version=2026-03-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
location	path	True	string minLength: 1	Nom de la région Azure.
publisherName	path	True	string
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
type	path	True	string
version	path	True	string
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	VirtualMachineExtensionImage	Opération Azure terminée avec succès.
Other Status Codes	CloudError	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 d’Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Usurper l’identité de votre compte utilisateur

Exemples

VirtualMachineExtensionImage_Get_MaximumSet_Gen

VirtualMachineExtensionImage_Get_MinimumSet_Gen

VirtualMachineExtensionImage_Get_MaximumSet_Gen

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaaaaaaaaa/publishers/aaaaaaaaaaaaaaaaaaaa/artifacttypes/vmextension/types/aaaaaaaaaaaaaaaaaa/versions/aaaaaaaaaaaaaa?api-version=2026-03-01

Java

/**
 * Samples for VirtualMachineExtensionImages Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * 2026-03-01/virtualMachineExtensionImageExamples/VirtualMachineExtensionImage_Get_MaximumSet_Gen.json
     */
    /**
     * Sample code: VirtualMachineExtensionImage_Get_MaximumSet_Gen.
     * 
     * @param manager Entry point to ComputeManager.
     */
    public static void
        virtualMachineExtensionImageGetMaximumSetGen(com.azure.resourcemanager.compute.ComputeManager manager) {
        manager.serviceClient().getVirtualMachineExtensionImages().getWithResponse("aaaaaaaaaaaaa",
            "aaaaaaaaaaaaaaaaaaaa", "aaaaaaaaaaaaaaaaaa", "aaaaaaaaaaaaaa", 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_extension_image_get_maximum_set_gen.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_extension_images.get(
        location="aaaaaaaaaaaaa",
        publisher_name="aaaaaaaaaaaaaaaaaaaa",
        type="aaaaaaaaaaaaaaaaaa",
        version="aaaaaaaaaaaaaa",
    )
    print(response)


# x-ms-original-file: 2026-03-01/virtualMachineExtensionImageExamples/VirtualMachineExtensionImage_Get_MaximumSet_Gen.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/v8"
)

// Generated from example definition: 2026-03-01/virtualMachineExtensionImageExamples/VirtualMachineExtensionImage_Get_MaximumSet_Gen.json
func ExampleVirtualMachineExtensionImagesClient_Get_virtualMachineExtensionImageGetMaximumSetGen() {
	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.NewVirtualMachineExtensionImagesClient().Get(ctx, "aaaaaaaaaaaaa", "aaaaaaaaaaaaaaaaaaaa", "aaaaaaaaaaaaaaaaaa", "aaaaaaaaaaaaaa", 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 = armcompute.VirtualMachineExtensionImagesClientGetResponse{
	// 	VirtualMachineExtensionImage: armcompute.VirtualMachineExtensionImage{
	// 		Properties: &armcompute.VirtualMachineExtensionImageProperties{
	// 			OperatingSystem: to.Ptr("aaaaaaaaaaaaaaaaaa"),
	// 			ComputeRole: to.Ptr("aaaaaaaaaaaaaaaaa"),
	// 			HandlerSchema: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaaaaaaa"),
	// 			VMScaleSetEnabled: to.Ptr(true),
	// 			SupportsMultipleExtensions: to.Ptr(true),
	// 		},
	// 		ID: to.Ptr("aaaaaaaaaaaaaaaaa"),
	// 		Name: to.Ptr("aaaaaaaaaaaaaaa"),
	// 		Type: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"),
	// 		Location: to.Ptr("aaaaaaaaaaaaa"),
	// 		Tags: map[string]*string{
	// 			"key9885": to.Ptr("aaaaaaaaa"),
	// 		},
	// 	},
	// }
}

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 gets a virtual machine extension image.
 *
 * @summary gets a virtual machine extension image.
 * x-ms-original-file: 2026-03-01/virtualMachineExtensionImageExamples/VirtualMachineExtensionImage_Get_MaximumSet_Gen.json
 */
async function virtualMachineExtensionImageGetMaximumSetGen() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "{subscription-id}";
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachineExtensionImages.get(
    "aaaaaaaaaaaaa",
    "aaaaaaaaaaaaaaaaaaaa",
    "aaaaaaaaaaaaaaaaaa",
    "aaaaaaaaaaaaaa",
  );
  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

Exemple de réponse

Code d’état:

200

{
  "properties": {
    "operatingSystem": "aaaaaaaaaaaaaaaaaa",
    "computeRole": "aaaaaaaaaaaaaaaaa",
    "handlerSchema": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "vmScaleSetEnabled": true,
    "supportsMultipleExtensions": true
  },
  "id": "aaaaaaaaaaaaaaaaa",
  "name": "aaaaaaaaaaaaaaa",
  "type": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "location": "aaaaaaaaaaaaa",
  "tags": {
    "key9885": "aaaaaaaaa"
  }
}

VirtualMachineExtensionImage_Get_MinimumSet_Gen

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaaaaaaaaaa/publishers/aaaaaaaaaaaaaaaaaaaaaaaaaa/artifacttypes/vmextension/types/aa/versions/aaa?api-version=2026-03-01

Java

/**
 * Samples for VirtualMachineExtensionImages Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * 2026-03-01/virtualMachineExtensionImageExamples/VirtualMachineExtensionImage_Get_MinimumSet_Gen.json
     */
    /**
     * Sample code: VirtualMachineExtensionImage_Get_MinimumSet_Gen.
     * 
     * @param manager Entry point to ComputeManager.
     */
    public static void
        virtualMachineExtensionImageGetMinimumSetGen(com.azure.resourcemanager.compute.ComputeManager manager) {
        manager.serviceClient().getVirtualMachineExtensionImages().getWithResponse("aaaaaaaaaaaaaa",
            "aaaaaaaaaaaaaaaaaaaaaaaaaa", "aa", "aaa", 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_extension_image_get_minimum_set_gen.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_extension_images.get(
        location="aaaaaaaaaaaaaa",
        publisher_name="aaaaaaaaaaaaaaaaaaaaaaaaaa",
        type="aa",
        version="aaa",
    )
    print(response)


# x-ms-original-file: 2026-03-01/virtualMachineExtensionImageExamples/VirtualMachineExtensionImage_Get_MinimumSet_Gen.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/v8"
)

// Generated from example definition: 2026-03-01/virtualMachineExtensionImageExamples/VirtualMachineExtensionImage_Get_MinimumSet_Gen.json
func ExampleVirtualMachineExtensionImagesClient_Get_virtualMachineExtensionImageGetMinimumSetGen() {
	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.NewVirtualMachineExtensionImagesClient().Get(ctx, "aaaaaaaaaaaaaa", "aaaaaaaaaaaaaaaaaaaaaaaaaa", "aa", "aaa", 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 = armcompute.VirtualMachineExtensionImagesClientGetResponse{
	// 	VirtualMachineExtensionImage: armcompute.VirtualMachineExtensionImage{
	// 		Name: to.Ptr("aaaaaaaaaaaaaaa"),
	// 		Location: to.Ptr("aaaaaaaaaaaaa"),
	// 		ID: to.Ptr("aaaaaaaaaaaaaaaaa"),
	// 	},
	// }
}

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 gets a virtual machine extension image.
 *
 * @summary gets a virtual machine extension image.
 * x-ms-original-file: 2026-03-01/virtualMachineExtensionImageExamples/VirtualMachineExtensionImage_Get_MinimumSet_Gen.json
 */
async function virtualMachineExtensionImageGetMinimumSetGen() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "{subscription-id}";
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachineExtensionImages.get(
    "aaaaaaaaaaaaaa",
    "aaaaaaaaaaaaaaaaaaaaaaaaaa",
    "aa",
    "aaa",
  );
  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

Exemple de réponse

Code d’état:

200

{
  "name": "aaaaaaaaaaaaaaa",
  "location": "aaaaaaaaaaaaa",
  "id": "aaaaaaaaaaaaaaaaa"
}

Définitions

Nom	Description
ApiError	Erreur d’API.
ApiErrorBase	Base d’erreurs d’API.
CloudError	Réponse d’erreur du service de calcul.
createdByType	Type d’identité qui a créé la ressource.
InnerError	Détails de l’erreur interne.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
VirtualMachineExtensionImage	Décrit une image d’extension de machine virtuelle.

ApiError

Objet

Erreur d’API.

Nom	Type	Description
code	string	Code d’erreur.
details	ApiErrorBase[]	Détails de l’erreur api
innererror	InnerError	Erreur interne de l’API
message	string	Message d’erreur.
target	string	Cible de l’erreur particulière.

ApiErrorBase

Objet

Base d’erreurs d’API.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur.
target	string	Cible de l’erreur particulière.

CloudError

Objet

Réponse d’erreur du service de calcul.

Nom	Type	Description
error	ApiError	Erreur d’API.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

InnerError

Objet

Détails de l’erreur interne.

Nom	Type	Description
errordetail	string	Message d’erreur interne ou vidage d’exception.
exceptiontype	string	Type d'exception.

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

VirtualMachineExtensionImage

Objet

Décrit une image d’extension de machine virtuelle.

Nom	Type	Description
id	string	Identifiant de ressource entièrement qualifié pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Emplacement géographique où réside la ressource
name	string	nom de la ressource.
properties.computeRole	string	Type de rôle (IaaS ou PaaS) pris en charge par cette extension.
properties.handlerSchema	string	Schéma défini par l’éditeur, où les consommateurs d’extensions doivent fournir des paramètres dans un schéma correspondant.
properties.operatingSystem	string	Le système d’exploitation pris en charge par cette extension.
properties.supportsMultipleExtensions	boolean	Indique si le gestionnaire peut prendre en charge plusieurs extensions.
properties.vmScaleSetEnabled	boolean	Indique si l’extension peut être utilisée sur xRP VMScaleSets. Par défaut, les extensions existantes sont utilisables sur des groupes identiques, mais il peut arriver qu’un éditeur souhaite indiquer explicitement que l’extension est activée uniquement pour les machines virtuelles CRP, mais pas pour VMSS.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressources.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »