Menggunakan pemesanan

Dokumen ini menjelaskan cara menggunakan pemesanan diCompute Engine. Untuk mempelajari cara menggunakan pemesanan di produk Google Cloud lain yang mendukung pemesanan, lihat dokumentasi berikut:

Setelah Anda membuat pemesanan, atau Compute Engine otomatis membuat pemesanan untuk Anda dalam memenuhi pemesanan untuk masa mendatang atau pemesanan untuk masa mendatang dalam mode kalender, Compute Engine akan menyimpan resource yang dipesan untuk project Anda, dan project yang Anda bagikan pemesanannya. Saat membuat instance Compute Engine yang cocok dengan properti pemesanan, Anda menggunakan pemesanan dengan menggunakan resource yang dipesan untuk membuat instance komputasi, bukan menggunakan resource yang tersedia di zona instance komputasi. Anda dapat menggunakan reservasi untuk membuat instance komputasi hingga reservasi sepenuhnya digunakan.

Batasan

Anda tidak dapat menggunakan reservasi untuk membuat resource Compute Engine berikut:

  • Flex-start VM

  • Spot VM atau preemptible instance

  • Sole-tenant node

Sebelum memulai

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menggunakan reservasi, minta administrator untuk memberi Anda peran IAM berikut:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk menggunakan pemesanan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk menggunakan pemesanan:

  • Untuk membuat pemesanan: compute.reservations.create pada project
  • Untuk membuat instance komputasi:
    • compute.instances.create pada project
    • Untuk menggunakan image kustom guna membuat VM: compute.images.useReadOnly pada image
    • Untuk menggunakan snapshot guna membuat VM: compute.snapshots.useReadOnly pada snapshot
    • Untuk menggunakan template instance guna membuat VM: compute.instanceTemplates.useReadOnly pada template instance
    • Untuk menetapkan jaringan lama ke VM: compute.networks.use pada project
    • Untuk menentukan alamat IP statis bagi VM: compute.addresses.use di project
    • Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama: compute.networks.useExternalIp pada project
    • Untuk menentukan subnet bagi VM: compute.subnetworks.use di project atau di subnet yang dipilih
    • Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC: compute.subnetworks.useExternalIp pada project atau pada subnet yang dipilih
    • Untuk menetapkan metadata instance VM untuk VM: compute.instances.setMetadata di project
    • Untuk menetapkan tag bagi VM: compute.instances.setTags di VM
    • Untuk menetapkan label bagi VM: compute.instances.setLabels di VM
    • Untuk menyetel akun layanan yang akan digunakan VM: compute.instances.setServiceAccount di VM
    • Untuk membuat disk baru untuk VM: compute.disks.create di project
    • Untuk memasang disk yang ada dalam mode hanya baca atau baca-tulis: compute.disks.use pada disk
    • Untuk memasang disk yang ada dalam mode hanya baca: compute.disks.useReadOnly pada disk
  • Untuk membuat template instance: compute.instanceTemplates.create pada project

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Menggunakan reservasi

Contoh di bagian berikut menunjukkan cara menggunakan reservasi dengan membuat satu instance komputasi. Anda juga dapat menggunakan pemesanan dengan membuat instance komputasi yang cocok dengan properti pemesanan menggunakan opsi deployment yang berbeda, atau dengan memperbarui properti instance komputasi yang ada agar cocok dengan pemesanan yang digunakan secara otomatis.

Untuk menggunakan reservasi, gunakan salah satu metode berikut:

Menggunakan pemesanan yang digunakan secara otomatis

Pemesanan yang digunakan secara otomatis memungkinkan instance komputasi apa pun yang cocok dengan properti pemesanan untuk menggunakannya secara otomatis. Perilaku konsumsi ini berlaku untuk instance komputasi yang baru dan yang sudah ada, yang sedang berjalan. Saat Anda membuat pemesanan on-demand, atau Compute Engine otomatis membuat pemesanan untuk memenuhi pemesanan untuk masa mendatang, jenis pemesanan ini adalah setelan default.

Jika properti reservasi otomatis satu project dan reservasi otomatis bersama cocok, instance komputasi di project Anda akan menggunakan reservasi satu project terlebih dahulu, lalu menggunakan reservasi bersama. Untuk mengetahui informasi selengkapnya, lihat urutan penggunaan untuk pemesanan.

Untuk membuat dan menggunakan contoh reservasi otomatis, pilih salah satu opsi berikut:

Konsol

Contoh berikut menunjukkan cara membuat pemesanan otomatis di zona us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum. Artikel ini juga menunjukkan cara membuat satu instance compute untuk menggunakan reservasi.

Untuk membuat contoh pemesanan otomatis dan menggunakannya, lakukan hal berikut:

  1. Untuk membuat contoh pemesanan, selesaikan langkah-langkah berikut:

    1. Di konsol Google Cloud , buka halaman Reservations.

      Buka Reservations

      Langkah-langkah selanjutnya akan otomatis muncul di konsolGoogle Cloud .

    2. Di tab pemesanan on-demand (default), klik Create reservation. Halaman Buat pemesanan akan muncul.

    3. Di kolom Name, masukkan nama untuk pemesanan. Misalnya, masukkan reservation-01.

    4. Pilih Region dan Zone tempat Anda ingin memesan resource. Misalnya, pilih us-central1 dan us-central1-a.

    5. Di bagian Share type, lakukan salah satu tindakan berikut:

      • Untuk membuat reservasi project tunggal, pilih Local.

      • Untuk membuat pemesanan bersama, pilih Shared, lalu tentukan project yang ingin Anda gunakan dalam pemesanan bersama.

    6. Di bagian Use with VM instance, pilih Use reservation automatically, jika belum dipilih.

    7. Di kolom Number of VM instances, masukkan 3.

    8. Di tab General purpose, pilih N2.

    9. Di bagian Machine type, pada tab Preset (default), pilih n2-standard-32.

    10. Luaskan CPU platform and GPU, lalu di kolom CPU platform, pilih Intel Cascade Lake or later.

    11. Klik Create.

  2. Untuk membuat instance komputasi yang menggunakan contoh pemesanan, selesaikan langkah-langkah berikut:

    1. Di konsol Google Cloud , buka halaman Create an instance.

      Buka halaman Buat instance

      Halaman Create an instance akan muncul dan menampilkan panel Machine configuration.

    2. Di panel Machine configuration, lakukan hal berikut:

      1. Di kolom Name, masukkan nama untuk instance komputasi. Untuk contoh ini, masukkan instance-01.

      2. Tentukan Region dan Zone tempat Anda ingin memesan resource. Untuk contoh ini, pilih us-central1 dan us-central1-a.

      3. Di tab General purpose, pilih N2.

      4. Di bagian Machine type, pada tab Preset (default), pilih n2-standard-32.

      5. Luaskan bagian Opsi lanjutan, lalu, di kolom Platform CPU, pilih Intel Cascade Lake atau yang lebih baru.

    3. Opsional: Menggunakan pemesanan yang cocok secara otomatis adalah setelan default. Namun, jika Anda ingin menentukan setelan ini, lakukan hal berikut:

      1. Di menu navigasi, klik Advanced. Panel Advanced akan muncul.

      2. Di bagian Reservations, pilih Use automatic selection.

    4. Klik Create.

gcloud

Contoh berikut menunjukkan cara membuat reservasi otomatis di zona us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum. Contoh ini juga menunjukkan cara membuat satu instance komputasi untuk menggunakan pemesanan.

Untuk membuat contoh pemesanan otomatis dan menggunakannya, lakukan hal berikut:

  1. Untuk membuat contoh reservasi, gunakan perintah gcloud compute reservations create:

    gcloud compute reservations create reservation-01 \
    --machine-type=n2-standard-32 \
    --min-cpu-platform="Intel Cascade Lake" \
    --vm-count=3 \
    --zone=us-central1-a

  2. Untuk membuat instance komputasi yang menggunakan contoh reservasi, gunakan perintah gcloud compute instances create dengan flag --reservation-affinity yang ditetapkan ke any. Karena any adalah konfigurasi default, Anda juga dapat menghilangkan flag ini.

    gcloud compute instances create instance-01 \
    --machine-type=n2-standard-32 \
    --min-cpu-platform="Intel Cascade Lake" \
    --reservation-affinity=any \
    --zone=us-central1-a

Go

Untuk membuat contoh pemesanan otomatis menggunakan template instance, dan membuat instance untuk menggunakan pemesanan menggunakan template yang sama, gunakan contoh kode berikut:

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "cloud.google.com/go/compute/apiv1/computepb"
	"google.golang.org/protobuf/proto"
)

