Memanggil Penyedia Jenis dalam Konfigurasi

Halaman ini menjelaskan cara menggunakan penyedia jenis yang telah Anda buat dengan Deployment Manager. Artikel ini tidak menjelaskan cara membuat penyedia jenis. Untuk mempelajari cara membuat penyedia jenis, baca Membuat Penyedia Jenis.

Sebelum memulai

  • Jika Anda ingin menggunakan contoh command line dalam panduan ini, instal alat command line`gcloud`.
  • Jika Anda ingin menggunakan contoh API dalam panduan ini, siapkan akses API.

Mengakses penyedia jenis

Penyedia jenis adalah resource per project dan dapat diakses sesuai dengan izin yang dijelaskan dalam dokumentasi Kontrol Akses. Definisinya yaitu:

  • Editor dan pelihat project dapat membuat dan menggunakan jenis yang tersedia untuk project tersebut.
  • Pelihat jenis dapat mendapatkan daftar dan menggunakan jenis yang tersedia untuk project tersebut.

Anda juga dapat menambahkan project lain sebagai penampil jenis agar dapat mengakses jenis Anda. Baca Berbagi Jenis di Seluruh Project.

Menggunakan penyedia jenis

Untuk menggunakan jenis yang ditampilkan oleh penyedia jenis dalam konfigurasi Anda, gunakan sintaksis berikut:

type: [PROJECT_ID]/[TYPE_NAME]:[COLLECTION]

  • Jika API ini didukung oleh spesifikasi OpenAPI, [COLLECTION] akan menjadi ID REST untuk jalur ke resource. Contoh:

    type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people

  • Jika API didukung oleh dokumen Google Discovery, [COLLECTION] adalah jalur resource yang mengarah ke resource yang Anda inginkan di API. Misalnya, untuk membuat kunci akun layanan, koleksinya adalah:

    type: my-project/example-type-provider:projects.serviceAccounts.keys

Sekarang Anda dapat melanjutkan konfigurasi jenis seperti yang diperlukan oleh API yang mendasarinya:

resources:
- name: Jane
  type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
  properties:
  - displayName: Jane
    email: jane@example.com
    ...

Langkah selanjutnya