VirtualMachine interface

Descreve uma máquina virtual.

Extends

Propriedades

additionalCapabilities

Especifica recursos adicionais habilitados ou desabilitados na máquina virtual.

applicationProfile

Especifica os aplicativos da galeria que devem ser disponibilizados para a VM/VMSS.

availabilitySet

Especifica informações sobre o conjunto de disponibilidade ao qual a máquina virtual deve ser atribuída. As máquinas virtuais especificadas no mesmo conjunto de disponibilidade são alocadas a nós diferentes para maximizar a disponibilidade. Para obter mais informações sobre conjuntos de disponibilidade, consulte Visão geral dos conjuntos de disponibilidade. Para obter mais informações sobre a manutenção planejada do Azure, consulte Manutenção e atualizações para máquinas virtuais no Azure. Atualmente, uma VM só pode ser adicionada ao conjunto de disponibilidade no momento da criação. O conjunto de disponibilidade ao qual a VM está sendo adicionada deve estar no mesmo grupo de recursos que o recurso do conjunto de disponibilidade. Uma VM existente não pode ser adicionada a um conjunto de disponibilidade. Essa propriedade não pode existir junto com uma referência non-null properties.virtualMachineScaleSet.

billingProfile

Especifica os detalhes relacionados à cobrança de uma máquina virtual do Spot do Azure. Versão mínima da API: 2019-03-01.

capacityReservation

Especifica informações sobre a reserva de capacidade usada para alocar a máquina virtual. Versão mínima da API: 2021-04-01.

diagnosticsProfile

Especifica o estado das configurações de diagnóstico de inicialização. Versão mínima da API: 2015-06-15.

etag

A etag é uma propriedade retornada em Criar/Atualizar/Obter resposta da VM, para que o cliente possa fornecê-la no cabeçalho para garantir atualizações otimistas.

evictionPolicy

Especifica a política de remoção para a máquina virtual spot do Azure e o conjunto de dimensionamento spot do Azure. Para máquinas virtuais spot do Azure, há suporte para 'Desalocar' e 'Excluir' e a versão mínima da API é 2019-03-01. Para conjuntos de dimensionamento do Spot do Azure, há suporte para 'Desalocar' e 'Excluir' e a versão mínima da API é 2017-10-30-preview.

extendedLocation

O local estendido da Máquina Virtual.

extensionsTimeBudget

Especifica o tempo alocado para que todas as extensões comecem. A duração do tempo deve estar entre 15 minutos e 120 minutos (inclusive) e deve ser especificada no formato ISO 8601. O valor padrão é 90 minutos (PT1H30M). Versão mínima da API: 2020-06-01.

hardwareProfile

Especifica as configurações de hardware da máquina virtual.

host

Especifica informações sobre o host dedicado no qual a máquina virtual reside. Versão mínima da API: 2018-10-01.

hostGroup

Especifica informações sobre o grupo de hosts dedicado no qual a máquina virtual reside. Observação: Usuário não pode especificar as propriedades host e hostGroup. Versão mínima da API: 2020-06-01.

identity

A identidade da máquina virtual, se configurada.

instanceView

O modo de exibição da instância da máquina virtual.

licenseType

Especifica que a imagem ou o disco que está sendo usado foi licenciado localmente.

Os valores possíveis para o sistema operacional Windows Server são:

Windows_Client

Windows_Server

Os valores possíveis para o sistema operacional Linux Server são:

RHEL_BYOS (para RHEL)

SLES_BYOS (para SUSE)

Para obter mais informações, consulte Benefício de Uso Híbrido do Azure para o Windows Server

Benefício de Uso Híbrido do Azure para o Linux Server

Versão mínima da API: 2015-06-15

managedBy

ManagedBy é definido como VMSS (Virtual Machine Scale Set) flex ARM resourceID, se a VM faz parte do VMSS. Essa propriedade é usada pela plataforma para otimização interna de exclusão do grupo de recursos.

networkProfile

Especifica os adaptadores de rede da máquina virtual.

osProfile

Especifica as configurações do sistema operacional usadas durante a criação da máquina virtual. Algumas das configurações não podem ser alteradas depois que a VM é provisionada.

placement

A seção posicionamento especifica as restrições definidas pelo usuário para o posicionamento de hardware da máquina virtual. Essa propriedade não pode ser alterada depois que a VM é provisionada. Versão mínima da API: 2024-11-01.

plan

