Mengelola revisi

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Pratinjau — Apigee API hub

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Setiap API di hub API dapat memiliki beberapa versi, dan setiap versi dapat memiliki spesifikasi yang dapat memiliki beberapa revisi. Tab History di halaman API mencantumkan setiap revisi spesifikasi di semua versi API.

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	Deployment memiliki histori revisi. Revisi deployment mewakili instance deployment tertentu secara tepat waktu dan dapat merujuk ke satu revisi spesifikasi atau lebih jika implementasi API yang disalurkan oleh deployment tersebut berubah. Spesifikasi memiliki histori revisi. Revisi spesifikasi mewakili instance spesifikasi berikutnya dan biasanya mewakili perubahan yang tidak menyebabkan gangguan pada konten spesifikasi. Dalam terminologi semver, revisi mungkin sesuai dengan versi minor atau poin.

Urutkan tabel revisi

Klik judul kolom Diperbarui untuk mengurutkan tabel.

Tambahkan revisi

Untuk menambahkan revisi:

1. Di konsol Google Cloud, buka halaman API hub.

   Buka hub API

   Halaman daftar APIs ditampilkan secara default.

2. Dari daftar API, klik baris API. Tab Ringkasan ditampilkan secara default.
3. Pilih tab History.
4. Klik Tambahkan revisi.
5. Klik Cari, lalu pilih dokumen deskripsi atau file zip.
6. Klik Buka.
7. Tentukan Detail:
   • Pilih Versi API.
   • Pilih jenis MIME. Jika Anda memilih Other, kolom teks akan ditampilkan dan Anda dapat menentukan jenis MIME secara manual.
   • Ketik Commit message (opsional).
   • Ketik Hash Commit (opsional).
8. Klik Simpan (atau Batal).

Catatan: Kolom ID di tabel History adalah ID revisi seperti yang muncul di registry API.

Lihat revisi

Buka Melihat atau mendownload spesifikasi

Hapus revisi

Untuk menghapus revisi:

1. Di Cloud Console, buka halaman API hub.

   Buka hub API

   Halaman daftar APIs ditampilkan secara default.

2. Dari daftar API, klik baris API. Tab Ringkasan ditampilkan secara default.
3. Pilih tab History.
4. Klik Hapus di samping revisi yang diinginkan.
5. Klik Hapus (atau Batalkan) saat diminta.