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 |
---|---|---|---|---|
resource
|
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 |
Conjuntos de Disponibilidade na VM. |
|
properties.hardwareProfile |
Propriedades de hardware. |
|
properties.infrastructureProfile |
Obtém o perfil de infraestrutura. |
|
properties.networkProfile |
Propriedades de rede. |
|
properties.storageProfile |
Propriedades de armazenamento. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
A operação do Azure foi concluída com êxito. |
|
202 Accepted |
Solicitação de atualização de recurso aceita. Cabeçalhos
|
|
Other Status Codes |
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
Virtual |
Virtual |
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 |
---|---|
Allocation |
Método de alocação de endereço de rede. |
Availability |
Modelo de Conjunto de Disponibilidade |
Checkpoint |
Define as propriedades do recurso. |
created |
O tipo de identidade que criou o recurso. |
Create |
Criar disco dif. |
Dynamic |
Memória dinâmica habilitada. |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta de erro |
Extended |
O local estendido. |
Hardware |
Define as propriedades do recurso. |
Hardware |
Define as propriedades de atualização de recurso. |
Infrastructure |
Especifica as configurações específicas da infraestrutura do vmmServer para a instância da máquina virtual. |
Infrastructure |
Especifica as configurações de atualização específicas da infraestrutura do vmmServer para a instância da máquina virtual. |
Is |
Altamente disponível. |
Limit |
Limite a CPU para migração. |
Network |
Modelo de Interface de Rede |
Network |
Modelo de Atualização de Interface de Rede |
Network |
Define as propriedades do recurso. |
Network |
Define as propriedades de atualização de recurso. |
Os |
Define as propriedades do recurso. |
Os |
Tipo de sistema operacional de máquina virtual. |
Provisioning |
O estado de provisionamento do recurso. |
Storage |
Define as propriedades do recurso. |
Storage |
Define as propriedades de atualização de recurso. |
Storage |
A definição StorageQoSPolicyDetails. |
system |
Metadados relativos à criação e última modificação do recurso. |
Virtual |
Modelo de disco virtual |
Virtual |
Modelo de Atualização de Disco Virtual |
Virtual |
Defina o virtualMachineInstance. |
Virtual |
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 |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
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 |
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 |
Obtém uma propriedade altamente disponível. |
|
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 |
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 |
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 |
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 |
Ú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 |
Obtém ou define o tipo de endereço ipv4. |
|
ipv4Addresses |
string[] |
Obtém os endereços ipv4 nic. |
ipv6AddressType |
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 |
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 |
Obtém ou define o tipo de endereço ipv4. |
|
ipv6AddressType |
Obtém ou define o tipo de endereço ipv6. |
|
macAddress |
string |
Obtém ou define o endereço MAC nic. |
macAddressType |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Conjuntos de Disponibilidade na VM. |
|
properties.hardwareProfile |
Propriedades de hardware. |
|
properties.infrastructureProfile |
Obtém o perfil de infraestrutura. |
|
properties.networkProfile |
Propriedades de rede. |
|
properties.osProfile |
Propriedades do sistema operacional. |
|
properties.powerState |
string |
Obtém o estado de energia da máquina virtual. |
properties.provisioningState |
Estado de provisionamento do recurso. |
|
properties.storageProfile |
Propriedades de armazenamento. |
|
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 |
Conjuntos de Disponibilidade na VM. |
|
properties.hardwareProfile |
Propriedades de hardware. |
|
properties.infrastructureProfile |
Obtém o perfil de infraestrutura. |
|
properties.networkProfile |
Propriedades de rede. |
|
properties.storageProfile |
Propriedades de armazenamento. |