Compartilhar via


Virtual Machine Instances - Update

Atualiza uma máquina virtual.
A operação para atualizar uma instância de máquina virtual.

PATCH https://management.azure.com/{resourceUri}/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceUri
path True

string

O identificador totalmente qualificado do Azure Resource Manager do recurso.

api-version
query True

string

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Tipo Description
properties.availabilitySets

AvailabilitySetListItem[]

Conjuntos de Disponibilidade na VM.

properties.hardwareProfile

HardwareProfileUpdate

Propriedades de hardware.

properties.infrastructureProfile

InfrastructureProfileUpdate

Obtém o perfil de infraestrutura.

properties.networkProfile

NetworkProfileUpdate

Propriedades de rede.

properties.storageProfile

StorageProfileUpdate

Propriedades de armazenamento.

Respostas

Nome Tipo Description
200 OK

VirtualMachineInstance

A operação do Azure foi concluída com êxito.

202 Accepted

Solicitação de atualização de recurso aceita.

Cabeçalhos

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

VirtualMachineInstances_Update_MaximumSet
VirtualMachineInstances_Update_MinimumSet

VirtualMachineInstances_Update_MaximumSet

Solicitação de exemplo

PATCH https://management.azure.com/gtgclehcbsyave/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

{
  "properties": {
    "availabilitySets": [
      {
        "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/availabilitySets/availabilitySetResourceName",
        "name": "lwbhaseo"
      }
    ],
    "hardwareProfile": {
      "memoryMB": 5,
      "cpuCount": 22,
      "limitCpuForMigration": "true",
      "dynamicMemoryEnabled": "true",
      "dynamicMemoryMaxMB": 2,
      "dynamicMemoryMinMB": 30
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "name": "kvofzqulbjlbtt",
          "macAddress": "oaeqqegt",
          "virtualNetworkId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualNetworks/virtualNetworkName",
          "ipv4AddressType": "Dynamic",
          "ipv6AddressType": "Dynamic",
          "macAddressType": "Dynamic",
          "nicId": "roxpsvlo"
        }
      ]
    },
    "storageProfile": {
      "disks": [
        {
          "name": "fgnckfymwdsqnfxkdvexuaobe",
          "diskId": "ltdrwcfjklpsimhzqyh",
          "diskSizeGB": 30,
          "bus": 8,
          "lun": 10,
          "busType": "zu",
          "vhdType": "cnbeeeylrvopigdynvgpkfp",
          "storageQoSPolicy": {
            "name": "ceiyfrflu",
            "id": "o"
          }
        }
      ]
    },
    "infrastructureProfile": {
      "checkpointType": "jkbpzjxpeegackhsvikrnlnwqz"
    }
  }
}

Resposta de exemplo