// consumeAnyReservation creates instance, consuming any available reservation
func consumeAnyReservation(w io.Writer, projectID, zone, instanceName, sourceTemplate string) error {
	// projectID := "your_project_id"
	// zone := "us-west3-a"
	// instanceName := "your_instance_name"
	// sourceTemplate: existing template path. Following formats are allowed:
	//  	- projects/{project_id}/global/instanceTemplates/{template_name}
	//  	- projects/{project_id}/regions/{region}/instanceTemplates/{template_name}
	//  	- https://www.googleapis.com/compute/v1/projects/{project_id}/global/instanceTemplates/instanceTemplate
	//  	- https://www.googleapis.com/compute/v1/projects/{project_id}/regions/{region}/instanceTemplates/instanceTemplate

	ctx := context.Background()

	instancesClient, err := compute.NewInstancesRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %w", err)
	}
	defer instancesClient.Close()

	req := &computepb.InsertInstanceRequest{
		Project:                projectID,
		Zone:                   zone,
		SourceInstanceTemplate: proto.String(sourceTemplate),
		InstanceResource: &computepb.Instance{
			Name: proto.String(instanceName),
			// specifies that any matching reservation should be consumed
			ReservationAffinity: &computepb.ReservationAffinity{
				ConsumeReservationType: proto.String("ANY_RESERVATION"),
			},
		},
	}

	op, err := instancesClient.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to create instance: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}
	fmt.Fprintf(w, "Instance created from reservation\n")

	return nil
}

Java

Contoh berikut menunjukkan cara membuat instance N1 dengan empat vCPU, dan Intel Skylake sebagai platform CPU minimum di zona us-central1-a. Instance akan otomatis menggunakan reservasi yang cocok.

Untuk membuat instance contoh, gunakan contoh kode berikut:

import static com.google.cloud.compute.v1.ReservationAffinity.ConsumeReservationType.ANY_RESERVATION;

import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.compute.v1.AttachedDisk;
import com.google.cloud.compute.v1.AttachedDiskInitializeParams;
import com.google.cloud.compute.v1.InsertInstanceRequest;
import com.google.cloud.compute.v1.Instance;
import com.google.cloud.compute.v1.InstancesClient;
import com.google.cloud.compute.v1.NetworkInterface;
import com.google.cloud.compute.v1.Operation;
import com.google.cloud.compute.v1.ReservationAffinity;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class ConsumeAnyMatchingReservation {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";
    // Zone where the VM instance will be created.
    String zone = "us-central1-a";
    // Name of the VM instance you want to query.
    String instanceName = "YOUR_INSTANCE_NAME";
    // machineType: machine type of the VM being created.
    // *   For a list of machine types, see https://cloud.google.com/compute/docs/machine-types
    String machineTypeName = "n1-standard-4";
    // sourceImage: path to the operating system image to mount.
    // *   For details about images you can mount, see https://cloud.google.com/compute/docs/images
    String sourceImage = "projects/debian-cloud/global/images/family/debian-13";
    // diskSizeGb: storage size of the boot disk to attach to the instance.
    long diskSizeGb = 10L;
    // networkName: network interface to associate with the instance.
    String networkName = "default";
    // Minimum CPU platform of the instances.
    String minCpuPlatform = "Intel Skylake";

    createInstanceAsync(projectId, zone, instanceName, machineTypeName, sourceImage,
        diskSizeGb, networkName, minCpuPlatform);
  }

  // Create a virtual machine targeted with the reserveAffinity field.
  // In this consumption model, existing and new VMs automatically consume a reservation
  // if their properties match the VM properties specified in the reservation.
  public static Instance createInstanceAsync(String projectId, String zone,
      String instanceName, String machineTypeName, String sourceImage,
      long diskSizeGb, String networkName, String minCpuPlatform)
      throws IOException, InterruptedException, ExecutionException, TimeoutException {
    String machineType = String.format("zones/%s/machineTypes/%s", zone, machineTypeName);
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (InstancesClient instancesClient = InstancesClient.create()) {
      AttachedDisk disk =
          AttachedDisk.newBuilder()
              .setBoot(true)
              .setAutoDelete(true)
              .setType(AttachedDisk.Type.PERSISTENT.toString())
              .setDeviceName("disk-1")
              .setInitializeParams(
                  AttachedDiskInitializeParams.newBuilder()
                      .setSourceImage(sourceImage)
                      .setDiskSizeGb(diskSizeGb)
                      .build())
              .build();

      NetworkInterface networkInterface = NetworkInterface.newBuilder()
          .setName(networkName)
          .build();

      ReservationAffinity reservationAffinity =
          ReservationAffinity.newBuilder()
              .setConsumeReservationType(ANY_RESERVATION.toString())
              .build();

      Instance instanceResource =
          Instance.newBuilder()
              .setName(instanceName)
              .setMachineType(machineType)
              .addDisks(disk)
              .addNetworkInterfaces(networkInterface)
              .setMinCpuPlatform(minCpuPlatform)
              .setReservationAffinity(reservationAffinity)
              .build();

      InsertInstanceRequest insertInstanceRequest = InsertInstanceRequest.newBuilder()
          .setProject(projectId)
          .setZone(zone)
          .setInstanceResource(instanceResource)
          .build();

      OperationFuture<Operation, Operation> operation = instancesClient.insertAsync(
          insertInstanceRequest);

      Operation response = operation.get(3, TimeUnit.MINUTES);

      if (response.hasError()) {
        return null;
      }
      return instancesClient.get(projectId, zone, instanceName);
    }
  }
}

Node.js

Contoh berikut menunjukkan cara membuat instance N1 dengan empat vCPU, dan Intel Skylake sebagai platform CPU minimum di zona us-central1-a. Instance akan otomatis menggunakan reservasi yang cocok.

Untuk membuat instance contoh, gunakan contoh kode berikut:

// Import the Compute library
const computeLib = require('@google-cloud/compute');
const compute = computeLib.protos.google.cloud.compute.v1;

// Instantiate a reservationsClient
const instancesClient = new computeLib.InstancesClient();
// Instantiate a zoneOperationsClient
const zoneOperationsClient = new computeLib.ZoneOperationsClient();

/**
 * TODO(developer): Update/uncomment these variables before running the sample.
 */
// The ID of the project where you want to create instance.
const projectId = await instancesClient.getProjectId();
// The zone in which to create instance.
const zone = 'us-central1-a';
// The name of the instance to create.
// const instanceName = 'instance-01';
// Machine type to use for VM.
const machineType = 'n1-standard-4';

// Create instance to consume reservation if their properties match the VM properties
async function callCreateInstanceToConsumeAnyReservation() {
  // Describe the size and source image of the boot disk to attach to the instance.
  const disk = new compute.Disk({
    boot: true,
    autoDelete: true,
    type: 'PERSISTENT',
    initializeParams: {
      diskSizeGb: '10',
      sourceImage: 'projects/debian-cloud/global/images/family/debian-12',
    },
  });

  //  Define networkInterface
  const networkInterface = new compute.NetworkInterface({
    name: 'global/networks/default',
  });

  // Define reservationAffinity
  const reservationAffinity = new compute.ReservationAffinity({
    consumeReservationType: 'ANY_RESERVATION',
  });

  // Create an instance
  const instance = new compute.Instance({
    name: instanceName,
    machineType: `zones/${zone}/machineTypes/${machineType}`,
    minCpuPlatform: 'Intel Skylake',
    disks: [disk],
    networkInterfaces: [networkInterface],
    reservationAffinity,
  });

  const [response] = await instancesClient.insert({
    project: projectId,
    instanceResource: instance,
    zone,
  });

  let operation = response.latestResponse;

  // Wait for the create instance operation to complete.
  while (operation.status !== 'DONE') {
    [operation] = await zoneOperationsClient.wait({
      operation: operation.name,
      project: projectId,
      zone: operation.zone.split('/').pop(),
    });
  }

  console.log(`Instance ${instanceName} created.`);
}

await callCreateInstanceToConsumeAnyReservation();

Python

Contoh berikut menunjukkan cara membuat reservasi otomatis di zona us-central1-a untuk tiga instance N1 dengan satu vCPU, dan Intel Ivy sebagai platform CPU minimum. Bagian ini juga menunjukkan cara membuat satu instance untuk menggunakan pemesanan.

Untuk membuat contoh reservasi otomatis dan menggunakannya, lakukan tindakan berikut:

from __future__ import annotations

import sys
from typing import Any

from google.api_core.extended_operation import ExtendedOperation
from google.cloud import compute_v1