Especifica informações sobre a imagem do marketplace usada para criar a máquina virtual. Esse elemento é usado apenas para imagens do marketplace. Antes de usar uma imagem do marketplace de uma API, você deve habilitar a imagem para uso programático. No portal do Azure, localize a imagem do marketplace que você deseja usar e clique em Deseja implantar programaticamente, Introdução –>. Insira as informações necessárias e clique em Salvar.

platformFaultDomain

Especifica o domínio de falha lógica do conjunto de dimensionamento no qual a Máquina Virtual será criada. Por padrão, a Máquina Virtual será atribuída automaticamente a um domínio de falha que melhor mantém o equilíbrio entre os domínios de falha disponíveis. Isso será aplicável somente se a propriedade 'virtualMachineScaleSet' dessa Máquina Virtual estiver definida. O Conjunto de Dimensionamento de Máquinas Virtuais referenciado deve ter 'platformFaultDomainCount' maior que 1. Essa propriedade não pode ser atualizada depois que a Máquina Virtual é criada. A atribuição de domínio de falha pode ser exibida no Modo de Exibição da Instância da Máquina Virtual. Apiversão mínima: 2020>12>01.

priority

Especifica a prioridade da máquina virtual. Versão mínima da API: 2019-03-01

provisioningState

O estado de provisionamento, que aparece apenas na resposta.

proximityPlacementGroup

Especifica informações sobre o grupo de posicionamento por proximidade ao qual a máquina virtual deve ser atribuída. Versão mínima da API: 2018-04-01.

resiliencyProfile

Perfil de resiliência para a máquina virtual.

resources

Os recursos de extensão filho da máquina virtual.

scheduledEventsPolicy

Especifica as configurações relacionadas a Eventos Agendados de Reimplantação, Reinicialização e ScheduledEventsAdditionalPublishingTargets para a máquina virtual.

scheduledEventsProfile

Especifica configurações relacionadas a eventos agendados.

securityProfile

Especifica as configurações de perfil relacionadas à segurança para a máquina virtual.

storageProfile

Especifica as configurações de armazenamento para os discos da máquina virtual.

timeCreated

Especifica a hora em que o recurso da Máquina Virtual foi criado. Versão mínima da API: 2021-11-01.

userData

UserData para a VM, que deve ser codificada em base 64. O cliente não deve passar segredos aqui. Versão mínima da API: 2021-03-01.

virtualMachineScaleSet

Especifica informações sobre o conjunto de dimensionamento de máquinas virtuais aos quais a máquina virtual deve ser atribuída. As máquinas virtuais especificadas no mesmo conjunto de dimensionamento de máquinas virtuais são alocadas a nós diferentes para maximizar a disponibilidade. Atualmente, uma VM só pode ser adicionada ao conjunto de dimensionamento de máquinas virtuais no momento da criação. Não é possível adicionar uma VM existente a um conjunto de dimensionamento de máquinas virtuais. Essa propriedade não pode existir junto com uma referência non-null properties.availabilitySet. Apiversão mínima: 2019<03>01.

vmId

Especifica a ID exclusiva da VM, que é um identificador de 128 bits que é codificado e armazenado em todas as VMs iaaS do Azure SMBIOS e pode ser lido usando comandos BIOS da plataforma.

zones

As zonas de disponibilidade.

Propriedades herdadas

id

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

A geolocalização onde o recurso reside

name

O nome do recurso

systemData

Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.

tags

Tags de recursos.

type

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

Detalhes da propriedade

additionalCapabilities

Especifica recursos adicionais habilitados ou desabilitados na máquina virtual.

additionalCapabilities?: AdditionalCapabilities

Valor da propriedade

applicationProfile

Especifica os aplicativos da galeria que devem ser disponibilizados para a VM/VMSS.

applicationProfile?: ApplicationProfile

Valor da propriedade

availabilitySet

Especifica informações sobre o conjunto de disponibilidade ao qual a máquina virtual deve ser atribuída. As máquinas virtuais especificadas no mesmo conjunto de disponibilidade são alocadas a nós diferentes para maximizar a disponibilidade. Para obter mais informações sobre conjuntos de disponibilidade, consulte Visão geral dos conjuntos de disponibilidade. Para obter mais informações sobre a manutenção planejada do Azure, consulte Manutenção e atualizações para máquinas virtuais no Azure. Atualmente, uma VM só pode ser adicionada ao conjunto de disponibilidade no momento da criação. O conjunto de disponibilidade ao qual a VM está sendo adicionada deve estar no mesmo grupo de recursos que o recurso do conjunto de disponibilidade. Uma VM existente não pode ser adicionada a um conjunto de disponibilidade. Essa propriedade não pode existir junto com uma referência non-null properties.virtualMachineScaleSet.

