Ringkasan Setelan Resource

Anda dapat menggunakan Setelan Resource untuk mengonfigurasi setelan secara terpusat bagi project, folder, dan organisasi Google Cloud. Setelan ini diwarisi 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 dibuatnya resource bucket baru.

Setiap setelan resource memiliki properti utama berikut:

  • Nama: ID unik 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 memungkinkan 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: tanda yang menunjukkan apakah Google telah membuat setelan ini hanya baca. Jika setelan resource bersifat hanya baca, nilai untuk setelan ini tidak dapat diubah. Setelan dibuat menjadi hanya baca untuk migrasi dan penghentian penggunaan. Google memberikan peringatan sebelum mengubah 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 Resource Settings Viewer atau Resource Settings Administrator Identity and Access Management 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 setiap 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 pendek yang unik secara global, dalam format settings/SETTING_ID. Misalnya, nama pendek setelan resource untuk mengontrol image startup awal mesin virtual 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 ke resource yang telah diberi nama.

Nilai setelan lokal

Nilai setelan yang langsung diterapkan 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 efektif

Nilai setelan lokal untuk resource diwarisi oleh semua turunan resource tersebut dalam hierarki resource. Jika salah satu turunan ini memiliki nilai setelan lokal, turunan itu akan menggantikan nilai setelan yang diwarisi. Jika Anda belum menetapkan nilai setelan lokal pada resource atau turunannya, nilai 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 pewarisan dan nilai lokal pada resource tertentu. Aturan untuk menentukan nilai setelan yang efektif dievaluasi sebagai berikut:

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

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

  3. Jika resource ini atau ancestornya tidak memiliki nilai untuk setelan resource ini, dan setelan tersebut memiliki default yang dikelola Google, maka itu adalah nilai efektif.

  4. Jika resource maupun ancestornya tidak memiliki nilai untuk setelan resource ini, dan nilainya tidak memiliki default yang dikelola Google, maka tidak ada nilai efektif untuk setelan ini pada resource ini.

Setelan resource tanpa nilai efektif

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

Nilai kosong dan nilai tidak ditetapkan

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

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

Langkah selanjutnya