REST Resource: projects.locations.privateClouds.clusters

Resource: Cluster

Cluster di cloud pribadi.

Representasi JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "management": boolean,
  "autoscalingSettings": {
    object (AutoscalingSettings)
  },
  "uid": string,
  "nodeTypeConfigs": {
    string: {
      object (NodeTypeConfig)
    },
    ...
  },
  "stretchedClusterConfig": {
    object (StretchedClusterConfig)
  },
  "datastoreMountConfig": [
    {
      object (DatastoreMountConfig)
    }
  ]
}
Kolom
name

string

Hanya output. ID. Nama resource cluster ini. Nama resource adalah URI tanpa skema yang mengikuti konvensi di https://cloud.google.com/apis/design/resource_names. Contoh: projects/my-project/locations/us-central1-a/privateClouds/my-cloud/clusters/my-cluster
createTime

string (Timestamp format)

Hanya output. Waktu pembuatan resource ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Waktu pembaruan terakhir resource ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
state

enum (State)

Hanya output. Status resource.
management

boolean

Hanya output. Benar jika cluster adalah cluster pengelolaan; salah jika tidak. Hanya boleh ada satu cluster pengelolaan di cloud pribadi dan cluster tersebut harus menjadi cluster pertama.
autoscalingSettings

object (AutoscalingSettings)

Opsional. Konfigurasi penskalaan otomatis yang diterapkan ke cluster ini.
uid

string

Hanya output. ID unik yang dibuat sistem untuk resource.
nodeTypeConfigs

map (key: string, value: object (NodeTypeConfig))

Wajib. Peta jenis node cluster dalam cluster ini, dengan kunci adalah ID kanonis jenis node (sesuai dengan NodeType).

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
stretchedClusterConfig

object (StretchedClusterConfig)

Opsional. Konfigurasi cluster yang diperluas. Diperlukan untuk cluster yang termasuk dalam cloud pribadi yang DIPERLUAS.
datastoreMountConfig[]

object (DatastoreMountConfig)

Hanya output. Konfigurasi datastore yang terpasang.

Negara bagian/Provinsi

Enum State menentukan kemungkinan status cluster cloud pribadi.

Enum
STATE_UNSPECIFIED Nilai default. Nilai ini tidak boleh digunakan.
ACTIVE Cluster beroperasi dan dapat digunakan oleh pengguna.
CREATING Cluster sedang di-deploy.
UPDATING Menambahkan atau menghapus node ke cluster, atau pembaruan khusus cluster lainnya.
DELETING Cluster sedang dihapus.
REPAIRING Cluster sedang menjalani pemeliharaan, misalnya: node yang gagal sedang diganti.

AutoscalingSettings

Setelan penskalaan otomatis menentukan aturan yang digunakan oleh VMware Engine untuk menskalakan cluster secara otomatis di cloud pribadi.

Representasi JSON 
{
  "autoscalingPolicies": {
    string: {
      object (AutoscalingPolicy)
    },
    ...
  },
  "minClusterNodeCount": integer,
  "maxClusterNodeCount": integer,
  "coolDownPeriod": string
}
Kolom
autoscalingPolicies

map (key: string, value: object (AutoscalingPolicy))

Wajib. Peta dengan kebijakan penskalaan otomatis yang diterapkan ke cluster. Kuncinya adalah ID kebijakan. URL harus memenuhi persyaratan berikut:

  • Hanya berisi 1-63 karakter alfanumerik dan tanda hubung
  • Dimulai dengan karakter alfabet
  • Diakhiri dengan karakter non-tanda hubung
  • Tidak diformat sebagai UUID
  • Sesuai dengan RFC 1034 (bagian 3.5)

Saat ini, peta tersebut hanya boleh berisi satu elemen yang menjelaskan kebijakan penskalaan otomatis untuk node komputasi.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
minClusterNodeCount

integer

Opsional. Jumlah minimum node dari jenis apa pun dalam cluster. Jika tidak ditentukan, batas default akan berlaku.
maxClusterNodeCount

integer

Opsional. Jumlah maksimum node dari jenis apa pun dalam cluster. Jika tidak ditentukan, batas default akan berlaku.
coolDownPeriod

string (Duration format)

Opsional. Durasi minimum antara operasi penskalaan otomatis yang berurutan. Proses ini dimulai setelah penambahan atau penghapusan node selesai sepenuhnya. Jika tidak ditentukan, setelan defaultnya adalah 30 menit. Periode tunggu harus dalam satuan menit penuh (misalnya, 30, 31, 50, 180 menit).

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

AutoscalingPolicy

Kebijakan penskalaan otomatis menjelaskan perilaku penskalaan otomatis terkait penggunaan resource. Operasi penskalaan horizontal dimulai jika penggunaan melebihi SALAH SATU dari masing-masing nilai minimum. Operasi penurunan skala dimulai jika penggunaan berada di bawah SEMUA nilai minimum masing-masing.

Representasi JSON 
{
  "nodeTypeId": string,
  "scaleOutSize": integer,
  "cpuThresholds": {
    object (Thresholds)
  },
  "grantedMemoryThresholds": {
    object (Thresholds)
  },
  "consumedMemoryThresholds": {
    object (Thresholds)
  },
  "storageThresholds": {
    object (Thresholds)
  }
}
Kolom
nodeTypeId

string

Wajib. ID kanonis jenis node yang akan ditambahkan atau dihapus. Sesuai dengan NodeType.
scaleOutSize

integer

