Ringkasan Setelan Resource

Anda dapat menggunakan Setelan Resource untuk mengonfigurasi setelan secara terpusat untuk project, folder, dan organisasi Google Cloud Anda. Setelan ini diwariskan oleh turunannya dalam hierarki resource. Setiap setelan dibuat dan dikelola oleh Google.

Setelan Resource

Setelan Resource mewakili dimensi resource atau layanan Google Cloud yang dapat Anda konfigurasi. Misalnya, setelan lokasi pembuatan bucket Cloud Storage dapat menentukan lokasi default tempat resource bucket baru dibuat.

Setiap setelan resource memiliki properti utama berikut:

  • Name: ID unik secara global untuk setelan yang digunakan saat mengonfigurasi nilai untuk setelan.

  • Metadata: informasi yang dikelola Google tentang setelan resource. Metadata untuk setelan resource mencakup kolom berikut:

    • Jenis data: jenis nilai yang dapat dikonfigurasi untuk setelan ini. Jenis data yang mungkin mencakup boolean, string, kumpulan string, dan enum.

    • Nilai default: nilai default setelan yang dikelola Google jika tidak ada nilai lain yang ditetapkan dalam organisasi Anda.

    • Hanya baca: flag yang menunjukkan apakah Google telah membuat setelan ini hanya baca. Jika setelan resource bersifat hanya baca, nilai untuk setelan ini tidak dapat diubah. Setelan hanya dibuat hanya baca untuk migrasi dan penghentian. Google memberikan peringatan sebelum membuat perubahan pada tanda ini.

  • Nilai lokal: nilai spesifik setelan yang terkait dengan resource.

  • Nilai efektif: nilai setelan setelah mengevaluasi setelan resource yang diwarisi dari hierarki resource.

Anda memerlukan peran Identity and Access Management Resource Settings Viewer atau Resource Settings Administrator untuk melihat daftar setelan yang tersedia untuk digunakan di organisasi, folder, atau project tertentu. Untuk mengetahui detail selengkapnya tentang peran ini, lihat Izin yang diperlukan.

Ketersediaan setelan resource dapat berbeda di antara organisasi, bergantung pada status rilis setelan resource.

Contoh setelan resource

Berikut adalah contoh tampilan setelan resource:

# Setting
{
  "name": "net-preferredDnsServers",
  "metadata": {
    "displayName": "Preferred DNS Servers",
    "description": "The DNS servers to be used by VMs associated with this resource.",
    "read_only": false,
    "data_type" : "STRING_SET",
    "default_value" : {
      "string_set_value" : {
        "values" : [ "8.8.8.8" ],
      }
    }
  }
}

Penamaan

Setelan resource memiliki nama singkat yang unik secara global, dalam format settings/SETTING_ID. Misalnya, nama singkat setelan resource untuk mengontrol image startup awal untuk virtual machine mungkin adalah settings/compute-vmStartupImage.

Nama resource relatif dari setelan menambahkan ID resource numerik ke nama pendek setelan. Misalnya, nama resource relatif dari setelan settings/compute-vmStartupImage di atas untuk organizations/12345678901 adalah organizations/12345678901/settings/compute-vmStartupImage.

Setelan yang memiliki nama pendek yang sama dianggap identik oleh Google Cloud, meskipun memiliki nama resource relatif yang berbeda. Resource yang disertakan dalam nama resource relatif hanya menunjukkan ketersediaan setelan tersebut untuk resource yang dinamai.

Nilai setelan lokal

Nilai setelan yang diterapkan langsung ke setelan resource tertentu disebut nilai setelan lokal. Anda dapat langsung mengubah nilai lokal setelan resource menggunakan Resource Settings API.

Berikut adalah contoh setelan resource yang menyertakan nilai setelan lokal:

# Setting
{
  "name" : "folders/123/settings/net-preferredDnsServers"
  "localValue": {
    "stringSetValue": {
      "values": ["8.8.8.8", "8.8.4.4"]
    }
  }
}

Nilai setelan yang efektif

Nilai setelan lokal untuk resource diwarisi oleh semua turunan resource tersebut dalam hierarki resource. Jika salah satu turunan ini memiliki nilai setelan lokal, nilai tersebut akan menggantikan nilai setelan yang diwarisi. Jika Anda belum menetapkan nilai setelan lokal pada resource atau turunannya, default yang ditentukan Google untuk setelan tersebut akan digunakan.

Setelan resource dievaluasi, dan hasilnya adalah nilai setelan yang efektif. Nilai ini menunjukkan hasil akhir dari semua setelan nilai lokal dan pewarisan di resource tertentu. Aturan untuk menentukan nilai setelan yang efektif dievaluasi sebagai berikut:

  1. Jika resource memiliki nilai untuk setelan resource tertentu, nilai tersebut adalah nilai efektif, yang menggantikan nilai yang diwarisi.

  2. Jika resource tidak memiliki nilai untuk setelan resource ini, jika salah satu ancestor resource memiliki nilai untuk setelan tersebut, nilai yang terkait dengan ancestor terdekat adalah nilai yang efektif.

  3. Jika resource ini atau ancestor-nya tidak memiliki nilai untuk setelan resource ini, dan setelan tersebut memiliki default yang dikelola Google, maka itulah nilai yang efektif.

  4. Jika resource atau ancestor-nya tidak memiliki nilai untuk setelan resource ini, dan nilai tersebut tidak memiliki default yang dikelola Google, maka tidak ada nilai yang efektif untuk setelan ini di resource ini.

Setelan resource tanpa nilai efektif

Jika setelan resource tidak memiliki setelan default yang dikelola Google, resource tersebut mungkin tidak memiliki nilai yang efektif untuk setelan tersebut. Setelan resource baru tidak memiliki setelan default yang dikelola Google jika mungkin dilakukan dengan cara yang kompatibel dengan versi lama. Oleh karena itu, setelan baru tidak akan mengganggu layanan yang ada.

Nilai kosong dan nilai yang tidak ditetapkan

Nilai setelan resource dianggap kosong jika memiliki nilai setelan resource yang kosong. Misalnya, "" adalah string kosong. Nilai kosong masih dianggap sebagai nilai sesuai dengan evaluasi nilai setelan yang efektif, dan mengganti pewarisan.

Jika tidak ada nilai lokal yang ditetapkan, setelan resource tetap tidak ditetapkan; resource ini mewarisi nilai setelan resource.

Langkah selanjutnya