def wait_for_extended_operation(
    operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
) -> Any:
    """
    Waits for the extended (long-running) operation to complete.

    If the operation is successful, it will return its result.
    If the operation ends with an error, an exception will be raised.
    If there were any warnings during the execution of the operation
    they will be printed to sys.stderr.

    Args:
        operation: a long-running operation you want to wait on.
        verbose_name: (optional) a more verbose name of the operation,
            used only during error and warning reporting.
        timeout: how long (in seconds) to wait for operation to finish.
            If None, wait indefinitely.

    Returns:
        Whatever the operation.result() returns.

    Raises:
        This method will raise the exception received from `operation.exception()`
        or RuntimeError if there is no exception set, but there is an `error_code`
        set for the `operation`.

        In case of an operation taking longer than `timeout` seconds to complete,
        a `concurrent.futures.TimeoutError` will be raised.
    """
    result = operation.result(timeout=timeout)

    if operation.error_code:
        print(
            f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
            file=sys.stderr,
            flush=True,
        )
        print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
        raise operation.exception() or RuntimeError(operation.error_message)

    if operation.warnings:
        print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
        for warning in operation.warnings:
            print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)

    return result


def consume_any_project_reservation(
    project_id: str,
    zone: str,
    reservation_name: str,
    instance_name: str,
    machine_type: str = "n1-standard-1",
    min_cpu_platform: str = "Intel Ivy Bridge",
) -> compute_v1.Instance:
    """
    Creates a specific reservation in a single project and launches a VM
    that consumes the newly created reservation.
    Args:
        project_id (str): The ID of the Google Cloud project.
        zone (str): The zone to create the reservation.
        reservation_name (str): The name of the reservation to create.
        instance_name (str): The name of the instance to create.
        machine_type (str): The machine type for the instance.
        min_cpu_platform (str): The minimum CPU platform for the instance.
    """
    instance_properties = (
        compute_v1.AllocationSpecificSKUAllocationReservedInstanceProperties(
            machine_type=machine_type,
            min_cpu_platform=min_cpu_platform,
        )
    )

    reservation = compute_v1.Reservation(
        name=reservation_name,
        specific_reservation=compute_v1.AllocationSpecificSKUReservation(
            count=3,
            instance_properties=instance_properties,
        ),
    )

    # Create a reservation client
    client = compute_v1.ReservationsClient()
    operation = client.insert(
        project=project_id,
        zone=zone,
        reservation_resource=reservation,
    )
    wait_for_extended_operation(operation, "Reservation creation")

    instance = compute_v1.Instance()
    instance.name = instance_name
    instance.machine_type = f"zones/{zone}/machineTypes/{machine_type}"
    instance.min_cpu_platform = min_cpu_platform
    instance.zone = zone

    # Set the reservation affinity to target any matching reservation
    instance.reservation_affinity = compute_v1.ReservationAffinity(
        consume_reservation_type="ANY_RESERVATION",  # Type of reservation to consume
    )
    # Define the disks for the instance
    instance.disks = [
        compute_v1.AttachedDisk(
            boot=True,  # Indicates that this is a boot disk
            auto_delete=True,  # The disk will be deleted when the instance is deleted
            initialize_params=compute_v1.AttachedDiskInitializeParams(
                source_image="projects/debian-cloud/global/images/family/debian-13",
                disk_size_gb=10,
            ),
        )
    ]
    instance.network_interfaces = [
        compute_v1.NetworkInterface(
            network="global/networks/default",  # The network to use
            access_configs=[
                compute_v1.AccessConfig(
                    name="External NAT",  # Name of the access configuration
                    type="ONE_TO_ONE_NAT",  # Type of access configuration
                )
            ],
        )
    ]
    # Create a request to insert the instance
    request = compute_v1.InsertInstanceRequest()
    request.zone = zone
    request.project = project_id
    request.instance_resource = instance

    vm_client = compute_v1.InstancesClient()
    operation = vm_client.insert(request)
    wait_for_extended_operation(operation, "instance creation")
    print(f"Instance {instance_name} that targets any open reservation created.")

    return vm_client.get(project=project_id, zone=zone, instance=instance_name)

REST

Contoh berikut menunjukkan cara membuat reservasi otomatis di zona us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum. Bagian ini juga menunjukkan cara membuat satu instance untuk menggunakan reservasi.

Untuk membuat contoh reservasi otomatis dan menggunakannya, lakukan tindakan berikut:

  1. Untuk membuat contoh pemesanan, buat permintaan POST ke metode reservations.insert:

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "reservation-01",
  "specificReservation": {
    "count": "3",
    "instanceProperties": {
      "machineType": "n2-standard-32",
      "minCpuPlatform": "Intel Cascade Lake",
    }
  }
}

  2. Untuk membuat instance yang menggunakan contoh pemesanan, buat permintaan POST ke metode instances.insert. Dalam isi permintaan, sertakan kolom consumeReservationType yang ditetapkan ke ANY_RESERVATION. Namun, karena ANY_RESERVATION adalah konfigurasi default, Anda juga dapat menghilangkan kolom tersebut.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances

{
  "name": "instance-01",
  "machineType": "zones/us-central1-a/machineTypes/n2-standard-32",
  "minCpuPlatform": "Intel Cascade Lake",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/debian-cloud/global/images/family/debian-12"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "reservationAffinity": {
    "consumeReservationType": "ANY_RESERVATION"
  }
}

Memakai reservasi yang ditargetkan secara khusus

Pemesanan yang ditargetkan secara khusus memungkinkan instance komputasi baru yang cocok dengan properti reservasi dan menargetkan reservasi untuk menggunakannya. Anda dapat berhasil membuat instance komputasi hanya jika propertinya cocok dengan properti reservasi. Jika tidak, permintaan pembuatan Anda akan gagal.

Berdasarkan metode pembuatan yang ingin Anda gunakan, buat reservasi tertentu dan instance komputasi yang menargetkannya sebagai berikut:

Metode pembuatan Saat Anda membuat pemesanan Saat Anda membuat instance komputasi untuk menggunakan pemesanan
KonsolGoogle Cloud Di bagian Use with VM instance, pilih Select specific reservation. Di panel Lanjutan, di bagian Reservasi, pilih Pilih reservasi. Kemudian, ikuti petunjuk untuk memilih reservasi.
Google Cloud CLI Sertakan tanda --require-specific-reservation. Sertakan flag berikut:
  • Flag --reservation-affinity ditetapkan ke specific.
  • Flag --reservation ditetapkan ke jalur resource untuk reservasi, yang diformat sebagai projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.
Go Sertakan kolom SpecificReservationRequired yang ditetapkan ke true. Di kolom ReservationAffinity, sertakan kolom berikut:
  • Kolom ConsumeReservationType ditetapkan ke SPECIFIC_RESERVATION.
  • Kolom Key ditetapkan ke compute.googleapis.com/reservation-name.
  • Kolom Values ditetapkan ke jalur resource untuk reservasi, yang diformat sebagai projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.
Java Sertakan kolom setSpecificReservationRequired yang ditetapkan ke true. Di kolom ReservationAffinity, sertakan kolom berikut:
  • Kolom setConsumeReservationType ditetapkan ke SPECIFIC_RESERVATION.
  • Kolom setKey ditetapkan ke compute.googleapis.com/reservation-name.
  • Kolom addValues ditetapkan ke jalur resource ke reservasi, yang diformat sebagai projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.
Node.js dan REST API Sertakan kolom specificReservationRequired yang ditetapkan ke true. Di kolom reservationAffinity, sertakan kolom berikut:
  • Kolom consumeReservationType ditetapkan ke SPECIFIC_RESERVATION.
  • Kolom key ditetapkan ke compute.googleapis.com/reservation-name.
  • Kolom values ditetapkan ke daftar yang berisi satu item dengan jalur resource ke pemesanan, yang diformat sebagai projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.
Python Sertakan kolom specific_reservation_required yang ditetapkan ke true. Di kolom reservation_affinity, sertakan kolom berikut:
  • Kolom consume_reservation_type ditetapkan ke SPECIFIC_RESERVATION.
  • Kolom key ditetapkan ke compute.googleapis.com/reservation-name.
  • Kolom values ditetapkan ke jalur resource untuk reservasi, yang diformat sebagai projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.
Terraform Sertakan kolom specific_reservation_required yang ditetapkan ke true. Di kolom reservation_affinity, sertakan kolom berikut:
  • Kolom type ditetapkan ke SPECIFIC_RESERVATION.
  • Kolom specific_reservation, yang mencakup kolom berikut:
    • Kolom key ditetapkan ke compute.googleapis.com/reservation-name.
    • Kolom values ditetapkan ke daftar yang berisi satu item dengan jalur resource ke pemesanan, yang diformat sebagai projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.

Untuk membuat contoh pemesanan khusus dan instance komputasi untuk menggunakannya, pilih salah satu opsi berikut:

Konsol

Contoh berikut menunjukkan cara membuat pemesanan spesifik di zona us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum. Panduan ini juga menunjukkan cara membuat satu instance komputasi untuk menggunakan pemesanan.

