Package google.cloud.gkehub.v1beta1

Indeks

GkeHubMembershipService

GKE Hub MembershipService menangani pendaftaran banyak cluster Kubernetes ke Google Cloud, yang direpresentasikan dengan resource Membership.

GKE Hub saat ini tersedia di region global dan semua region di https://cloud.google.com/compute/docs/regions-zones. Fitur hanya tersedia di wilayah global sementara keanggotaan adalah wilayah global dan semua wilayah.

Pengelolaan keanggotaan mungkin sulit: sebaiknya gunakan salah satu library klien atau alat yang disediakan Google saat menggunakan referensi Keanggotaan.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Operation)

Membuat Keanggotaan baru.

Saat ini hanya didukung untuk cluster GKE di Google Cloud. Untuk mendaftarkan cluster lain, ikuti petunjuknya di https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Operation)

Menghapus Keanggotaan.

Saat ini hanya didukung untuk cluster GKE di Google Cloud. Untuk membatalkan pendaftaran cluster lain, ikuti petunjuknya di https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/unregistering-a-cluster.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.

GenerateConnectManifest

rpc GenerateConnectManifest(GenerateConnectManifestRequest) returns (GenerateConnectManifestResponse)

Membuat manifes untuk deployment agen koneksi GKE.

Metode ini digunakan secara internal oleh library yang disediakan Google. Sebagian besar klien tidak perlu memanggil metode ini secara langsung.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.

GenerateExclusivityManifest

rpc GenerateExclusivityManifest(GenerateExclusivityManifestRequest) returns (GenerateExclusivityManifestResponse)

GenerateExclusivityManifest menghasilkan manifes untuk mengupdate artefak eksklusivitas di cluster jika diperlukan.

Artefak eksklusivitas mencakup definisi resource kustom (CRD) Keanggotaan dan resource kustom Keanggotaan (CR) singleton. Dikombinasikan dengan ValidateExclusivity, artefak eksklusivitas menjamin bahwa cluster Kubernetes hanya didaftarkan ke satu GKE Hub.

CRD Keanggotaan memiliki versi, dan mungkin memerlukan konversi saat server GKE Hub API mulai menyajikan versi CRD yang lebih baru dan CR yang terkait. Responsnya akan berupa CRD dan CR yang dikonversi jika ada perbedaan di antara kedua versi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

Mendapatkan detail Langganan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

Mencantumkan Keanggotaan dalam project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.

UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Operation)

Memperbarui Keanggotaan yang ada.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.

ValidateExclusivity

rpc ValidateExclusivity(ValidateExclusivityRequest) returns (ValidateExclusivityResponse)

ValidasiExclusivity memvalidasi status eksklusivitas di cluster. Validasi tidak bergantung pada resource keanggotaan Hub yang ada.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.

ApplianceCluster

ApplianceCluster berisi informasi khusus untuk Cluster Edge Appliance GDC.

Kolom

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

Kolom
issuer

string

Opsional. URI penerbit JSON Web Token (JWT). issuer harus diawali dengan https:// dan berupa URL yang valid dengan panjang <2000 karakter.

Jika ditetapkan, Google akan mengizinkan token OIDC yang valid dari penerbit ini untuk melakukan autentikasi dalam workload_identity_pool. Penemuan OIDC akan dilakukan pada URI ini untuk memvalidasi token dari penerbit.

Menghapus issuer akan menonaktifkan Workload Identity. issuer tidak dapat diubah secara langsung. Ini harus dihapus (dan Workload Identity dinonaktifkan) sebelum menggunakan penerbit baru (dan mengaktifkan kembali Workload Identity).

workload_identity_pool

string

Hanya output. Nama kumpulan workload identity tempat issuer akan dikenali.

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 {PROJECT_ID}.hub.id.goog, meskipun hal ini dapat berubah pada versi API ini yang lebih baru.

identity_provider

string

Hanya output. Penyedia identitas yang mencerminkan issuer di kumpulan workload identity.

oidc_jwks

bytes

Opsional. Kunci verifikasi OIDC untuk Keanggotaan ini dalam format JWKS (RFC 7517).

