Halaman ini diterjemahkan oleh Cloud Translation API.

Melihat pemesanan

Dokumen ini menjelaskan cara melihat pemesanan.

Melihat pemesanan berguna untuk mendapatkan ringkasan semua pemesanan di project Anda, atau meninjau detail konfigurasi pemesanan. Jika ingin melihat pemesanan bersama, Anda hanya dapat melihatnya menggunakan project pemilik.

Sebelum memulai

Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat pemesanan, minta administrator untuk memberi Anda peran IAM Compute Admin (roles/compute.admin) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat pemesanan. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat pemesanan:

Untuk melihat daftar pemesanan: compute.reservations.list pada project
Untuk melihat detail pemesanan: compute.reservations.get pada project

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

Melihat pemesanan

Untuk melihat informasi tentang reservasi dalam project Anda, gunakan salah satu metode berikut:

Untuk melihat ringkasan semua reservasi di project Anda, lihat daftar reservasi Anda.
Untuk mengetahui detail lengkap pemesanan tertentu, lihat detail pemesanan.

Melihat daftar pemesanan Anda

Untuk melihat daftar reservasi Anda, pilih salah satu opsi berikut:

Konsol

Di Konsol Google Cloud, buka halaman Pemesanan.

Buka Pemesanan
Di tab Pemesanan on demand (default), dalam tabel, setiap baris menjelaskan pemesanan dan setiap kolom menjelaskan properti.
Opsional: Untuk mengubah pemesanan dan properti yang ditampilkan, gunakan Filter dan Opsi tampilan kolom.

gcloud

Untuk melihat daftar pemesanan, gunakan perintah gcloud compute reservations list.

gcloud compute reservations list

Outputnya akan mirip dengan contoh berikut:

NAME: r-01
IN_USE_COUNT: 0
COUNT: 5
ZONE: us-central1-a
SHARE_TYPE: LOCAL

NAME: r-02
IN_USE_COUNT: 3
COUNT: 10
ZONE: us-central1-f
SHARE_TYPE: LOCAL

Atau, untuk mempersempit daftar pemesanan menggunakan ekspresi filter, sertakan flag --filter.

gcloud compute reservations list \
    --filter="FILTER_EXPRESSION"

Ganti FILTER_EXPRESSION dengan ekspresi filter.

Misalnya, untuk hanya melihat pemesanan dengan nama yang diawali dengan prefix dan berada di zona us-central1-a, jalankan perintah berikut:

gcloud compute reservations list \
    --filter="name~prefix AND zone=us-central1-a"

Go

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "cloud.google.com/go/compute/apiv1/computepb"
	"google.golang.org/api/iterator"
)

// Get list of reservations for given project in particular zone
func listReservations(w io.Writer, projectID, zone string) error {
	// projectID := "your_project_id"
	// zone := "us-west3-a"

	ctx := context.Background()
	reservationsClient, err := compute.NewReservationsRESTClient(ctx)
	if err != nil {
		return err
	}
	defer reservationsClient.Close()

	req := &computepb.ListReservationsRequest{
		Project: projectID,
		Zone:    zone,
	}

	it := reservationsClient.List(ctx, req)
	fmt.Fprintf(w, "Instances found in zone %s:\n", zone)
	for {
		instance, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			return err
		}
		fmt.Fprintf(w, "- %s %d\n", instance.GetName(), instance.GetSpecificReservation().GetCount())
	}

	return nil
}

Java

import com.google.cloud.compute.v1.Reservation;
import com.google.cloud.compute.v1.ReservationsClient;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class ListReservations {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String project = "YOUR_PROJECT_ID";
    // Zone in which reservations are located.
    String zone = "us-central1-a";

    listReservations(project, zone);
  }

  // List all reservations in the given project and zone.
  public static List<Reservation> listReservations(String project, String zone) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    List<Reservation> listOfReservations = new ArrayList<>();

    try (ReservationsClient reservationsClient = ReservationsClient.create()) {
      for (Reservation reservation : reservationsClient.list(project, zone).iterateAll()) {
        listOfReservations.add(reservation);
        System.out.println("Reservation: " + reservation.getName());
      }
    }
    return listOfReservations;
  }
}

Node.js

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

// Instantiate a reservationsClient
const reservationsClient = new computeLib.ReservationsClient();

/**
 * TODO(developer): Update these variables before running the sample.
 */
// The ID of the project where your reservations are located.
const projectId = await reservationsClient.getProjectId();
// The zone where your reservations are located.
const zone = 'us-central1-a';

async function callGetReservations() {
  const reservations = (
    await reservationsClient.list({
      project: projectId,
      zone,
    })
  )[0];

  console.log(JSON.stringify(reservations));
}

await callGetReservations();

Python

from google.cloud import compute_v1
from google.cloud.compute_v1.services.reservations.pagers import ListPager


