Descripción general de la API de Virtual Machine Manager
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
El administrador de máquinas virtuales (VMM) de Google Distributed Cloud (GDC) aislado usa las APIs del modelo de recursos de Kubernetes (KRM) en sus operaciones de máquina virtual (VM) y en la administración del ciclo de vida.
Usa la CLI de kubectl para las APIs de VMM.
Extremo de servicio
Las APIs del KRM del VMM se proporcionan en dos paquetes según la implementación zonal o global.
Los extremos de API para las APIs de VMM zonales y globales son los siguientes, respectivamente:
La variable MANAGEMENT_API_SERVER_ENDPOINT es el extremo del servidor de la API de Management.
Documento de descubrimiento
Usa el comando kubectl proxy para abrir un proxy al servidor de la API en tu máquina local. Desde allí, puedes acceder al documento de descubrimiento en una de las siguientes URLs:
En el siguiente archivo VirtualMachineImageImport, se muestra la creación de una imagen de disco a partir de un disco persistente. Elige el disco persistente de una lista VirtualMachineDisk y selecciónalo para crear la imagen y obtener el parámetro size de la fuente. El mismo ejemplo se encuentra en la página Crea imágenes personalizadas.
apiVersion:virtualmachine.gdc.goog/v1kind:VirtualMachineImageImportmetadata:name:VM_IMAGE_IMPORT_NAME# Name of the VM image you want to import.spec:source:diskRef:name:DISK_NAME# Name of the source disk that you will use to create your image.imageMetadata:name:IMAGE_NAME# Name of your created VM image.operatingSystem:OS_NAME# Name of the image OS.minimumDiskSize:MINIMUM_DISK_SIZE# Disk size in the VM image. It must be greater than or equal to the source disk size. An example value is 20G.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eThe Virtual Machine Manager (VMM) in Google Distributed Cloud (GDC) air-gapped uses Kubernetes Resource Model (KRM) APIs for managing virtual machine (VM) operations and their lifecycle.\u003c/p\u003e\n"],["\u003cp\u003eVMM APIs are accessed using the \u003ccode\u003ekubectl\u003c/code\u003e CLI tool, with distinct packages for zonal and global deployments.\u003c/p\u003e\n"],["\u003cp\u003eThe API endpoints for zonal and global VMM are located at \u003ccode\u003ehttps://MANAGEMENT_API_SERVER_ENDPOINT/apis/virtualmachine.gdc.goog/v1\u003c/code\u003e and \u003ccode\u003ehttps://MANAGEMENT_API_SERVER_ENDPOINT/apis/virtualmachine.global.gdc.goog/v1\u003c/code\u003e, respectively.\u003c/p\u003e\n"],["\u003cp\u003eYou can access the discovery document for each deployment using the \u003ccode\u003ekubectl proxy\u003c/code\u003e command with the corresponding URL based on whether it's zonal or global.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003eVirtualMachineImageImport\u003c/code\u003e example demonstrates creating a disk image from a persistent disk, including details like the source disk name, image name, OS, and minimum disk size.\u003c/p\u003e\n"]]],[],null,["# Overview of Virtual Machine Manager API\n\nThe Virtual Machine Manager (VMM) of Google Distributed Cloud (GDC) air-gapped uses Kubernetes Resource Model (KRM) APIs in its virtual machine (VM) operations and lifecycle management.\n\n\u003cbr /\u003e\n\nUse the `kubectl` CLI for the VMM APIs.\n\nService endpoint\n----------------\n\nThe VMM KRM APIs are provided in two packages depending on zonal deployment or\nglobal deployment.\n\nThe API endpoints for the zonal and global VMM APIs are the following,\nrespectively:\n\n- `https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/virtualmachine.gdc.goog/v1`\n- `https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/virtualmachine.global.gdc.goog/v1`\n\nThe \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e variable is the\nendpoint of the Management API server.\n\nDiscovery document\n------------------\n\nUse the `kubectl proxy` command to open a proxy to the API server on your local\nmachine. From there, you can access the discovery document at one of the\nfollowing URLs:\n\n- `http://127.0.0.1:8001/apis/virtualmachine.gdc.goog/v1`\n- `http://127.0.0.1:8001/apis/virtualmachine.global.gdc.goog/v1`\n\nExample of VM KRM\n-----------------\n\nThe following `VirtualMachineImageImport` file shows the creation of a disk\nimage from a persistent disk. You choose the persistent\ndisk from a `VirtualMachineDisk` list and select it to create the image and get\nthe `size` parameter of the source. The same example is on the\n[Create custom images](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vms/create-custom-images/create-custom-images)\npage. \n\n apiVersion: virtualmachine.gdc.goog/v1\n kind: VirtualMachineImageImport\n metadata:\n name: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eVM_IMAGE_IMPORT_NAME\u003c/span\u003e\u003c/var\u003e\n # Name of the VM image you want to import.\n spec:\n source:\n diskRef:\n name: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eDISK_NAME\u003c/span\u003e\u003c/var\u003e\n # Name of the source disk that you will use to create your image.\n imageMetadata:\n name: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eIMAGE_NAME\u003c/span\u003e\u003c/var\u003e\n # Name of your created VM image.\n operatingSystem: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eOS_NAME\u003c/span\u003e\u003c/var\u003e\n # Name of the image OS.\n minimumDiskSize: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eMINIMUM_DISK_SIZE\u003c/span\u003e\u003c/var\u003e\n # Disk size in the VM image. It must be greater than or equal to the source disk size. An example value is 20G."]]
