Virtual Machine Templates - Get

Referência

Serviço:: Azure Arc enabled SCVMM

Versão da API:: 2024-06-01

Obtém um VirtualMachineTemplate.
Implementa o método GET VirtualMachineTemplate.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachineTemplates/{virtualMachineTemplateName}?api-version=2024-06-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string uuid	A ID da assinatura de destino. O valor deve ser uma UUID.
virtualMachineTemplateName	path	True	string	Nome do VirtualMachineTemplate. Padrão Regex: `[a-zA-Z0-9-_\.]`
api-version	query	True	string	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	VirtualMachineTemplate	A operação do Azure foi concluída com êxito.
Other Status Codes	ErrorResponse	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

VirtualMachineTemplates_Get_MaximumSet

VirtualMachineTemplates_Get_MinimumSet

VirtualMachineTemplates_Get_MaximumSet

Solicitação de exemplo

HTTP

GET https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/virtualMachineTemplates/4?api-version=2024-06-01

Resposta de exemplo

Código de status:: 200

{
  "properties": {
    "inventoryItemId": "qjrykoogccwlgkd",
    "uuid": "12345678-1234-1234-1234-12345678abcd",
    "vmmServerId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/vmmServers/vmmServerName",
    "osType": "Windows",
    "osName": "qcbolnbisklo",
    "computerName": "asxghqngsojdsdptpirbz",
    "memoryMB": 24,
    "cpuCount": 23,
    "limitCpuForMigration": "true",
    "dynamicMemoryEnabled": "true",
    "isCustomizable": "true",
    "dynamicMemoryMaxMB": 21,
    "dynamicMemoryMinMB": 21,
    "isHighlyAvailable": "true",
    "generation": 16,
    "networkInterfaces": [
      {
        "name": "kvofzqulbjlbtt",
        "displayName": "yoayfd",
        "ipv4Addresses": [
          "eeunirpkpqazzxhsqonkxcfuks"
        ],
        "ipv6Addresses": [
          "pk"
        ],
        "macAddress": "oaeqqegt",
        "virtualNetworkId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualNetworks/virtualNetworkName",
        "networkName": "lqbm",
        "ipv4AddressType": "Dynamic",
        "ipv6AddressType": "Dynamic",
        "macAddressType": "Dynamic",
        "nicId": "roxpsvlo"
      }
    ],
    "disks": [
      {
        "name": "fgnckfymwdsqnfxkdvexuaobe",
        "displayName": "fgladknawlgjodo",
        "diskId": "ltdrwcfjklpsimhzqyh",
        "diskSizeGB": 30,
        "maxDiskSizeGB": 18,
        "bus": 8,
        "lun": 10,
        "busType": "zu",
        "vhdType": "cnbeeeylrvopigdynvgpkfp",
        "volumeType": "ckkymkuekzzqhexyjueruzlfemoeln",
        "vhdFormatType": "vbcrrmhgahznifudvhxfagwoplcb",
        "templateDiskId": "lcdwrokpyvekqccclf",
        "storageQoSPolicy": {
          "name": "ceiyfrflu",
          "id": "o"
        },
        "createDiffDisk": "true"
      }
    ],
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ExtendedLocation/customLocations/customLocationName"
  },
  "tags": {
    "key9494": "kkbmfpwhmvlobm"
  },
  "location": "ayxsyduviotylbojh",
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
  "name": "ioeuwaznkaayvhpqbnrwbr",
  "type": "egfzqiscydkyddksvsjujdlee",
  "systemData": {
    "createdBy": "p",
    "createdByType": "User",
    "createdAt": "2024-01-29T22:28:00.094Z",
    "lastModifiedBy": "goxcwpyyqlxndquly",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-01-29T22:28:00.095Z"
  }
}

VirtualMachineTemplates_Get_MinimumSet

Solicitação de exemplo

HTTP

GET https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/virtualMachineTemplates/m?api-version=2024-06-01