def list_compute_reservation(project_id: str, zone: str = "us-central1-a") -> ListPager:
    """
    Lists all compute reservations in a specified Google Cloud project and zone.
    Args:
        project_id (str): The ID of the Google Cloud project.
        zone (str): The zone of the reservations.
    Returns:
        ListPager: A pager object containing the list of reservations.
    """

    client = compute_v1.ReservationsClient()

    reservations_list = client.list(
        project=project_id,
        zone=zone,
    )

    for reservation in reservations_list:
        print("Name: ", reservation.name)
        print(
            "Machine type: ",
            reservation.specific_reservation.instance_properties.machine_type,
        )
    # Example response:
    # Name:  my-reservation_1
    # Machine type:  n1-standard-1
    # Name:  my-reservation_2
    # Machine type:  n1-standard-1

    return reservations_list

REST

Untuk melihat daftar pemesanan Anda, buat permintaan GET ke metode reservations.list.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

Ganti kode berikut:

PROJECT_ID: ID project tempat pemesanan Anda berada.
ZONE: zona tempat pemesanan Anda berada.

Outputnya mirip dengan contoh berikut:

{
  "kind": "compute#reservation",
  "id": "4100668622331754141",
  "creationTimestamp": "2019-09-27T08:21:14.707-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-05",
  "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a",
  "name": "reservation-05",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n1-standard-2"
    },
    "count": "100",
    "inUseCount": "0",
    "assuredCount": "100"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "shareSettings": {
    "shareType": "LOCAL"
  }
},
{
  "kind": "compute#reservation",
  "id": "2533514314332214789",
  "creationTimestamp": "2019-09-27T08:21:14.707-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04",
  "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a",
  "name": "reservation-04",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n1-standard-2",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-tesla-t4",
          "acceleratorCount": 1
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ]
    },
    "count": "50",
    "inUseCount": "25",
    "assuredCount": "50"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "shareSettings": {
    "shareType": "LOCAL"
  }
}

Atau, untuk mempersempit daftar pemesanan menggunakan ekspresi filter, sertakan parameter kueri filter sebagai berikut:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations?filter=FILTER_EXPRESSION

Ganti kode berikut:

PROJECT_ID: ID project tempat pemesanan Anda berada.
ZONE: zona tempat pemesanan Anda berada.
FILTER_EXPRESSION: ekspresi filter.

Misalnya, untuk hanya melihat pemesanan dengan nama yang diawali dengan prefix dan berada di zona us-central1-a, buat permintaan GET berikut menggunakan nilai yang dienkode ke URL:

GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations?filter=name%7Eprefix%20AND%20zone=us-central1-a

Melihat detail pemesanan

Untuk melihat jumlah VM yang digunakan oleh setiap produk Google Cloud yang didukung dalam pemesanan, lihat detail pemesanan menggunakan konsol Google Cloud. Jika tidak, pilih salah satu opsi berikut:

Konsol

Di Konsol Google Cloud, buka halaman Pemesanan.

Buka Pemesanan
Di tab Pemesanan on demand (default), di kolom Nama, klik nama pemesanan yang ingin Anda lihat detailnya.

Halaman detail pemesanan akan terbuka. Jika ingin melihat kolom Jumlah yang dijamin, Anda harus melihat daftar pemesanan.

gcloud

Untuk melihat detail pemesanan, gunakan perintah gcloud compute reservations describe.

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

Ganti kode berikut:

RESERVATION_NAME: nama pemesanan yang ada.
ZONE: zona tempat pemesanan berada.

Outputnya mirip dengan hal berikut ini:

creationTimestamp: '2024-10-11T03:25:23.192-07:00'
id: '4488228526648280060'
kind: compute#reservation
name: r-01
selfLink: https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/r-01
shareSettings:
  shareType: LOCAL
specificReservation:
  assuredCount: '50'
  count: '50'
  inUseCount: '25'
  instanceProperties:
    machineType: n2-standard-2
specificReservationRequired: false
status: READY
zone: https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a

Go

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "cloud.google.com/go/compute/apiv1/computepb"
)

// Get certain reservation for given project and zone
func getReservation(w io.Writer, projectID, zone, reservationName string) (*computepb.Reservation, error) {
	// projectID := "your_project_id"
	// zone := "us-west3-a"
	// reservationName := "your_reservation_name"

	ctx := context.Background()
	reservationsClient, err := compute.NewReservationsRESTClient(ctx)
	if err != nil {
		return nil, err
	}
	defer reservationsClient.Close()

	req := &computepb.GetReservationRequest{
		Project:     projectID,
		Reservation: reservationName,
		Zone:        zone,
	}

	reservation, err := reservationsClient.Get(ctx, req)
	if err != nil {
		return nil, fmt.Errorf("unable to delete reservation: %w", err)
	}

	fmt.Fprintf(w, "Reservation: %s\n", reservation.GetName())

	return reservation, nil
}

Java

import com.google.cloud.compute.v1.Reservation;
import com.google.cloud.compute.v1.ReservationsClient;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeoutException;

public class GetReservation {

  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 in which you want to create the reservation.
    String zone = "us-central1-a";
    // Name of the reservation you want to create.
    String reservationName = "test-reservation-name";

