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.ResourceVirtualMachine
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.
- 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.
- 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
- 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.
- 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.
- 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
- 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.
Azure SDK for Python