VirtualMachinesOperations Classe

Aviso

NÃO instancia esta classe diretamente.

Em vez disso, deve aceder às seguintes operações através de

ComputeManagementClient's

<xref:virtual_machines> atributo.

Herança

builtins.object

VirtualMachinesOperations

Construtor

VirtualMachinesOperations(*args, **kwargs)

Métodos

begin_capture	Captura a VM ao copiar discos rígidos virtuais da VM e produz um modelo que pode ser utilizado para criar VMs semelhantes.
begin_convert_to_managed_disks	Converte discos de máquinas virtuais de discos baseados em blobs em discos geridos. A máquina virtual tem de ser parada desalocada antes de invocar esta operação.
begin_create_or_update	A operação para criar ou atualizar uma máquina virtual.
begin_deallocate	Encerra a máquina virtual e liberta os recursos de computação. Não lhe são cobrados os recursos de computação que esta máquina virtual utiliza.
begin_delete	A operação para eliminar uma máquina virtual.
begin_perform_maintenance	A operação para efetuar a manutenção numa máquina virtual.
begin_power_off	A operação para desligar (parar) uma máquina virtual. A máquina virtual pode ser reiniciada com os mesmos recursos aprovisionados. Continua a ser-lhe cobrada esta máquina virtual.
begin_redeploy	Desliga a máquina virtual, move-a para um novo nó e volta a ligar a máquina virtual.
begin_reimage	Reimage a máquina virtual que tem um disco de SO efémero de volta ao estado inicial.
begin_restart	A operação para reiniciar uma máquina virtual.
begin_run_command	Execute o comando na VM.
begin_start	A operação para iniciar uma máquina virtual.
begin_update	A operação para atualizar uma máquina virtual.
generalize	Define o estado da máquina virtual como generalizado.
get	Obtém informações sobre a vista de modelo ou a vista de instância de uma máquina virtual.
instance_view	Obtém informações sobre o estado de tempo de execução de uma máquina virtual.
list	Lista todas as máquinas virtuais no grupo de recursos especificado. Utilize a propriedade nextLink na resposta para obter a página seguinte das máquinas virtuais.
list_all	Lista todas as máquinas virtuais na subscrição especificada. Utilize a propriedade nextLink na resposta para obter a página seguinte das máquinas virtuais.
list_available_sizes	Lista todos os tamanhos de máquinas virtuais disponíveis para os quais a máquina virtual especificada pode ser redimensionada.
list_by_location	Obtém todas as máquinas virtuais na subscrição especificada para a localização especificada.

begin_capture

Captura a VM ao copiar discos rígidos virtuais da VM e produz um modelo que pode ser utilizado para criar VMs semelhantes.

begin_capture(resource_group_name: str, vm_name: str, parameters: _models.VirtualMachineCaptureParameters, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.VirtualMachineCaptureResult]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

parameters

VirtualMachineCaptureParameters ou IO

Necessário

Parâmetros fornecidos para a operação Capturar Máquina Virtual. É um tipo virtualMachineCaptureParameters ou um tipo de E/S. Obrigatório.

content_type

str

Tipo de conteúdo do Parâmetro do Corpo. Os valores conhecidos são: "application/json". O valor predefinido é Nenhum.

cls

callable

Um tipo ou função personalizado que será transmitido à resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não estiver presente nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve VirtualMachineCaptureResult ou o resultado de cls(response)

Tipo de retorno

LROPoller[VirtualMachineCaptureResult]

Exceções

HttpResponseError

begin_convert_to_managed_disks

Converte discos de máquinas virtuais de discos baseados em blobs em discos geridos. A máquina virtual tem de ser parada desalocada antes de invocar esta operação.

