Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A exclusão de uma máquina virtual (VM) remove a VM e os recursos associados do seu projeto. Se você não quiser excluir uma instância, é possível interrompê-la
temporariamente. Consulte Interromper e iniciar uma VM para conferir essas instruções.
Antes de começar
Para usar os comandos da interface de linha de comando (CLI) gdcloud, verifique se você baixou, instalou
e configurou a CLI gdcloud.
Todos os comandos para o dispositivo isolado do GDC usam a CLI gdcloud ou kubectl e exigem um ambiente de sistema operacional (SO).
Extrair o caminho do arquivo kubeconfig
Para executar comandos no servidor da API Management, verifique se você tem os seguintes
recursos:
Localize o nome do servidor da API Management ou pergunte ao administrador da plataforma (PA) qual é o nome do servidor.
Faça login e gere o arquivo
kubeconfig para o servidor da API Management se você não tiver um.
Use o caminho para substituir MANAGEMENT_API_SERVER{"</var>"}} nestas instruções.
Solicitar permissões e acesso
Para executar as tarefas listadas nesta página, você precisa ter o papel de administrador de máquina virtual do projeto. Siga as etapas para
verificar
ou peça ao administrador do IAM do projeto para
atribuir
a você o papel de administrador de máquinas virtuais do projeto (project-vm-admin) no namespace
do projeto em que a VM reside.
Para operações de VM usando o console do GDC ou a CLI gdcloud,
peça ao administrador do IAM do projeto para atribuir a você os papéis de
administrador de máquina virtual do projeto e leitor do projeto (project-viewer).
Exclua uma VM
Exclua uma VM usando o console do GDC ou kubectl. A VM não pode estar em um estado de encerramento ou desconhecido.
Console
No menu de navegação, clique em Virtual Machines > Instâncias.
Na lista de VMs, marque a caixa de seleção da VM que você quer excluir.
Clique em Excluir.
Na caixa de diálogo de confirmação, clique em Excluir.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eDeleting a virtual machine (VM) permanently removes it and its resources from your project, as opposed to temporarily stopping it.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egdcloud\u003c/code\u003e CLI must be downloaded, installed, and configured to use its commands for managing VMs on the GDC air-gapped appliance.\u003c/p\u003e\n"],["\u003cp\u003eVMs can be deleted via the GDC console, by selecting the VM from the list and confirming deletion, or via the \u003ccode\u003egdcloud\u003c/code\u003e command-line tool by using \u003ccode\u003egdcloud compute instances delete VM_NAME --project PROJECT\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eVMs can be deleted using the \u003ccode\u003ekubectl\u003c/code\u003e command-line tool by using the command: \u003ccode\u003ekubectl --kubeconfig ADMIN_KUBECONFIG delete virtualmachines.virtualmachine.gdc.goog VM_NAME -n NAMESPACE_NAME\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can verify a VM has been deleted by using \u003ccode\u003ekubectl --kubeconfig ADMIN_KUBECONFIG get virtualmachines.virtualmachine.gdc.goog VM_NAME -n PROJECT\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Delete VMs\n\nDeleting a virtual machine (VM) removes the VM and its associated resources from\nyour project. If you don't want to delete an instance, you can temporarily stop\nit. See [Stop and start a VM](/distributed-cloud/hosted/docs/latest/appliance/application/ao-user/vms/manage-vms/operations-and-lifecycle/start-and-stop-vm) for those instructions.\n\nBefore you begin\n----------------\n\nTo use `gdcloud` command-line interface (CLI) commands, ensure that you have downloaded, installed,\nand configured the [`gdcloud` CLI](/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-overview).\nAll commands for GDC air-gapped appliance use the `gdcloud` or\n`kubectl` CLI, and require an operating system (OS) environment.\n\n### Get the kubeconfig file path\n\nTo run commands against the Management API server, ensure you have the following\nresources:\n\n1. Locate the Management API server name, or ask your Platform Administrator (PA)\n what the server name is.\n\n2. [Sign in and generate](/distributed-cloud/hosted/docs/latest/appliance/application/ao-user/iam/sign-in#cli) the\n kubeconfig file for the Management API server if you don't have one.\n\n3. Use the path to replace \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER{\"</var>\"}}\u003c/var\u003e in these instructions.\n\n### Request permissions and access\n\nTo perform the tasks listed in this page, you must have the Project\nVirtualMachine Admin role. Follow the steps to either\n[verify](/distributed-cloud/hosted/docs/latest/appliance/application/ao-user/vms/preparation#verify-user-access)\nor have your Project IAM Admin\n[assign](/distributed-cloud/hosted/docs/latest/appliance/application/ao-user/vms/preparation#grant-user-access-vm-resources)\nyou the Project VirtualMachine Admin (`project-vm-admin`) role in the namespace\nof the project where the VM resides.\n\nFor VM operations using the GDC console or the gdcloud CLI,\nrequest your Project IAM Admin to assign you both the\nProject VirtualMachine Admin role and the Project Viewer (`project-viewer`)\nrole.\n\nDelete a VM\n-----------\n\nDelete a VM by using the GDC console or `kubectl`. The VM must not be\nin a terminating or unknown state. \n\n### Console\n\n1. In the navigation menu, click **Virtual Machines \\\u003e Instances**.\n\n2. In the list of VMs, select the checkbox for the VM that you want to delete.\n\n3. Click **Delete**.\n\n4. In the confirmation dialog, click **Delete**.\n\n### gdcloud\n\nTo delete a VM: \n\n gdcloud compute instances delete \u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e --project \u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\n\n- Replace \u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e with the name of the VM.\n- Replace \u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e with the name of the GDC project in which the VM lives.\n\n### kubectl\n\n1. Delete the VM:\n\n kubectl --kubeconfig \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER\u003c/var\u003e delete virtualmachines.virtualmachine.gdc.goog \u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e -n \u003cvar translate=\"no\"\u003eNAMESPACE_NAME\u003c/var\u003e\n\n2. Replace \u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e and \u003cvar translate=\"no\"\u003eNAMESPACE_NAME\u003c/var\u003e\n with the name and namespace, respectively, of the VM.\n\n3. Verify that you've deleted the VM:\n\n kubectl --kubeconfig \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER\u003c/var\u003e get virtualmachines.virtualmachine.gdc.goog \u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e -n \u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ePROJECT\u003c/code\u003e\u003c/var\u003e with the VM project name."]]
