Ada berbagai cara untuk mengautentikasi ke Compute Engine, bergantung pada cara Anda mengakses
API. Untuk informasi selengkapnya, lihat
Mengautentikasi ke Compute Engine.
Mempelajari REST
Ada dua cara untuk memanggil API:
- Mengirim permintaan HTTP dan mengurai respons.
- Menggunakan library klien.
Jika memutuskan untuk tidak menggunakan library klien, Anda harus memahami dasar-dasar REST.
Dasar-dasar REST
REST adalah gaya arsitektur software yang memberikan pendekatan yang praktis dan konsisten untuk meminta dan memodifikasi data.
Istilah REST adalah singkatan dari "Representational State Transfer". Dalam konteks Google API, REST merujuk pada penggunaan kata kerja HTTP untuk mengambil dan memodifikasi representasi data yang disimpan oleh Google.
Dalam sistem RESTful, resource disimpan di penyimpanan data; klien mengirim permintaan agar server melakukan tindakan tertentu (seperti membuat, mengambil, memperbarui, atau menghapus resource), dan server melakukan tindakan dan mengirim respons, sering kali dalam bentuk representasi resource yang ditentukan.
Di RESTful API Google, klien menentukan tindakan menggunakan kata kerja HTTP seperti POST, GET, PUT, atau DELETE. Kata kerja ini menentukan resource berdasarkan URI yang unik secara global untuk form berikut:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Karena semua resource API memiliki URI unik yang dapat diakses HTTP, REST memungkinkan caching data dan dioptimalkan untuk berfungsi dengan infrastruktur terdistribusi web.
Anda dapat memperoleh manfaat dari definisi metode dalam dokumentasi standar HTTP 1.1; dokumentasi tersebut menyertakan spesifikasi untuk GET, POST, PUT, dan DELETE.
REST di Compute Engine API
Operasi Compute Engine API dipetakan langsung ke kata kerja REST HTTP.
Compute Engine API menggunakan format berikut untuk URI:
https://www.googleapis.com/compute/API_VERSION/RESOURCE_PATH
URI berisi nilai-nilai berikut:
API_VERSION: versi API yang ingin Anda gunakan, yang sesuai dengan tahap peluncuran resource Compute Engine sebagai berikut:
- Untuk resource di GA:
v1
- Untuk resource dalam Pratinjau Publik:
beta
- Untuk resource dalam Pratinjau Pribadi:
alpha
RESOURCE_PATH: jalur ke resource Compute Engine
tertentu—misalnya, projects/example-project/aggregated/instances. Untuk
melihat resource yang tersedia untuk setiap versi API, lihat hal berikut:
Jika Anda ingin menyertakan parameter kueri, sertakan parameter tersebut dalam URI setelah tanda tanya
(?):
https://www.googleapis.com/compute/API_VERSION/RESOURCE_PATH?QUERY_PARAMETERS
Dalam URI, QUERY_PARAMETERS adalah daftar parameter kueri, yang dipisahkan dengan ampersand
(&)—misalnya,
format=json&filter=zone=us-central1-a.