{
  "properties": {
    "availabilitySets": [
      {
        "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/availabilitySets/availabilitySetResourceName",
        "name": "lwbhaseo"
      }
    ],
    "osProfile": {
      "computerName": "uuxpcxuxcufllc",
      "osType": "Windows",
      "osSku": "cxqnjxgkts",
      "osVersion": "djt"
    },
    "hardwareProfile": {
      "memoryMB": 5,
      "cpuCount": 22,
      "limitCpuForMigration": "true",
      "dynamicMemoryEnabled": "true",
      "dynamicMemoryMaxMB": 2,
      "dynamicMemoryMinMB": 30,
      "isHighlyAvailable": "true"
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "name": "kvofzqulbjlbtt",
          "displayName": "yoayfd",
          "ipv4Addresses": [
            "eeunirpkpqazzxhsqonkxcfuks"
          ],
          "ipv6Addresses": [
            "pk"
          ],
          "macAddress": "oaeqqegt",
          "virtualNetworkId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualNetworks/virtualNetworkName",
          "networkName": "lqbm",
          "ipv4AddressType": "Dynamic",
          "ipv6AddressType": "Dynamic",
          "macAddressType": "Dynamic",
          "nicId": "roxpsvlo"
        }
      ]
    },
    "storageProfile": {
      "disks": [
        {
          "name": "fgnckfymwdsqnfxkdvexuaobe",
          "displayName": "fgladknawlgjodo",
          "diskId": "ltdrwcfjklpsimhzqyh",
          "diskSizeGB": 30,
          "maxDiskSizeGB": 18,
          "bus": 8,
          "lun": 10,
          "busType": "zu",
          "vhdType": "cnbeeeylrvopigdynvgpkfp",
          "volumeType": "ckkymkuekzzqhexyjueruzlfemoeln",
          "vhdFormatType": "vbcrrmhgahznifudvhxfagwoplcb",
          "templateDiskId": "lcdwrokpyvekqccclf",
          "storageQoSPolicy": {
            "name": "ceiyfrflu",
            "id": "o"
          },
          "createDiffDisk": "true"
        }
      ]
    },
    "infrastructureProfile": {
      "inventoryItemId": "ihkkqmg",
      "vmmServerId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/vmmServers/vmmServerName",
      "cloudId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/clouds/cloudResourceName",
      "templateId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
      "vmName": "qovpayfydhcvfrhe",
      "uuid": "hrpw",
      "lastRestoredVMCheckpoint": {
        "parentCheckpointID": "hqhhzikoxunuqguouw",
        "checkpointID": "wsqmrje",
        "name": "keqn",
        "description": "qurzfrgyflrh"
      },
      "checkpointType": "jkbpzjxpeegackhsvikrnlnwqz",
      "generation": 28,
      "biosGuid": "xixivxifyql",
      "checkpoints": [
        {
          "parentCheckpointID": "hqhhzikoxunuqguouw",
          "checkpointID": "wsqmrje",
          "name": "keqn",
          "description": "kz"
        }
      ]
    },
    "powerState": "dbqyxewvrbqcifpwfvxyllwyaffmvm",
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ExtendedLocation/customLocations/customLocationName"
  },
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineInstances/default",
  "name": "uuqpsdoiyvedvqtrwop",
  "type": "zculorteltpvthtzgnpgdpoe",
  "systemData": {
    "createdBy": "p",
    "createdByType": "User",
    "createdAt": "2024-01-29T22:28:00.094Z",
    "lastModifiedBy": "goxcwpyyqlxndquly",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-01-29T22:28:00.095Z"
  }
}
location: https://contoso.com/operationstatus

VirtualMachineInstances_Update_MinimumSet

Solicitação de exemplo

PATCH https://management.azure.com/gtgclehcbsyave/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

{}

Resposta de exemplo

{
  "extendedLocation": {}
}
location: https://contoso.com/operationstatus

Definições

Nome Description
AllocationMethod

Método de alocação de endereço de rede.

AvailabilitySetListItem

Modelo de Conjunto de Disponibilidade

Checkpoint

Define as propriedades do recurso.

createdByType

O tipo de identidade que criou o recurso.

CreateDiffDisk

Criar disco dif.

DynamicMemoryEnabled

Memória dinâmica habilitada.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

ExtendedLocation

O local estendido.

HardwareProfile

Define as propriedades do recurso.

HardwareProfileUpdate

Define as propriedades de atualização de recurso.

InfrastructureProfile

Especifica as configurações específicas da infraestrutura do vmmServer para a instância da máquina virtual.

InfrastructureProfileUpdate

Especifica as configurações de atualização específicas da infraestrutura do vmmServer para a instância da máquina virtual.

IsHighlyAvailable

Altamente disponível.

LimitCpuForMigration

Limite a CPU para migração.

NetworkInterface

Modelo de Interface de Rede

NetworkInterfaceUpdate

Modelo de Atualização de Interface de Rede

NetworkProfile

Define as propriedades do recurso.

NetworkProfileUpdate

Define as propriedades de atualização de recurso.

OsProfileForVmInstance

Define as propriedades do recurso.

OsType

Tipo de sistema operacional de máquina virtual.

ProvisioningState

O estado de provisionamento do recurso.

StorageProfile

Define as propriedades do recurso.

StorageProfileUpdate

Define as propriedades de atualização de recurso.

StorageQosPolicyDetails

A definição StorageQoSPolicyDetails.

systemData

Metadados relativos à criação e última modificação do recurso.

VirtualDisk

Modelo de disco virtual

VirtualDiskUpdate

