Virtual Machine Extension Images - List Types

Serviço:

Compute

Versão da API:

2025-04-01

Obtém uma lista de tipos de imagem de extensão 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 URI

Nome	Em	Obrigatório	Tipo	Description
location	path	True	string minLength: 1	O nome da região do Azure.
publisherName	path	True	string
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	VirtualMachineExtensionImage[]	A operação do Azure foi concluída com êxito.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

VirtualMachineExtensionImage_ListTypes_MaximumSet_Gen

VirtualMachineExtensionImage_ListTypes_MinimumSet_Gen

VirtualMachineExtensionImage_ListTypes_MaximumSet_Gen

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:

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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:

200

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

Definições

Nome	Description
ApiError	Erro de API.
ApiErrorBase	Base de erros da API.
CloudError	Uma resposta de erro do serviço Compute.
createdByType	O tipo de identidade que criou o recurso.
InnerError	Detalhes do erro interno.
systemData	Metadados relativos à criação e última modificação do recurso.
VirtualMachineExtensionImage	Descreve uma imagem de extensão de máquina virtual.

ApiError

Objeto

Erro de API.

Nome	Tipo	Description
code	string	O código de erro.
details	ApiErrorBase[]	Os detalhes do erro da API
innererror	InnerError	O erro interno da API
message	string	A mensagem de erro.
target	string	O destino do erro específico.

ApiErrorBase

Objeto

Base de erros da API.

Nome	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.
target	string	O destino do erro específico.

CloudError

Objeto

Uma resposta de erro do serviço Compute.

Nome	Tipo	Description
error	ApiError	Erro de API.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

InnerError

Objeto

Detalhes do erro interno.

Nome	Tipo	Description
errordetail	string	A mensagem de erro interna ou o despejo de exceção.
exceptiontype	string	O tipo de exceção.

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

VirtualMachineExtensionImage

Objeto

Descreve uma imagem de extensão de máquina virtual.

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	A localização geográfica onde o recurso reside
name	string	O nome do recurso
properties.computeRole	string	O tipo de função (IaaS ou PaaS) compatível com essa extensão.
properties.handlerSchema	string	O esquema definido pelo editor, em que os consumidores de extensão devem fornecer configurações em um esquema correspondente.
properties.operatingSystem	string	O sistema operacional compatível com esta extensão.
properties.supportsMultipleExtensions	boolean	Se o manipulador pode dar suporte a várias extensões.
properties.vmScaleSetEnabled	boolean	Se a extensão pode ser usada em VMScaleSets xRP. Por padrão, as extensões existentes podem ser usadas em conjuntos de dimensionamento, mas pode haver casos em que um editor deseja indicar explicitamente que a extensão está habilitada apenas para VMs CRP, mas não para VMSS.
systemData	systemData	Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"