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
-
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init
- 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.
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init
-
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.
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.
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.