Memanggil Penyedia Jenis dalam Konfigurasi

Halaman ini menjelaskan cara menggunakan penyedia jenis yang telah Anda buat dengan Deployment Manager. Panduan 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 pengakses project dapat membuat dan menggunakan jenis yang tersedia untuk project tersebut.
  • Pembaca jenis bisa mendapatkan daftar dan penggunaan jenis yang tersedia untuk project tersebut.

Anda juga dapat menambahkan project lain sebagai penampil jenis agar 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 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 terus mengonfigurasi jenis seperti yang diwajibkan oleh API dasar:

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

Langkah selanjutnya