Untuk membuat contoh reservasi khusus dan menggunakannya, lakukan hal berikut:

  1. Untuk membuat contoh pemesanan, selesaikan langkah-langkah berikut:

    1. Di konsol Google Cloud , buka halaman Reservations.

      Buka Reservations

      Langkah-langkah selanjutnya akan otomatis muncul di konsolGoogle Cloud .

    2. Di tab pemesanan on-demand (default), klik Create reservation. Halaman Buat pemesanan akan muncul.

    3. Di kolom Name, masukkan nama untuk pemesanan. Misalnya, masukkan reservation-02.

    4. Tentukan Region dan Zone tempat Anda ingin memesan resource. Untuk contoh ini, pilih us-central1 dan us-central1-a.

    5. Di bagian Share type, lakukan salah satu tindakan berikut:

      • Untuk membuat reservasi project tunggal, pilih Local.

      • Untuk membuat pemesanan bersama, pilih Shared, lalu tentukan project yang ingin Anda gunakan dalam pemesanan bersama.

    6. Di bagian Use with VM instance, pilih Select specific reservation.

    7. Di kolom Number of VM instances, masukkan 3.

    8. Di tab General purpose, pilih N2.

    9. Di bagian Machine type, pada tab Preset (default), pilih n2-standard-32.

    10. Luaskan CPU platform and GPU, lalu di kolom CPU platform, pilih Intel Cascade Lake or later.

    11. Klik Create.

  2. Untuk membuat instance komputasi yang menggunakan contoh pemesanan, selesaikan langkah-langkah berikut:

    1. Di konsol Google Cloud , buka halaman Create an instance.

      Buka halaman Buat instance

      Halaman Create an instance akan muncul dan menampilkan panel Machine configuration.

    2. Di panel Machine configuration, lakukan hal berikut:

      1. Di kolom Name, masukkan nama untuk instance komputasi. Untuk contoh ini, masukkan instance-02.

      2. Tentukan Region dan Zone tempat Anda ingin memesan resource. Untuk contoh ini, pilih us-central1 dan us-central1-a.

      3. Di tab General purpose, pilih N2.

      4. Di bagian Machine type, pada tab Preset (default), pilih n2-standard-32.

      5. Luaskan bagian Opsi lanjutan, lalu, di kolom Platform CPU, pilih Intel Cascade Lake atau yang lebih baru.

    3. Di menu navigasi, klik Advanced. Panel Lanjutan akan muncul.

    4. Di bagian Reservations, pilih Choose a reservation, lalu klik Choose reservation.

    5. Di panel Choose a reservation yang muncul, lakukan hal berikut:

      1. Pilih reservasi spesifik yang Anda buat pada langkah-langkah sebelumnya. Jika Anda ingin menggunakan pemesanan bersama yang ada di project lain, pilih project tempat pemesanan berada dalam daftar Project.

      2. Klik Pilih.

    6. Klik Create.

gcloud

Contoh berikut menunjukkan cara membuat pemesanan spesifik di zona us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum. Contoh ini juga menunjukkan cara membuat satu instance komputasi untuk menggunakan pemesanan.

Untuk membuat contoh reservasi khusus dan menggunakannya, lakukan hal berikut:

  1. Untuk membuat contoh pemesanan, gunakan perintah gcloud compute reservations create dengan flag --require-specific-reservation:

    gcloud compute reservations create reservation-02 \
    --machine-type=n2-standard-32 \
    --min-cpu-platform="Intel Cascade Lake" \
    --require-specific-reservation \
    --vm-count=3 \
    --zone=us-central1-a

  2. Untuk membuat instance komputasi yang menggunakan contoh pemesanan, gunakan perintah gcloud compute instances create dengan flag --reservation dan --reservation-affinity=specific:

    gcloud compute instances create instance-02 \
    --machine-type=n2-standard-32 \
    --min-cpu-platform="Intel Cascade Lake" \
    --reservation-affinity=specific \
    --reservation=RESERVATION_URL \
    --zone=us-central1-a

    Ganti RESERVATION_URL dengan URL pemesanan. Tentukan salah satu nilai berikut:

    • Jika Anda membuat pemesanan di project yang sama: reservation-02

    • Jika reservasi berada di project yang berbeda: projects/PROJECT_ID/reservations/reservation-02

Go

Contoh berikut menunjukkan cara membuat instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum, di zona us-central1-a untuk menggunakan pemesanan tertentu yang cocok:

  • Untuk membuat contoh instance komputasi yang akan menggunakan reservasi khusus, satu project, gunakan contoh kode berikut:

    import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "cloud.google.com/go/compute/apiv1/computepb"
	"google.golang.org/protobuf/proto"
)

// consumeSpecificReservation creates instance, consuming specific reservation
// Note: respective reservation should have SpecificReservationRequired: true
func consumeSpecificReservation(w io.Writer, projectID, zone, instanceName, reservationName string) error {
	// projectID := "your_project_id"
	// zone := "us-west3-a"
	// reservationName := "your_reservation_name"
	// instanceName := "your_instance_name"

	ctx := context.Background()
	machineType := fmt.Sprintf("zones/%s/machineTypes/%s", zone, "n2-standard-32")
	sourceImage := "projects/debian-cloud/global/images/family/debian-12"

	instancesClient, err := compute.NewInstancesRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %w", err)
	}
	defer instancesClient.Close()

	req := &computepb.InsertInstanceRequest{
		Project: projectID,
		Zone:    zone,
		InstanceResource: &computepb.Instance{
			Disks: []*computepb.AttachedDisk{
				{
					InitializeParams: &computepb.AttachedDiskInitializeParams{
						DiskSizeGb:  proto.Int64(10),
						SourceImage: proto.String(sourceImage),
					},
					AutoDelete: proto.Bool(true),
					Boot:       proto.Bool(true),
					Type:       proto.String(computepb.AttachedDisk_PERSISTENT.String()),
				},
			},
			MachineType:    proto.String(machineType),
			MinCpuPlatform: proto.String("Intel Cascade Lake"),
			Name:           proto.String(instanceName),
			NetworkInterfaces: []*computepb.NetworkInterface{
				{
					Network: proto.String("global/networks/default"),
				},
			},
			// specifies particular reservation, which should be consumed
			ReservationAffinity: &computepb.ReservationAffinity{
				ConsumeReservationType: proto.String("SPECIFIC_RESERVATION"),
				Key:                    proto.String("compute.googleapis.com/reservation-name"),
				Values:                 []string{reservationName},
			},
		},
	}

	op, err := instancesClient.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to create instance: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}
	fmt.Fprintf(w, "Instance created from reservation\n")

	return nil
}

  • Untuk membuat contoh instance komputasi yang akan menggunakan reservasi bersama tertentu, gunakan contoh kode berikut:

    import (
	"context"
	"fmt"
	"io"

	computepb "cloud.google.com/go/compute/apiv1/computepb"
	"google.golang.org/protobuf/proto"
)

// consumeSpecificSharedReservation consumes specific shared reservation in particular zone
func consumeSpecificSharedReservation(w io.Writer, client InstanceClientInterface, projectID, baseProjectId, zone, instanceName, reservationName string) error {
	// client, err := compute.NewInstancesRESTClient(ctx)
	// projectID := "your_project_id". Project where reservation is created.
	// baseProjectId := "shared_project_id". Project where instance will be consumed and created.
	// zone := "us-west3-a"
	// reservationName := "your_reservation_name"
	// instanceName := "your_instance_name"

	ctx := context.Background()
	machineType := fmt.Sprintf("zones/%s/machineTypes/%s", zone, "n2-standard-32")
	sourceImage := "projects/debian-cloud/global/images/family/debian-12"
	sharedReservation := fmt.Sprintf("projects/%s/reservations/%s", baseProjectId, reservationName)

	req := &computepb.InsertInstanceRequest{
		Project: projectID,
		Zone:    zone,
		InstanceResource: &computepb.Instance{
			Disks: []*computepb.AttachedDisk{
				{
					InitializeParams: &computepb.AttachedDiskInitializeParams{
						DiskSizeGb:  proto.Int64(10),
						SourceImage: proto.String(sourceImage),
					},
					AutoDelete: proto.Bool(true),
					Boot:       proto.Bool(true),
					Type:       proto.String(computepb.AttachedDisk_PERSISTENT.String()),
				},
			},
			MachineType:    proto.String(machineType),
			MinCpuPlatform: proto.String("Intel Cascade Lake"),
			Name:           proto.String(instanceName),
			NetworkInterfaces: []*computepb.NetworkInterface{
				{
					Network: proto.String("global/networks/default"),
				},
			},
			// specifies particular reservation, which should be consumed
			ReservationAffinity: &computepb.ReservationAffinity{
				ConsumeReservationType: proto.String("SPECIFIC_RESERVATION"),
				Key:                    proto.String("compute.googleapis.com/reservation-name"),
				Values:                 []string{sharedReservation},
			},
		},
	}

	op, err := client.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to create instance: %w", err)
	}

	if op != nil {
		if err = op.Wait(ctx); err != nil {
			return fmt.Errorf("unable to wait for the operation: %w", err)
		}
	}
	fmt.Fprintf(w, "Instance created from shared reservation\n")

	return nil
}

