Partilhar via


VirtualMachine Classe

Descreve uma Máquina Virtual.

As variáveis só são preenchidas pelo servidor e serão ignoradas ao enviar um pedido.

Todos os parâmetros necessários têm de ser preenchidos para enviar para o Azure.

Herança
azure.mgmt.compute.v2023_09_01.models._models_py3.Resource
VirtualMachine

Construtor

VirtualMachine(*, location: str, tags: Dict[str, str] | None = None, plan: _models.Plan | None = None, identity: _models.VirtualMachineIdentity | None = None, zones: List[str] | None = None, extended_location: _models.ExtendedLocation | None = None, hardware_profile: _models.HardwareProfile | None = None, storage_profile: _models.StorageProfile | None = None, additional_capabilities: _models.AdditionalCapabilities | None = None, os_profile: _models.OSProfile | None = None, network_profile: _models.NetworkProfile | None = None, security_profile: _models.SecurityProfile | None = None, diagnostics_profile: _models.DiagnosticsProfile | None = None, availability_set: _models.SubResource | None = None, virtual_machine_scale_set: _models.SubResource | None = None, proximity_placement_group: _models.SubResource | None = None, priority: str | _models.VirtualMachinePriorityTypes | None = None, eviction_policy: str | _models.VirtualMachineEvictionPolicyTypes | None = None, billing_profile: _models.BillingProfile | None = None, host: _models.SubResource | None = None, host_group: _models.SubResource | None = None, license_type: str | None = None, extensions_time_budget: str | None = None, platform_fault_domain: int | None = None, scheduled_events_profile: _models.ScheduledEventsProfile | None = None, user_data: str | None = None, capacity_reservation: _models.CapacityReservationProfile | None = None, application_profile: _models.ApplicationProfile | None = None, **kwargs: Any)

Keyword-Only Parameters

location
str

Localização do recurso. Obrigatório.

tags
dict[str, str]

Etiquetas de recursos.

plan
Plan

Especifica informações sobre a imagem do marketplace utilizada para criar a máquina virtual. Este elemento só é utilizado para imagens do marketplace. Antes de poder utilizar uma imagem do marketplace a partir de uma API, tem de ativar a imagem para utilização programática. No portal do Azure, localize a imagem do marketplace que pretende utilizar e, em seguida, clique em Pretende implementar programaticamente, Introdução ->. Introduza as informações necessárias e, em seguida, clique em Guardar.

identity
VirtualMachineIdentity

A identidade da máquina virtual, se configurada.

zones
list[str]

As zonas da máquina virtual.

extended_location
ExtendedLocation

A localização expandida da Máquina Virtual.

hardware_profile
HardwareProfile

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

storage_profile
StorageProfile

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

additional_capabilities
AdditionalCapabilities

Especifica capacidades adicionais ativadas ou desativadas na máquina virtual.

os_profile
OSProfile

Especifica as definições do sistema operativo utilizadas ao criar a máquina virtual. Algumas das definições não podem ser alteradas depois de a VM ser aprovisionada.

network_profile
NetworkProfile

Especifica as interfaces de rede da máquina virtual.

security_profile
SecurityProfile

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

diagnostics_profile
DiagnosticsProfile

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

availability_set
SubResource

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 os conjuntos de disponibilidade, veja Descrição geral dos conjuntos de disponibilidade. Para obter mais informações sobre a manutenção planeada do Azure, veja 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á a ser adicionada deve estar no mesmo grupo de recursos que o recurso do conjunto de disponibilidade. Não é possível adicionar uma VM existente a um conjunto de disponibilidade. Esta propriedade não pode existir juntamente com uma referência properties.virtualMachineScaleSet não nula.

virtual_machine_scale_set
SubResource

Especifica informações sobre o conjunto de dimensionamento de máquinas virtuais ao qual 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. Esta propriedade não pode existir juntamente com uma referência properties.availabilitySet não nula. Versão mínima da API: 2019-03-01.

proximity_placement_group
SubResource

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

priority
str ou VirtualMachinePriorityTypes

Especifica a prioridade da máquina virtual. Versão mínima da API: 2019-03-01. Os valores conhecidos são: "Regular", "Baixo" e "Spot".

eviction_policy
str ou VirtualMachineEvictionPolicyTypes

