VirtualMachinesOperations Classe
Aviso
NÃO instancie essa classe diretamente.
Em vez disso, você deve acessar as operações a seguir por meio de
Atributo <xref:virtual_machines>.
- Herança
-
builtins.objectVirtualMachinesOperations
Construtor
VirtualMachinesOperations(*args, **kwargs)Métodos
| begin_assess_patches |
Avaliar patches na VM. |
| begin_capture |
Captura a VM copiando discos rígidos virtuais da VM e gera um modelo que pode ser usado para criar VMs semelhantes. |
| begin_convert_to_managed_disks |
Converte discos de máquina virtual de discos baseados em blob em discos gerenciados. A máquina virtual deve ser desalocada antes de invocar essa operação. |
| begin_create_or_update |
A operação para criar ou atualizar uma máquina virtual. Observe que algumas propriedades só podem ser definidas durante a criação da máquina virtual. |
| begin_deallocate |
Desliga a máquina virtual e libera os recursos de computação. Você não é cobrado pelos recursos de computação que essa máquina virtual usa. |
| begin_delete |
A operação para excluir uma máquina virtual. |
| begin_perform_maintenance |
A operação para executar a manutenção em uma 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 provisionados. Você ainda será cobrado por essa máquina virtual. |
| begin_reapply |
A operação para reaplicar o estado de uma máquina virtual. |
| begin_redeploy |
Desliga a máquina virtual, move-a para um novo nó e a liga novamente. |
| begin_reimage |
Refazer a imagem da máquina virtual que tem um disco do sistema operacional 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 do sistema operacional da máquina virtual como generalizado. É recomendável sysprep a máquina virtual antes de executar essa operação. >>:code: |
| get |
Recupera informações sobre a exibição do modelo ou da instância de uma máquina virtual. |
| instance_view |
Recupera 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. Use a propriedade nextLink na resposta para obter a próxima página de máquinas virtuais. |
| list_all |
Lista todas as máquinas virtuais na assinatura especificada. Use a propriedade nextLink na resposta para obter a próxima página de máquinas virtuais. |
| list_available_sizes |
Lista todos os tamanhos de máquina virtual disponíveis aos quais a máquina virtual especificada pode ser redimensionada. |
| list_by_location |
Obtém todas as máquinas virtuais na assinatura especificada para o local especificado. |
| retrieve_boot_diagnostics_data |
A operação para recuperar URIs SAS para os logs de diagnóstico de inicialização de uma máquina virtual. |
| simulate_eviction |
A operação para simular a remoção da máquina virtual spot. |
begin_assess_patches
Avaliar patches na VM.
begin_assess_patches(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[VirtualMachineAssessPatchesResult]Parâmetros
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um poller de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, seu método de sondagem será ARMPolling. Passe em False para que esta operação não sondar ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna VirtualMachineAssessPatchesResult ou o resultado de cls(response)
Tipo de retorno
Exceções
begin_capture
Captura a VM copiando discos rígidos virtuais da VM e gera um modelo que pode ser usado 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
- parameters
- VirtualMachineCaptureParameters ou IO
Parâmetros fornecidos para a operação Capturar Máquina Virtual. É um tipo VirtualMachineCaptureParameters ou um tipo de E/S. Obrigatórios.
- content_type
- str
Tipo de conteúdo do Parâmetro do Corpo. Os valores conhecidos são: 'application/json'. O valor padrão é Nenhum.
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um poller de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, seu método de sondagem será ARMPolling. Passe em False para que esta operação não sondar ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna VirtualMachineCaptureResult ou o resultado de cls(response)
Tipo de retorno
Exceções
begin_convert_to_managed_disks
Converte discos de máquina virtual de discos baseados em blob em discos gerenciados. A máquina virtual deve ser desalocada antes de invocar essa operação.
begin_convert_to_managed_disks(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]Parâmetros
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um poller de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, seu método de sondagem será ARMPolling. Passe em False para que esta operação não sondar ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
begin_create_or_update
A operação para criar ou atualizar uma máquina virtual. Observe que algumas propriedades só podem ser definidas durante a criação da 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
- parameters
- VirtualMachine ou IO
Parâmetros fornecidos para a operação Criar Máquina Virtual. É um tipo VirtualMachine ou um tipo de E/S. Obrigatórios.
- content_type
- str
Tipo de conteúdo do Parâmetro do Corpo. Os valores conhecidos são: 'application/json'. O valor padrão é Nenhum.
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um poller de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, seu método de sondagem será ARMPolling. Passe em False para que esta operação não sondar ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna VirtualMachine ou o resultado de cls(response)
Tipo de retorno
Exceções
begin_deallocate
Desliga a máquina virtual e libera os recursos de computação. Você não é cobrado pelos recursos de computação que essa máquina virtual usa.
begin_deallocate(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]Parâmetros
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um poller de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, seu método de sondagem será ARMPolling. Passe em False para que esta operação não sondar ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
begin_delete
A operação para excluir uma máquina virtual.
begin_delete(resource_group_name: str, vm_name: str, *, force_deletion: bool | None = None, **kwargs: Any) -> LROPoller[None]Parâmetros
- force_deletion
- bool
Parâmetro opcional para forçar a exclusão de máquinas virtuais. O valor padrão é Nenhum.
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um poller de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, seu método de sondagem será ARMPolling. Passe em False para que esta operação não sondar ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
begin_perform_maintenance
A operação para executar a manutenção em uma máquina virtual.
begin_perform_maintenance(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]Parâmetros
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um poller de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, o método de sondagem será ARMPolling. Passe False para que essa operação não seja sondada ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
begin_power_off
A operação para desligar (parar) uma máquina virtual. A máquina virtual pode ser reiniciada com os mesmos recursos provisionados. Você ainda será cobrado por essa máquina virtual.
begin_power_off(resource_group_name: str, vm_name: str, *, skip_shutdown: bool = False, **kwargs: Any) -> LROPoller[None]Parâmetros
- skip_shutdown
- bool
O parâmetro para solicitar o desligamento não normal da VM. O valor true para esse sinalizador indica um desligamento não normal, enquanto false indica o contrário. O valor padrão desse sinalizador será false se não for especificado. O valor padrão é Falso.
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um sondador de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, o método de sondagem será ARMPolling. Passe False para que essa operação não seja sondada ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
begin_reapply
A operação para reaplicar o estado de uma máquina virtual.
begin_reapply(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]Parâmetros
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um sondador de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, o método de sondagem será ARMPolling. Passe False para que essa operação não seja sondada ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
begin_redeploy
Desliga a máquina virtual, move-a para um novo nó e a liga novamente.
begin_redeploy(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]Parâmetros
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um sondador de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, o método de sondagem será ARMPolling. Passe False para que essa operação não seja sondada ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
begin_reimage
Refazer a imagem da máquina virtual que tem um disco do sistema operacional 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
- parameters
- VirtualMachineReimageParameters ou IO
Parâmetros fornecidos para a operação refazer imagem da máquina virtual. É um tipo VirtualMachineReimageParameters ou um tipo de E/S. O valor padrão é Nenhum.
- content_type
- str
Body Parameter content-type. Os valores conhecidos são: 'application/json'. O valor padrão é Nenhum.
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um sondador de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, o método de sondagem será ARMPolling. Passe False para que essa operação não seja sondada ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
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
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um sondador de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, o método de sondagem será ARMPolling. Passe False para que essa operação não seja sondada ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
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
- parameters
- RunCommandInput ou IO
Parâmetros fornecidos para a operação executar comando. É um tipo RunCommandInput ou um tipo de E/S. Obrigatórios.
- content_type
- str
Body Parameter content-type. Os valores conhecidos são: 'application/json', 'text/json'. O valor padrão é Nenhum.
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um sondador de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, o método de sondagem será ARMPolling. Passe False para que essa operação não seja sondada ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna RunCommandResult ou o resultado de cls(response)
Tipo de retorno
Exceções
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
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um sondador de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, o método de sondagem será ARMPolling. Passe False para que essa operação não seja sondada ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
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
- parameters
- VirtualMachineUpdate ou IO
Parâmetros fornecidos para a operação Atualizar Máquina Virtual. É um tipo VirtualMachineUpdate ou um tipo de E/S. Obrigatórios.
- content_type
- str
Tipo de conteúdo do Parâmetro do Corpo. Os valores conhecidos são: 'application/json'. O valor padrão é Nenhum.
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
- continuation_token
- str
Um token de continuação para reiniciar um poller de um estado salvo.
- polling
- bool ou PollingMethod
Por padrão, seu método de sondagem será ARMPolling. Passe em False para que esta operação não sondar ou passe seu próprio objeto de sondagem inicializado para uma estratégia de sondagem pessoal.
- polling_interval
- int
Tempo de espera padrão entre duas pesquisas para operações LRO se nenhum cabeçalho Retry-After estiver presente.
Retornos
Uma instância de LROPoller que retorna VirtualMachine ou o resultado de cls(response)
Tipo de retorno
Exceções
generalize
Define o estado do sistema operacional da máquina virtual como generalizado. É recomendável sysprep a máquina virtual antes de executar essa operação. >>:code:<br>For Windows, consulte Create a managed image of a generalized VM in Azure <https://docs.microsoft.com/en-us/azure/virtual-machines/windows/capture-image-resource>_<<.:code:For Linux, please refer to Como criar uma imagem de uma máquina virtual ou VHD.
generalize(resource_group_name: str, vm_name: str, **kwargs: Any) -> NoneParâmetros
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
Retornos
Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
get
Recupera informações sobre a exibição do modelo ou da instância de uma máquina virtual.
get(resource_group_name: str, vm_name: str, *, expand: Literal['instanceView'] = 'instanceView', **kwargs: Any) -> VirtualMachineParâmetros
- expand
- str
A expressão de expansão a ser aplicada na operação. Os valores conhecidos são "instanceView" e None. O valor padrão é "instanceView".
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
Retornos
VirtualMachine ou o resultado de cls(response)
Tipo de retorno
Exceções
instance_view
Recupera 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) -> VirtualMachineInstanceViewParâmetros
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
Retornos
VirtualMachineInstanceView ou o resultado de cls(response)
Tipo de retorno
Exceções
list
Lista todas as máquinas virtuais no grupo de recursos especificado. Use a propriedade nextLink na resposta para obter a próxima página de máquinas virtuais.
list(resource_group_name: str, **kwargs: Any) -> Iterable[VirtualMachine]Parâmetros
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
Retornos
Um iterador como a instância de VirtualMachine ou o resultado de cls(response)
Tipo de retorno
Exceções
list_all
Lista todas as máquinas virtuais na assinatura especificada. Use a propriedade nextLink na resposta para obter a próxima página de máquinas virtuais.
list_all(*, status_only: str | None = None, **kwargs: Any) -> Iterable[VirtualMachine]Parâmetros
- status_only
- str
statusOnly=true permite buscar status de tempo de execução de todos os Máquinas Virtuais na assinatura. O valor padrão é Nenhum.
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
Retornos
Um iterador como a instância de VirtualMachine ou o resultado de cls(response)
Tipo de retorno
Exceções
list_available_sizes
Lista todos os tamanhos de máquina virtual disponíveis aos 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
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
Retornos
Um iterador como instância de VirtualMachineSize ou o resultado de cls(response)
Tipo de retorno
Exceções
list_by_location
Obtém todas as máquinas virtuais na assinatura especificada para o local especificado.
list_by_location(location: str, **kwargs: Any) -> Iterable[VirtualMachine]Parâmetros
- location
- str
O local para o qual as máquinas virtuais na assinatura são consultadas. Obrigatórios.
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
Retornos
Um iterador como a instância de VirtualMachine ou o resultado de cls(response)
Tipo de retorno
Exceções
retrieve_boot_diagnostics_data
A operação para recuperar URIs SAS para os logs de diagnóstico de inicialização de uma máquina virtual.
retrieve_boot_diagnostics_data(resource_group_name: str, vm_name: str, *, sas_uri_expiration_time_in_minutes: int | None = None, **kwargs: Any) -> RetrieveBootDiagnosticsDataResultParâmetros
- sas_uri_expiration_time_in_minutes
- int
Duração de expiração em minutos para os URIs sas com um valor entre 1 a 1440 minutos. <br>:code:>><<<br>NOTE: se não for especificado, os URIs SAS serão gerados com uma duração de expiração padrão de 120 minutos. O valor padrão é Nenhum.
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
Retornos
RetrieveBootDiagnosticsDataResult ou o resultado de cls(response)
Tipo de retorno
Exceções
simulate_eviction
A operação para simular a remoção da máquina virtual spot.
simulate_eviction(resource_group_name: str, vm_name: str, **kwargs: Any) -> NoneParâmetros
- cls
- callable
Um tipo ou função personalizado que será passado para a resposta direta
Retornos
Nenhum ou o resultado de cls(response)
Tipo de retorno
Exceções
Atributos
models
models = <module 'azure.mgmt.compute.v2020_06_01.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\mgmt\\compute\\v2020_06_01\\models\\__init__.py'>
Azure SDK for Python