availabilitySet?: SubResource

Valor da propriedade

billingProfile

Especifica os detalhes relacionados à cobrança de uma máquina virtual do Spot do Azure. Versão mínima da API: 2019-03-01.

billingProfile?: BillingProfile

Valor da propriedade

capacityReservation

Especifica informações sobre a reserva de capacidade usada para alocar a máquina virtual. Versão mínima da API: 2021-04-01.

capacityReservation?: CapacityReservationProfile

Valor da propriedade

diagnosticsProfile

Especifica o estado das configurações de diagnóstico de inicialização. Versão mínima da API: 2015-06-15.

diagnosticsProfile?: DiagnosticsProfile

Valor da propriedade

etag

A etag é uma propriedade retornada em Criar/Atualizar/Obter resposta da VM, para que o cliente possa fornecê-la no cabeçalho para garantir atualizações otimistas.

etag?: string

Valor da propriedade

string

evictionPolicy

Especifica a política de remoção para a máquina virtual spot do Azure e o conjunto de dimensionamento spot do Azure. Para máquinas virtuais spot do Azure, há suporte para 'Desalocar' e 'Excluir' e a versão mínima da API é 2019-03-01. Para conjuntos de dimensionamento do Spot do Azure, há suporte para 'Desalocar' e 'Excluir' e a versão mínima da API é 2017-10-30-preview.

evictionPolicy?: string

Valor da propriedade

string

extendedLocation

O local estendido da Máquina Virtual.

extendedLocation?: ExtendedLocation

Valor da propriedade

extensionsTimeBudget

Especifica o tempo alocado para que todas as extensões comecem. A duração do tempo deve estar entre 15 minutos e 120 minutos (inclusive) e deve ser especificada no formato ISO 8601. O valor padrão é 90 minutos (PT1H30M). Versão mínima da API: 2020-06-01.

extensionsTimeBudget?: string

Valor da propriedade

string

hardwareProfile

Especifica as configurações de hardware da máquina virtual.

hardwareProfile?: HardwareProfile

Valor da propriedade

host

Especifica informações sobre o host dedicado no qual a máquina virtual reside. Versão mínima da API: 2018-10-01.

host?: SubResource

Valor da propriedade

hostGroup

Especifica informações sobre o grupo de hosts dedicado no qual a máquina virtual reside. Observação: Usuário não pode especificar as propriedades host e hostGroup. Versão mínima da API: 2020-06-01.

hostGroup?: SubResource

Valor da propriedade

identity

A identidade da máquina virtual, se configurada.

identity?: VirtualMachineIdentity

Valor da propriedade

instanceView

O modo de exibição da instância da máquina virtual.

instanceView?: VirtualMachineInstanceView

Valor da propriedade

licenseType

Especifica que a imagem ou o disco que está sendo usado foi licenciado localmente.

Os valores possíveis para o sistema operacional Windows Server são:

Windows_Client

Windows_Server

Os valores possíveis para o sistema operacional Linux Server são:

RHEL_BYOS (para RHEL)

SLES_BYOS (para SUSE)

Para obter mais informações, consulte Benefício de Uso Híbrido do Azure para o Windows Server

Benefício de Uso Híbrido do Azure para o Linux Server

Versão mínima da API: 2015-06-15

licenseType?: string

Valor da propriedade

string

managedBy

ManagedBy é definido como VMSS (Virtual Machine Scale Set) flex ARM resourceID, se a VM faz parte do VMSS. Essa propriedade é usada pela plataforma para otimização interna de exclusão do grupo de recursos.

managedBy?: string

Valor da propriedade

string

networkProfile

Especifica os adaptadores de rede da máquina virtual.

networkProfile?: NetworkProfile

Valor da propriedade

osProfile

Especifica as configurações do sistema operacional usadas durante a criação da máquina virtual. Algumas das configurações não podem ser alteradas depois que a VM é provisionada.

osProfile?: OSProfile

Valor da propriedade

placement

A seção posicionamento especifica as restrições definidas pelo usuário para o posicionamento de hardware da máquina virtual. Essa propriedade não pode ser alterada depois que a VM é provisionada. Versão mínima da API: 2024-11-01.

placement?: Placement

Valor da propriedade

plan

Especifica informações sobre a imagem do marketplace usada para criar a máquina virtual. Esse elemento é usado apenas para imagens do marketplace. Antes de usar uma imagem do marketplace de uma API, você deve habilitar a imagem para uso programático. No portal do Azure, localize a imagem do marketplace que você deseja usar e clique em Deseja implantar programaticamente, Introdução –>. Insira as informações necessárias e clique em Salvar.