Modelo de Atualização de Disco Virtual

VirtualMachineInstance

Defina o virtualMachineInstance.

VirtualMachineInstanceUpdate

O tipo usado para operações de atualização do VirtualMachineInstance.

AllocationMethod

Método de alocação de endereço de rede.

Nome Tipo Description
Dynamic

string

Endereço alocado dinamicamente.

Static

string

Endereço alocado estaticamente.

AvailabilitySetListItem

Modelo de Conjunto de Disponibilidade

Nome Tipo Description
id

string

Obtém a ID do ARM do recurso microsoft.scvmm/availabilitySets.

name

string

Obtém ou define o nome do conjunto de disponibilidade.

Checkpoint

Define as propriedades do recurso.

Nome Tipo Description
checkpointID

string

Obtém a ID do ponto de verificação.

description

string

Obtém a descrição do ponto de verificação.

name

string

Obtém o nome do ponto de verificação.

parentCheckpointID

string

Obtém a ID do pai do ponto de verificação.

createdByType

O tipo de identidade que criou o recurso.

Nome Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

CreateDiffDisk

Criar disco dif.

Nome Tipo Description
false

string

Desabilite a criação de disco dif.

true

string

Habilitar a criação de disco dif.

DynamicMemoryEnabled

Memória dinâmica habilitada.

Nome Tipo Description
false

string

Desabilite a memória dinâmica.

true

string

Habilitar memória dinâmica.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

ExtendedLocation

O local estendido.

Nome Tipo Description
name

string

O nome do local estendido.

type

string

O tipo de local estendido.

HardwareProfile

Define as propriedades do recurso.

Nome Tipo Description
cpuCount

integer

Obtém ou define o número de vCPUs para a vm.

dynamicMemoryEnabled

DynamicMemoryEnabled

Obtém ou define um valor que indica se a memória dinâmica deve ser habilitada ou não.

dynamicMemoryMaxMB

integer

Obtém ou define a memória dinâmica máxima para a VM.

dynamicMemoryMinMB

integer

Obtém ou define a memória dinâmica mínima para a VM.

isHighlyAvailable

IsHighlyAvailable

Obtém uma propriedade altamente disponível.

limitCpuForMigration

LimitCpuForMigration

Obtém ou define um valor que indica se o modo de compatibilidade do processador deve ser habilitado para a migração dinâmica de VMs.

memoryMB

integer

MemoryMB é do tamanho da memória de uma máquina virtual, em MB.

HardwareProfileUpdate

Define as propriedades de atualização de recurso.

Nome Tipo Description
cpuCount

integer

Obtém ou define o número de vCPUs para a vm.

dynamicMemoryEnabled

DynamicMemoryEnabled

Obtém ou define um valor que indica se a memória dinâmica deve ser habilitada ou não.

dynamicMemoryMaxMB

integer

Obtém ou define a memória dinâmica máxima para a VM.

dynamicMemoryMinMB

integer

Obtém ou define a memória dinâmica mínima para a VM.

limitCpuForMigration

LimitCpuForMigration

Obtém ou define um valor que indica se o modo de compatibilidade do processador deve ser habilitado para a migração dinâmica de VMs.

memoryMB

integer

MemoryMB é do tamanho da memória de uma máquina virtual, em MB.

InfrastructureProfile

Especifica as configurações específicas da infraestrutura do vmmServer para a instância da máquina virtual.

Nome Tipo Description
biosGuid

string

Obtém ou define o guid de bios para a VM.

checkpointType

string

Tipo de ponto de verificação com suporte para a VM.

checkpoints

Checkpoint[]

Pontos de verificação na vm.

cloudId

string

ID do ARM do recurso de nuvem a ser usado para implantar a vm.

generation

integer

Obtém ou define a geração da vm.

inventoryItemId

string

Obtém ou define a ID do item de inventário para o recurso.

lastRestoredVMCheckpoint

Checkpoint

Último ponto de verificação restaurado na VM.

templateId

string

ID do ARM do recurso de modelo a ser usado para implantar a vm.

uuid

string

ID exclusiva da máquina virtual.

vmName

string

VMName é o nome da VM no servidor SCVmm.

