Melihat pemesanan

Dokumen ini menjelaskan cara melihat reservasi.

Sebelum memulai

Tinjau persyaratan dan batasan untuk pemesanan.
Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
Konsol

Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.
gcloud
1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
  gcloud init
  Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi baru dengan menjalankan gcloud components update.
2. Menetapkan region dan zona default.
REST

Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

Peran yang diperlukan

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

Peran yang telah ditentukan 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 yang telah ditetapkan sebelumnya.

Melihat pemesanan Anda

Anda hanya dapat melihat reservasi yang dibuat di project saat ini.

Hanya project pemilik yang dapat melihat pemesanan bersama. Jika Anda ingin melihat project yang diajak berbagi pemesanan bersama, lihat detail pemesanan.

Melihat daftar pemesanan Anda

Untuk melihat daftar reservasi Anda, gunakan Konsol Google Cloud, gcloud CLI, atau REST.

Konsol

Di Konsol Google Cloud, buka halaman Pemesanan.

Buka Pemesanan

Halaman Pemesanan akan muncul.

Dalam tabel, setiap baris menjelaskan pemesanan dan setiap kolom mendeskripsikan properti. Misalnya, kolom Mesin yang digunakan menjelaskan pemakaian dan total kapasitas setiap reservasi: nilai 25 (50) mewakili reservasi untuk 50 VM dengan 25 VM ini telah digunakan.

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 \
    --project=PROJECT_ID

Ganti PROJECT_ID dengan ID project tempat reservasi Anda berada.

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, tentukan flag --filter.

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

Ganti kode berikut:

FILTER_EXPRESSION: ekspresi filter.
PROJECT_ID: ID project tempat reservasi Anda berada.

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" \
    --project=example-project

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 reservasi Anda berada.
ZONE: zona tempat reservasi Anda berada.

Outputnya mirip dengan contoh berikut:

{
  "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",
      "minCpuPlatform": "Any CPU Platform",
    },
    "count": "100",
    "inUseCount": "0"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "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-k80",
          "acceleratorCount": 1
        }
      ],
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ]
    },
    "count": "50",
    "inUseCount": "25"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "kind": "compute#reservation"
}

Atau, untuk mempersempit daftar pemesanan menggunakan ekspresi filter, buat permintaan GET 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 reservasi Anda berada.
ZONE: zona tempat reservasi Anda.
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 detail reservasi, gunakan Konsol Google Cloud, gcloud CLI, atau REST.

Konsol

Untuk melihat detail reservasi, lakukan langkah berikut:

Di Konsol Google Cloud, buka halaman Pemesanan.

Buka Pemesanan

Halaman Pemesanan akan muncul.
Di kolom Nama, klik nama pemesanan yang ingin Anda deskripsikan.

Halaman detail pemesanan akan muncul. Untuk menentukan penggunaan pemesanan, lihat kolom Total Machines Reserved dan Machines used.

gcloud

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

gcloud compute reservations describe RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Ganti kode berikut:

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

Outputnya akan mirip dengan contoh berikut:

kind: compute#reservation
name: reservation-04
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04
specificReservation:
  count: '50'
  inUseCount: '25'
  instanceProperties:
    guestAccelerators:
    - acceleratorCount: 1
      acceleratorType: nvidia-tesla-k80
    localSsds:
    - diskSizeGb: '375'
      interface: SCSI
    machineType: n1-standard-2
    minCpuPlatform: Any CPU Platform
specificReservationRequired: false
status: READY
zone: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a

Untuk menentukan penggunaan pemesanan, lihat kolom count dan inUseCount. Dalam contoh ini, 50 VM direservasi dan 25 VM telah dipakai.

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 reservasi berada.
ZONE: zona tempat pemesanan berada.
RESERVATION_NAME: nama pemesanan yang ada.

Outputnya akan mirip dengan contoh berikut:

{
  "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-centra1-a",
  "name": "reservation-04",
  "specificReservationRequired": false,
  "status": "READY",
  "kind": "compute#reservation",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n1-standard-2",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-tesla-k80",
          "acceleratorCount": 1
        }
      ],
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ]
    },
    "count": "50",
    "inUseCount": "25"
  }
}

Untuk menentukan penggunaan pemesanan, lihat kolom count dan inUseCount. Dalam contoh ini, 50 VM direservasi dan 25 VM telah dipakai.

Langkah selanjutnya

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