plan?: Plan

Valor da propriedade

platformFaultDomain

Especifica o domínio de falha lógica do conjunto de dimensionamento no qual a Máquina Virtual será criada. Por padrão, a Máquina Virtual será atribuída automaticamente a um domínio de falha que melhor mantém o equilíbrio entre os domínios de falha disponíveis. Isso será aplicável somente se a propriedade 'virtualMachineScaleSet' dessa Máquina Virtual estiver definida. O Conjunto de Dimensionamento de Máquinas Virtuais referenciado deve ter 'platformFaultDomainCount' maior que 1. Essa propriedade não pode ser atualizada depois que a Máquina Virtual é criada. A atribuição de domínio de falha pode ser exibida no Modo de Exibição da Instância da Máquina Virtual. Apiversão mínima: 2020>12>01.

platformFaultDomain?: number

Valor da propriedade

number

priority

Especifica a prioridade da máquina virtual. Versão mínima da API: 2019-03-01

priority?: string

Valor da propriedade

string

provisioningState

O estado de provisionamento, que aparece apenas na resposta.

provisioningState?: string

Valor da propriedade

string

proximityPlacementGroup

Especifica informações sobre o grupo de posicionamento por proximidade ao qual a máquina virtual deve ser atribuída. Versão mínima da API: 2018-04-01.

proximityPlacementGroup?: SubResource

Valor da propriedade

resiliencyProfile

Perfil de resiliência para a máquina virtual.

resiliencyProfile?: ResiliencyProfile

Valor da propriedade

resources

Os recursos de extensão filho da máquina virtual.

resources?: VirtualMachineExtension[]

Valor da propriedade

scheduledEventsPolicy

Especifica as configurações relacionadas a Eventos Agendados de Reimplantação, Reinicialização e ScheduledEventsAdditionalPublishingTargets para a máquina virtual.

scheduledEventsPolicy?: ScheduledEventsPolicy

Valor da propriedade

scheduledEventsProfile

Especifica configurações relacionadas a eventos agendados.

scheduledEventsProfile?: ScheduledEventsProfile

Valor da propriedade

securityProfile

Especifica as configurações de perfil relacionadas à segurança para a máquina virtual.

securityProfile?: SecurityProfile

Valor da propriedade

storageProfile

Especifica as configurações de armazenamento para os discos da máquina virtual.

storageProfile?: StorageProfile

Valor da propriedade

timeCreated

Especifica a hora em que o recurso da Máquina Virtual foi criado. Versão mínima da API: 2021-11-01.

timeCreated?: Date

Valor da propriedade

Date

userData

UserData para a VM, que deve ser codificada em base 64. O cliente não deve passar segredos aqui. Versão mínima da API: 2021-03-01.

userData?: string

Valor da propriedade

string

virtualMachineScaleSet

Especifica informações sobre o conjunto de dimensionamento de máquinas virtuais aos quais a máquina virtual deve ser atribuída. As máquinas virtuais especificadas no mesmo conjunto de dimensionamento de máquinas virtuais são alocadas a nós diferentes para maximizar a disponibilidade. Atualmente, uma VM só pode ser adicionada ao conjunto de dimensionamento de máquinas virtuais no momento da criação. Não é possível adicionar uma VM existente a um conjunto de dimensionamento de máquinas virtuais. Essa propriedade não pode existir junto com uma referência non-null properties.availabilitySet. Apiversão mínima: 2019<03>01.

virtualMachineScaleSet?: SubResource

Valor da propriedade

vmId

Especifica a ID exclusiva da VM, que é um identificador de 128 bits que é codificado e armazenado em todas as VMs iaaS do Azure SMBIOS e pode ser lido usando comandos BIOS da plataforma.

vmId?: string

Valor da propriedade

string

zones

As zonas de disponibilidade.

zones?: string[]

Valor da propriedade

string[]

Detalhes das propriedades herdadas

id

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

id?: string

Valor da propriedade

string

herdado deTrackedResource.id

location

A geolocalização onde o recurso reside

location: string

Valor da propriedade

string

Herdado deTrackedResource.location

name

O nome do recurso

name?: string

Valor da propriedade

string

herdado deTrackedResource.name

systemData

Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.

systemData?: SystemData

Valor da propriedade

herdado detrackedResource.systemData

tags

Tags de recursos.

tags?: Record<string, string>

Valor da propriedade

Record<string, string>

Herdado deTrackedResource.tags

type

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

type?: string

Valor da propriedade

string

Herdado deTrackedResource.type