Memanggil Penyedia Jenis dalam Konfigurasi

Halaman ini menjelaskan cara menggunakan penyedia jenis yang telah Anda buat dengan Deployment Manager. 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 memperoleh daftar dan menggunakan jenis yang tersedia untuk project tersebut.

Anda juga dapat menambahkan project lain sebagai pelihat jenis sehingga mereka dapat mengakses jenis Anda. Baca Jenis Berbagi di Seluruh Project.

Menggunakan penyedia jenis

Untuk menggunakan jenis yang diekspos 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 Penemuan Google, [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 sesuai kebutuhan API pokok:

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

Langkah berikutnya