    getReservation(projectId, reservationName, zone);
  }

  // Retrieve a reservation with the given name in the given zone.
  public static Reservation getReservation(
      String projectId, String reservationName, String zone)
      throws IOException {
    // 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 (ReservationsClient reservationsClient = ReservationsClient.create()) {

      // Get the reservation.
      Reservation reservation = reservationsClient.get(projectId, zone, reservationName);

      System.out.println("Reservation: " + reservation.getName());
      return reservation;
    }
  }
}

Node.js

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

// Instantiate a reservationsClient
const reservationsClient = new computeLib.ReservationsClient();

/**
 * TODO(developer): Update/uncomment these variables before running the sample.
 */
// The ID of the project where your reservation is located.
const projectId = await reservationsClient.getProjectId();
// The zone where your reservation is located.
const zone = 'us-central1-a';
// The name of the reservation to return.
// reservationName = 'reservation-01';

async function callGetReservation() {
  const requestedReservation = (
    await reservationsClient.get({
      project: projectId,
      zone,
      reservation: reservationName,
    })
  )[0];

  console.log(JSON.stringify(requestedReservation));
}

await callGetReservation();

Python

from google.cloud import compute_v1
from google.cloud.compute_v1.types import compute


def get_compute_reservation(
    project_id: str,
    zone: str = "us-central1-a",
    reservation_name="your-reservation-name",
) -> compute.Reservation:
    """
    Retrieves a compute reservation from GCP.
    Args:
        project_id (str): The ID of the Google Cloud project.
        zone (str): The zone of the reservation.
        reservation_name (str): The name of the reservation to retrieve.
    Returns:
        compute.Reservation: The reservation object retrieved from Google Cloud.
    """

    client = compute_v1.ReservationsClient()

    reservation = client.get(
        project=project_id,
        zone=zone,
        reservation=reservation_name,
    )

    print("Name: ", reservation.name)
    print("STATUS: ", reservation.status)
    print(reservation.specific_reservation)
    # Example response:
    # Name:  your-reservation-name
    # STATUS:  READY
    # count: 3
    # instance_properties {
    #   machine_type: "n1-standard-1"
    #   local_ssds {
    #     disk_size_gb: 375
    #     interface: "NVME"
    #   }
    # ...

    return reservation

REST

Untuk melihat detail pemesanan, buat permintaan GET ke metode reservations.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME

Ganti kode berikut:

PROJECT_ID: ID project tempat pemesanan berada.
ZONE: zona tempat pemesanan berada.
RESERVATION_NAME: nama pemesanan yang ada.

Outputnya mirip dengan hal berikut ini:

{
  "kind": "compute#reservation",
  "id": "4488228526648280060",
  "creationTimestamp": "2024-10-11T03:25:23.192-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/davide-experimental/zones/us-central1-a/reservations/r-01",
  "zone": "https://www.googleapis.com/compute/v1/projects/davide-experimental/zones/us-central1-a",
  "name": "r-01",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n2-standard-2"
    },
    "count": "50",
    "inUseCount": "25",
    "assuredCount": "50"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "shareSettings": {
    "shareType": "LOCAL"
  }
}

Menentukan jumlah VM yang dapat digunakan

Saat melihat reservasi, Anda dapat menentukan jumlah VM yang menggunakan reservasi, dan jumlah VM lainnya yang dapat menggunakannya, dengan memeriksa kolom berikut:

Jumlah terjamin (assuredCount): Jumlah VM yang secara fisik dipesan di zona pemesanan untuk project Anda, dan untuk project apa pun yang memiliki pemesanan bersama.
Jumlah total (count): Jumlah VM yang dipesan yang ditentukan dalam pemesanan. Jumlah ini harus cocok dengan jumlah yang dijamin.

Perhatian: Jika jumlah terjamin pemesanan lebih rendah dari jumlah totalnya, VM yang dipesan akan lebih sedikit dari yang diharapkan. Untuk mengatasi masalah ini, lihat Lebih sedikit VM yang tersedia untuk digunakan.
Komputer yang digunakan (inUseCount): Jumlah VM yang berjalan di project Anda, atau project yang berbagi reservasi bersama, yang menggunakan reservasi.

Misalnya, jika jumlah terjamin (assuredCount) dan jumlah total (count) adalah 50, dan jumlah VM yang menggunakan reservasi (inUseCount) adalah 25, berarti 25 VM menggunakan reservasi, dan Anda dapat membuat serta menjalankan 25 VM lagi sebelum reservasi digunakan sepenuhnya.

Langkah selanjutnya

Pelajari cara melampirkan pemesanan ke komitmen.
Pelajari cara menggunakan pemesanan.
Pelajari cara mengubah pemesanan.
Pelajari cara menghapus pemesanan.

Melihat pemesanan

Sebelum memulai

Console

gcloud

Terraform

Go

Java

Node.js

Python

REST

Peran yang diperlukan

Izin yang diperlukan

Melihat pemesanan

Melihat daftar pemesanan Anda

Konsol

gcloud

Go

Java

Node.js

Python

REST

Melihat detail pemesanan

Konsol

gcloud

Go

Java

Node.js

Python

REST

Menentukan jumlah VM yang dapat digunakan

Langkah selanjutnya