Java

Contoh berikut menunjukkan cara membuat instance N1 dengan empat vCPU, dan Intel Skylake sebagai platform CPU minimum, di zona us-central1-a untuk menggunakan pemesanan tertentu yang cocok:

  • Untuk membuat contoh reservasi sebagai reservasi project tunggal, dan membuat instance komputasi untuk menggunakannya, gunakan contoh kode berikut:

    import static com.google.cloud.compute.v1.ReservationAffinity.ConsumeReservationType.SPECIFIC_RESERVATION;

import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.compute.v1.AttachedDisk;
import com.google.cloud.compute.v1.AttachedDiskInitializeParams;
import com.google.cloud.compute.v1.InsertInstanceRequest;
import com.google.cloud.compute.v1.Instance;
import com.google.cloud.compute.v1.InstancesClient;
import com.google.cloud.compute.v1.NetworkInterface;
import com.google.cloud.compute.v1.Operation;
import com.google.cloud.compute.v1.ReservationAffinity;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class ConsumeSingleProjectReservation {
  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";
    // Name of the zone where the reservation is located.
    String zone = "us-central1-a";
    // Name of the reservation you want to query.
    String reservationName = "YOUR_RESERVATION_NAME";
    // Name of the VM instance you want to query.
    String instanceName = "YOUR_INSTANCE_NAME";
    // machineType: machine type of the VM being created.
    // *   For a list of machine types, see https://cloud.google.com/compute/docs/machine-types
    String machineTypeName = "n1-standard-4";
    // sourceImage: path to the operating system image to mount.
    // *   For details about images you can mount, see https://cloud.google.com/compute/docs/images
    String sourceImage = "projects/debian-cloud/global/images/family/debian-13";
    // diskSizeGb: storage size of the boot disk to attach to the instance.
    long diskSizeGb = 10L;
    // networkName: network interface to associate with the instance.
    String networkName = "default";
    // Minimum CPU platform of the instances.
    String minCpuPlatform = "Intel Skylake";

    createInstanceAsync(projectId, zone, instanceName, reservationName, machineTypeName,
        sourceImage, diskSizeGb, networkName, minCpuPlatform);
  }

  // Create a virtual machine targeted with the reserveAffinity field.
  // Ensure that the VM's properties match the reservation's VM properties.
  public static Instance createInstanceAsync(String projectId, String zone, String instanceName,
      String reservationName, String machineTypeName, String sourceImage, long diskSizeGb,
      String networkName, String minCpuPlatform)
      throws IOException, InterruptedException, ExecutionException, TimeoutException {
    String machineType = String.format("zones/%s/machineTypes/%s", zone, machineTypeName);
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (InstancesClient instancesClient = InstancesClient.create()) {
      AttachedDisk disk =
          AttachedDisk.newBuilder()
              .setBoot(true)
              .setAutoDelete(true)
              .setType(AttachedDisk.Type.PERSISTENT.toString())
              .setDeviceName("disk-1")
              .setInitializeParams(
                  AttachedDiskInitializeParams.newBuilder()
                      .setSourceImage(sourceImage)
                      .setDiskSizeGb(diskSizeGb)
                      .build())
              .build();

      NetworkInterface networkInterface = NetworkInterface.newBuilder()
          .setName(networkName)
          .build();

      ReservationAffinity reservationAffinity =
          ReservationAffinity.newBuilder()
              .setConsumeReservationType(SPECIFIC_RESERVATION.toString())
              .setKey("compute.googleapis.com/reservation-name")
              // Set specific reservation
              .addValues(reservationName)
              .build();

      Instance instanceResource =
          Instance.newBuilder()
              .setName(instanceName)
              .setMachineType(machineType)
              .addDisks(disk)
              .addNetworkInterfaces(networkInterface)
              .setMinCpuPlatform(minCpuPlatform)
              .setReservationAffinity(reservationAffinity)
              .build();

      InsertInstanceRequest insertInstanceRequest = InsertInstanceRequest.newBuilder()
          .setProject(projectId)
          .setZone(zone)
          .setInstanceResource(instanceResource)
          .build();

      OperationFuture<Operation, Operation> operation = instancesClient.insertAsync(
          insertInstanceRequest);
      Operation response = operation.get(3, TimeUnit.MINUTES);

      if (response.hasError()) {
        return null;
      }
      return instancesClient.get(projectId, zone, instanceName);
    }
  }
}

  • Untuk membuat contoh pemesanan sebagai pemesanan bersama, dan membuat instance komputasi untuk menggunakannya, gunakan contoh kode berikut:

    import static com.google.cloud.compute.v1.ReservationAffinity.ConsumeReservationType.SPECIFIC_RESERVATION;

import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.compute.v1.AttachedDisk;
import com.google.cloud.compute.v1.AttachedDiskInitializeParams;
import com.google.cloud.compute.v1.InsertInstanceRequest;
import com.google.cloud.compute.v1.Instance;
import com.google.cloud.compute.v1.InstancesClient;
import com.google.cloud.compute.v1.NetworkInterface;
import com.google.cloud.compute.v1.Operation;
import com.google.cloud.compute.v1.ReservationAffinity;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class ConsumeSpecificSharedReservation {
  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";
    // Name of the zone the reservation is located.
    String zone = "us-central1-a";
    // Name of the reservation you want to query.
    String reservationName = "YOUR_RESERVATION_NAME";
    // Name of the VM instance you want to query.
    String instanceName = "YOUR_INSTANCE_NAME";
    // machineType: machine type of the VM being created.
    // *   For a list of machine types, see https://cloud.google.com/compute/docs/machine-types
    String machineTypeName = "n1-standard-4";
    // sourceImage: path to the operating system image to mount.
    // *   For details about images you can mount, see https://cloud.google.com/compute/docs/images
    String sourceImage = "projects/debian-cloud/global/images/family/debian-13";
    // diskSizeGb: storage size of the boot disk to attach to the instance.
    long diskSizeGb = 10L;
    // networkName: network interface to associate with the instance.
    String networkName = "default";
    // Minimum CPU platform of the instances.
    String minCpuPlatform = "Intel Skylake";

    createInstanceAsync(projectId, zone, instanceName, reservationName, machineTypeName,
        sourceImage, diskSizeGb, networkName, minCpuPlatform);
  }

  // Create a virtual machine targeted with the reserveAffinity field.
  // Ensure that the VM's properties match the reservation's VM properties.
  public static Instance createInstanceAsync(String projectId, String zone, String instanceName,
      String reservationName, String machineTypeName, String sourceImage, long diskSizeGb,
      String networkName, String minCpuPlatform)
      throws IOException, InterruptedException, ExecutionException, TimeoutException {
    String machineType = String.format("zones/%s/machineTypes/%s", zone, machineTypeName);
    // To consume this reservation from any consumer projects that this reservation is shared with,
    // you must also specify the owner project of the reservation - the path to the reservation.
    String reservationPath =
        String.format("projects/%s/reservations/%s", projectId, reservationName);
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (InstancesClient instancesClient = InstancesClient.create()) {
      AttachedDisk disk =
          AttachedDisk.newBuilder()
              .setBoot(true)
              .setAutoDelete(true)
              .setType(AttachedDisk.Type.PERSISTENT.toString())
              .setDeviceName("disk-1")
              .setInitializeParams(
                  AttachedDiskInitializeParams.newBuilder()
                      .setSourceImage(sourceImage)
                      .setDiskSizeGb(diskSizeGb)
                      .build())
              .build();

      NetworkInterface networkInterface = NetworkInterface.newBuilder()
          .setName(networkName)
          .build();

      ReservationAffinity reservationAffinity =
          ReservationAffinity.newBuilder()
              .setConsumeReservationType(SPECIFIC_RESERVATION.toString())
              .setKey("compute.googleapis.com/reservation-name")
              // Set specific reservation
              .addValues(reservationPath)
              .build();

      Instance instanceResource =
          Instance.newBuilder()
              .setName(instanceName)
              .setMachineType(machineType)
              .addDisks(disk)
              .addNetworkInterfaces(networkInterface)
              .setMinCpuPlatform(minCpuPlatform)
              .setReservationAffinity(reservationAffinity)
              .build();

      InsertInstanceRequest insertInstanceRequest = InsertInstanceRequest.newBuilder()
          .setProject(projectId)
          .setZone(zone)
          .setInstanceResource(instanceResource)
          .build();

      OperationFuture<Operation, Operation> operation = instancesClient.insertAsync(
          insertInstanceRequest);
      Operation response = operation.get(3, TimeUnit.MINUTES);

      if (response.hasError()) {
        return null;
      }
      return instancesClient.get(projectId, zone, instanceName);
    }
  }
}