Especifica a política de expulsão para a máquina virtual spot do Azure e o conjunto de dimensionamento do Azure Spot. Para máquinas virtuais spot do Azure, são suportados "Desalocar" e "Eliminar" e a versão mínima da API é 2019-03-01. Para conjuntos de dimensionamento do Azure Spot, são suportados "Desalocar" e "Eliminar" e a versão mínima da API é 2017-10-30-preview. Os valores conhecidos são: "Desalocar" e "Eliminar".

billing_profile
BillingProfile

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

host
SubResource

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

host_group
SubResource

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

license_type
str

Especifica que a imagem ou disco que está a ser utilizado foi licenciado no local. <br>``<br>Os valores possíveis para o sistema operativo Windows Server são: <br>``<br> Windows_Client <br>``<br> Windows_Server <br>``<br> Os valores possíveis para o sistema operativo Do Linux Server são: <br>``<br> RHEL_BYOS (para RHEL) <br>``<br> SLES_BYOS (para SUSE) <br>``<br> Para obter mais informações, consulte Benefício de Utilização Híbrida do Azure para Windows Server<br>``<br> Benefício deUtilização Híbrida do Azure para a versão mínima da API do Servidor <br>``<br> Linux: 2015-06-15.

extensions_time_budget
str

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

platform_fault_domain
int

Especifica o domínio de falha lógica do conjunto de dimensionamento no qual a Máquina Virtual será criada. Por predefinição, a Máquina Virtual será automaticamente atribuída a um domínio de falha que melhor mantém o equilíbrio entre os domínios de falha disponíveis. Isto só é aplicável se a propriedade "virtualMachineScaleSet" desta Máquina Virtual estiver definida. O Conjunto de Dimensionamento de Máquinas Virtuais referenciado tem de ter "platformFaultDomainCount" maior do que

  1. Esta propriedade não pode ser atualizada depois de a Máquina Virtual ser criada. A atribuição de domínio de falha pode ser visualizada na Vista de Instância de Máquina Virtual. Versão mínima da API: 2020-12-01.
scheduled_events_profile
ScheduledEventsProfile

Especifica as configurações relacionadas com o Evento Agendado.

user_data
str

UserData para a VM, que tem de ter codificação base 64. O cliente não deve transmitir segredos aqui. Versão mínima da API: 2021-03-01.

capacity_reservation
CapacityReservationProfile

Especifica informações sobre a reserva de capacidade que é utilizada para alocar máquinas virtuais. Versão mínima da API: 2021-04-01.

application_profile
ApplicationProfile

Especifica as aplicações da galeria que devem ser disponibilizadas para a VM/VMSS.

Variáveis

id
str

ID do Recurso.

name
str

Nome do recurso.

type
str

Tipo de recurso.

location
str

Localização do recurso. Obrigatório.

tags
dict[str, str]

Etiquetas de recursos.

plan
Plan

Especifica informações sobre a imagem do marketplace utilizada para criar a máquina virtual. Este elemento só é utilizado para imagens do marketplace. Antes de poder utilizar uma imagem do marketplace a partir de uma API, tem de ativar a imagem para utilização programática. No portal do Azure, localize a imagem do marketplace que pretende utilizar e, em seguida, clique em Pretende implementar programaticamente, Introdução ->. Introduza as informações necessárias e, em seguida, clique em Guardar.

resources
list[VirtualMachineExtension]

Os recursos da extensão subordinada da máquina virtual.

identity
VirtualMachineIdentity

A identidade da máquina virtual, se configurada.

zones
list[str]

As zonas da máquina virtual.

extended_location
ExtendedLocation

A localização expandida da Máquina Virtual.

managed_by
str

ManagedBy está definido como Conjunto de Dimensionamento de Máquinas Virtuais (VMSS) arm resourceID flexível, se a VM fizer parte do VMSS. Esta propriedade é utilizada pela plataforma para otimização da eliminação de grupos de recursos internos.

etag
str

A propriedade Etag é devolvida na resposta Create/Update/Get da VM, para que o cliente possa fornecê-la no cabeçalho para garantir atualizações otimistas.

hardware_profile
HardwareProfile

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

storage_profile
StorageProfile

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