Jika kolom ini disetel, penemuan OIDC TIDAK akan dilakukan di issuer, dan token OIDC akan divalidasi menggunakan kolom ini.

ConnectAgent

Informasi yang diperlukan pengguna akhir untuk menggunakan GKE Connect.

Kolom
name
(deprecated)

string

Jangan disetel.

proxy

bytes

Opsional. URI proxy jika konektivitas dari agen ke gkeconnect.googleapis.com memerlukan penggunaan proxy. Format harus dalam format http(s)://{proxy_address}, bergantung pada protokol HTTP/HTTPS yang didukung oleh proxy. Tindakan ini akan mengarahkan traffic keluar agen penghubung melalui proxy HTTP(S).

namespace

string

Opsional. Namespace untuk resource agen GKE Connect. Nilai defaultnya adalah gke-connect.

Connect Agent diberi otorisasi secara otomatis saat dijalankan di namespace default. Jika tidak, otorisasi eksplisit harus diberikan dengan binding IAM tambahan.

ConnectAgentResource

ConnectAgentResource mewakili manifes resource Kubernetes untuk deployment Connect Agent.

Kolom
type

TypeMeta

Jenis Kubernetes resource.

manifest

string

Manifes YAML resource.

CreateMembershipRequest

Pesan permintaan untuk metode GkeHubMembershipService.CreateMembership.

Kolom
parent

string

