Halaman ini diterjemahkan oleh Cloud Translation API.

Mengupload dan mendownload integrasi

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

Memiliki seluruh integrasi dalam format file memberi Anda keuntungan berikut:

Anda dapat menyalin integrasi dari satu project ke project lain tanpa perlu bersusah payah.
Anda dapat memperbarui file integrasi secara terprogram untuk perubahan berulang, seperti mengganti nama tugas atau mengubah nama variabel secara dinamis.

Mendownload integrasi

Untuk mendownload integrasi, lakukan langkah-langkah berikut:

Di UI Apigee, pilih Organisasi Apigee.
Klik Develop > Integrations.
Pilih integrasi yang ada. Tindakan ini akan membuka integrasi di editor integrasi.
Klik dropdown Versions, lalu pilih versi yang ingin Anda download.
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 jenis DownloadIntegrationVersionResponse. Jika Anda memodifikasi file JSON, pastikan file yang diubah mematuhi struktur DownloadIntegrationVersionResponse.

Mengupload integrasi

Untuk mengupload integrasi, lakukan langkah-langkah berikut:

Di UI Apigee, pilih Organisasi Apigee.
Klik Develop > Integrations.
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 Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan wilayah baru untuk informasi selengkapnya.
3. Klik Create.
Tindakan ini akan membuka integrasi di editor integrasi.
Di toolbar desainer, klik (menu Tindakan), lalu pilih Upload.
Di dialog file browser, pilih file yang ingin diupload, lalu klik Open.
Versi baru integrasi dibuat menggunakan file yang diupload.

Download dan upload menggunakan API

Anda dapat menggunakan API integrasi untuk mengupload atau mendownload integrasi.

Download integrasi menggunakan API

Untuk mendownload integrasi, berikan 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 versi integrasi yang diperlukan di UI dan salin string ID unik yang dibuat otomatis setelah ../integrations/integration/INTEGRATION_NAME/ dari URL.

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

Upload integrasi menggunakan 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\":\"abc@test.com\",
  \"createTime\":\"2022-01-06T04:26:42.734Z\",
  \"lastModifierEmail\":\"abc@test.com\",
  \"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.

Pertimbangan

Ketika menggunakan fitur upload atau download, pertimbangkan hal-hal berikut:

Mengupload integrasi akan membuat versi baru integrasi. Misalnya, jika Anda memiliki integrasi dengan nama IP-Test pada versi 5, dan Anda mengupload file integrasi dalam IP-Test, versi baru 6 akan dibuat untuk integrasi tersebut.
Jika belum memiliki integrasi yang memungkinkan Anda mengupload file, Anda harus membuat integrasi baru terlebih dahulu, lalu menguploadnya. Dalam hal ini, integrasi baru yang Anda buat akan menggunakan versi 1 dan integrasi yang diupload akan berada di versi 2.
Detail profil autentikasi yang dikonfigurasi untuk integrasi tidak akan tersedia di file yang didownload. Setelah mengupload file, Anda harus mengonfigurasi ulang profil autentikasi dalam integrasi yang diupload.