Method: projects.locations.apps.importApp

Mengimpor aplikasi yang ditentukan.

Permintaan HTTP

POST https://ces.googleapis.com/v1beta/{parent=projects/*/locations/*}/apps:importApp

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Nama resource induk dengan lokasi aplikasi yang akan diimpor.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "displayName": string,
  "appId": string,
  "importOptions": {
    object (ImportAppRequest.ImportOptions)
  },
  "ignoreAppLock": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "gcsUri": string,
  "appContent": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "jsonPatchContent": string,
  "jsonPatchGcsUri": string
  // End of mutually exclusive fields.
}
Kolom
displayName

string

Opsional. Nama tampilan aplikasi yang akan diimpor. * Jika aplikasi dibuat saat diimpor, dan nama tampilannya ditentukan, aplikasi yang diimpor akan menggunakan nama tampilan ini. Jika konflik terdeteksi dengan aplikasi yang ada, stempel waktu akan ditambahkan ke nama tampilan agar unik. * Jika aplikasi adalah impor ulang, kolom ini tidak boleh disetel. Memberikan nama tampilan selama impor ulang akan menghasilkan error INVALID_ARGUMENT.
appId

string

Opsional. ID yang akan digunakan untuk aplikasi yang diimpor. * Jika tidak ditentukan, ID unik akan otomatis ditetapkan untuk aplikasi. * Jika tidak, aplikasi yang diimpor akan menggunakan ID ini sebagai komponen akhir dari nama resource-nya. Jika aplikasi dengan ID yang sama sudah ada di lokasi yang ditentukan dalam project, konten aplikasi yang ada akan diganti.
importOptions

object (ImportAppRequest.ImportOptions)

Opsional. Opsi yang mengatur proses impor untuk aplikasi.
ignoreAppLock

boolean

Opsional. Flag untuk mengganti kunci aplikasi selama impor. Jika disetel ke benar (true), proses impor akan mengabaikan kunci aplikasi.
Aplikasi yang akan diimpor. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
gcsUri

string

URI Google Cloud Storage tempat aplikasi akan diimpor. Format URI ini harus gs://<bucket-name>/<object-name>.
appContent

string (bytes format)

Byte mentah yang merepresentasikan file ZIP terkompresi dengan struktur folder aplikasi.

String berenkode base64.
Akhir kolom yang saling eksklusif.
Patch JSON yang akan diterapkan ke aplikasi yang diimpor. Berikut adalah daftar kolom yang saling eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
jsonPatchContent

string

Opsional. Membuat patch konten sebagai string JSON.
jsonPatchGcsUri

string

Opsional. Cloud Storage URI yang mengarah ke file JSON yang berisi patch.
Akhir kolom yang saling eksklusif.

Isi respons

Jika berhasil, isi respons akan memuat instance Operation.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource parent:

  • ces.apps.import

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.

ImportAppRequest.ImportOptions

Opsi konfigurasi untuk proses impor aplikasi. Opsi ini mengontrol cara kerja impor, terutama saat terjadi konflik dengan data aplikasi yang ada.

Representasi JSON 
{
  "conflictResolutionStrategy": enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy),
  "validateOnly": boolean
}
Kolom
conflictResolutionStrategy

enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy)

Opsional. Strategi yang akan digunakan saat menyelesaikan konflik selama impor.
validateOnly

boolean

Opsional. Tanda untuk menjalankan proses impor uji coba. Jika disetel ke benar (true), proses impor hanya akan melakukan validasi dan tidak akan membuat perubahan apa pun pada aplikasi yang ada atau membuat aplikasi baru.

ImportAppRequest.ImportOptions.ConflictResolutionStrategy

Menentukan strategi untuk menangani konflik saat aplikasi dengan ID yang sama sudah ada, atau saat resource yang diimpor (seperti Agen, Alat, dll.) memiliki nama tampilan yang sama dengan resource yang ada dalam aplikasi tersebut.

Enum
CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED Strategi resolusi konflik tidak ditentukan.
REPLACE Mengganti data yang ada dengan data yang diimpor. Jika aplikasi dengan appId yang sama sudah ada, kontennya akan diperbarui berdasarkan aplikasi yang diimpor. - Resource (Aplikasi, Agen, Alat, Contoh, Batas Keamanan, Kumpulan Alat) di aplikasi yang diimpor yang memiliki nama tampilan yang sama dengan resource yang ada akan menggantikan resource yang ada. - Resource yang diimpor dengan nama tampilan baru akan dibuat. - Resource yang ada yang tidak memiliki nama tampilan yang cocok di aplikasi yang diimpor tidak akan diubah.
OVERWRITE Menimpa data yang ada dengan data yang diimpor. Jika aplikasi dengan appId yang sama sudah ada, kontennya akan ditimpa dengan aplikasi yang diimpor. - Resource yang ada (Agen, Alat, Contoh, Batas, Kumpulan Alat) di aplikasi akan dihapus. - Resource yang diimpor akan dibuat sebagai resource baru.