additional_capabilities
AdditionalCapabilities

Especifica capacidades adicionais ativadas ou desativadas na máquina virtual.

os_profile
OSProfile

Especifica as definições do sistema operativo utilizadas ao criar a máquina virtual. Algumas das definições não podem ser alteradas depois de a VM ser aprovisionada.

network_profile
NetworkProfile

Especifica as interfaces de rede da máquina virtual.

security_profile
SecurityProfile

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

diagnostics_profile
DiagnosticsProfile

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

availability_set
SubResource

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 os conjuntos de disponibilidade, veja Descrição geral dos conjuntos de disponibilidade. Para obter mais informações sobre a manutenção planeada do Azure, veja 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á a ser adicionada deve estar no mesmo grupo de recursos que o recurso do conjunto de disponibilidade. Não é possível adicionar uma VM existente a um conjunto de disponibilidade. Esta propriedade não pode existir juntamente com uma referência não null properties.virtualMachineScaleSet.

virtual_machine_scale_set
SubResource

Especifica informações sobre o conjunto de dimensionamento de máquinas virtuais ao qual 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. Esta propriedade não pode existir juntamente com uma referência não nula properties.availabilitySet. Versão mínima da api:2019}03-01.

proximity_placement_group
SubResource

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

priority
str ou VirtualMachinePriorityTypes

Especifica a prioridade da máquina virtual. Versão mínima da API: 2019-03-01. Os valores conhecidos são: "Regular", "Low" e "Spot".

eviction_policy
str ou VirtualMachineEvictionPolicyTypes

Especifica a política de expulsão da máquina virtual spot do Azure e do conjunto de dimensionamento do Azure Spot. Para máquinas virtuais spot do Azure, são suportados "Desalocar" e "Eliminar" e a versão mínima da API é 2019-03-01. Para conjuntos de dimensionamento do Azure Spot, são suportados "Desalocar" e "Eliminar" e a versão mínima da API é 2017-10-30-preview. Os valores conhecidos são: "Desalocar" e "Eliminar".

billing_profile
BillingProfile

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

host
SubResource

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

host_group
SubResource

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

provisioning_state
str

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

instance_view
VirtualMachineInstanceView

A vista de instância da máquina virtual.

license_type
str

Especifica que a imagem ou o disco que está a ser utilizado foi licenciado no local. <br>``<br>Os valores possíveis para o sistema operativo Windows Server são: <br>``<br> Windows_Client <br>``<br> Windows_Server <br>``<br> Valores possíveis para o sistema operativo Linux Server são: <br>``<br> RHEL_BYOS (para RHEL) <br>``<br> SLES_BYOS (para SUSE) <br>``<br> Para obter mais informações, consulte Benefício de Utilização Híbrida do Azure para Windows Server<br>``<br> Benefício deUtilização Híbrida do Azure para a versão mínima da API do Linux Server<br>``<br>: 2015-06-15.

vm_id
str

Especifica o ID exclusivo da VM, que é um identificador de 128 bits que está codificado e armazenado em todas as VMs IaaS do Azure SMBIOS e pode ser lido com comandos BIOS da plataforma.

extensions_time_budget
str

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

platform_fault_domain
int

Especifica o domínio de falha lógica do conjunto de dimensionamento no qual a Máquina Virtual será criada. Por predefinição, a Máquina Virtual será automaticamente atribuída a um domínio de falha que melhor mantém o equilíbrio entre os domínios de falha disponíveis. Isto só é aplicável se a propriedade "virtualMachineScaleSet" desta Máquina Virtual estiver definida. O Conjunto de Dimensionamento de Máquinas Virtuais referenciado tem de ter "platformFaultDomainCount" maior do que

  1. Esta propriedade não pode ser atualizada depois de a Máquina Virtual ser criada. A atribuição de domínio de falha pode ser visualizada na Vista de Instância da Máquina Virtual. Versão mínima da api:2020}12-01.
scheduled_events_profile
ScheduledEventsProfile

Especifica configurações relacionadas com Eventos Agendados.

user_data
str

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

capacity_reservation
CapacityReservationProfile

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

application_profile
ApplicationProfile

Especifica as aplicações de galeria que devem ser disponibilizadas para a VM/VMSS.

time_created
datetime

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