Mengupload dan mendownload integrasi

Pengumuman: Application Integration kini tersedia untuk project Google Cloud Anda. Anda kini dapat menggunakan Apigee Integration dan Application Integration dalam project Google Cloud yang sama. Pelajari lebih lanjut

Anda dapat mendownload integrasi sebagai file JSON dan menyimpannya di sistem lokal. Akibatnya, seluruh integrasi Anda tersedia dalam sebuah file, yang dapat langsung Anda diupload dalam project integrasi lain tanpa modifikasi apa pun. Mengupload integrasi akan membuat versi baru integrasi dalam project tempat file diupload.

Memiliki integrasi yang menyeluruh dalam format {i>file<i} memberi Anda keuntungan sebagai berikut:

• Anda dapat menyalin integrasi dari satu project ke project lain tanpa banyak upaya.
• Anda dapat memperbarui file integrasi secara terprogram untuk perubahan berulang, seperti mengganti nama tugas atau secara dinamis memodifikasi nama variabel.

Catatan: Detail profil autentikasi yang dikonfigurasi untuk integrasi tidak tersedia di yang didownload. Setelah mengupload file integrasi, Anda harus mengonfigurasi ulang profil autentikasi di integrasi yang diupload.

Mendownload integrasi

Untuk mendownload integrasi, pilih salah satu opsi berikut:

Konsol

1. Di UI Apigee, pilih Organisasi Apigee Anda.
2. Klik Develop > Integrasi.
3. Pilih integrasi yang ada. Tindakan ini akan membuka integrasi di editor integrasi.
4. Klik dropdown Versi dan pilih versi yang ingin Anda download.
5. Di toolbar desainer, klik (menu Tindakan), lalu pilih Download.

   File INTEGRATION_NAME.json otomatis disimpan di folder download default browser web Anda.

Catatan: File JSON yang didownload akan memiliki struktur DownloadIntegrationVersionResponse . Jika Anda mengubah file JSON, pastikan file yang diubah tersebut mematuhi DownloadIntegrationVersionResponse email.

API

Untuk mendownload integrasi, kirimkan permintaan GET ke API berikut:

https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download

Contoh berikut menunjukkan cara mendownload versi integrasi tertentu:

curl -v -s \
-H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
-H "X-GFE-SSL: yes" \
-X GET "https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/products/apigee/integrations/test-integration/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11:download"

Catatan: Pada contoh sebelumnya, nomor versi integrasi adalah 0e90d453-5fcf-4aae-b164-2e8344d1ac11. Untuk mendapatkan versi integrasi, buka file yang diperlukan integrasi di UI dan salin string ID unik yang dibuat secara otomatis setelah ../integrations/integration/INTEGRATION_NAME/ dari URL.

Untuk informasi selengkapnya, lihat projects.locations.products.integrations.versions.download.

Mengupload integrasi

Mengupload integrasi akan membuat versi baru integrasi dalam project tempat file ketika image baru diupload. Misalnya, jika Anda memiliki integrasi berdasarkan nama IP-Test di versi 5, dan Anda mengupload file integrasi di IP-Test, versi 6 yang baru akan dibuat untuk integrasi tersebut.

Jika belum memiliki integrasi tempat Anda dapat mengupload file, Anda harus membuat integrasi baru terlebih dahulu, lalu menguploadnya. Dalam hal ini, integrasi baru yang Anda buat akan berada di versi 1 dan integrasi yang diupload akan berada di versi 2.

Jika Anda sudah memiliki integrasi yang ingin diupload, pilih salah satu opsi berikut:

Konsol

1. Di UI Apigee, pilih Organisasi Apigee Anda.
2. Klik Develop > Integrasi.
3. Pilih integrasi yang ada atau buat integrasi baru dengan mengklik Buat integrasi.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi dalam dialog Create Integration.
   2. Pilih region untuk integrasi.
      Catatan: Dropdown Region hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan wilayah baru untuk mengetahui informasi selengkapnya.
   3. Klik Create.

   Tindakan ini akan membuka integrasi di editor integrasi.

4. Di toolbar desainer, klik (menu Tindakan), lalu pilih Upload.
5. Di dialog file browser, pilih file yang ingin diupload, lalu klik Open.

   Versi baru integrasi dibuat menggunakan file yang diupload.

API

Untuk mengupload integrasi, kirimkan permintaan POST ke API berikut:

    https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION}:upload
    

Contoh berikut menunjukkan cara mengupload integrasi:

  curl -v -s -H "Content-Type: application/json"  -H "Authorization: Bearer $TOKEN"  \
  -X POST -d '{"content": 
    "{\"name\":\"projects/450954726404/locations/us-east1/products/apigee/integrations/test-workflow/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11\",
    \"origin\":\"UI\",
    \"snapshotNumber\":\"3\",
    \"updateTime\":\"2022-01-06T04:26:58.137Z\",
    \"lockHolder\":\"[e-mail]\",
    \"createTime\":\"2022-01-06T04:26:42.734Z\",
    \"lastModifierEmail\":\"[e-mail]\",
    \"state\":\"DRAFT\",
    \"triggerConfigs\":[{\"label\":\"API Trigger\",\"startTasks\":[{\"taskId\":\"1\"}],
    \"properties\":{\"Trigger name\":\"rj-test-workflow_API_1\"},\"triggerType\":\"API\",\"triggerNumber\":\"1\",\"triggerId\":\"api_trigger/rj-test-workflow_API_1\"}],\"taskConfigs\":[{\"task\":\"EmailTask\",\"taskId\":\"1\",\"taskExecutionStrategy\":\"WHEN_ALL_SUCCEED\",\"displayName\":\"Send Email\"}]}"}' 
    \https://integrations.googleapis.com/v1/projects/apigee-1/locations/us-east1/products/apigee/integrations/test-integration/versions:upload
  

Untuk informasi selengkapnya tentang API, lihat projects.locations.products.integrations.versions.upload.