Halaman ini berlaku untuk Apigee dan Apigee Hybrid.
Versi adalah antarmuka API yang terdefinisi dengan baik guna memberikan stabilitas bagi aplikasi yang menggunakannya. Anda dapat memiliki beberapa versi API.
Sebuah API dapat memiliki beberapa deployment. Setiap deployment dapat memiliki versi yang berbeda.
Versi dikaitkan dengan API oleh pengguna yang memiliki izin edit saat mendaftarkan API, dan terkait dengan deployment saat menambahkan atau mengedit deployment.
Lihat skema Registry API
Berikut ini ilustrasi hubungan antara API hub API, versi, deployment, dan spesifikasi.
Referensi | Item | Deskripsi |
---|---|---|
Registry | Registry adalah kumpulan API yang berfungsi sebagai katalog API. | |
Versi | Sebuah API dapat memiliki beberapa versi. Versi harus sesuai dengan antarmuka stabil yang dapat digunakan klien untuk memanggil API. Salah satu versi ini dapat ditetapkan sebagai versi yang direkomendasikan. Dalam terminologi semver ,
adalah praktik terbaik untuk membuat versi menjadi versi utama. |
|
Deployment | API dapat memiliki beberapa deployment, misalnya, lingkungan atau region staging yang berbeda. Deployment adalah lokasi (alamat) tempat pengguna dapat mengakses API. Salah satu deployment ini bisa menjadi deployment yang direkomendasikan. | |
Spesifikasi | Direkomendasikan, tetapi tidak diwajibkan bahwa versi API dijelaskan oleh spesifikasi formal, sering kali menggunakan format spesifikasi API yang berbeda. Salah satu format spesifikasi ini dapat berupa format utama, yang menunjukkan bahwa spesifikasi lain untuk versi ini berasal dari spesifikasi tersebut. | |
Revisi |
|
Tambahkan versi
Untuk menambahkan versi:
Di konsol Google Cloud, buka halaman API hub.
Halaman daftar APIs ditampilkan secara default.
- Dari daftar API, klik baris API. Tab Overview ditampilkan secara default.
- Pilih tab Versions.
- Klik Tambahkan versi.
- Tentukan detail:
- Masukkan ID. Gunakan huruf kecil, angka, dan tanda hubung (-). Misalnya, v1, v1, 1, 1-0-0, dll.
- Masukkan Version. Gunakan karakter apa pun.
- Pilih tahap siklus proses API.
- Masa akhir yang diharapkan:
- Pilih Ekspektasi dari daftar.
- Jika Ekspektasi adalah Minimum date, tentukan Date.
- Jika Expectation adalah Confirmed date, tentukan Date.
- Klik Simpan (atau Batal).
Edit versi
Untuk mengedit versi:
Di Cloud Console, buka halaman API hub.
Halaman daftar APIs ditampilkan secara default.
- Dari daftar API, klik baris API. Tab Overview ditampilkan secara default.
- Pilih tab Versions.
- Klik Lainnya > Edit di samping versi yang diinginkan.
- Lakukan perubahan seperlunya.
- Klik Simpan (atau Batal)
Hapus versi
Untuk menghapus versi:
Di Cloud Console, buka halaman API hub.
Halaman daftar APIs ditampilkan secara default.
- Dari daftar API, klik baris API. Tab Overview ditampilkan secara default.
- Pilih tab Versions.
- Klik Lainnya > Hapus di samping versi yang diinginkan.
- Klik Hapus (atau Batalkan) saat diminta.