vmmServerId

string

ID do ARM do recurso vmmServer no qual esse recurso reside.

InfrastructureProfileUpdate

Especifica as configurações de atualização específicas da infraestrutura do vmmServer para a instância da máquina virtual.

Nome Tipo Description
checkpointType

string

Tipo de ponto de verificação com suporte para a VM.

IsHighlyAvailable

Altamente disponível.

Nome Tipo Description
false

string

Desabilitar altamente disponível.

true

string

Habilitar altamente disponível.

LimitCpuForMigration

Limite a CPU para migração.

Nome Tipo Description
false

string

Desabilite o limite de CPU para migração.

true

string

Habilite a CPU de limite para migração.

NetworkInterface

Modelo de Interface de Rede

Nome Tipo Description
displayName

string

Obtém o nome de exibição do adaptador de rede, conforme mostrado no vmmServer. Esse é o rótulo de fallback de uma NIC quando o nome não está definido.

ipv4AddressType

AllocationMethod

Obtém ou define o tipo de endereço ipv4.

ipv4Addresses

string[]

Obtém os endereços ipv4 nic.

ipv6AddressType

AllocationMethod

Obtém ou define o tipo de endereço ipv6.

ipv6Addresses

string[]

Obtém os endereços ipv6 nic.

macAddress

string

Obtém ou define o endereço MAC nic.

macAddressType

AllocationMethod

Obtém ou define o tipo de endereço mac.

name

string

Obtém ou define o nome da interface de rede.

networkName

string

Obtém o nome da rede virtual no vmmServer ao qual a nic está conectada.

nicId

string

Obtém ou define a ID nic.

virtualNetworkId

string

Obtém ou define a ID do ARM do recurso Microsoft.ScVmm/virtualNetwork para conectar a nic.

NetworkInterfaceUpdate

Modelo de Atualização de Interface de Rede

Nome Tipo Description
ipv4AddressType

AllocationMethod

Obtém ou define o tipo de endereço ipv4.

ipv6AddressType

AllocationMethod

Obtém ou define o tipo de endereço ipv6.

macAddress

string

Obtém ou define o endereço MAC nic.

macAddressType

AllocationMethod

Obtém ou define o tipo de endereço mac.

name

string

Obtém ou define o nome da interface de rede.

nicId

string

Obtém ou define a ID nic.

virtualNetworkId

string

Obtém ou define a ID do ARM do recurso Microsoft.ScVmm/virtualNetwork para conectar a nic.

NetworkProfile

Define as propriedades do recurso.

Nome Tipo Description
networkInterfaces

NetworkInterface[]

Obtém ou define a lista de interfaces de rede associadas à máquina virtual.

NetworkProfileUpdate

Define as propriedades de atualização de recurso.

Nome Tipo Description
networkInterfaces

NetworkInterfaceUpdate[]

Obtém ou define a lista de interfaces de rede associadas à máquina virtual.

OsProfileForVmInstance

Define as propriedades do recurso.

Nome Tipo Description
adminPassword

string

Senha de administrador da máquina virtual.

computerName

string

Obtém ou define o nome do computador.

domainName

string

Obtém ou define o nome de domínio.

domainPassword

string

Senha do domínio em que a VM precisa ingressar.

domainUsername

string

Obtém ou define o nome de usuário do domínio.

osSku

string

Obtém o sku do sistema operacional.

osType

OsType

Obtém o tipo do sistema operacional.

osVersion

string

Obtém a versão do sistema operacional.

productKey

string

Obtém ou define a chave do produto. Formato de entrada xxxxx-xxxxx-xxxxx-xxxxx-xxxxxx

runOnceCommands

string

Obtenha ou define os comandos a serem executados uma vez no momento da criação separados por ponto-e-vírgula.

timezone

integer

Obtém ou define o valor do índice do fuso horário.

workgroup

string

Obtém ou define o grupo de trabalho.

OsType

Tipo de sistema operacional de máquina virtual.

Nome Tipo Description
Linux

string

Sistema operacional Linux.

Other

string

Outro sistema operacional.

Windows

string

Sistema operacional Windows.

ProvisioningState

O estado de provisionamento do recurso.