Wajib. Induk (project dan lokasi) tempat Langganan akan dibuat. Ditentukan dalam format projects/*/locations/*.

Otorisasi memerlukan izin IAM berikut pada resource parent yang ditentukan:

  • gkehub.memberships.create
membership_id

string

Wajib. ID yang dipilih klien untuk keanggotaan. membership_id harus berupa label DNS yang sesuai dengan RFC 1123 yang valid:

  1. Maksimal 63 karakter
  2. Harus terdiri dari karakter alfanumerik huruf kecil atau -
  3. Nama harus diawali dan diakhiri dengan karakter alfanumerik

Yang dapat dinyatakan sebagai ekspresi reguler: [a-z0-9]([-a-z0-9]*[a-z0-9])?, dengan panjang maksimum 63 karakter.

resource

Membership

Wajib. Keanggotaan yang akan dibuat.

request_id

string

Opsional. ID permintaan untuk mengidentifikasi permintaan. Tetapkan ID permintaan unik sehingga jika Anda harus mencoba lagi permintaan, server akan mengetahui untuk mengabaikan permintaan tersebut jika sudah diselesaikan. Server akan menjamin setidaknya selama 60 menit setelah permintaan pertama.

Misalnya, pertimbangkan situasi saat Anda membuat permintaan awal dan waktu permintaan habis. Jika Anda membuat permintaan lagi dengan ID permintaan yang sama, server dapat memeriksa apakah operasi asli dengan ID permintaan yang sama diterima, dan jika demikian, akan mengabaikan permintaan kedua. Langkah ini mencegah klien membuat komitmen duplikat secara tidak sengaja.

ID permintaan harus berupa UUID yang valid dengan pengecualian bahwa nol UUID tidak didukung (00000000-0000-0000-0000-000000000000).

DeleteMembershipRequest

Pesan permintaan untuk metode GkeHubMembershipService.DeleteMembership.

Kolom
name

string

Wajib. Nama resource Keanggotaan dalam format projects/*/locations/*/memberships/*.

Otorisasi memerlukan izin IAM berikut pada resource name yang ditentukan:

  • gkehub.memberships.delete
request_id

string

Opsional. ID permintaan untuk mengidentifikasi permintaan. Tetapkan ID permintaan unik sehingga jika Anda harus mencoba lagi permintaan, server akan mengetahui untuk mengabaikan permintaan tersebut jika sudah diselesaikan. Server akan menjamin setidaknya selama 60 menit setelah permintaan pertama.

Misalnya, pertimbangkan situasi saat Anda membuat permintaan awal dan waktu permintaan habis. Jika Anda membuat permintaan lagi dengan ID permintaan yang sama, server dapat memeriksa apakah operasi asli dengan ID permintaan yang sama diterima, dan jika demikian, akan mengabaikan permintaan kedua. Langkah ini mencegah klien membuat komitmen duplikat secara tidak sengaja.

ID permintaan harus berupa UUID yang valid dengan pengecualian bahwa nol UUID tidak didukung (00000000-0000-0000-0000-000000000000).

force

bool

Opsional. Jika disetel ke benar (true), subresource apa pun dari Keanggotaan ini juga akan dihapus. Jika tidak, permintaan hanya akan berfungsi jika Keanggotaan tidak memiliki subresource.

EdgeCluster

EdgeCluster berisi informasi khusus terkait Cluster Google Edge.

Kolom

GenerateConnectManifestRequest

Pesan permintaan untuk metode GkeHubMembershipService.GenerateConnectManifest.

Kolom
name

string

Wajib. Nama resource Keanggotaan yang akan dikaitkan dengan Agen, dalam format projects/*/locations/*/memberships/*.

Otorisasi memerlukan izin IAM berikut pada resource name yang ditentukan:

  • gkehub.memberships.generateConnectManifest
connect_agent

ConnectAgent

Opsional. Agen penghubung untuk membuat manifes.

version

string

Opsional. Versi agen Connect yang akan digunakan. Setelan defaultnya adalah versi terbaru.

is_upgrade

bool

Opsional. Jika benar, buat resource hanya untuk upgrade. Beberapa resource yang dihasilkan hanya untuk penginstalan (mis. secret) akan dikecualikan.

registry

string

Opsional. Registry tempat mengambil image agen koneksi. Default-nya adalah gcr.io/gkeconnect.

image_pull_secret_content

bytes

Opsional. Image akan menarik konten secret untuk registry, jika tidak bersifat publik.

GenerateConnectManifestResponse

GenerateConnectManifestResponse berisi informasi manifes untuk menginstal/mengupgrade agen Connect.

Kolom
manifest[]

ConnectAgentResource

Daftar resource Kubernetes yang diurutkan dan perlu diterapkan ke cluster untuk penginstalan/upgrade agen GKE Connect.

GenerateExclusivityManifestRequest

Permintaan untuk menghasilkan manifes untuk artefak eksklusivitas.

Kolom
name

string

Wajib. Nama resource Keanggotaan dalam format projects/*/locations/*/memberships/*.

Otorisasi memerlukan izin IAM berikut pada resource name yang ditentukan:

  • gkehub.memberships.generateConnectManifest
crd_manifest

string

Opsional. Manifes YAML dari CRD keanggotaan yang diambil oleh kubectl get customresourcedefinitions membership. Biarkan kosong jika resource tidak ada.

cr_manifest

string

Opsional. Manifes YAML dari CR keanggotaan yang diambil oleh kubectl get memberships membership. Biarkan kosong jika resource tidak ada.

GenerateExclusivityManifestResponse

Respons manifes artefak eksklusivitas untuk diterapkan oleh klien.

Kolom
crd_manifest

string

Manifes YAML dari CRD keanggotaan yang akan diterapkan jika versi CRD yang lebih baru tersedia. Kosong jika tidak ada update yang perlu diterapkan.

cr_manifest

string

Manifes YAML dari CR keanggotaan yang akan diterapkan jika versi CR baru tersedia. Kosong jika tidak ada update yang perlu diterapkan.

GetMembershipRequest

Pesan permintaan untuk metode GkeHubMembershipService.GetMembership.

Kolom
name

string

Wajib. Nama resource Keanggotaan dalam format projects/*/locations/*/memberships/*.

Otorisasi memerlukan izin IAM berikut pada resource name yang ditentukan:

  • gkehub.memberships.get

GkeCluster

GkeCluster berisi informasi khusus untuk cluster GKE.

Kolom
cluster_missing

bool

Hanya output. Jika cluster_missing telah ditetapkan, berarti cluster GKE sudah tidak ada lagi di Bidang Kontrol GKE.

KubernetesMetadata

KubernetesMetadata menyediakan metadata informasi untuk Langganan yang mewakili cluster Kubernetes.

Kolom
kubernetes_api_server_version

string

Hanya output. String versi server Kubernetes API seperti yang dilaporkan oleh '/version'.

node_provider_id

string

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), node_count akan menjadi nol dan node_provider_id akan kosong.

node_count

int32

Hanya output. Jumlah node seperti yang dilaporkan oleh resource node Kubernetes.

vcpu_count

int32

Hanya output. Jumlah vCPU seperti yang dilaporkan oleh resource node Kubernetes.

memory_mb

int32

Hanya output. Total kapasitas memori seperti yang dilaporkan oleh jumlah semua resource node Kubernetes, yang ditentukan dalam MB.

update_time

Timestamp

Hanya output. Waktu saat detail ini terakhir diperbarui. update_time ini berbeda dengan update_time tingkat Keanggotaan karena EndpointDetails diupdate secara internal untuk konsumen API.

KubernetesResource

KubernetesResource berisi manifes dan konfigurasi YAML untuk resource Keanggotaan Kubernetes di cluster. Setelah CreateMembership atau UpdateMembership, resource ini harus diterapkan kembali di cluster.

Kolom
membership_cr_manifest

string

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 CreateMembership atau UpdateMembership, atau biarkan kolom ini kosong jika tidak ada. Manifes CR digunakan untuk memvalidasi bahwa cluster belum terdaftar dengan Keanggotaan lain.

membership_resources[]

ResourceManifest

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 yang berhasil dari CreateMembership atau UpdateMembership. Kolom ini tidak diisi selama permintaan GetMembership atau ListMemberships normal. Untuk mendapatkan manifes resource setelah pendaftaran awal, pemanggil harus melakukan panggilan UpdateMembership dengan mask kolom kosong.

connect_resources[]

ResourceManifest

Hanya output. Resource Kubernetes untuk menginstal agen GKE Connect

Kolom ini hanya diisi di Keanggotaan yang ditampilkan dari operasi yang berjalan lama yang berhasil dari CreateMembership atau UpdateMembership. Kolom ini tidak diisi selama permintaan GetMembership atau ListMemberships normal. Untuk mendapatkan manifes resource setelah pendaftaran awal, pemanggil harus melakukan panggilan UpdateMembership dengan mask kolom kosong.

resource_options

ResourceOptions

Opsional. Opsi untuk pembuatan resource Kubernetes.

ListMembershipsRequest

Pesan permintaan untuk metode GkeHubMembershipService.ListMemberships.

Kolom
parent

string

Wajib. Induk (project dan lokasi) tempat Langganan akan dicantumkan. Ditentukan dalam format projects/*/locations/*. projects/*/locations/- keanggotaan daftar di semua wilayah.

