VirtualMachine interface

Descreve uma máquina virtual.

Extends

Propriedades

additionalCapabilities

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

applicationProfile

Especifica os aplicativos de 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 sob o 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 properties.virtualMachineScaleSet não nula.

billingProfile

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

capacityReservation

Especifica informações sobre a reserva de capacidade usada para alocar a máquina virtual. Versão mínima 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

Etag é a propriedade retornada em Create/Update/Get response of the 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 do Azure Spot e o conjunto de escala do Azure Spot. Para máquinas virtuais do Azure Spot, há suporte para 'Deslocalizar' e 'Excluir' e a versão mínima da api é 2019-03-01. Para conjuntos de escala do Azure Spot, há suporte para 'Deslocalizar' 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 o início de todas as extensões. A duração do tempo deve ser entre 15 minutos e 120 minutos (inclusive) e deve ser especificada no formato ISO 8601. O valor padrão é 90 minutos (PT1H30M). Versão api mínima: 2020-06-01.

hardwareProfile

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

host

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

hostGroup

Especifica informações sobre o grupo de hosts dedicados em que a máquina virtual reside. Nota: usuário não pode especificar as propriedades host e hostGroup. Versão api mínima: 2020-06-01.

identity

A identidade da máquina virtual, se configurada.

instanceView

A 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 Windows Server

Benefício de Uso Híbrido do Azure para 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 fizer parte do VMSS. Esta propriedade é usada pela plataforma para otimização de exclusão de grupo de recursos internos.

networkProfile

Especifica as interfaces 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. Este elemento é usado apenas para imagens do mercado. Antes de poder usar uma imagem de mercado de uma API, você deve habilitar a imagem para uso programático. No portal do Azure, localize a imagem do marketplace que pretende utilizar e, em seguida, clique em Pretende implementar programaticamente, Introdução ->. Introduza todas as informações necessárias e, em seguida, clique em Guardar.

platformFaultDomain

Especifica o domínio de falha lógica do conjunto de escala 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 mantenha o equilíbrio entre os domínios de falha disponíveis. Isso é aplicável somente se a propriedade 'virtualMachineScaleSet' desta máquina virtual estiver definida. O Conjunto de Escala de Máquina Virtual 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 visualizada na Visualização de Instância de Máquina Virtual. Mínimo api‐versão: 2020‐12‐01.

priority

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

provisioningState

O estado de provisionamento, que só aparece na resposta.

proximityPlacementGroup

Especifica informações sobre o grupo de posicionamento de proximidade ao qual a máquina virtual deve ser atribuída. Versão api mínima: 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, Reimplantação e Eventos AgendadosAdicionalPublicandoDestinos para a máquina virtual.

scheduledEventsProfile

Especifica as 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 de Máquina Virtual foi criado. Versão mínima api: 2021-11-01.

userData

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

virtualMachineScaleSet

Especifica informações sobre o conjunto de escala da máquina virtual ao qual a máquina virtual deve ser atribuída. As máquinas virtuais especificadas no mesmo conjunto de escala de máquina virtual são alocadas a nós diferentes para maximizar a disponibilidade. Atualmente, uma VM só pode ser adicionada à escala da máquina virtual definida no momento da criação. Uma VM existente não pode ser adicionada a um conjunto de dimensionamento de máquina virtual. Essa propriedade não pode existir junto com uma referência properties.availabilitySet não nula. Versão mínima api‐version: 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 do BIOS da plataforma.

zones

As zonas de disponibilidade.

Propriedades Herdadas

id

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

location

A geolocalização onde o recurso vive

name

O nome do recurso

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

tags

Tags de recursos.

type

O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

Detalhes de Propriedade

additionalCapabilities

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

additionalCapabilities?: AdditionalCapabilities

Valor de Propriedade

applicationProfile

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

applicationProfile?: ApplicationProfile

Valor de 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 sob o 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 properties.virtualMachineScaleSet não nula.

availabilitySet?: SubResource

Valor de Propriedade

billingProfile

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

billingProfile?: BillingProfile

Valor de Propriedade

capacityReservation

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

capacityReservation?: CapacityReservationProfile

Valor de 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 de Propriedade

etag

Etag é a propriedade retornada em Create/Update/Get response of the VM, para que o cliente possa fornecê-la no cabeçalho para garantir atualizações otimistas.

etag?: string

Valor de Propriedade

string

evictionPolicy

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

evictionPolicy?: string

Valor de Propriedade

string

extendedLocation

O local estendido da máquina virtual.

extendedLocation?: ExtendedLocation

Valor de Propriedade