Resposta de exemplo

Código de status:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
  "extendedLocation": {},
  "location": "ayxsyduviotylbojh"
}

Definições

Nome	Description
AllocationMethod	Método de alocação de endereço de rede.
createdByType	O tipo de identidade que criou o recurso.
CreateDiffDisk	Criar disco dif.
DynamicMemoryEnabled	Memória dinâmica habilitada.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExtendedLocation	O local estendido.
IsCustomizable	Personalizável.
IsHighlyAvailable	Altamente disponível.
LimitCpuForMigration	Limite a CPU para migração.
NetworkInterface	Modelo de Interface de Rede
OsType	Tipo de sistema operacional de máquina virtual.
ProvisioningState	O estado de provisionamento do recurso.
StorageQosPolicyDetails	A definição StorageQoSPolicyDetails.
systemData	Metadados relativos à criação e última modificação do recurso.
VirtualDisk	Modelo de disco virtual
VirtualMachineTemplate	A definição de recurso VirtualMachineTemplates.

AllocationMethod

Método de alocação de endereço de rede.

Nome	Tipo	Description
Dynamic	string	Endereço alocado dinamicamente.
Static	string	Endereço alocado estaticamente.

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CreateDiffDisk

Criar disco dif.

Nome	Tipo	Description
false	string	Desabilite a criação de disco dif.
true	string	Habilitar a criação de disco dif.

DynamicMemoryEnabled

Memória dinâmica habilitada.

Nome	Tipo	Description
false	string	Desabilite a memória dinâmica.
true	string	Habilitar memória dinâmica.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

ExtendedLocation

O local estendido.

Nome	Tipo	Description
name	string	O nome do local estendido.
type	string	O tipo de local estendido.

IsCustomizable

Personalizável.

Nome	Tipo	Description
false	string	Desabilitar personalizável.
true	string	Habilitar personalizável.

IsHighlyAvailable

Altamente disponível.

Nome	Tipo	Description
false	string	Desabilitar altamente disponível.
true	string	Habilitar altamente disponível.

LimitCpuForMigration

Limite a CPU para migração.

Nome	Tipo	Description
false	string	Desabilite o limite de CPU para migração.
true	string	Habilite a CPU de limite para migração.

NetworkInterface

Modelo de Interface de Rede

Nome	Tipo	Description
displayName	string	Obtém o nome de exibição do adaptador de rede, conforme mostrado no vmmServer. Esse é o rótulo de fallback de uma NIC quando o nome não está definido.
ipv4AddressType	AllocationMethod	Obtém ou define o tipo de endereço ipv4.
ipv4Addresses	string[]	Obtém os endereços ipv4 nic.
ipv6AddressType	AllocationMethod	Obtém ou define o tipo de endereço ipv6.
ipv6Addresses	string[]	Obtém os endereços ipv6 nic.
macAddress	string	Obtém ou define o endereço MAC nic.
macAddressType	AllocationMethod	Obtém ou define o tipo de endereço mac.
name	string	Obtém ou define o nome da interface de rede.
networkName	string	Obtém o nome da rede virtual no vmmServer ao qual a nic está conectada.
nicId	string	Obtém ou define a ID nic.
virtualNetworkId	string	Obtém ou define a ID do ARM do recurso Microsoft.ScVmm/virtualNetwork para conectar a nic.

OsType

Tipo de sistema operacional de máquina virtual.

Nome	Tipo	Description
Linux	string	Sistema operacional Linux.
Other	string	Outro sistema operacional.
Windows	string	Sistema operacional Windows.

ProvisioningState

O estado de provisionamento do recurso.

Nome	Tipo	Description
Accepted	string	O recurso foi aceito.
Canceled	string	A criação de recursos foi cancelada.
Created	string	O recurso foi criado.
Deleting	string	O recurso está sendo excluído.
Failed	string	Falha na criação de recursos.
Provisioning	string	O recurso está sendo provisionado.
Succeeded	string	O recurso foi criado.
Updating	string	O recurso está sendo atualizado.