Otorisasi memerlukan izin IAM berikut pada resource parent yang ditentukan:

  • gkehub.memberships.list
page_size

int32

Opsional. Saat meminta 'halaman' resource, page_size menentukan jumlah resource yang akan ditampilkan. Jika tidak ditentukan atau disetel ke 0, semua resource akan ditampilkan.

page_token

string

Opsional. Token yang ditampilkan oleh panggilan sebelumnya ke ListMemberships yang menentukan posisi dalam daftar dari tempat untuk melanjutkan listingan resource.

filter

string

Opsional. Mencantumkan Langganan yang cocok dengan ekspresi filter, dengan mengikuti sintaksis yang diuraikan di https://google.aip.dev/160.

Contoh:

  • Nama adalah bar dalam project foo-proj dan lokasi global:
  name = "projects/foo-proj/locations/global/membership/bar"
  • Langganan yang memiliki label bernama foo:
  labels.foo:*
  • Langganan yang memiliki label bernama foo yang nilainya adalah bar:
  labels.foo = bar
  • Langganan dalam status MEMBUAT KONTEN:
  state = CREATING
order_by

string

Opsional. Satu atau beberapa kolom untuk dibandingkan dan digunakan untuk mengurutkan output. Lihat https://google.aip.dev/132#ordering.

ListMembershipsResponse

Pesan respons untuk metode GkeHubMembershipService.ListMemberships.

Kolom
resources[]

Membership

Daftar Langganan yang cocok.

next_page_token

string

Token untuk meminta halaman resource berikutnya dari metode ListMemberships. Nilai string kosong berarti tidak ada lagi resource untuk ditampilkan.

unreachable[]