extensionsTimeBudget

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

extensionsTimeBudget?: string

Valor de Propriedade

string

hardwareProfile

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

hardwareProfile?: HardwareProfile

Valor de Propriedade

host

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

host?: SubResource

Valor de Propriedade

hostGroup

Especifica informações sobre o grupo de hosts dedicados em que a máquina virtual reside. Nota: usuário não pode especificar as propriedades host e hostGroup. Versão api mínima: 2020-06-01.

hostGroup?: SubResource

Valor de Propriedade

identity

A identidade da máquina virtual, se configurada.

identity?: VirtualMachineIdentity

Valor de Propriedade

instanceView

A exibição da instância da máquina virtual.

instanceView?: VirtualMachineInstanceView

Valor de 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 Windows Server

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

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

licenseType?: string

Valor de Propriedade

string

managedBy

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

managedBy?: string

Valor de Propriedade

string

networkProfile

Especifica as interfaces de rede da máquina virtual.

networkProfile?: NetworkProfile

Valor de 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 de 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 de Propriedade

plan

Especifica informações sobre a imagem do marketplace usada para criar a máquina virtual. Este elemento é usado apenas para imagens do mercado. Antes de poder usar uma imagem de mercado de uma API, você deve habilitar a imagem para uso programático. No portal do Azure, localize a imagem do marketplace que pretende utilizar e, em seguida, clique em Pretende implementar programaticamente, Introdução ->. Introduza todas as informações necessárias e, em seguida, clique em Guardar.

plan?: Plan

Valor de Propriedade

platformFaultDomain

Especifica o domínio de falha lógica do conjunto de escala 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 mantenha o equilíbrio entre os domínios de falha disponíveis. Isso é aplicável somente se a propriedade 'virtualMachineScaleSet' desta máquina virtual estiver definida. O Conjunto de Escala de Máquina Virtual 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 visualizada na Visualização de Instância de Máquina Virtual. Mínimo api‐versão: 2020‐12‐01.

platformFaultDomain?: number

Valor de Propriedade

number

priority

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

priority?: string

Valor de Propriedade

string

provisioningState

O estado de provisionamento, que só aparece na resposta.

provisioningState?: string

Valor de Propriedade

string

proximityPlacementGroup

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

proximityPlacementGroup?: SubResource

Valor de Propriedade

resiliencyProfile

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

resiliencyProfile?: ResiliencyProfile

Valor de Propriedade

resources

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

resources?: VirtualMachineExtension[]

Valor de Propriedade

scheduledEventsPolicy

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

scheduledEventsPolicy?: ScheduledEventsPolicy

Valor de Propriedade

scheduledEventsProfile

Especifica as configurações relacionadas a Eventos Agendados.

scheduledEventsProfile?: ScheduledEventsProfile

Valor de Propriedade

securityProfile

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

securityProfile?: SecurityProfile

Valor de Propriedade

storageProfile

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

storageProfile?: StorageProfile

Valor de Propriedade

timeCreated

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

timeCreated?: Date

Valor de Propriedade

Date

userData

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

userData?: string

Valor de Propriedade

string

virtualMachineScaleSet

Especifica informações sobre o conjunto de escala da máquina virtual ao qual a máquina virtual deve ser atribuída. As máquinas virtuais especificadas no mesmo conjunto de escala de máquina virtual são alocadas a nós diferentes para maximizar a disponibilidade. Atualmente, uma VM só pode ser adicionada à escala da máquina virtual definida no momento da criação. Uma VM existente não pode ser adicionada a um conjunto de dimensionamento de máquina virtual. Essa propriedade não pode existir junto com uma referência properties.availabilitySet não nula. Versão mínima api‐version: 2019‐03‐01.

virtualMachineScaleSet?: SubResource

Valor de 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 do BIOS da plataforma.

vmId?: string

Valor de Propriedade

string

zones

As zonas de disponibilidade.

zones?: string[]

Valor de Propriedade

string[]

Detalhes da Propriedade Herdada

id

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

id?: string

Valor de Propriedade

string

herdado deTrackedResource.id

location

A geolocalização onde o recurso vive

location: string

Valor de Propriedade

string

herdado de TrackedResource.location

name

O nome do recurso

name?: string

Valor de Propriedade

string

herdado deTrackedResource.name

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

systemData?: SystemData

Valor de Propriedade

herdado deTrackedResource.systemData

tags

Tags de recursos.

tags?: Record<string, string>

Valor de Propriedade

Record<string, string>

herdado deTrackedResource.tags

type

O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

type?: string

Valor de Propriedade

string

herdado de TrackedResource.type