Instance adalah virtual machine tempat project API dan layanan terkait Anda disimpan. Instance sesuai dengan wilayah.
Biasanya, Anda memulai dengan satu instance dan menambahkan instance baru saat organisasi Anda berkembang ke lebih banyak region. Bagian ini menjelaskan cara:
Untuk membuat instance baru, Anda dapat menggunakan Instances API atau UI Apigee. Setiap instance memerlukan:
kunci enkripsi disknya sendiri untuk jaringan. Apigee merekomendasikan agar Anda
juga membuat key ring terpisah untuk instance baru. Untuk mengetahui informasi selengkapnya, lihat
Tentang kunci enkripsi Apigee.
rentang CIDR /22 dan /28 yang tidak tumpang-tindih untuk peering jaringan. Rentang tidak dapat
dibagikan antar-instance.
Apigee di Konsol Cloud
Untuk membuat instance baru di Apigee di konsol Cloud:
Di Google Cloud konsol, buka halaman Management > Instances.
Panel Instances menampilkan
daftar instance yang ada.
Klik + Create. Mungkin ada penundaan saat UI menentukan apakah
organisasi Anda memiliki hak yang tepat untuk membuat instance baru.
Halaman Create new instance akan ditampilkan.
Masukkan detail tentang instance baru Anda di kolom:
Kolom
Diperlukan
Deskripsi
Runtime hosting location
Wajib
Pilih region tempat Anda ingin membuat instance baru. Anda tidak dapat membuat instance baru di region yang sudah memiliki instance. Untuk mengetahui informasi selengkapnya tentang cara bekerja
dengan beberapa region, lihat Menggunakan beberapa region.
Name
Wajib
Masukkan ID instance baru.
Nilai defaultnya adalah nama region hosting runtime
yang Anda pilih, tetapi Anda dapat mengubahnya menjadi nama bermakna apa pun yang Anda inginkan, selama
Anda mengikuti aturan penamaan:
Panjang minimum 2.
Panjang maksimum 32.
Hanya gunakan huruf kecil, angka, dan tanda hubung (mengikuti pola
/^[a-z0-9\-]+$/).
Harus diawali dengan huruf; tidak memiliki angka atau tanda hubung di depannya.
Harus diakhiri dengan angka atau huruf; tidak memiliki tanda hubung di akhir.
Harus unik di seluruh organisasi Anda.
IP range allocation
Wajib
Tentukan cara Anda ingin mengalokasikan rentang IP. Pilih salah satu opsi berikut:
Otomatis (Direkomendasikan) - Apigee memilih rentang CIDR yang tersedia dengan
ukuran awalan /22. Anda tidak perlu melakukan tindakan lebih lanjut.
Kustom - Dalam kasus penggunaan lanjutan, Anda mungkin perlu menentukan secara persis rentang IP yang ingin digunakan Apigee. Untuk kasus ini, Anda menentukan rentang IP kustom, dan rentang IP tersebut harus memiliki ukuran awalan /22. Rentang
harus tersedia sebagai bagian dari koneksi pribadi antara project Anda dan Apigee.
Disk encryption key
Wajib
Di bagian Disk encryption key, pilih kunci enkripsi yang dikelola pelanggan. Jika kunci sudah ada,
Anda dapat
memilihnya. Wizard mencantumkan semua kunci di lokasi yang sama dengan region hosting runtime di semua key ring. Jika kunci tidak ada, atau jika Anda tidak ingin menggunakan kunci yang ada, Anda dapat membuat kunci baru dari dalam wizard. Untuk membuat kunci:
Klik Create key.
Pilih key ring, atau jika tidak ada, aktifkan Buat key ring dan
masukkan nama key ring dan pilih lokasi key ring. Nama key ring dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Key ring tidak dapat diganti namanya atau dihapus.
Klik Lanjutkan.
Buat kunci. Masukkan nama dan tingkat perlindungan.
Perhatikan bahwa nama kunci dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Kunci tidak dapat diganti namanya atau dihapus. Untuk tingkat perlindungan, Software adalah pilihan yang
baik. Default ini sama dengan yang digunakan oleh Cloud KMS; namun, Anda dapat mengubahnya jika
menginginkannya.
Klik Lanjutkan dan tinjau pilihan Anda.
Klik Buat.
Klik Grant untuk memberikan izin akun layanan untuk mengenkripsi/mendekripsi dengan
kunci yang dipilih.
Environments
Opsional
Pilih lingkungan yang ingin Anda lampirkan ke instance ini. Untuk melakukannya, klik
menu drop-down Lingkungan, lalu centang kotak di samping
lingkungan yang ingin Anda lampirkan. Anda dapat melakukannya
untuk sebanyak mungkin lingkungan yang Anda inginkan. Kemudian, klik OK.
Perhatikan bahwa lingkungan semua instance dihitung dalam jumlah total
lingkungan yang dapat Anda alokasikan. Untuk mengetahui informasi selengkapnya, lihat
Tentang lingkungan dan grup lingkungan.
Klik Tambahkan project yang diterima untuk memilih satu atau beberapa project Cloud. Project yang dipilih dapat terhubung secara pribadi ke lampiran layanan untuk instance Anda.
Secara default, project yang terkait dengan organisasi Apigee Anda disertakan dalam
daftar ini.
Enable logging
Opsional
Klik tombol Enable logging untuk mengaktifkan log akses masuk Cloud Logging untuk instance.
Fitur ini memungkinkan Anda melihat log yang dihasilkan oleh gateway ingress
di infrastruktur Apigee, seperti Load Balancer Aplikasi eksternal atau gateway Anthos,
untuk membantu memecahkan masalah panggilan API Apigee.
Pilih kode respons HTTP dari kotak kode respons untuk bertindak sebagai filter
untuk log akses ingress.
Jika Anda ingin menyertakan semua log, terlepas dari kode respons HTTP, pilih None (all HTTP responses).
Untuk membuat filter kustom, pilih Custom dan masukkan filter dalam format berikut:
status_code > XX && status code <= YY
Contoh:
status_code >= 500 && status_code < 504
Jika organisasi Anda tidak dapat membuat instance baru, hubungi Tim Penjualan Apigee.
Klik Buat.
Apigee memulai operasi yang berjalan lama yang dapat memerlukan waktu 20 menit
atau lebih untuk diselesaikan. Setelah selesai, instance baru akan muncul dalam daftar instance di
UI Instances.
Apigee API
Jika Apigee disediakan tanpa peering VPC, lihat Membuat instance runtime dalam langkah-langkah penyediaan non-peering VPC.
Jika Apigee disediakan dengan peering VPC, lihat Membuat instance runtime dalam langkah-langkah penyediaan peering VPC.
Melampirkan atau menghapus lingkungan dari instance
Saat membuat lingkungan menggunakan UI Apigee di konsol Google Cloud , Anda memiliki opsi untuk menetapkan lingkungan ke instance yang ada. Untuk mengetahui informasi selengkapnya, lihat
Membuat lingkungan baru di UI.
Jika Anda tidak melampirkan lingkungan ke instance selama pembuatan lingkungan, atau Anda ingin menghapus lingkungan dari instance, Anda dapat mengikuti langkah-langkah berikut. Untuk mengetahui informasi selengkapnya tentang lingkungan dan instance, lihat Lingkungan dan instance.
Untuk melampirkan atau menghapus lingkungan dari instance menggunakan konsol Apigee di Cloud:
Di Google Cloud konsol, buka halaman Management > Instances.
Di halaman Edit Instance, klik kolom Environments (opsional) dan
pilih lingkungan yang ingin Anda
lampirkan ke instance, atau batalkan pilihan lingkungan yang ingin Anda hapus.
Klik Oke.
Klik Simpan untuk menyimpan perubahan.
Selain menggunakan UI, Anda juga dapat melampirkan lingkungan ke instance menggunakan
API pembuatan lampiran instance. Sebagai contoh, lihat
Membuat
lingkungan dalam dokumentasi penyediaan command line.
Mengedit daftar project yang diterima
Anda dapat menambahkan atau menghapus project dari daftar Project yang diterima:
Di Google Cloud konsol, buka halaman Management > Instances.
Di bagian Accepted projects pada halaman Edit Instance, klik
delete
Hapus di samping project untuk menghapusnya.
Untuk menambahkan project, klik Tambahkan project yang diterima, lalu masukkan ID project yang akan ditambahkan.
Klik Simpan untuk menyimpan perubahan.
Mengaktifkan atau menonaktifkan log akses ingress untuk instance
Setelah membuat instance, Anda dapat mengaktifkan dan menonaktifkan log akses masuk Cloud Logging untuk instance:
Di Google Cloud konsol, buka halaman Management > Instances.
halaman Edit Instance, klik tombol Enable logging untuk menonaktifkan fitur.
Klik Simpan untuk menyimpan perubahan.
Menghapus instance
Anda dapat menggunakan UI Apigee untuk menghapus instance yang ada, seperti yang dijelaskan di bagian ini.
Atau, Anda dapat menghapus instance menggunakan Instances API.
Hanya satu instance Apigee yang dapat berada di region Google Cloud tertentu. Saat Anda menghapus instance,
instance tersebut akan dihapus sepenuhnya dari regionnya. Lihat juga
penginstalan multi-region.
Peringatan: Saat Anda menghapus instance, semua data yang terkait
dengan instance tersebut akan hilang. Langkah ini tidak dapat diurungkan. Namun, perhatikan bahwa jika Anda memiliki
beberapa instance, seperti dalam penginstalan multi-region, data Anda hanya akan hilang
jika Anda menghapus semua instance. Sebelum menghapus instance terakhir, pastikan untuk mengekstrak
dan mencadangkan data yang tidak ingin Anda hilangkan.
Data berikut disimpan dalam instance Apigee dan akan dihapus jika Anda menghapus instance:
Jenis data
Deskripsi
Sistem pengelolaan kunci (KMS)
Data KMS mencakup produk API, developer, aplikasi developer, token OAuth
(termasuk token akses, token refresh, dan kode otorisasi), serta kunci API.
Gunakan kebijakan AccessEntity atau Apigee API terkait untuk
mengambil data yang ingin Anda simpan.
Peta nilai kunci (KVM)
Data apa pun yang dapat dibuat atau dikelola dengan kebijakan KVM. Lihat
Mengambil KVM.
Kuota
Definisi kuota, bucket, dan penghitung.
Cache lingkungan
Semua data yang di-cache.
Untuk menghapus instance Apigee menggunakan UI Apigee di konsol Cloud:
Di Google Cloud konsol, buka halaman Management > Instances.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-05 UTC."],[[["\u003cp\u003eThis page outlines how to manage Apigee instances, which are virtual machines storing your API project and services, and it's important to note that this content does not apply to Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eYou can create a new instance via the Apigee UI or Instances API, each requiring a unique disk encryption key and non-overlapping CIDR ranges for network peering.\u003c/p\u003e\n"],["\u003cp\u003eInstances can have environments attached or removed, and these associations can be managed through the Apigee UI or the Instances attachment create API.\u003c/p\u003e\n"],["\u003cp\u003eThe list of Cloud projects that can connect to an instance can be managed by adding or removing projects in the "Accepted projects" list, and this can be done through the UI.\u003c/p\u003e\n"],["\u003cp\u003eDeleting an instance will remove all associated data, including KMS, KVM, quota data, and environment cache, and it will also remove the association for any attached environments.\u003c/p\u003e\n"]]],[],null,["# Managing instances\n\n*This page\napplies to **Apigee** , but not to **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nAn [instance](/apigee/docs/api-platform/get-started/create-instance) is a virtual\nmachine where your API project and related services are stored. Instances correspond to regions.\nTypically, you start with a single instance and add new instances as your organization expands\ninto more regions. This section explains how to:\n\n- [Create a new instance](#create-a-new-instance).\n- [Attach or remove environments from an instance](#add-envs).\n- [Edit the accepted projects list](#accepted-projects)\n- [Enable or disable ingress access logs for an instance](#enable-logging).\n- [Delete an instance](#delete-an-instance).\n\n| **Note:** Evaluation organizations can only have one instance (region).\n| To expand beyond a single region and instance, you must have a\n| [paid organization](/apigee/docs/api-platform/fundamentals/organization-structure#org_types). Your subscription entitlements limit the number of instances (regions) you can add.\n| You can add more instances (regions) by purchasing an Org Pack. For more information,\n| see [Subscription entitlements](/apigee/docs/api-platform/reference/subscription-entitlements).\n\nCreate a new instance\n---------------------\n\nTo create a new instance, you can use the [Instances API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.instances) or the Apigee UI. Each instance requires:\n\n- its own disk encryption key for the network. Apigee recommends that you also create a separate key ring for the new instance. For more information, see [About the Apigee encryption keys](/apigee/docs/api-platform/security/encryption-keys).\n- its own non-overlapping /22 and /28 CIDR ranges for network peering. The ranges cannot be shared between instances.\n\n**Note:** You must have a paid organization to add an instance. Evaluation accounts are limited to one region or instance and cannot be expanded to a second. Your entitlements limit the number of regions you can add. For more information, see [Apigee Pricing](https://cloud.google.com/apigee/pricing). \n\n### Apigee in Cloud console\n\n| **Important:** This topic only applies to organizations that were created with VPC peering enabled. See also [Apigee networking options](/apigee/docs/api-platform/get-started/networking-options).\n\nTo create a new instance in Apigee in Cloud console:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n The **Instances** pane displays a list of existing instances.\n\n \u003cbr /\u003e\n\n2. Click **+ Create**. There might be a delay while the UI determines if\n your org has the proper entitlements to create a new instance.\n\n The **Create new instance** page displays.\n3. Enter details about your new instance in the fields:\n\n If your org cannot create a new instance, contact [Apigee Sales](https://pages.apigee.com/contact-sales-reg.html).\n4. Click **Create**.\n\n Apigee begins a long-running operation that can take 20 minutes\n or more to complete. When it's done, the new instance will appear in the list of instances in\n the **Instances** UI.\n\n### Apigee API\n\nIf Apigee was provisioned without VPC-peering, see [Create a runtime instance](/apigee/docs/api-platform/get-started/install-cli-non-peered#runtime-instance) in the non-VPC peering provisioning steps.\n\nIf Apigee was provisioned with VPC-peering, see [Create a runtime instance](/apigee/docs/api-platform/get-started/install-cli#runtime-instance) in the VPC peering provisioning steps.\n\nAttach or remove environments from an instance\n----------------------------------------------\n\nWhen you create an environment using the Apigee UI in Google Cloud console, you have the option to assign the\nenvironment to an existing instance. For more information, see [Creating a new environment in the UI](/apigee/docs/api-platform/fundamentals/environments-working-with#creating-a-new-environment-in-the-ui).\n\nIf you did not attach your environment to an instance during environment creation, or you want to remove an\nenvironment from an instance, you can follow these steps. For more information on environments and instances, see [Environments and instances](/apigee/docs/api-platform/fundamentals/environments-working-with#environments-and-instances).\n\nTo attach or remove an environment from an instance using Apigee in Cloud console:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to edit.\n\n3. In the **Instance details** page, click **Edit**.\n4. In the **Edit Instance** page, click the **Environments (optional)** field and select the environment you want to attach to the instance, or deselect the environment you want to remove.\n5. Click **OK**.\n6. Click **Save** to save your changes.\n\nIn addition to using the UI, you can also attach environments to an instance using the\n[Instances attachment create API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.instances.attachments/create). For an example, see\n[Create\nan environment](/apigee/docs/api-platform/get-started/install-cli#create-environment) in the command-line provisioning documentation.\n\nEdit the accepted projects list\n-------------------------------\n\nYou can add or remove projects from the **Accepted projects** list:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to edit.\n\n3. In the **Instance details** page, click **Edit**.\n4. In the **Accepted projects** section of the **Edit Instance** page, click delete **Delete** next to a project to remove it. To add a project click **Add accepted project** and enter the ID of the project to add.\n5. Click **Save** to save your changes.\n\nEnable or disable ingress access logs for an instance\n-----------------------------------------------------\n\nAfter you create an instance, you can enable and disable Cloud Logging ingress access logs for the instance:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to edit.\n\n3. In the **Instance details** page, click **Edit**.\n4. the **Edit Instance** page, click the **Enable logging** toggle to disable the feature.\n5. Click **Save** to save your changes.\n\nDelete an instance\n------------------\n\nYou can use the Apigee UI to delete an existing instance, as described in this section.\nAlternatively, you can delete an instance using the [Instances API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.instances).\n\nOnly one Apigee instance can be in a given Google Cloud region. When you delete an instance,\nit is completely removed from its region. See also\n[multi-region installation](/apigee/docs/api-platform/system-administration/multi-region).\n**Warning:** When you delete an instance, all data associated with that instance is lost. This step cannot be undone. Note, however, that if you have multiple instances, such as in a multi-region installation, your data will be lost only if you delete all of the instances. Before deleting the last instance, be sure to extract and back up any data you do not wish to lose. **Note:** Deleting an instance removes the association for any attached environments. You may need to move any attached environments to new instances by [Attaching and removing environments from an instance](#add-envs) before deleting the instance. All environments must be attached to at least one instance for their proxies to function.\n\nThe following data is stored in an Apigee instance and will be deleted if you delete\nthe instance:\n\nTo delete an Apigee instance using the Apigee UI in Cloud console:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to delete.\n3. In the **Instance Details** page, click **Delete**."]]
