ID region
REGION_ID
adalah kode singkat yang ditetapkan Google berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode negara dan provinsi yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020, REGION_ID.r
disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal tersebut, ID region bersifat opsional dalam URL.
Pelajari ID region lebih lanjut.
Gunakan App Engine Admin API untuk membuat aplikasi App Engine secara terprogram di project Google Cloud baru. Dengan menggunakan Admin API beserta Cloud Resource Manager API, Anda dapat mengelola project Google Cloud dan aplikasi App Engine secara terprogram.
Membuat aplikasi App Engine akan membuat resource Application
untuk project Google Cloud target di lokasi yang ditentukan.
Untuk membuat aplikasi App Engine secara manual di project Google Cloud, lihat topik Mengelola Project, Aplikasi, dan Penagihan untuk bahasa Anda baik dalam lingkungan standar atau lingkungan fleksibel.
Sebelum memulai
Anda harus memenuhi prasyarat berikut sebelum dapat membuat aplikasi App Engine menggunakan Admin API:
- Anda harus membuat atau sudah memiliki project Google Cloud.
- Anda harus menjadi pemilik project Google Cloud target.
- Anda harus dapat mengakses Admin API.
Sebelum akun pengguna lain dapat melakukan tugas pada aplikasi App Engine, pemilik project Google Cloud harus membuat resource Application
terlebih dahulu. Misalnya, Anda harus membuat aplikasi App Engine sebelum akun pengguna dengan peran App Engine Deployer dapat men-deploy aplikasi menggunakan akun layanan.
Untuk membuat project Google Cloud:
API
Untuk membuat project Google Cloud secara terprogram, Anda dapat menggunakan Cloud Resource Manager API. Lihat Membuat Project Baru untuk mengetahui detailnya. Lihat contoh singkatnya.
Konsol
Untuk membuat project Google Cloud menggunakan konsol Google Cloud:
gcloud
Setelah menginstal Google Cloud CLI, Anda dapat menjalankan perintah gcloud CLI berikut untuk membuat project Google Cloud:
gcloud projects create
Membuat project Google Cloud baru dengan Cloud Resource Manager API
Sebelum dapat mengirim permintaan dengan Google Cloud Resource Manager, Anda harus mengaktifkan API tersebut di project Google Cloud yang ingin Anda gunakan untuk membuat project Google Cloud lainnya. Mengaktifkan Cloud Resource Manager API di Konsol Google Cloud
Kirim permintaan HTTP
POST
menggunakan token akses Anda:POST https://cloudresourcemanager.googleapis.com/v1/projects/ { "projectId": "[MY_PROJECT_ID]", "name": "[MY_PROJECT_NAME]" }
Contoh perintah cURL:
curl -X POST -d "{ 'projectId': '[MY_PROJECT_ID]', 'name': '[MY_PROJECT_NAME]' }" -H "Content-Type: application/json" -H "Authorization: Bearer [MY_ACCESS_TOKEN]" https://cloudresourcemanager.googleapis.com/v1/projects/
Untuk informasi selengkapnya, lihat topik Membuat Project Baru dari Cloud Resource Manager.
Jika memilih untuk menggunakan project Google Cloud yang sudah ada, Anda harus memastikan bahwa project tersebut belum berisi resource Application
, karena project hanya mendukung satu aplikasi App Engine. Untuk memeriksa apakah
project Google Cloud Anda sudah berisi resource Application
, Anda dapat
menggunakan
metode apps.get
atau
menjalankan gcloud app describe
.
Membuat aplikasi App Engine
Untuk membuat aplikasi App Engine dengan Admin API:
Mengizinkan permintaan HTTP Anda, misalnya mendapatkan token akses.
Mengizinkan akses ke Admin API dapat dilakukan dengan alur OAuth yang berbeda, bergantung pada kebutuhan aplikasi API Anda. Untuk informasi selengkapnya, lihat Mengakses API.
Kirim permintaan
POST
HTTP menggunakan token akses Anda dan Admin API untuk membuat aplikasi App Engine.Anda menentukan resource
Application
dan menargetkan project Google Cloud dalam permintaan HTTPPOST
, misalnya:POST https://appengine.googleapis.com/v1/apps { "id": "[MY_PROJECT_ID]", "locationId": "[MY_APP_LOCATION]" }
Kolom permintaan HTTP yang diperlukan:
id
: Project ID dari project Google Cloud target tempat Anda ingin membuat aplikasi App Engine.locationId
: Nama region geografis tempat aplikasi App Engine berada seperti yang tercantum dalam App Engine Locations, misalnyaus-east1
.Untuk melihat daftar lengkap lokasi yang didukung, Anda dapat menggunakan metode
apps.locations.list
.Contoh: Izinkan dan jalankan contoh permintaan di APIs Explorer untuk melihat daftar lokasi yang didukung saat ini.
Lihat referensi
Application
untuk mengetahui daftar lengkap opsi kolom.Contoh perintah cURL:
curl -X POST -d "{ 'id': '[MY_PROJECT_ID]', 'locationId': '[MY_APP_LOCATION]' }" -H "Content-Type: application/json" -H "Authorization: Bearer [MY_ACCESS_TOKEN]" https://appengine.googleapis.com/v1/apps
Dengan keterangan:
[MY_PROJECT_ID]
adalah ID project target tempat Anda ingin membuat aplikasi App Engine.[MY_APP_LOCATION]
adalah lokasi tempat Anda ingin membuat aplikasi App Engine.[MY_ACCESS_TOKEN]
adalah token akses yang Anda dapatkan untuk mengizinkan permintaan HTTP Anda.
Contoh respons:
{ "name": "apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f", "metadata": { "@type": "type.googleapis.com/google.appengine.v1.OperationMetadataV1", "method": "google.appengine.v1.Applications.CreateApplication", "insertTime": "2016-10-03T20:48:02.099Z", "user": "me@example.com", "target": "apps/[MY_PROJECT_ID]" } }
Verifikasi bahwa aplikasi App Engine Anda telah dibuat:
Lihat status operasi pembuatan yang sebenarnya:
HTTP
POST
yang Anda gunakan di langkah sebelumnya akan menampilkan nama operasi diname
, yang digunakan bersama metodeGET
koleksiapps.operations
untuk memeriksa status operasi pembuatan.Misalnya, jika kolom
name
respons adalah:"name": "apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f"
Kemudian, kirim permintaan
GET
HTTP berikut:GET https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f
Contoh perintah cURL:
curl -X GET -H "Authorization: Bearer [MY_ACCESS_TOKEN]" https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f
Dengan
[MY_ACCESS_TOKEN]
sebagai token akses Anda dan[MY_PROJECT_ID]
sebagai ID project target.Contoh respons:
{ "name": "apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f", "metadata": { "@type": "type.googleapis.com/google.appengine.v1.OperationMetadataV1", "method": "google.appengine.v1.Applications.CreateApplication", "insertTime": "2016-10-03T20:48:02.099Z", "endTime": "2016-10-03T20:48:18.272Z", "user": "me@example.com", "target": "apps/[MY_PROJECT_ID]" }, "done": true, "response": { "@type": "type.googleapis.com/google.appengine.v1.Application", "id": "[MY_PROJECT_ID]", "locationId": "[MY_APP_LOCATION]" } }
Verifikasi bahwa aplikasi App Engine telah dibuat di project Anda:
Untuk melihat detail tentang versi, gunakan metode
GET
dari koleksiapps
. Anda harus menentukan project yang di-deploy dalam permintaanGET
HTTP, misalnya:GET https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]
Contoh perintah cURL:
curl -X GET -H "Authorization: Bearer [MY_ACCESS_TOKEN]" https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]/
Dengan
[MY_ACCESS_TOKEN]
sebagai token akses Anda dan[MY_PROJECT_ID]
sebagai ID project target.Contoh respons:
{ "name": "apps/[MY_PROJECT_ID]", "id": "[MY_PROJECT_ID]", "authDomain": "gmail.com", "locationId": "us-central", "defaultHostname": "[MY_PROJECT_ID].[REGION_ID].r.appspot.com", "defaultBucket": "[MY_PROJECT_ID].[REGION_ID].r.appspot.com" }
REGION_ID
adalah kode singkat yang Google tetapkan berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode provinsi dan negara yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020,REGION_ID.r
disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal ini, ID region bersifat opsional dalam URL.