StorageQosPolicyDetails

A definição StorageQoSPolicyDetails.

Nome	Tipo	Description
id	string	A ID da política de QoS.
name	string	O nome da política.

systemData

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

Nome	Tipo	Description
createdAt	string	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	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.

VirtualDisk

Modelo de disco virtual

Nome	Tipo	Description
bus	integer	Obtém ou define o barramento de disco.
busType	string	Obtém ou define o tipo de barramento de disco.
createDiffDisk	CreateDiffDisk	Obtém ou define um valor que indica o disco dif.
diskId	string	Obtém ou define a ID do disco.
diskSizeGB	integer	Obtém ou define o tamanho total do disco.
displayName	string	Obtém o nome de exibição do disco virtual, conforme mostrado no vmmServer. Esse é o rótulo de fallback de um disco quando o nome não está definido.
lun	integer	Obtém ou define o lun de disco.
maxDiskSizeGB	integer	Obtém o tamanho máximo do disco.
name	string	Obtém ou define o nome do disco.
storageQoSPolicy	StorageQosPolicyDetails	A política de QoS para o disco.
templateDiskId	string	Obtém ou define a ID do disco no modelo.
vhdFormatType	string	Obtém o tipo de formato vhd de disco.
vhdType	string	Obtém ou define o tipo vhd de disco.
volumeType	string	Obtém o tipo de volume de disco.

VirtualMachineTemplate

A definição de recurso VirtualMachineTemplates.

Nome	Tipo	Description
extendedLocation	ExtendedLocation	O local estendido.
id	string	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/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.computerName	string	Obtém o nome do computador.
properties.cpuCount	integer	Obtém o número desejado de vCPUs para a vm.
properties.disks	VirtualDisk[]	Obtém os discos do modelo.
properties.dynamicMemoryEnabled	DynamicMemoryEnabled	Obtém um valor que indica se a memória dinâmica deve ser habilitada ou não.
properties.dynamicMemoryMaxMB	integer	Obtém a memória dinâmica máxima para a VM.
properties.dynamicMemoryMinMB	integer	Obtém a memória dinâmica mínima para a VM.
properties.generation	integer	Obtém a geração da vm.
properties.inventoryItemId	string	Obtém ou define a ID do item de inventário para o recurso.
properties.isCustomizable	IsCustomizable	Obtém um valor que indica se o modelo de vm é personalizável ou não.
properties.isHighlyAvailable	IsHighlyAvailable	Obtém uma propriedade altamente disponível.
properties.limitCpuForMigration	LimitCpuForMigration	Obtém um valor que indica se o modo de compatibilidade do processador deve ser habilitado para migração dinâmica de VMs.
properties.memoryMB	integer	MemoryMB é o tamanho desejado da memória de uma máquina virtual, em MB.
properties.networkInterfaces	NetworkInterface[]	Obtém os adaptadores de rede do modelo.
properties.osName	string	Obtém o nome do sistema operacional.
properties.osType	OsType	Obtém o tipo do sistema operacional.
properties.provisioningState	ProvisioningState	Estado de provisionamento do recurso.
properties.uuid	string	ID exclusiva do modelo de máquina virtual.
properties.vmmServerId	string	ID do ARM do recurso vmmServer no qual esse recurso reside.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
tags	object	Marcas de recurso.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

Compartilhar via

Virtual Machine Templates - Get

Parâmetros de URI

Respostas

Segurança

azure_auth

Escopos

Exemplos

VirtualMachineTemplates_Get_MaximumSet

Solicitação de exemplo

Resposta de exemplo

VirtualMachineTemplates_Get_MinimumSet

Solicitação de exemplo

Resposta de exemplo

Definições

AllocationMethod

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

IsCustomizable

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

OsType

ProvisioningState

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineTemplate

Recursos adicionais