Virtual Machine Extension Images - List Types

Servicio:

Compute

Versión de la API:

2025-04-01

Obtiene una lista de tipos de imágenes de extensión de máquina virtual.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
location	path	True	string minLength: 1	Nombre de la región de Azure.
publisherName	path	True	string
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Respuestas

Nombre	Tipo	Description
200 OK	VirtualMachineExtensionImage[]	La operación de Azure se completó correctamente.
Other Status Codes	CloudError	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

VirtualMachineExtensionImage_ListTypes_MaximumSet_Gen

VirtualMachineExtensionImage_ListTypes_MinimumSet_Gen

VirtualMachineExtensionImage_ListTypes_MaximumSet_Gen

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaaaaaaaaaaaaaaaaaaaaaa/publishers/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/artifacttypes/vmextension/types?api-version=2025-04-01

Respuesta de muestra

status code:

200

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

VirtualMachineExtensionImage_ListTypes_MinimumSet_Gen

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaa/publishers/aa/artifacttypes/vmextension/types?api-version=2025-04-01

Respuesta de muestra

status code:

200

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

Definiciones

Nombre	Description
ApiError	Error de API.
ApiErrorBase	Base de errores de API.
CloudError	Una respuesta de error del servicio de proceso.
createdByType	Tipo de identidad que creó el recurso.
InnerError	Detalles del error interno.
systemData	Metadatos relativos a la creación y última modificación del recurso.
VirtualMachineExtensionImage	Describe una imagen de extensión de máquina virtual.

ApiError

Objeto

Error de API.

Nombre	Tipo	Description
code	string	Código de error.
details	ApiErrorBase[]	Detalles del error de la API
innererror	InnerError	El error interno de la API
message	string	El mensaje de error.
target	string	Destino del error concreto.

ApiErrorBase

Objeto

Base de errores de API.

Nombre	Tipo	Description
code	string	Código de error.
message	string	El mensaje de error.
target	string	Destino del error concreto.

CloudError

Objeto

Una respuesta de error del servicio de proceso.

Nombre	Tipo	Description
error	ApiError	Error de API.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

InnerError

Objeto

Detalles del error interno.

Nombre	Tipo	Description
errordetail	string	El mensaje de error interno o el volcado de excepción.
exceptiontype	string	El tipo de excepción.

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

VirtualMachineExtensionImage

Objeto

Describe una imagen de extensión de máquina virtual.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Ej: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties.computeRole	string	El tipo de rol (IaaS o PaaS) que admite esta extensión.
properties.handlerSchema	string	El esquema definido por el editor, donde los consumidores de extensiones deben proporcionar la configuración en un esquema coincidente.
properties.operatingSystem	string	El sistema operativo compatible con esta extensión.
properties.supportsMultipleExtensions	boolean	Si el controlador puede admitir varias extensiones.
properties.vmScaleSetEnabled	boolean	Si la extensión se puede usar en VMScaleSets xRP. De forma predeterminada, las extensiones existentes se pueden usar en conjuntos de escalado, pero puede haber casos en los que un editor quiera indicar explícitamente que la extensión solo está habilitada para máquinas virtuales CRP, pero no para VMSS.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"