Wajib. Jumlah node yang akan ditambahkan ke cluster selama operasi penskalaan. Harus dapat dibagi 2 untuk cluster yang direntangkan. Selama operasi pengurangan skala, hanya satu node (atau 2 untuk cluster yang direntangkan) yang dihapus dalam satu iterasi.
cpuThresholds

object (Thresholds)

Opsional. Nilai minimum pemakaian yang berkaitan dengan pemakaian CPU.
grantedMemoryThresholds

object (Thresholds)

Opsional. Batas penggunaan yang berkaitan dengan jumlah memori yang diberikan.
consumedMemoryThresholds

object (Thresholds)

Opsional. Batas pemakaian yang berkaitan dengan jumlah memori yang digunakan.
storageThresholds

object (Thresholds)

Opsional. Nilai minimum penggunaan yang berkaitan dengan jumlah penyimpanan yang digunakan.

Nilai minimum

Nilai minimum menentukan pemanfaatan resource yang memicu operasi penskalaan dan pengecilan skala.

Representasi JSON 
{
  "scaleOut": integer,
  "scaleIn": integer
}
Kolom
scaleOut

integer

Wajib. Pemanfaatan yang memicu operasi penskalaan horizontal dalam persentase.
scaleIn

integer

Wajib. Pemanfaatan yang memicu operasi pengecilan skala dalam persen.

DatastoreMountConfig

Konfigurasi Pemasangan Datastore

Representasi JSON 
{
  "fileShare": string,
  "datastore": string,
  "datastoreNetwork": {
    object (DatastoreNetwork)
  },
  "accessMode": enum (AccessMode),
  "nfsVersion": enum (NfsVersion),
  "servers": [
    string
  ]
}
Kolom
fileShare

string

Hanya output. Nama berbagi file.
datastore

string

Wajib. Nama resource datastore yang akan di-mount. Nama resource adalah URI tanpa skema yang mengikuti konvensi di https://cloud.google.com/apis/design/resource_names. Contoh: projects/my-project/locations/us-central1/datastores/my-datastore
datastoreNetwork

object (DatastoreNetwork)

Wajib. Konfigurasi jaringan untuk datastore.
accessMode

enum (AccessMode)

Opsional. Mode akses volume NFS. Opsional. Nilai default yang digunakan adalah READ_WRITE
nfsVersion

enum (NfsVersion)

Opsional. Protokol NFS yang didukung oleh volume NFS. Nilai default yang digunakan adalah NFS_V3
servers[]

string

Hanya output. Alamat IP server volume NFS. Untuk NFS 3, Anda hanya dapat memberikan satu alamat IP server atau nama DNS.

DatastoreNetwork

Konfigurasi jaringan untuk datastore.

Representasi JSON 
{
  "subnet": string,
  "mtu": integer,
  "networkPeering": string,
  "connectionCount": integer
}
Kolom
subnet

string

Wajib. Nama resource subnet. Nama resource adalah URI tanpa skema yang mengikuti konvensi di https://cloud.google.com/apis/design/resource_names. Misalnya, projects/my-project/locations/us-central1/subnets/my-subnet
mtu

integer

Opsional. Nilai MTU ditetapkan pada adaptor VMKernel untuk traffic NFS. Jika tidak diberikan, MTU 1500 akan digunakan. Untuk menggunakan frame jumbo, tetapkan nilai ini ke 8896. Sebaiknya sesuaikan nilai ini berdasarkan performa traffic NFS. Performa dapat ditentukan menggunakan alat I/O tolok ukur seperti utilitas fio (Flexible I/O Tester).
networkPeering

string

Hanya output. Nama resource peering jaringan, yang digunakan untuk mengakses berbagi file oleh klien di cloud pribadi. Nama resource adalah URI tanpa skema yang mengikuti konvensi di https://cloud.google.com/apis/design/resource_names. Misalnya, projects/my-project/locations/us-central1/networkPeerings/my-network-peering
connectionCount

integer

Opsional. connectionCount digunakan untuk menyetel beberapa koneksi dari klien NFS di host ESXi ke server NFS. Jumlah koneksi yang lebih tinggi menghasilkan performa yang lebih baik pada datastore. Di API clusters.mountDatastore, secara default maksimum 4 koneksi dikonfigurasi. Pengguna dapat menetapkan nilai connectionCount antara 1 hingga 4. Connection_count didukung dari vSphere 8.0u1 untuk versi sebelumnya, jumlah koneksi 1 ditetapkan di host ESXi.

AccessMode

Mode akses volume NFS.

Enum
ACCESS_MODE_UNSPECIFIED Nilai default. Nilai ini tidak boleh digunakan.
READ_ONLY NFS diakses oleh host dalam mode baca
READ_WRITE NFS diakses oleh host dalam mode baca dan tulis

NfsVersion

Protokol NFS yang didukung oleh volume NFS.

Enum
NFS_VERSION_UNSPECIFIED Nilai default. Nilai ini tidak boleh digunakan.
NFS_V3 NFS 3

Metode

create

 Membuat cluster baru di cloud pribadi tertentu.

delete

 Menghapus resource Cluster.

get

 Mengambil resource Cluster berdasarkan nama resource-nya.

getIamPolicy

 Mendapatkan kebijakan kontrol akses untuk resource.

list

 Mencantumkan resource Cluster di cloud pribadi tertentu.

mountDatastore

 Memasang Datastore pada resource cluster

patch

 Mengubah resource Cluster.

setIamPolicy

 Menetapkan kebijakan kontrol akses pada resource yang ditentukan.

testIamPermissions

 Menampilkan izin yang dimiliki pemanggil pada resource tertentu.

unmountDatastore

 Melepaskan Datastore pada resource cluster