Atualizar ou excluir um pool em espera

Este artigo aborda a atualização, o gerenciamento e a exclusão de um recurso de pool em espera.

Pré-requisitos

Para permitir que pools em espera criem e gerenciem máquinas virtuais em sua assinatura, atribua as permissões apropriadas ao provedor de recursos do pool em espera.

1. No portal do Azure, navegue para as subscrições.
2. Selecione a subscrição que pretende ajustar as permissões.
3. Selecione Controlo de Acesso (IAM).
4. Selecione Adicionar e Adicionar atribuição de função.
5. Na guia Função, procure por Colaborador de Máquina Virtual e selecione-o.
6. Vá para a guia Membros .
7. Selecione + Selecionar membros.
8. Procure por Provedor de Recursos do Pool em Espera e selecione-o.
9. Vá para a guia Revisar + atribuir .
10. Aplique as alterações.
11. Repita as etapas acima e atribua a função de Colaborador de Rede e a função de Operador de Identidade Gerenciada ao Provedor de Recursos do Pool em Espera. Se você estiver usando imagens armazenadas na Galeria de Computação, atribua também as funções de Administrador de Compartilhamento da Galeria de Computação e Editor de Artefatos da Galeria de Computação.

Para obter mais informações sobre como atribuir funções, consulte Atribuir funções do Azure usando o portal do Azure.

Atualizar um pool em espera

Você pode atualizar o estado das instâncias e a capacidade máxima pronta do seu pool de espera a qualquer momento. O nome do pool em espera só pode ser definido durante a criação do pool em espera.

Portal

Nota

Para criar e gerenciar pools em espera no portal do Azure, registre o seguinte sinalizador de recurso: Register-AzProviderFeature -FeatureName StandbyVMPoolPreview -ProviderNamespace Microsoft.StandbyPool

1. Navegue até Dimensionamento de Máquina Virtual, defina ao qual o pool de espera está associado.
2. Em Disponibilidade + escala, selecione Pool em espera.
3. Selecione Gerenciar pool.
4. Atualize a configuração e salve as alterações.

CLI

Atualize um pool de espera existente usando az standby-vm-pool update.

az standby-vm-pool update \
   --resource-group myResourceGroup \
   --name myStandbyPool \
   --max-ready-capacity 20 \
   --min-ready-capacity 5 \
   --vm-state "Deallocated" 

PowerShell

Atualize um pool de espera existente usando Update-AzStandbyVMPool.

Update-AzStandbyVMPool `
   -ResourceGroup myResourceGroup `
   -Name myStandbyPool `
   -MaxReadyCapacity 20 `
   -MinReadyCapacity 5 `
   -VMState "Deallocated" 

Modelo ARM

Atualize uma implantação de pool em espera existente. Implante o modelo atualizado usando az deployment group create ou New-AzResourceGroupDeployment.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "location": {
           "type": "string",
           "defaultValue": "east us"    
        },
        "name": {
           "type": "string",
           "defaultValue": "myStandbyPool"
        },
        "maxReadyCapacity" : {
           "type": "int",
           "defaultValue": 10
        },
         "minReadyCapacity" : {
           "type": "int",
           "defaultValue": 5
        },
        "virtualMachineState" : {
           "type": "string",
           "defaultValue": "Deallocated"
        },
        "attachedVirtualMachineScaleSetId" : {
           "type": "string",
           "defaultValue": "/subscriptions/{subscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet"
        }
    },
    "resources": [ 
        {
            "type": "Microsoft.StandbyPool/standbyVirtualMachinePools",
            "apiVersion": "2024-03-01",
            "name": "[parameters('name')]",
            "location": "[parameters('location')]",
            "properties": {
               "elasticityProfile": {
                   "maxReadyCapacity": "[parameters('maxReadyCapacity')]",
                   "minReadyCapacity": "[parameters('minReadyCapacity')]" 
               },
               "virtualMachineState": "[parameters('virtualMachineState')]",
               "attachedVirtualMachineScaleSetId": "[parameters('attachedVirtualMachineScaleSetId')]"
            }
        }
    ]
   }

Bicep

Atualize uma implantação de pool em espera existente. Implante o modelo atualizado usando az deployment group create ou New-AzResourceGroupDeployment.

param location string = resourceGroup().location
param standbyPoolName string = 'myStandbyPool'
param maxReadyCapacity int = 10
param minReadyCapacity int = 5
@allowed([
  'Running'
  'Deallocated'
])
param vmState string = 'Deallocated'
param virtualMachineScaleSetId string = '/subscriptions/{subscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet'

resource standbyPool 'Microsoft.standbypool/standbyvirtualmachinepools@2024-03-01' = {
  name: standbyPoolName
  location: location
  properties: {
     elasticityProfile: {
      maxReadyCapacity: maxReadyCapacity
      minReadyCapacity: minReadyCapacity
    }
    virtualMachineState: vmState
    attachedVirtualMachineScaleSetId: virtualMachineScaleSetId
  }
}

REST

Atualize um pool de espera existente usando Criar ou Atualizar.

PUT https://management.azure.com/subscriptions/{subscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/myStandbyPool?api-version=2024-03-01
{
"type": "Microsoft.StandbyPool/standbyVirtualMachinePools",
"name": "myStandbyPool",
"location": "east us",
"properties": {
	 "elasticityProfile": {
		 "maxReadyCapacity": 20
       "minReadyCapacity": 5
	 },
	  "virtualMachineState":"Deallocated",
	  "attachedVirtualMachineScaleSetId": "/subscriptions/{subscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet"
	  }
}

Excluir um pool em espera

Portal

Nota

Para criar e gerenciar pools em espera no portal do Azure, registre o seguinte sinalizador de recurso: Register-AzProviderFeature -FeatureName StandbyVMPoolPreview -ProviderNamespace Microsoft.StandbyPool

1. Navegue até Dimensionamento de Máquina Virtual, defina ao qual o pool de espera está associado.
2. Em Disponibilidade + escala, selecione Pool em espera.
3. Selecione Excluir pool.
4. Selecione Eliminar.

CLI

Exclua um pool de espera existente usando az standbypool delete.

az standby-vm-pool delete \
    --resource-group myResourceGroup \
    --name myStandbyPool

PowerShell

Exclua um pool de espera existente usando Remove-AzStandbyVMPool.

Remove-AzStandbyVMPool `
    -ResourceGroup myResourceGroup `
    -Name myStandbyPool `
    -Nowait

REST

Exclua um pool de espera existente usando Delete.

DELETE https://management.azure.com/subscriptions/{subscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/myStandbyPool?api-version=2024-03-01

Próximos passos

Analise as perguntas mais frequentes sobre pools em espera para Conjuntos de Dimensionamento de Máquinas Virtuais.