Visão geral da API do administrador de máquina virtual

O administrador de máquina virtual (VMM, na sigla em inglês) do Google Distributed Cloud (GDC) com isolamento físico usa APIs do modelo de recursos do Kubernetes (KRM, na sigla em inglês) nas operações e no gerenciamento do ciclo de vida de máquinas virtuais (VMs).

Use a CLI kubectl para as APIs do VMM.

Endpoint de serviço

As APIs KRM do VMM são fornecidas em dois pacotes, dependendo da implantação zonal ou global.

Os endpoints de API das APIs zonais e globais do VMM são os seguintes, respectivamente:

  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/virtualmachine.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/virtualmachine.global.gdc.goog/v1

A variável MANAGEMENT_API_SERVER_ENDPOINT é o endpoint do servidor da API Management.

Documento de descoberta

Use o comando kubectl proxy para abrir um proxy para o servidor de API na máquina local. A partir daí, você pode acessar o documento de descoberta em um dos seguintes URLs:

  • http://127.0.0.1:8001/apis/virtualmachine.gdc.goog/v1
  • http://127.0.0.1:8001/apis/virtualmachine.global.gdc.goog/v1

Exemplo de KRM de VM

O arquivo VirtualMachineImageImport a seguir mostra a criação de uma imagem de disco com base em um disco permanente. Escolha o disco permanente em uma lista VirtualMachineDisk e selecione-o para criar a imagem e receber o parâmetro size da origem. O mesmo exemplo está na página Criar imagens personalizadas.

apiVersion: virtualmachine.gdc.goog/v1
kind: VirtualMachineImageImport
metadata:
  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.