Node.js

Contoh berikut menunjukkan cara membuat instance N1 dengan 4 vCPU, dan Intel Skylake sebagai platform CPU minimum, di zona us-central1-a untuk menggunakan pemesanan tertentu yang cocok:

// Import the Compute library
const computeLib = require('@google-cloud/compute');
const compute = computeLib.protos.google.cloud.compute.v1;

// Instantiate a reservationsClient
const instancesClient = new computeLib.InstancesClient();
// Instantiate a zoneOperationsClient
const zoneOperationsClient = new computeLib.ZoneOperationsClient();

/**
 * TODO(developer): Update/uncomment these variables before running the sample.
 */
// The ID of the project where you want to create instance.
const projectId = await instancesClient.getProjectId();
// The zone in which to create instance.
const zone = 'us-central1-a';
// The name of the instance to create.
// const instanceName = 'instance-01';
// The name of the reservation to consume.
// Ensure that the specificReservationRequired field in reservation properties is set to true.
// const reservationName = 'reservation-01';
// Machine type to use for VM.
const machineType = 'n1-standard-4';

// Create instance to consume a specific single-project reservation
async function callCreateInstanceToConsumeSingleProjectReservation() {
  // Describe the size and source image of the boot disk to attach to the instance.
  // Ensure that the VM's properties match the reservation's VM properties,
  // including the zone, machine type (machine family, vCPUs, and memory),
  // minimum CPU platform, GPU amount and type, and local SSD interface and size
  const disk = new compute.Disk({
    boot: true,
    autoDelete: true,
    type: 'PERSISTENT',
    initializeParams: {
      diskSizeGb: '10',
      sourceImage: 'projects/debian-cloud/global/images/family/debian-12',
    },
  });

  //  Define networkInterface
  const networkInterface = new compute.NetworkInterface({
    name: 'global/networks/default',
  });

  // Define reservationAffinity
  const reservationAffinity = new compute.ReservationAffinity({
    consumeReservationType: 'SPECIFIC_RESERVATION',
    key: 'compute.googleapis.com/reservation-name',
    values: [reservationName],
  });

  // Create an instance
  const instance = new compute.Instance({
    name: instanceName,
    machineType: `zones/${zone}/machineTypes/${machineType}`,
    minCpuPlatform: 'Intel Skylake',
    disks: [disk],
    networkInterfaces: [networkInterface],
    reservationAffinity,
  });

  const [response] = await instancesClient.insert({
    project: projectId,
    instanceResource: instance,
    zone,
  });

  let operation = response.latestResponse;

  // Wait for the create instance operation to complete.
  while (operation.status !== 'DONE') {
    [operation] = await zoneOperationsClient.wait({
      operation: operation.name,
      project: projectId,
      zone: operation.zone.split('/').pop(),
    });
  }

  console.log(`Instance ${instanceName} created.`);
}

await callCreateInstanceToConsumeSingleProjectReservation();

Python

Contoh berikut menunjukkan cara membuat instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum, di zona us-central1-a untuk menggunakan pemesanan tertentu yang cocok:

Untuk membuat contoh pemesanan khusus dan menggunakannya, lakukan hal berikut:

  • Untuk membuat dan menggunakan contoh reservasi sebagai reservasi satu project, gunakan contoh kode berikut:

    from __future__ import annotations

import sys
from typing import Any

from google.api_core.extended_operation import ExtendedOperation
from google.cloud import compute_v1


def wait_for_extended_operation(
    operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
) -> Any:
    """
    Waits for the extended (long-running) operation to complete.

    If the operation is successful, it will return its result.
    If the operation ends with an error, an exception will be raised.
    If there were any warnings during the execution of the operation
    they will be printed to sys.stderr.

    Args:
        operation: a long-running operation you want to wait on.
        verbose_name: (optional) a more verbose name of the operation,
            used only during error and warning reporting.
        timeout: how long (in seconds) to wait for operation to finish.
            If None, wait indefinitely.

    Returns:
        Whatever the operation.result() returns.

    Raises:
        This method will raise the exception received from `operation.exception()`
        or RuntimeError if there is no exception set, but there is an `error_code`
        set for the `operation`.

        In case of an operation taking longer than `timeout` seconds to complete,
        a `concurrent.futures.TimeoutError` will be raised.
    """
    result = operation.result(timeout=timeout)

    if operation.error_code:
        print(
            f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
            file=sys.stderr,
            flush=True,
        )
        print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
        raise operation.exception() or RuntimeError(operation.error_message)

    if operation.warnings:
        print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
        for warning in operation.warnings:
            print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)

    return result


def consume_specific_single_project_reservation(
    project_id: str,
    zone: str,
    reservation_name: str,
    instance_name: str,
    machine_type: str = "n1-standard-1",
    min_cpu_platform: str = "Intel Ivy Bridge",
) -> compute_v1.Instance:
    """
    Creates a specific reservation in a single project and launches a VM
    that consumes the newly created reservation.
    Args:
        project_id (str): The ID of the Google Cloud project.
        zone (str): The zone to create the reservation.
        reservation_name (str): The name of the reservation to create.
        instance_name (str): The name of the instance to create.
        machine_type (str): The machine type for the instance.
        min_cpu_platform (str): The minimum CPU platform for the instance.
    """
    instance_properties = (
        compute_v1.AllocationSpecificSKUAllocationReservedInstanceProperties(
            machine_type=machine_type,
            min_cpu_platform=min_cpu_platform,
        )
    )

    reservation = compute_v1.Reservation(
        name=reservation_name,
        specific_reservation=compute_v1.AllocationSpecificSKUReservation(
            count=3,
            instance_properties=instance_properties,
        ),
        # Only VMs that target the reservation by name can consume from this reservation
        specific_reservation_required=True,
    )

    # Create a reservation client
    client = compute_v1.ReservationsClient()
    operation = client.insert(
        project=project_id,
        zone=zone,
        reservation_resource=reservation,
    )
    wait_for_extended_operation(operation, "Reservation creation")

    instance = compute_v1.Instance()
    instance.name = instance_name
    instance.machine_type = f"zones/{zone}/machineTypes/{machine_type}"
    instance.min_cpu_platform = min_cpu_platform
    instance.zone = zone

    # Set the reservation affinity to target the specific reservation
    instance.reservation_affinity = compute_v1.ReservationAffinity(
        consume_reservation_type="SPECIFIC_RESERVATION",  # Type of reservation to consume
        key="compute.googleapis.com/reservation-name",  # Key for the reservation
        values=[reservation_name],  # Reservation name to consume
    )
    # Define the disks for the instance
    instance.disks = [
        compute_v1.AttachedDisk(
            boot=True,  # Indicates that this is a boot disk
            auto_delete=True,  # The disk will be deleted when the instance is deleted
            initialize_params=compute_v1.AttachedDiskInitializeParams(
                source_image="projects/debian-cloud/global/images/family/debian-13",
                disk_size_gb=10,
            ),
        )
    ]
    instance.network_interfaces = [
        compute_v1.NetworkInterface(
            network="global/networks/default",  # The network to use
            access_configs=[
                compute_v1.AccessConfig(
                    name="External NAT",  # Name of the access configuration
                    type="ONE_TO_ONE_NAT",  # Type of access configuration
                )
            ],
        )
    ]
    # Create a request to insert the instance
    request = compute_v1.InsertInstanceRequest()
    request.zone = zone
    request.project = project_id
    request.instance_resource = instance

    vm_client = compute_v1.InstancesClient()
    operation = vm_client.insert(request)
    wait_for_extended_operation(operation, "instance creation")
    print(f"Instance {instance_name} with specific reservation created successfully.")

    return vm_client.get(project=project_id, zone=zone, instance=instance_name)

  • Untuk membuat dan menggunakan contoh pemesanan sebagai pemesanan bersama, gunakan contoh kode berikut:

    from __future__ import annotations

import sys
from typing import Any

from google.api_core.extended_operation import ExtendedOperation
from google.cloud import compute_v1