string

Daftar lokasi yang tidak dapat dijangkau saat mengambil daftar ini.

Langganan

Keanggotaan berisi informasi tentang cluster anggota.

Kolom
name

string

Hanya output. Nama lengkap dan unik resource Keanggotaan ini dalam format projects/*/locations/*/memberships/{membership_id}, yang ditetapkan selama pembuatan.

membership_id harus berupa label DNS yang sesuai dengan RFC 1123 yang valid:

  1. Maksimal 63 karakter
  2. Harus terdiri dari karakter alfanumerik huruf kecil atau -
  3. Nama harus diawali dan diakhiri dengan karakter alfanumerik

Yang dapat dinyatakan sebagai ekspresi reguler: [a-z0-9]([-a-z0-9]*[a-z0-9])?, dengan panjang maksimum 63 karakter.

labels

map<string, string>

Opsional. Label GCP untuk keanggotaan ini.

description

string

Opsional. Deskripsi keanggotaan ini, dibatasi hingga 63 karakter. Harus cocok dengan ekspresi reguler: [a-zA-Z0-9][a-zA-Z0-9_\-\.\ ]*

state

MembershipState

Hanya output. Status resource Membership.

authority

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

create_time

Timestamp

Hanya output. Kapan Keanggotaan dibuat.

update_time

Timestamp

Hanya output. Kapan Keanggotaan terakhir diperbarui.

delete_time

Timestamp

Hanya output. Kapan Keanggotaan dihapus.

external_id

string

Opsional. ID yang dibuat dan dikelola secara eksternal untuk Keanggotaan ini. ID ini dapat diubah setelah dibuat, tetapi sebaiknya jangan lakukan tindakan ini. Untuk cluster GKE, external_id dikelola oleh Hub API dan update akan diabaikan.

ID harus cocok dengan ekspresi reguler: [a-zA-Z0-9][a-zA-Z0-9_\-\.]*

Jika Keanggotaan ini mewakili cluster Kubernetes, nilai ini harus ditetapkan ke UID objek namespace kube-system.

last_connection_time

Timestamp

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.

unique_id

string

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 unique_id yang berbeda.

infrastructure_type

Membership.InfrastructureType

Opsional. Jenis infrastruktur yang menjalankan Langganan ini.

monitoring_config

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

MembershipEndpoint

Opsional. Informasi endpoint untuk menjangkau anggota ini.

InfrastructureType

Menentukan jenis infrastruktur Keanggotaan. Jenis infrastruktur digunakan oleh Hub untuk mengontrol perilaku spesifik per infrastruktur, termasuk harga.

Setiap distribusi GKE (di GCP, lokal, on-X,...) akan menetapkan kolom ini secara otomatis, tetapi pelanggan Attached Clusters harus menentukan jenis selama pendaftaran.

Enum
INFRASTRUCTURE_TYPE_UNSPECIFIED Tidak ada jenis yang ditentukan. Beberapa fungsi Hub mungkin memerlukan jenis yang ditentukan, dan tidak akan mendukung Langganan dengan nilai ini.
ON_PREM Infrastruktur pribadi yang dimiliki atau dioperasikan oleh pelanggan. Hal ini mencakup distribusi GKE seperti GKE-OnPrem dan GKE-OnBareMetal.
MULTI_CLOUD Infrastruktur cloud publik.

MembershipEndpoint

MembershipEndpoint berisi informasi yang diperlukan untuk menghubungi Kubernetes API, endpoint, dan metadata Kubernetes tambahan apa pun.

Kolom
kubernetes_metadata

KubernetesMetadata

Hanya output. Metadata khusus Kubernetes yang berguna.

kubernetes_resource

KubernetesResource

Opsional. Resource Kubernetes dalam cluster yang harus diterapkan untuk cluster yang terdaftar dengan benar, dalam status stabil. Referensi ini:

  • Pastikan cluster terdaftar secara eksklusif untuk satu dan hanya satu Keanggotaan Hub.
  • Menyebarkan Informasi Kumpulan Workload tersedia di kolom Membership Authority.
  • Pastikan konfigurasi awal yang benar pada Fitur Hub default.
