- Referensi: Keanggotaan
- MembershipEndpoint
- GkeCluster
- OnPremCluster
- OnPremCluster.ClusterType
- MultiCloudCluster
- EdgeCluster
- ApplianceCluster
- KubernetesMetadata
- KubernetesResource
- ResourceManifest
- ResourceOptions
- MembershipState
- MembershipState.Code
- Otoritas
- MonitoringConfig
- Metode
Referensi: Keanggotaan
Keanggotaan berisi informasi tentang cluster anggota.
Representasi JSON |
---|
{ "name": string, "labels": { string: string, ... }, "description": string, "state": { object ( |
Kolom | |
---|---|
name |
Hanya output. Nama lengkap dan unik resource Keanggotaan ini dalam format
Yang dapat dinyatakan sebagai ekspresi reguler: |
labels |
Opsional. Label untuk langganan ini. Objek yang berisi daftar pasangan |
description |
Hanya output. Deskripsi keanggotaan ini, dibatasi hingga 63 karakter. Harus cocok dengan ekspresi reguler: Kolom ini ada untuk tujuan lama. |
state |
Hanya output. Status resource Membership. |
createTime |
Hanya output. Kapan Keanggotaan dibuat. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
updateTime |
Hanya output. Kapan Keanggotaan terakhir diperbarui. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
deleteTime |
Hanya output. Kapan Keanggotaan dihapus. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
externalId |
Opsional. ID yang dibuat dan dikelola secara eksternal untuk Keanggotaan ini. ID ini dapat diubah setelah dibuat, tetapi sebaiknya jangan lakukan tindakan ini. ID harus cocok dengan ekspresi reguler: Jika Keanggotaan ini mewakili cluster Kubernetes, nilai ini harus ditetapkan ke UID objek namespace |
lastConnectionTime |
Hanya output. Untuk cluster yang menggunakan Connect, stempel waktu koneksi terbaru yang dibuat dengan Google Cloud. Waktu ini diperbarui setiap beberapa menit, tidak berkelanjutan. Untuk cluster yang tidak menggunakan GKE Connect, atau yang tidak pernah berhasil terhubung, kolom ini akan dibatalkan penetapannya. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
uniqueId |
Hanya output. UUID yang dibuat Google untuk resource ini. Akses ini bersifat unik di semua resource Keanggotaan. Jika resource Keanggotaan dihapus dan resource lain dengan nama yang sama dibuat, resource tersebut akan mendapatkan uniqueId yang berbeda. |
authority |
Opsional. Cara mengidentifikasi workload dari Keanggotaan ini. Lihat dokumentasi tentang Workload Identity untuk mengetahui detail selengkapnya: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity |
monitoringConfig |
Opsional. Informasi konfigurasi pemantauan untuk keanggotaan ini. |
Kolom union type . Jenis resource yang diwakili oleh type Keanggotaan ini hanya dapat berupa salah satu dari berikut: |
|
endpoint |
Opsional. Informasi endpoint untuk menjangkau anggota ini. |
MembershipEndpoint
MembershipEndpoint berisi informasi yang diperlukan untuk menghubungi Kubernetes API, endpoint, dan metadata Kubernetes tambahan apa pun.
Representasi JSON |
---|
{ "kubernetesMetadata": { object ( |
Kolom | |
---|---|
kubernetesMetadata |
Hanya output. Metadata khusus Kubernetes yang berguna. |
kubernetesResource |
Opsional. Resource Kubernetes dalam cluster yang harus diterapkan untuk cluster yang terdaftar dengan benar, dalam status stabil. Referensi ini:
|
googleManaged |
Hanya output. Apakah siklus proses keanggotaan ini dikelola oleh layanan platform Google Cluster. |
Kolom union type . Informasi cluster yang terdaftar. type hanya ada berupa salah satu diantara berikut: |
|
gkeCluster |
Opsional. Informasi spesifik untuk cluster GKE-on-GCP. |
onPremCluster |
Opsional. Informasi spesifik untuk cluster GKE On-Prem. Cluster pengguna lokal yang tidak memiliki resourceLink tidak diizinkan untuk menggunakan kolom ini. Sebagai gantinya, cluster harus memiliki "type" nol. |
multiCloudCluster |
Opsional. Informasi spesifik tentang cluster GKE Multi-Cloud. |
edgeCluster |
Opsional. Informasi spesifik untuk cluster Google Edge. |
applianceCluster |
Opsional. Informasi khusus untuk cluster Edge Appliance GDC. |
GkeCluster
GkeCluster berisi informasi khusus untuk cluster GKE.
Representasi JSON |
---|
{ "resourceLink": string, "clusterMissing": boolean } |
Kolom | |
---|---|
resourceLink |
Tidak dapat diubah. Self-link resource Google Cloud untuk cluster GKE. Contoh: //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster Cluster zona juga didukung. |
clusterMissing |
Hanya output. Jika clusterMissing ditetapkan, ini menunjukkan bahwa cluster GKE sudah tidak ada di Bidang Kontrol GKE. |
OnPremCluster
OnPremCluster berisi informasi khusus untuk cluster GKE On-Prem.
Representasi JSON |
---|
{
"resourceLink": string,
"clusterMissing": boolean,
"adminCluster": boolean,
"clusterType": enum ( |
Kolom | |
---|---|
resourceLink |
Tidak dapat diubah. Self-link resource Google Cloud untuk cluster GKE On-Prem. Contoh: //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vmwareClusters/my-cluster //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/bareMetalClusters/my-cluster |
clusterMissing |
Hanya output. Jika clusterMissing ditetapkan, hal ini menunjukkan bahwa resource API(gkeonprem.googleapis.com) untuk cluster GKE On-Prem ini sudah tidak ada lagi. |
adminCluster |
Tidak dapat diubah. Apakah cluster adalah cluster admin. |
clusterType |
Tidak dapat diubah. Jenis cluster lokal. |
OnPremCluster.ClusterType
ClusterType mendeskripsikan jenis cluster prem.
Enum | |
---|---|
CLUSTERTYPE_UNSPECIFIED |
ClusterType belum ditetapkan. |
BOOTSTRAP |
ClusterType adalah cluster bootstrap. |
HYBRID |
ClusterType adalah cluster hybrid baremetal. |
STANDALONE |
ClusterType adalah cluster mandiri baremetal. |
USER |
ClusterType adalah cluster pengguna. |
MultiCloudCluster
MultiCloudCluster berisi informasi khusus untuk cluster GKE Multi-Cloud.
Representasi JSON |
---|
{ "resourceLink": string, "clusterMissing": boolean } |
Kolom | |
---|---|
resourceLink |
Tidak dapat diubah. Self-link resource Google Cloud untuk cluster GKE Multi-Cloud. Contoh: //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/awsClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/azureClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/attached |
clusterMissing |
Hanya output. Jika clusterMissing ditetapkan, hal ini menunjukkan bahwa resource API(gkemulticloud.googleapis.com) untuk cluster Multi-Cloud GKE ini sudah tidak ada lagi. |
EdgeCluster
EdgeCluster berisi informasi khusus terkait Cluster Google Edge.
Representasi JSON |
---|
{ "resourceLink": string } |
Kolom | |
---|---|
resourceLink |
Tidak dapat diubah. Link mandiri resource Google Cloud untuk Cluster Edge. Contoh: //edgecontainer.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster |
ApplianceCluster
ApplianceCluster berisi informasi khusus untuk Cluster Edge Appliance GDC.
Representasi JSON |
---|
{ "resourceLink": string } |
Kolom | |
---|---|
resourceLink |
Tidak dapat diubah. Link mandiri resource Google Cloud untuk Cluster Appliance. Contoh: //transferappliance.googleapis.com/projects/my-project/locations/us-west1-a/appliances/my-appliance |
KubernetesMetadata
KubernetesMetadata menyediakan metadata informasi untuk Langganan yang mewakili cluster Kubernetes.
Representasi JSON |
---|
{ "kubernetesApiServerVersion": string, "nodeProviderId": string, "nodeCount": integer, "vcpuCount": integer, "memoryMb": integer, "updateTime": string } |
Kolom | |
---|---|
kubernetesApiServerVersion |
Hanya output. String versi server Kubernetes API seperti yang dilaporkan oleh |
nodeProviderId |
Hanya output. Node providerID seperti yang dilaporkan oleh node pertama dalam daftar node di endpoint Kubernetes. Pada platform Kubernetes yang mendukung cluster nol node (seperti GKE-on-GCP), nodeCount akan menjadi nol dan nodeProviderId akan kosong. |
nodeCount |
Hanya output. Jumlah node seperti yang dilaporkan oleh resource node Kubernetes. |
vcpuCount |
Hanya output. Jumlah vCPU seperti yang dilaporkan oleh resource node Kubernetes. |
memoryMb |
Hanya output. Total kapasitas memori seperti yang dilaporkan oleh jumlah semua resource node Kubernetes, yang ditentukan dalam MB. |
updateTime |
Hanya output. Waktu saat detail ini terakhir diperbarui. UpdateTime ini berbeda dengan updateTime tingkat Keanggotaan karena EndpointDetails diupdate secara internal untuk konsumen API. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
KubernetesResource
KubernetesResource berisi manifes dan konfigurasi YAML untuk resource Keanggotaan Kubernetes di cluster. Setelah membership.create atau membership.patch, resource ini harus diterapkan ulang di cluster.
Representasi JSON |
---|
{ "membershipCrManifest": string, "membershipResources": [ { object ( |
Kolom | |
---|---|
membershipCrManifest |
Hanya input. Representasi YAML dari CR Keanggotaan. Kolom ini diabaikan untuk cluster GKE tempat Hub dapat membaca CR secara langsung. Pemanggil harus memberikan CR yang saat ini ada di cluster selama membership.create atau membership.patch, atau biarkan kolom ini kosong jika tidak ada. Manifes CR digunakan untuk memvalidasi bahwa cluster belum terdaftar dengan Keanggotaan lain. |
membershipResources[] |
Hanya output. Resource Kubernetes tambahan yang perlu diterapkan ke cluster setelah pembuatan Keanggotaan, dan setelah setiap update. Kolom ini hanya diisi di Keanggotaan yang ditampilkan dari operasi yang berjalan lama dan berhasil dari membership.create ataumembership.patch. Kolom ini tidak diisi selama permintaan langganan.get atau membership.list normal. Untuk mendapatkan manifes resource setelah pendaftaran awal, pemanggil harus melakukan panggilan membership.patch dengan mask kolom kosong. |
connectResources[] |
Hanya output. Resource Kubernetes untuk menginstal agen GKE Connect Kolom ini hanya diisi di Keanggotaan yang ditampilkan dari operasi yang berjalan lama dan berhasil dari membership.create ataumembership.patch. Kolom ini tidak diisi selama permintaan langganan.get atau membership.list normal. Untuk mendapatkan manifes resource setelah pendaftaran awal, pemanggil harus melakukan panggilan membership.patch dengan mask kolom kosong. |
resourceOptions |
Opsional. Opsi untuk pembuatan resource Kubernetes. |
ResourceManifest
ResourceManifest mewakili satu resource Kubernetes yang akan diterapkan ke cluster.
Representasi JSON |
---|
{ "manifest": string, "clusterScoped": boolean } |
Kolom | |
---|---|
manifest |
Manifes YAML resource. |
clusterScoped |
Apakah resource yang disediakan dalam manifes adalah Kolom ini digunakan untuk pemetaan REST saat menerapkan resource di cluster. |
ResourceOptions
ResourceOptions merepresentasikan opsi untuk pembuatan resource Kubernetes.
Representasi JSON |
---|
{ "connectVersion": string, "v1beta1Crd": boolean, "k8sVersion": string } |
Kolom | |
---|---|
connectVersion |
Opsional. Versi agen Connect yang akan digunakan untuk connectResources. Setelan defaultnya adalah versi GKE Connect terbaru. Versi harus merupakan versi yang didukung saat ini, versi yang tidak digunakan lagi akan ditolak. |
v1beta1Crd |
Opsional. Gunakan |
k8sVersion |
Opsional. Versi utama cluster Kubernetes. Atribut ini hanya digunakan untuk menentukan versi yang akan digunakan untuk resource CustomResourceDefinition, |
MembershipState
MembershipState menjelaskan status resource Membership.
Representasi JSON |
---|
{
"code": enum ( |
Kolom | |
---|---|
code |
Hanya output. Status resource Membership saat ini. |
MembershipState.Code
Kode menjelaskan status resource Keanggotaan.
Enum | |
---|---|
CODE_UNSPECIFIED |
Kode belum disetel. |
CREATING |
Cluster sedang didaftarkan. |
READY |
Cluster terdaftar. |
DELETING |
Cluster ini sedang dibatalkan pendaftarannya. |
UPDATING |
Keanggotaan sedang diperbarui. |
SERVICE_UPDATING |
Keanggotaan sedang diperbarui oleh Layanan Hub. |
Wewenang
Otoritas mengenkode cara Google mengenali identitas dari Keanggotaan ini. Lihat dokumentasi identitas workload untuk mengetahui detail selengkapnya: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity
Representasi JSON |
---|
{ "issuer": string, "workloadIdentityPool": string, "identityProvider": string, "oidcJwks": string } |
Kolom | |
---|---|
issuer |
Opsional. URI penerbit JSON Web Token (JWT). Jika disetel, Google akan mengizinkan token OIDC yang valid dari penerbit ini untuk melakukan autentikasi dalam workloadIdentityPool. Penemuan OIDC akan dilakukan pada URI ini untuk memvalidasi token dari penerbit. Menghapus |
workloadIdentityPool |
Hanya output. Nama kumpulan workload identity tempat Ada satu Kumpulan Workload Identity per Hub yang digunakan bersama oleh semua Langganan milik Hub tersebut. Untuk Hub yang dihosting di {PROJECT_ID}, format kumpulan workload adalah |
identityProvider |
Hanya output. Penyedia identitas yang mencerminkan |
oidcJwks |
Opsional. Kunci verifikasi OIDC untuk Keanggotaan ini dalam format JWKS (RFC 7517). Jika kolom ini disetel, penemuan OIDC TIDAK akan dilakukan di String berenkode base64. |
MonitoringConfig
MonitoringConfig memberi tahu aplikasi/layanan/UI berbasis Armada bagaimana metrik untuk cluster dasar dilaporkan ke layanan pemantauan cloud. Kolom ini dapat ditetapkan dari kosong menjadi tidak kosong, tetapi tidak dapat diubah secara langsung untuk mencegah kerusakan metrik secara tidak sengaja.
Representasi JSON |
---|
{ "projectId": string, "location": string, "cluster": string, "kubernetesMetricsPrefix": string, "clusterHash": string } |
Kolom | |
---|---|
projectId |
Opsional. Project yang digunakan untuk melaporkan Metrik |
location |
Opsional. Lokasi yang digunakan untuk melaporkan Metrik |
cluster |
Opsional. Nama cluster yang digunakan untuk melaporkan metrik. Untuk Anthos di cluster VMWare/Baremetal/MultiCloud, formatnya akan berupa {clusterType}/{clusterName}, misalnya, "awsClusters/cluster_1". |
kubernetesMetricsPrefix |
Opsional. Metrik sistem Kubernetes, jika tersedia, ditulis ke awalan ini. Default-nya adalah kubernetes.io untuk GKE, dan kubernetes.io/anthos untuk Anthos pada akhirnya. Catatan: Anthos MultiCloud akan memiliki awalan kubernetes.io hari ini, tetapi migrasi akan berada di bawah kubernetes.io/anthos. |
clusterHash |
Opsional. Untuk cluster GKE dan Multicloud, ini adalah UUID resource cluster. Untuk cluster VMWare dan Baremetal, ini adalah UID sistem kube. |
Metode |
|
---|---|
|
Membuat Keanggotaan baru. |
|
Menghapus Keanggotaan. |
|
Membuat manifes untuk deployment agen koneksi GKE. |
|
Mendapatkan detail Langganan. |
|
Mendapatkan kebijakan kontrol akses untuk resource. |
|
Mencantumkan Keanggotaan dalam project dan lokasi tertentu. |
|
Memperbarui Keanggotaan yang ada. |
|
Menetapkan kebijakan kontrol akses pada resource yang ditentukan. |
|
Menampilkan izin yang dimiliki pemanggil atas resource yang ditentukan. |