def wait_for_extended_operation(
    operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
) -> Any:
    """
    Waits for the extended (long-running) operation to complete.

    If the operation is successful, it will return its result.
    If the operation ends with an error, an exception will be raised.
    If there were any warnings during the execution of the operation
    they will be printed to sys.stderr.

    Args:
        operation: a long-running operation you want to wait on.
        verbose_name: (optional) a more verbose name of the operation,
            used only during error and warning reporting.
        timeout: how long (in seconds) to wait for operation to finish.
            If None, wait indefinitely.

    Returns:
        Whatever the operation.result() returns.

    Raises:
        This method will raise the exception received from `operation.exception()`
        or RuntimeError if there is no exception set, but there is an `error_code`
        set for the `operation`.

        In case of an operation taking longer than `timeout` seconds to complete,
        a `concurrent.futures.TimeoutError` will be raised.
    """
    result = operation.result(timeout=timeout)

    if operation.error_code:
        print(
            f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
            file=sys.stderr,
            flush=True,
        )
        print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
        raise operation.exception() or RuntimeError(operation.error_message)

    if operation.warnings:
        print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
        for warning in operation.warnings:
            print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)

    return result


def consume_specific_shared_project_reservation(
    owner_project_id: str,
    shared_project_id: str,
    zone: str,
    reservation_name: str,
    instance_name: str,
    machine_type: str = "n1-standard-1",
    min_cpu_platform: str = "Intel Ivy Bridge",
) -> compute_v1.Instance:
    """
    Creates a specific reservation in a single project and launches a VM
    that consumes the newly created reservation.
    Args:
        owner_project_id (str): The ID of the Google Cloud project.
        shared_project_id: The ID of the owner project of the reservation in the same zone.
        zone (str): The zone to create the reservation.
        reservation_name (str): The name of the reservation to create.
        instance_name (str): The name of the instance to create.
        machine_type (str): The machine type for the instance.
        min_cpu_platform (str): The minimum CPU platform for the instance.
    """
    instance_properties = (
        compute_v1.AllocationSpecificSKUAllocationReservedInstanceProperties(
            machine_type=machine_type,
            min_cpu_platform=min_cpu_platform,
        )
    )

    reservation = compute_v1.Reservation(
        name=reservation_name,
        specific_reservation=compute_v1.AllocationSpecificSKUReservation(
            count=3,
            instance_properties=instance_properties,
        ),
        # Only VMs that target the reservation by name can consume from this reservation
        specific_reservation_required=True,
        share_settings=compute_v1.ShareSettings(
            share_type="SPECIFIC_PROJECTS",
            project_map={
                shared_project_id: compute_v1.ShareSettingsProjectConfig(
                    project_id=shared_project_id
                )
            },
        ),
    )

    # Create a reservation client
    client = compute_v1.ReservationsClient()
    operation = client.insert(
        project=owner_project_id,
        zone=zone,
        reservation_resource=reservation,
    )
    wait_for_extended_operation(operation, "Reservation creation")

    instance = compute_v1.Instance()
    instance.name = instance_name
    instance.machine_type = f"zones/{zone}/machineTypes/{machine_type}"
    instance.min_cpu_platform = min_cpu_platform
    instance.zone = zone

    # Set the reservation affinity to target the specific reservation
    instance.reservation_affinity = compute_v1.ReservationAffinity(
        consume_reservation_type="SPECIFIC_RESERVATION",  # Type of reservation to consume
        key="compute.googleapis.com/reservation-name",
        # To consume this reservation from any consumer projects, specify the owner project of the reservation
        values=[f"projects/{owner_project_id}/reservations/{reservation_name}"],
    )
    # Define the disks for the instance
    instance.disks = [
        compute_v1.AttachedDisk(
            boot=True,  # Indicates that this is a boot disk
            auto_delete=True,  # The disk will be deleted when the instance is deleted
            initialize_params=compute_v1.AttachedDiskInitializeParams(
                source_image="projects/debian-cloud/global/images/family/debian-13",
                disk_size_gb=10,
            ),
        )
    ]
    instance.network_interfaces = [
        compute_v1.NetworkInterface(
            network="global/networks/default",  # The network to use
            access_configs=[
                compute_v1.AccessConfig(
                    name="External NAT",  # Name of the access configuration
                    type="ONE_TO_ONE_NAT",  # Type of access configuration
                )
            ],
        )
    ]
    # Create a request to insert the instance
    request = compute_v1.InsertInstanceRequest()
    request.zone = zone
    # The instance will be created in the shared project
    request.project = shared_project_id
    request.instance_resource = instance

    vm_client = compute_v1.InstancesClient()
    operation = vm_client.insert(request)
    wait_for_extended_operation(operation, "instance creation")
    print(f"Instance {instance_name} from project {owner_project_id} created.")
    # The instance is created in the shared project, so we return it from there.
    return vm_client.get(project=shared_project_id, zone=zone, instance=instance_name)

REST

Contoh berikut menunjukkan cara membuat pemesanan spesifik di zona us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum. Contoh ini juga menunjukkan cara membuat satu instance untuk menggunakan pemesanan.

Untuk membuat contoh pemesanan khusus dan menggunakannya, lakukan hal berikut:

  1. Untuk membuat contoh pemesanan, buat permintaan POST ke metode instances.insert. Dalam isi permintaan, sertakan kolom specificReservationRequired yang ditetapkan ke true:

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "reservation-02",
  "specificReservation": {
    "count": "3",
    "instanceProperties": {
      "machineType": "n2-standard-32",
      "minCpuPlatform": "Intel Cascade Lake",
    }
  },
  "specificReservationRequired": true
}

  2. Untuk membuat instance komputasi yang menggunakan contoh pemesanan, buat permintaan POST ke metode instances.insert. Dalam isi permintaan, di kolom reservationAffinity, sertakan berikut:

    • Kolom consumeReservationType ditetapkan ke SPECIFIC_RESERVATION.

    • Kolom key ditetapkan ke compute.googleapis.com/reservation-name.

    • Kolom values ditetapkan ke URL pemesanan.

    Permintaannya mirip dengan berikut ini:

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances

{
  "name": "instance-02",
  "machineType": "zones/us-central1-a/machineTypes/n2-standard-32",
  "minCpuPlatform": "Intel Cascade Lake",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/debian-cloud/global/images/family/debian-12"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "reservationAffinity": {
    "consumeReservationType": "SPECIFIC_RESERVATION",
    "key": "compute.googleapis.com/reservation-name",
    "values": [
      "RESERVATION_URL"
    ]
  }
}

    Ganti RESERVATION_URL dengan URL pemesanan. Tentukan salah satu nilai berikut:

    • Jika Anda membuat pemesanan di project yang sama: reservation-02

    • Jika pemesanan berada di project yang berbeda: projects/PROJECT_ID/reservations/reservation-02

Menggunakan pemesanan yang dibuat otomatis untuk permintaan dalam mode kalender

Jenis pemesanan ini memungkinkan instance komputasi baru menggunakan pemesanan yang dibuat secara otomatis oleh Compute Engine untuk memenuhi pemesanan untuk masa mendatang dalam mode kalender.

Untuk menggunakan jenis reservasi ini, Anda harus membuat instance komputasi sebagai berikut:

  • Instance komputasi harus secara khusus menargetkan pemesanan.

  • Instance komputasi harus dihentikan atau dihapus pada waktu berakhirnya pemesanan.

  • Instance komputasi harus menggunakan model penyediaan terikat reservasi. Saat membuat instance komputasi, Anda dapat menentukan model ini sebagai berikut:

    • Di konsol Google Cloud , jika Anda menentukan jenis mesin yang didukung untuk pemesanan untuk masa mendatang dalam mode kalender, model yang terikat dengan pemesanan akan otomatis dipilih.

    • Di gcloud CLI, sertakan flag --provisioning-model yang ditetapkan ke reservation-bound.

    • Di REST API, sertakan kolom provisioningModel yang ditetapkan ke RESERVATION_BOUND.

Contoh berikut membuat permintaan pemesanan untuk masa mendatang dalam mode kalender untuk instance A3 Ultra. Contoh ini juga menunjukkan kolom yang harus ditentukan saat Anda membuat instance A3 Ultra mandiri untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan.

Untuk menggunakan contoh pemesanan yang dibuat otomatis, pilih salah satu opsi berikut:

Konsol

  1. Buat contoh permintaan untuk lima instance A3 Ultra dan kirimkan untuk ditinjau:

    1. Di konsol Google Cloud , buka halaman Reservations.

      Buka Reservations

    2. Klik tab Pemesanan untuk masa mendatang.

    3. Klik Buat pemesanan untuk masa mendatang. Halaman Create a future reservation akan muncul.

    4. Klik tab GPU, lalu di daftar GPU type, pilih NVIDIA H200 141 GB. Tindakan ini menentukan instance A3 Ultra.

    5. Di kolom Total kapasitas yang diperlukan, masukkan 5.

    6. Di bagian Reservation period, tentukan waktu mulai dan durasi untuk periode pemesanan Anda.

    7. Klik Search for capacity, lalu di bagian Available capacity, pilih salah satu mesin yang tersedia.

    8. Klik Create.

  2. Pada waktu mulai permintaan, untuk membuat instance A3 Ultra yang akan menggunakan contoh pemesanan yang dibuat otomatis, lakukan hal berikut:

    1. Di konsol Google Cloud , buka halaman Create an instance.

      Buka halaman Buat instance

    2. Di kolom Name, masukkan nama untuk instance komputasi. Untuk contoh ini, masukkan example-instance.

    3. Tentukan Region dan Zone tempat reservasi yang dibuat otomatis berada. Untuk contoh ini, pilih us-central1 dan us-central1-b.

    4. Klik tab GPU, lalu di daftar GPU type, pilih NVIDIA H200 141 GB. Tindakan ini menentukan instance A3 Ultra dan menetapkan model penyediaan ke Reservation-bound.

    5. Di menu navigasi, klik Advanced.

    6. Di bagian Reservations, pilih Choose a reservation, lalu klik Choose a reservation.

    7. Di panel Choose a reservation, lakukan hal berikut:

      1. Pilih contoh pemesanan yang dibuat otomatis.

      2. Klik Pilih.

    8. Di bagian Provisioning model, luaskan bagian VM provisioning model advanced settings.

    9. Dalam daftar On VM termination, pilih Stop (default) atau Delete.

    10. Klik Create.

gcloud

  1. Untuk membuat contoh permintaan untuk lima VM A3 Ultra dan mengirimkannya untuk ditinjau, gunakan perintah gcloud compute future-reservations create:

    gcloud compute future-reservations create example-fr \
    --auto-delete-auto-created-reservations \
    --deployment-type=DENSE \
    --planning-status=SUBMITTED \
    --require-specific-reservation \
    --reservation-mode=CALENDAR \
    --reservation-name=example-reservation \
    --share-setting=local \
    --start-time=2026-03-05T00:00:00Z \
    --end-time=2026-03-19T00:00:00Z \
    --machine-type=a3-ultragpu-8g \
    --total-count=5 \
    --zone=us-central1-b

    Asumsikan bahwa Google Cloud menyetujui permintaan dan Compute Engine secara otomatis membuat pemesanan kosong. Pada waktu mulai permintaan, yaitu 5 Maret 2026, Compute Engine akan meningkatkan jumlah VM GPU yang dipesan dalam pemesanan. Kemudian, Anda dapat menggunakan pemesanan.

  2. Pada waktu mulai permintaan, untuk membuat instance A3 Ultra yang akan menggunakan contoh pemesanan yang dibuat otomatis, gunakan perintah gcloud compute instances create dengan flag berikut:

    • Flag --instance-termination-action.

    • Flag --provisioning-model ditetapkan ke RESERVATION_BOUND.

    • Flag --reservation.

    • Flag --reservation-affinity ditetapkan ke specific.

    Perintahnya mirip dengan berikut ini. Untuk mengetahui persyaratan lengkap dalam membuat instance A3 Ultra, lihat Membuat instance A3 Ultra atau A4.

    gcloud compute instance create example-a3ultra-instance  \
    --machine-type=a3-ultragpu-8g \
    --instance-termination-action=TERMINATION_ACTION \
    --provisioning-model=RESERVATION_BOUND \
    --reservation-affinity=specific \
    --reservation=RESERVATION_URL \
    --zone=us-central1-b \
    ...

    Perintah tersebut menyertakan nilai berikut:

    • TERMINATION_ACTION: apakah Compute Engine menghentikan (STOP) atau menghapus (DELETE) VM di akhir periode reservasi.

    • RESERVATION_URL: URL pemesanan, yang diformat sebagai berikut:

      • Jika pemesanan yang dibuat otomatis ada di project Anda: example-reservation.

      • Jika pemesanan yang dibuat otomatis ada di project lain: projects/PROJECT_ID/reservations/example-reservation.

REST

  1. Untuk membuat contoh permintaan lima instance A3 Ultra dan mengirimkannya untuk ditinjau, buat permintaan POST ke metode futureReservations.insert:

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/futureReservations

{
  "name": "example-request-calendar-mode",
  "autoDeleteAutoCreatedReservations": true,
  "deploymentType": "DENSE",
  "planningStatus": "SUBMITTED",
  "reservationMode": "CALENDAR",
  "reservationName": "example-reservation",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificReservationRequired": true,
  "specificSkuProperties": {
    "machineType": "a3-ultragpu-8g",
    "totalCount": 5
  },
  "timeWindow": {
    "startTime": "2026-03-05T00:00:00Z",
    "endTime": "2026-03-19T00:00:00Z"
  }
}

    Asumsikan bahwa Google Cloud menyetujui permintaan dan Compute Engine secara otomatis membuat pemesanan kosong. Pada waktu mulai permintaan, yaitu 5 Maret 2026, Compute Engine akan meningkatkan jumlah VM GPU yang dipesan dalam pemesanan. Kemudian, Anda dapat menggunakan reservasi.

  2. Pada waktu mulai permintaan, untuk membuat instance A3 Ultra guna menggunakan contoh pemesanan yang dibuat otomatis, buat permintaan POST ke metode instances.insert. Dalam isi permintaan, sertakan kolom berikut:

    • Kolom reservationAffinity.consumeReservationType ditetapkan ke SPECIFIC_RESERVATION.

    • Kolom reservationAffinity.key ditetapkan ke compute.googleapis.com/reservation-name.

    • Kolom reservationAffinity.values ditetapkan ke URL pemesanan.

    • Kolom scheduling.instanceTerminationAction.

    • Kolom scheduling.provisioningModel ditetapkan ke RESERVATION_BOUND.

    Permintaannya mirip dengan yang berikut ini. Untuk mengetahui persyaratan lengkap guna membuat instance A3 Ultra, lihat Membuat instance A3 Ultra atau A4.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/

{
  {
    "machineType": "projects/example-project/zones/us-central1-b/machineTypes/a3-ultragpu-8g",
    "name": "example-a3ultra-instance",
    "reservationAffinity": {
      "consumeReservationType": "SPECIFIC_RESERVATION",
      "key": "compute.googleapis.com/reservation-name",
      "values":[
        "RESERVATION_URL"
      ],
    },
    "scheduling": {
      "instanceTerminationAction": "TERMINATION_ACTION",
      "provisioningModel": "RESERVATION_BOUND"
    },
    ...
  }
}

    Isi permintaan menyertakan nilai-nilai berikut:

    • RESERVATION_URL: URL pemesanan, yang diformat sebagai berikut:

      • Jika pemesanan yang dibuat otomatis ada di project Anda: example-reservation.

      • Jika pemesanan yang dibuat secara otomatis ada di project lain: projects/PROJECT_ID/reservations/example-reservation.

    • TERMINATION_ACTION: apakah Compute Engine menghentikan (STOP) atau menghapus (DELETE) VM di akhir periode pemesanan.

Menguji apakah properti instance komputasi cocok dengan reservasi yang digunakan secara otomatis

Tidak seperti pemesanan yang ditargetkan secara khusus, pemesanan yang digunakan secara otomatis tidak menampilkan error jika properti instance komputasi tidak cocok. Sebagai gantinya, Compute Engine akan mencoba membuat instance komputasi menggunakan kapasitas on-demand. Untuk memverifikasi bahwa properti instance komputasi Anda cocok dengan reservasi yang digunakan secara otomatis sebelum Anda meluncurkan workload, uji properti terhadap reservasi yang ditargetkan secara khusus yang memiliki properti yang sama.

Untuk menguji apakah properti instance komputasi cocok dengan pemesanan yang digunakan secara otomatis, selesaikan langkah-langkah berikut:

  1. Buat pemesanan pengujian: buat pemesanan yang ditargetkan secara khusus dengan properti instance komputasi yang sama dengan pemesanan yang dipakai secara otomatis yang ingin Anda uji. Tetapkan jumlah instance komputasi yang dicadangkan ke 1.

  2. Buat instance komputasi pengujian: coba buat instance komputasi dengan menargetkan reservasi pengujian Anda. Hasil dari langkah ini adalah salah satu dari berikut:

    • Jika Anda berhasil membuat instance komputasi, properti instance komputasi dan pemesanan pengujian akan cocok.

    • Jika Anda tidak dapat membuat instance komputasi dan menerima error, berarti properti mungkin tidak cocok. Untuk memecahkan masalah error, lihat Memecahkan masalah pemakaian pemesanan.

  3. Hapus resource: jika Anda berhasil membuat instance komputasi dengan menargetkan reservasi pengujian, hapus resource pengujian untuk menghindari biaya yang tidak perlu:

Memverifikasi pemakaian reservasi

Untuk memverifikasi penggunaan reservasi, gunakan salah satu metode berikut:

Langkah berikutnya