Kolom union type. Informasi cluster yang terdaftar. type hanya ada berupa salah satu diantara berikut:
gke_cluster

GkeCluster

Opsional. Informasi spesifik untuk cluster GKE-on-GCP.

on_prem_cluster

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.

multi_cloud_cluster

MultiCloudCluster

Opsional. Informasi spesifik tentang cluster GKE Multi-Cloud.

edge_cluster

EdgeCluster

Opsional. Informasi spesifik untuk cluster Google Edge.

appliance_cluster

ApplianceCluster

Opsional. Informasi khusus untuk cluster Edge Appliance GDC.

MembershipState

Status resource Membership.

Kolom
code

MembershipState.Code

Hanya output. Status resource Membership saat ini.

description
(deprecated)

string

Kolom ini tidak pernah ditetapkan oleh Layanan Hub.

update_time
(deprecated)

Timestamp

Kolom ini tidak pernah ditetapkan oleh Layanan Hub.

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.

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.

Kolom
project_id

string

Opsional. Project yang digunakan untuk melaporkan Metrik

location

string

Opsional. Lokasi yang digunakan untuk melaporkan Metrik

cluster

string

Opsional. Nama cluster yang digunakan untuk melaporkan metrik. Untuk Anthos di cluster VMWare/Baremetal/MultiCloud, formatnya akan berupa {cluster_type}/{cluster_name}, misalnya, "awsClusters/cluster_1".

kubernetes_metrics_prefix

string

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.

cluster_hash

string

Opsional. Untuk cluster GKE dan Multicloud, ini adalah UUID resource cluster. Untuk cluster VMWare dan Baremetal, ini adalah UID sistem kube.

MultiCloudCluster

MultiCloudCluster berisi informasi khusus untuk cluster GKE Multi-Cloud.

Kolom
cluster_missing

bool

Hanya output. Jika cluster_missing ditetapkan, hal ini menunjukkan bahwa resource API(gkemulticloud.googleapis.com) untuk cluster Multi-Cloud GKE ini tidak ada lagi.

OnPremCluster

OnPremCluster berisi informasi khusus untuk cluster GKE On-Prem.

Kolom
cluster_missing

bool

Hanya output. Jika cluster_missing ditetapkan, hal ini menunjukkan bahwa resource API(gkeonprem.googleapis.com) untuk cluster GKE On-Prem ini tidak ada lagi.

admin_cluster

bool

Tidak dapat diubah. Apakah cluster adalah cluster admin.

cluster_type

OnPremCluster.ClusterType

Tidak dapat diubah. Jenis cluster lokal.

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.

OperationMetadata

Mewakili metadata operasi yang berjalan lama.

Kolom
create_time

Timestamp

Hanya output. Waktu operasi dibuat.

end_time

Timestamp

Hanya output. Waktu operasi selesai berjalan.

target

string

Hanya output. Jalur resource yang ditentukan server untuk target operasi.

verb

string

Hanya output. Nama kata kerja yang dieksekusi oleh operasi.

status_detail

string

Hanya output. Status operasi yang dapat dibaca manusia, jika ada.

cancel_requested

bool

Hanya output. Mengidentifikasi apakah pengguna telah meminta pembatalan operasi. Operasi yang telah berhasil dibatalkan memiliki nilai [Operation.error][] google.rpc.Status.code bernilai 1, yang sesuai dengan Code.CANCELLED.

api_version

string

Hanya output. Versi API yang digunakan untuk memulai operasi.

ResourceManifest

ResourceManifest mewakili satu resource Kubernetes yang akan diterapkan ke cluster.

Kolom
manifest

string

Manifes YAML resource.

cluster_scoped

bool

Apakah resource yang disediakan dalam manifes adalah cluster_scoped. Jika tidak disetel, manifes dianggap sebagai cakupan namespace.

Kolom ini digunakan untuk pemetaan REST saat menerapkan resource di cluster.

ResourceOptions

ResourceOptions merepresentasikan opsi untuk pembuatan resource Kubernetes.

Kolom
connect_version

string

Opsional. Versi agen Connect yang akan digunakan untuk connect_resources. Setelan defaultnya adalah versi GKE Connect terbaru. Versi harus merupakan versi yang didukung saat ini, versi yang tidak digunakan lagi akan ditolak.