begin_convert_to_managed_disks(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido à resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não estiver presente nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve Nenhum ou o resultado de cls(response)

Tipo de retorno

LROPoller[None]

Exceções

HttpResponseError

begin_create_or_update

A operação para criar ou atualizar uma máquina virtual.

begin_create_or_update(resource_group_name: str, vm_name: str, parameters: _models.VirtualMachine, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.VirtualMachine]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

parameters

VirtualMachine ou IO

Necessário

Parâmetros fornecidos para a operação Criar Máquina Virtual. É um tipo virtualMachine ou um tipo de E/S. Obrigatório.

content_type

str

Tipo de conteúdo do Parâmetro do Corpo. Os valores conhecidos são: "application/json". O valor predefinido é Nenhum.

cls

callable

Um tipo ou função personalizado que será transmitido à resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não estiver presente nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve VirtualMachine ou o resultado de cls(response)

Tipo de retorno

LROPoller[VirtualMachine]

Exceções

HttpResponseError

begin_deallocate

Encerra a máquina virtual e liberta os recursos de computação. Não lhe são cobrados os recursos de computação que esta máquina virtual utiliza.

begin_deallocate(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido à resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não estiver presente nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve Nenhum ou o resultado de cls(response)

Tipo de retorno

LROPoller[None]

Exceções

HttpResponseError

begin_delete

A operação para eliminar uma máquina virtual.

begin_delete(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido à resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não estiver presente nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve Nenhum ou o resultado de cls(response)

Tipo de retorno

LROPoller[None]

Exceções

HttpResponseError

begin_perform_maintenance

A operação para efetuar a manutenção numa máquina virtual.

begin_perform_maintenance(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido à resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não estiver presente nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve Nenhum ou o resultado de cls(response)

Tipo de retorno

LROPoller[None]

Exceções

HttpResponseError

begin_power_off

A operação para desligar (parar) uma máquina virtual. A máquina virtual pode ser reiniciada com os mesmos recursos aprovisionados. Continua a ser-lhe cobrada esta máquina virtual.

begin_power_off(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido à resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não estiver presente nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve Nenhum ou o resultado de cls(resposta)

Tipo de retorno

LROPoller[None]

Exceções

HttpResponseError

begin_redeploy

Desliga a máquina virtual, move-a para um novo nó e volta a ligar a máquina virtual.

begin_redeploy(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o seu método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não existir nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve Nenhum ou o resultado de cls(resposta)

Tipo de retorno

LROPoller[None]

Exceções

HttpResponseError

begin_reimage

Reimage a máquina virtual que tem um disco de SO efémero de volta ao estado inicial.

begin_reimage(resource_group_name: str, vm_name: str, parameters: _models.VirtualMachineReimageParameters | None = None, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[None]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

parameters

VirtualMachineReimageParameters ou IO

Necessário

Parâmetros fornecidos para a operação Reimage Virtual Machine. É um tipo VirtualMachineReimageParameters ou um tipo de E/S. O valor predefinido é Nenhum.

content_type

str

Tipo de conteúdo do Parâmetro do Corpo. Os valores conhecidos são: "application/json". O valor predefinido é Nenhum.

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o seu método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não existir nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve Nenhum ou o resultado de cls(resposta)

Tipo de retorno

LROPoller[None]

Exceções

HttpResponseError

begin_restart

A operação para reiniciar uma máquina virtual.

begin_restart(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o seu método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não existir nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve Nenhum ou o resultado de cls(resposta)

Tipo de retorno

LROPoller[None]

Exceções

HttpResponseError

begin_run_command

Execute o comando na VM.

begin_run_command(resource_group_name: str, vm_name: str, parameters: _models.RunCommandInput, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.RunCommandResult]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

parameters

RunCommandInput ou IO

Necessário

Parâmetros fornecidos para a operação de comando Executar. É um tipo RunCommandInput ou um tipo de E/S. Obrigatório.

content_type

str

Tipo de conteúdo do Parâmetro do Corpo. Os valores conhecidos são: "application/json", "text/json". O valor predefinido é Nenhum.

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o seu método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não existir nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve RunCommandResult ou o resultado de cls(response)

Tipo de retorno

LROPoller[RunCommandResult]

Exceções

HttpResponseError

begin_start

A operação para iniciar uma máquina virtual.

begin_start(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o seu método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não existir nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve Nenhum ou o resultado de cls(resposta)

Tipo de retorno

LROPoller[None]

Exceções

HttpResponseError

begin_update

A operação para atualizar uma máquina virtual.

begin_update(resource_group_name: str, vm_name: str, parameters: _models.VirtualMachineUpdate, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.VirtualMachine]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

parameters

VirtualMachineUpdate ou IO

Necessário

Parâmetros fornecidos para a operação Atualizar Máquina Virtual. É um tipo VirtualMachineUpdate ou um tipo de E/S. Obrigatório.

content_type

str

Tipo de conteúdo do Parâmetro do Corpo. Os valores conhecidos são: "application/json". O valor predefinido é Nenhum.

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

continuation_token

str

Um token de continuação para reiniciar um poller a partir de um estado guardado.

polling

bool ou PollingMethod

Por predefinição, o seu método de consulta será ARMPolling. Transmita Falso para que esta operação não seja consultada ou transmita o seu próprio objeto de consulta inicializado para uma estratégia de consulta pessoal.

polling_interval

int

Tempo de espera predefinido entre duas sondagens para operações LRO se não existir nenhum cabeçalho de Retry-After.

Devoluções

Uma instância do LROPoller que devolve VirtualMachine ou o resultado de cls(resposta)

Tipo de retorno

LROPoller[VirtualMachine]

Exceções

HttpResponseError

generalize

Define o estado da máquina virtual como generalizado.

generalize(resource_group_name: str, vm_name: str, **kwargs: Any) -> None

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

Devoluções

Nenhum ou o resultado de cls(resposta)

Tipo de retorno

None

Exceções

HttpResponseError

get

Obtém informações sobre a vista de modelo ou a vista de instância de uma máquina virtual.

get(resource_group_name: str, vm_name: str, *, expand: Literal['instanceView'] = 'instanceView', **kwargs: Any) -> VirtualMachine

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

expand

str

A expressão expandir a aplicar na operação. Os valores conhecidos são "instanceView" e None. O valor predefinido é "instanceView".

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

Devoluções

VirtualMachine ou o resultado de cls(resposta)

Tipo de retorno

VirtualMachine

Exceções

HttpResponseError

instance_view

Obtém informações sobre o estado de tempo de execução de uma máquina virtual.

instance_view(resource_group_name: str, vm_name: str, **kwargs: Any) -> VirtualMachineInstanceView

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

Devoluções

VirtualMachineInstanceView ou o resultado de cls(response)

Tipo de retorno

VirtualMachineInstanceView

Exceções

HttpResponseError

list

Lista todas as máquinas virtuais no grupo de recursos especificado. Utilize a propriedade nextLink na resposta para obter a página seguinte das máquinas virtuais.

list(resource_group_name: str, **kwargs: Any) -> Iterable[VirtualMachine]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

Devoluções

Um iterador como a instância de VirtualMachine ou o resultado de cls(resposta)

Tipo de retorno

ItemPaged[VirtualMachine]

Exceções

HttpResponseError

list_all

Lista todas as máquinas virtuais na subscrição especificada. Utilize a propriedade nextLink na resposta para obter a página seguinte das máquinas virtuais.

list_all(**kwargs: Any) -> Iterable[VirtualMachine]

Parâmetros

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

Devoluções

Um iterador como a instância de VirtualMachine ou o resultado de cls(resposta)

Tipo de retorno

ItemPaged[VirtualMachine]

Exceções

HttpResponseError

list_available_sizes

Lista todos os tamanhos de máquinas virtuais disponíveis para os quais a máquina virtual especificada pode ser redimensionada.

list_available_sizes(resource_group_name: str, vm_name: str, **kwargs: Any) -> Iterable[VirtualMachineSize]

Parâmetros

resource_group_name

str

Necessário

O nome do grupo de recursos. Obrigatório.

vm_name

str

Necessário

O nome da máquina virtual. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

Devoluções

Um iterador como a instância de VirtualMachineSize ou o resultado de cls(response)

Tipo de retorno

ItemPaged[VirtualMachineSize]

Exceções

HttpResponseError

list_by_location

Obtém todas as máquinas virtuais na subscrição especificada para a localização especificada.

list_by_location(location: str, **kwargs: Any) -> Iterable[VirtualMachine]

Parâmetros

location

str

Necessário

A localização para a qual as máquinas virtuais na subscrição são consultadas. Obrigatório.

cls

callable

Um tipo ou função personalizado que será transmitido a resposta direta

Devoluções

Um iterador como a instância de VirtualMachine ou o resultado de cls(resposta)

Tipo de retorno

ItemPaged[VirtualMachine]

Exceções

HttpResponseError

Atributos

models

models = <module 'azure.mgmt.compute.v2018_06_01.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\mgmt\\compute\\v2018_06_01\\models\\__init__.py'>