Nome Tipo Description
Accepted

string

O recurso foi aceito.

Canceled

string

A criação de recursos foi cancelada.

Created

string

O recurso foi criado.

Deleting

string

O recurso está sendo excluído.

Failed

string

Falha na criação de recursos.

Provisioning

string

O recurso está sendo provisionado.

Succeeded

string

O recurso foi criado.

Updating

string

O recurso está sendo atualizado.

StorageProfile

Define as propriedades do recurso.

Nome Tipo Description
disks

VirtualDisk[]

Obtém ou define a lista de discos virtuais associados à máquina virtual.

StorageProfileUpdate

Define as propriedades de atualização de recurso.

Nome Tipo Description
disks

VirtualDiskUpdate[]

Obtém ou define a lista de discos virtuais associados à máquina virtual.

StorageQosPolicyDetails

A definição StorageQoSPolicyDetails.

Nome Tipo Description
id

string

A ID da política de QoS.

name

string

O nome da política.

systemData

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

VirtualDisk

Modelo de disco virtual

Nome Tipo Description
bus

integer

Obtém ou define o barramento de disco.

busType

string

Obtém ou define o tipo de barramento de disco.

createDiffDisk

CreateDiffDisk

Obtém ou define um valor que indica o disco dif.

diskId

string

Obtém ou define a ID do disco.

diskSizeGB

integer

Obtém ou define o tamanho total do disco.

displayName

string

Obtém o nome de exibição do disco virtual, conforme mostrado no vmmServer. Esse é o rótulo de fallback de um disco quando o nome não está definido.

lun

integer

Obtém ou define o lun de disco.

maxDiskSizeGB

integer

Obtém o tamanho máximo do disco.

name

string

Obtém ou define o nome do disco.

storageQoSPolicy

StorageQosPolicyDetails

A política de QoS para o disco.

templateDiskId

string

Obtém ou define a ID do disco no modelo.

vhdFormatType

string

Obtém o tipo de formato vhd de disco.

vhdType

string

Obtém ou define o tipo vhd de disco.

volumeType

string

Obtém o tipo de volume de disco.

VirtualDiskUpdate

Modelo de Atualização de Disco Virtual

Nome Tipo Description
bus

integer

Obtém ou define o barramento de disco.

busType

string

Obtém ou define o tipo de barramento de disco.

diskId

string

Obtém ou define a ID do disco.

diskSizeGB

integer

Obtém ou define o tamanho total do disco.

lun

integer

Obtém ou define o lun de disco.

name

string

Obtém ou define o nome do disco.

storageQoSPolicy

StorageQosPolicyDetails

A política de QoS para o disco.

vhdType

string

Obtém ou define o tipo vhd de disco.

VirtualMachineInstance

Defina o virtualMachineInstance.

Nome Tipo Description
extendedLocation

ExtendedLocation

Obtém ou define o local estendido.

id

string

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.availabilitySets

AvailabilitySetListItem[]

Conjuntos de Disponibilidade na VM.

properties.hardwareProfile

HardwareProfile

Propriedades de hardware.

properties.infrastructureProfile

InfrastructureProfile

Obtém o perfil de infraestrutura.

properties.networkProfile

NetworkProfile

Propriedades de rede.

properties.osProfile

OsProfileForVmInstance

Propriedades do sistema operacional.

properties.powerState

string

Obtém o estado de energia da máquina virtual.

properties.provisioningState

ProvisioningState

Estado de provisionamento do recurso.

properties.storageProfile

StorageProfile

Propriedades de armazenamento.

systemData

systemData

Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

VirtualMachineInstanceUpdate

O tipo usado para operações de atualização do VirtualMachineInstance.

Nome Tipo Description
properties.availabilitySets

AvailabilitySetListItem[]

Conjuntos de Disponibilidade na VM.

properties.hardwareProfile

HardwareProfileUpdate

Propriedades de hardware.

properties.infrastructureProfile

InfrastructureProfileUpdate

Obtém o perfil de infraestrutura.

properties.networkProfile

NetworkProfileUpdate

Propriedades de rede.

properties.storageProfile

StorageProfileUpdate

Propriedades de armazenamento.