v1beta1_crd

bool

Opsional. Gunakan apiextensions/v1beta1, bukan apiextensions/v1 untuk resource CustomResourceDefinition. Opsi ini harus ditetapkan untuk cluster dengan Kubernetes apiserver versi <1.16.

k8s_version

string

Opsional. Versi utama cluster Kubernetes. Atribut ini hanya digunakan untuk menentukan versi yang akan digunakan untuk resource CustomResourceDefinition, apiextensions/v1beta1 atau apiextensions/v1.

TypeMeta

TypeMeta adalah informasi jenis yang diperlukan untuk melakukan unmarshalling konten pada resource Kubernetes dalam manifes.

Kolom
kind

string

Jenis resource (misalnya, Deployment).

api_version

string

APIVersion resource (mis. v1).

UpdateMembershipRequest

Pesan permintaan untuk metode GkeHubMembershipService.UpdateMembership.

Kolom
name

string

Wajib. Nama resource keanggotaan dalam format: projects/[project_id]/locations/global/memberships/[membership_id]

Otorisasi memerlukan izin IAM berikut pada resource name yang ditentukan:

  • gkehub.memberships.update
update_mask

FieldMask

Wajib. Mask kolom yang akan diperbarui. Setidaknya satu jalur kolom harus ditentukan dalam mask ini.

resource

Membership

Wajib. Hanya kolom yang ditentukan dalam update_mask yang diperbarui. Jika Anda menentukan kolom dalam update_mask, tetapi tidak menentukan nilainya di sini, kolom tersebut akan dihapus. Jika Anda memperbarui kolom peta, tetapkan nilai kunci ke null atau string kosong untuk menghapus kunci dari peta. Nilai kunci tidak dapat diperbarui ke string kosong. Jika Anda menentukan update_mask sebagai jalur khusus "*", semua kolom yang dapat diubah pengguna akan diganti sepenuhnya agar cocok dengan resource.

request_id

string

Opsional. ID permintaan untuk mengidentifikasi permintaan. Tetapkan ID permintaan unik sehingga jika Anda harus mencoba lagi permintaan, server akan mengetahui untuk mengabaikan permintaan tersebut jika sudah diselesaikan. Server akan menjamin setidaknya selama 60 menit setelah permintaan pertama.

Misalnya, pertimbangkan situasi saat Anda membuat permintaan awal dan waktu permintaan habis. Jika Anda membuat permintaan lagi dengan ID permintaan yang sama, server dapat memeriksa apakah operasi asli dengan ID permintaan yang sama diterima, dan jika demikian, akan mengabaikan permintaan kedua. Langkah ini mencegah klien membuat komitmen duplikat secara tidak sengaja.

ID permintaan harus berupa UUID yang valid dengan pengecualian bahwa nol UUID tidak didukung (00000000-0000-0000-0000-000000000000).

ValidateExclusivityRequest

Permintaan untuk memvalidasi status CR keanggotaan yang ada di cluster.

Kolom
parent

string

Wajib. Induk (project dan lokasi) tempat Langganan akan dibuat. Ditentukan dalam format projects/*/locations/*.

Otorisasi memerlukan izin IAM berikut pada resource parent yang ditentukan:

  • gkehub.memberships.generateConnectManifest
cr_manifest

string

Opsional. YAML dari CR keanggotaan di cluster. Kosong jika CR keanggotaan tidak ada.

intended_membership

string

Wajib. Nama keanggotaan yang dimaksud dengan parent. Metode ini hanya melakukan validasi untuk mengantisipasi panggilan CreateMembership dengan nama yang sama.

ValidateExclusivityResponse

Respons status hasil validasi artefak eksklusivitas.

Kolom
status

Status

Hasil validasi.

  • OK berarti eksklusivitas divalidasi, dengan asumsi manifes yang dihasilkan oleh GenerateExclusivityManifest berhasil diterapkan.
  • ALREADY_EXISTS berarti CRD Keanggotaan sudah dimiliki oleh Hub lain. Lihat status.message untuk mengetahui informasi selengkapnya.