Package google.cloud.edgecontainer.v1

Indeks

EdgeContainer

EdgeContainer API menyediakan pengelolaan Cluster Kubernetes pada deployment Google Edge Cloud.

CreateCluster

rpc CreateCluster(CreateClusterRequest) returns (Operation)

Membuat Cluster baru di project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

CreateNodePool

rpc CreateNodePool(CreateNodePoolRequest) returns (Operation)

Membuat NodePool baru di project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

CreateVpnConnection

rpc CreateVpnConnection(CreateVpnConnectionRequest) returns (Operation)

Membuat koneksi VPN baru di project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

DeleteCluster

rpc DeleteCluster(DeleteClusterRequest) returns (Operation)

Menghapus satu Cluster.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

DeleteNodePool

rpc DeleteNodePool(DeleteNodePoolRequest) returns (Operation)

Menghapus satu NodePool.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

DeleteVpnConnection

rpc DeleteVpnConnection(DeleteVpnConnectionRequest) returns (Operation)

Menghapus satu koneksi VPN.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

GenerateAccessToken

rpc GenerateAccessToken(GenerateAccessTokenRequest) returns (GenerateAccessTokenResponse)

Membuat token akses untuk Cluster.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

GenerateOfflineCredential

rpc GenerateOfflineCredential(GenerateOfflineCredentialRequest) returns (GenerateOfflineCredentialResponse)

Membuat kredensial offline untuk Cluster.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

GetCluster

rpc GetCluster(GetClusterRequest) returns (Cluster)

Mendapatkan detail satu Cluster.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

GetMachine

rpc GetMachine(GetMachineRequest) returns (Machine)

Mendapatkan detail satu Mesin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

GetNodePool

rpc GetNodePool(GetNodePoolRequest) returns (NodePool)

Mendapatkan detail satu NodePool.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

GetServerConfig

rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig)

Mendapatkan konfigurasi server.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

GetVpnConnection

rpc GetVpnConnection(GetVpnConnectionRequest) returns (VpnConnection)

Mendapatkan detail satu koneksi VPN.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

ListClusters

rpc ListClusters(ListClustersRequest) returns (ListClustersResponse)

Mencantumkan Cluster di project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

ListMachines

rpc ListMachines(ListMachinesRequest) returns (ListMachinesResponse)

Mencantumkan Mesin di project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

ListNodePools

rpc ListNodePools(ListNodePoolsRequest) returns (ListNodePoolsResponse)

Mencantumkan NodePool di project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

ListVpnConnections

rpc ListVpnConnections(ListVpnConnectionsRequest) returns (ListVpnConnectionsResponse)

Mencantumkan koneksi VPN di project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

UpdateCluster

rpc UpdateCluster(UpdateClusterRequest) returns (Operation)

Memperbarui parameter satu Cluster.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

UpdateNodePool

rpc UpdateNodePool(UpdateNodePoolRequest) returns (Operation)

Memperbarui parameter satu NodePool.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

UpgradeCluster

rpc UpgradeCluster(UpgradeClusterRequest) returns (Operation)

Mengupgrade satu cluster.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Otorisasi

Kebijakan RBAC yang akan diterapkan dan dikelola oleh GEC.

Kolom
admin_users

ClusterUser

Wajib. Pengguna yang akan diberi peran cluster-admin di cluster, sehingga memberikan akses penuh ke cluster. Saat ini, kolom ini adalah kolom tunggal, tetapi akan diperluas untuk memungkinkan beberapa admin pada masa mendatang.

ChannelConfig

Konfigurasi untuk saluran rilis.

Kolom
default_version

string

Hanya output. Versi default untuk saluran rilis ini, misalnya: "1.4.0".

Cluster

Cluster Kubernetes Google Distributed Cloud Edge.

Kolom
name

string

Wajib. Nama resource cluster.

create_time

Timestamp

Hanya output. Waktu saat cluster dibuat.

update_time

Timestamp

Hanya output. Waktu saat cluster terakhir diperbarui.

labels

map<string, string>

Label yang terkait dengan resource ini.

fleet

Fleet

Wajib. Konfigurasi armada.

networking

ClusterNetworking

Wajib. Konfigurasi jaringan seluruh cluster.

authorization

Authorization

Wajib. Tidak dapat diubah. Kebijakan RBAC yang akan diterapkan dan dikelola oleh GEC.

default_max_pods_per_node

int32

Opsional. Jumlah maksimum pod per node default yang digunakan jika nilai maksimum tidak ditentukan secara eksplisit untuk node pool di cluster ini. Jika tidak ditentukan, nilai default Kubernetes akan digunakan.

endpoint

string

Hanya output. Alamat IP server Kubernetes API.

port

int32

Hanya output. Nomor port server Kubernetes API.

cluster_ca_certificate

string

Hanya output. Sertifikat publik berenkode PEM dari CA cluster.

maintenance_policy

MaintenancePolicy

Opsional. Konfigurasi kebijakan pemeliharaan seluruh cluster.

control_plane_version

string

Hanya output. Versi rilis bidang kontrol

node_version

string

Hanya output. Versi rilis terendah di antara semua worker node. Kolom ini dapat kosong jika cluster tidak memiliki node pekerja.

control_plane

ControlPlane

Opsional. Konfigurasi bidang kontrol cluster.

system_addons_config

SystemAddonsConfig

Opsional. Konfigurasi add-on sistem.

external_load_balancer_ipv4_address_pools[]

string

Opsional. Kumpulan alamat IPv4 untuk load balancing eksternal bidang data cluster.

control_plane_encryption

ControlPlaneEncryption

Opsional. Opsi enkripsi disk bidang kontrol jarak jauh. Kolom ini hanya digunakan saat mengaktifkan dukungan CMEK.

status

Status

Hanya output. Status cluster saat ini.

maintenance_events[]

MaintenanceEvent

Hanya output. Semua peristiwa pemeliharaan yang dijadwalkan untuk cluster, termasuk yang sedang berlangsung, direncanakan untuk masa mendatang, dan dilakukan pada masa lalu (hingga 90 hari).

target_version

string

Opsional. Versi cluster target. Misalnya: "1.5.0".

release_channel

ReleaseChannel

Opsional. Saluran rilis yang diikuti oleh cluster.

survivability_config

SurvivabilityConfig

Opsional. Konfigurasi kelangsungan cluster, misalnya, untuk kasus saat konektivitas jaringan terputus. Catatan: Setelan ini hanya berlaku untuk cluster bidang kontrol lokal.

external_load_balancer_ipv6_address_pools[]

string

Opsional. Kumpulan alamat IPv6 untuk load balancing eksternal bidang data cluster.

connection_state

ConnectionState

Hanya output. Status koneksi cluster saat ini.

external_load_balancer_address_pools[]

ExternalLoadBalancerPool

Opsional. Kumpulan load balancer eksternal untuk cluster.

zone_storage_encryption

ZoneStorageEncryption

Opsional. Konfigurasi enkripsi penyimpanan zona

container_runtime_config

ContainerRuntimeConfig

Opsional. Konfigurasi runtime container cluster.

enable_cluster_isolation

bool

Opsional. Menunjukkan apakah cluster harus diisolasi. go/cluster-isolation-in-gdcc-cluster

google_group_authentication

GoogleGroupAuthenticationConfig

Opsional. Konfigurasi autentikasi Grup Google pada cluster.

ConnectionState

ConnectionState menyimpan status koneksi saat ini dari cluster ke Google.

Kolom
state

State

Hanya output. Status koneksi saat ini.

update_time

Timestamp

Hanya output. Waktu saat status koneksi terakhir diubah.

Negara bagian/Provinsi

Status koneksi.

Enum
STATE_UNSPECIFIED Status koneksi tidak diketahui.
DISCONNECTED Cluster ini saat ini terputus dari Google.
CONNECTED Cluster ini saat ini terhubung ke Google.
CONNECTED_AND_SYNCING Cluster ini saat ini terhubung ke Google, tetapi mungkin baru-baru ini terhubung kembali setelah koneksi terputus. Perangkat masih menyinkronkan kembali.

ContainerRuntimeConfig

Konfigurasi runtime container cluster.

Kolom
default_container_runtime

DefaultContainerRuntime

Opsional. Runtime container default yang akan dikonfigurasi di cluster.

DefaultContainerRuntime

Daftar runtime container yang didukung.

Enum
DEFAULT_CONTAINER_RUNTIME_UNSPECIFIED Runtime container tidak ditentukan.
RUNC Gunakan runc sebagai runtime container default di cluster.
GVISOR Gunakan gVisor sebagai runtime container default di cluster.

ControlPlane

Konfigurasi bidang kontrol cluster.

Kolom

Kolom union config.

config hanya dapat berupa salah satu dari berikut:

remote

Remote

Konfigurasi bidang kontrol jarak jauh.

local

Local

Konfigurasi bidang kontrol lokal.

Peringatan: Cluster bidang kontrol lokal harus dibuat di projectnya sendiri. Cluster bidang kontrol lokal tidak dapat berada bersama dalam project yang sama dengan jenis cluster lainnya, termasuk cluster non-GDCE. Mencampur cluster GDCE bidang kontrol lokal dengan jenis cluster lain dalam project yang sama dapat menyebabkan kehilangan data.

Lokal

Konfigurasi khusus untuk cluster dengan bidang kontrol yang dihosting secara lokal.

Peringatan: Cluster bidang kontrol lokal harus dibuat di projectnya sendiri. Cluster bidang kontrol lokal tidak dapat berada bersama dalam project yang sama dengan jenis cluster lainnya, termasuk cluster non-GDCE. Mencampur cluster GDCE bidang kontrol lokal dengan jenis cluster lain dalam project yang sama dapat menyebabkan kehilangan data.

Kolom
node_location

string

Nama zona Google Distributed Cloud Edge tempat node pool ini akan dibuat. Misalnya: us-central1-edge-customer-a.

node_count

int32

Jumlah node yang akan berfungsi sebagai replika Bidang Kontrol.

machine_filter

string

Hanya mesin yang cocok dengan filter ini yang akan diizinkan untuk menghosting node bidang kontrol. Bahasa pemfilteran menerima string seperti "name=", dan didokumentasikan di sini: AIP-160.

shared_deployment_policy

SharedDeploymentPolicy

Konfigurasi kebijakan tentang cara aplikasi pengguna di-deploy.

control_plane_node_storage_schema

string

Opsional. Nama untuk skema penyimpanan node bidang kontrol.

Eksternal

Jenis ini tidak memiliki kolom.

Konfigurasi khusus untuk cluster dengan bidang kontrol yang dihosting dari jarak jauh.

SharedDeploymentPolicy

Mewakili konfigurasi kebijakan tentang cara aplikasi pengguna di-deploy.

Enum
SHARED_DEPLOYMENT_POLICY_UNSPECIFIED Tidak ditentukan.
ALLOWED Aplikasi pengguna dapat di-deploy di bidang kontrol dan worker node.
DISALLOWED Aplikasi pengguna tidak dapat di-deploy di node panel kontrol dan hanya dapat di-deploy di node pekerja.

ControlPlaneEncryption

Konfigurasi untuk dukungan kunci KMS yang dikelola pelanggan untuk node bidang kontrol.

Kolom
kms_key

string

Opsional. CryptoKey Cloud KMS, misalnya projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey} yang akan digunakan untuk melindungi disk bidang kontrol. Jika tidak ditentukan, kunci yang dikelola Google akan digunakan.

kms_key_active_version

string

Hanya output. CryptoKeyVersion Cloud KMS yang saat ini digunakan untuk melindungi disk bidang kontrol. Hanya berlaku jika kms_key disetel.

kms_key_state

KmsKeyState

Hanya output. Ketersediaan CryptoKey Cloud KMS. Jika tidak KEY_AVAILABLE, node dapat menjadi offline karena tidak dapat mengakses data lokalnya. Hal ini dapat disebabkan oleh kurangnya izin untuk menggunakan kunci, atau jika kunci dinonaktifkan atau dihapus.

kms_status

Status

Hanya output. Status error yang ditampilkan oleh Cloud KMS saat menggunakan kunci ini. Kolom ini hanya dapat diisi jika kms_key_state bukan KMS_KEY_STATE_KEY_AVAILABLE. Jika terisi, kolom ini berisi status error yang dilaporkan oleh Cloud KMS.

resource_state

ResourceState

Hanya output. Status resource saat ini yang terkait dengan cmek.

ExternalLoadBalancerPool

Kumpulan load balancer eksternal dengan konfigurasi kustom seperti nama, penetapan manual/otomatis, IPv4 yang tidak tumpang-tindih, dan rentang alamat IPv6 opsional.

Kolom
address_pool

string

Opsional. Nama kumpulan load balancer eksternal.

ipv4_range[]

string

Wajib. Rentang alamat IPv4 yang tidak tumpang-tindih dari kumpulan load balancer eksternal.

ipv6_range[]

string

Opsional. Rentang alamat IPv6 yang tidak tumpang-tindih dari kumpulan load balancer eksternal.

avoid_buggy_ips

bool

Opsional. Jika benar, kumpulan ini akan menghilangkan alamat IP yang diakhiri dengan .0 dan .255. Beberapa hardware jaringan akan membatalkan traffic ke alamat khusus ini. Nilai defaultnya adalah false.

manual_assign

bool

Opsional. Jika benar (true), alamat di kumpulan ini tidak otomatis ditetapkan ke Layanan Kubernetes. Jika benar (true), alamat IP dalam kumpulan ini hanya digunakan jika ditentukan secara eksplisit oleh layanan. Nilai defaultnya adalah false.

GoogleGroupAuthenticationConfig

Konfigurasi autentikasi Google Grup pada cluster. go/gdc-google-group-authentication

Kolom
enable

bool

Opsional. Jika benar (true), cluster akan dikonfigurasi untuk menggunakan autentikasi Grup Google.

MaintenanceEvent

Peristiwa Pemeliharaan adalah operasi yang dapat menyebabkan gangguan sementara pada workload cluster, termasuk upgrade cluster yang dilakukan Google atau dimulai pengguna, perubahan konfigurasi cluster yang dimulai pengguna yang memerlukan restart node, dll.

Kolom
uuid

string

Hanya output. UUID peristiwa pemeliharaan.

target_version

string

Hanya output. Versi target cluster.

operation

string

Hanya output. Operasi untuk menjalankan peristiwa pemeliharaan. Ditentukan dalam format projects/*/locations/*/operations/*. Jika peristiwa pemeliharaan dibagi menjadi beberapa operasi (misalnya karena masa pemeliharaan), operasi terbaru akan dicatat.

type

Type

Hanya output. Jenis peristiwa pemeliharaan.

schedule

Schedule

Hanya output. Jadwal acara pemeliharaan.

state

State

Hanya output. Status peristiwa pemeliharaan.

create_time

Timestamp

Hanya output. Waktu saat permintaan acara pemeliharaan dibuat.

start_time

Timestamp

Hanya output. Waktu saat peristiwa pemeliharaan dimulai.

end_time

Timestamp

Hanya output. Waktu saat peristiwa pemeliharaan berakhir, baik berhasil maupun tidak. Jika peristiwa pemeliharaan dibagi menjadi beberapa masa pemeliharaan, end_time hanya diperbarui saat seluruh alur berakhir.

update_time

Timestamp

Hanya output. Waktu saat pesan peristiwa pemeliharaan diperbarui.

Jadwal

Menunjukkan kapan peristiwa pemeliharaan harus dilakukan.

Enum
SCHEDULE_UNSPECIFIED Tidak ditentukan.
IMMEDIATELY Segera setelah menerima permintaan.

Negara bagian/Provinsi

Menunjukkan status peristiwa pemeliharaan.

Enum
STATE_UNSPECIFIED Tidak ditentukan.
RECONCILING Acara pemeliharaan sedang berlangsung. Cluster mungkin tidak dapat digunakan.
SUCCEEDED Acara pemeliharaan berhasil.
FAILED Acara pemeliharaan gagal.

Jenis

Menunjukkan jenis peristiwa pemeliharaan.

Enum
TYPE_UNSPECIFIED Tidak ditentukan.
USER_INITIATED_UPGRADE Upgrade yang dimulai oleh pengguna.
GOOGLE_DRIVEN_UPGRADE Upgrade yang didorong oleh Google.

ReleaseChannel

Saluran rilis yang diikuti oleh cluster.

Enum
RELEASE_CHANNEL_UNSPECIFIED Saluran rilis tidak ditentukan. Secara default, channel ini akan ditetapkan ke channel REGULER.
NONE Tidak ada saluran rilis.
REGULAR Saluran rilis reguler.

Status

Menunjukkan status cluster.

Enum
STATUS_UNSPECIFIED Status tidak diketahui.
PROVISIONING Cluster sedang dibuat.
RUNNING Cluster dibuat dan dapat digunakan sepenuhnya.
DELETING Cluster sedang dihapus.
ERROR Status menunjukkan bahwa terjadi beberapa error saat merekonsiliasi/menghapus cluster.
RECONCILING Cluster sedang melakukan beberapa tugas seperti upgrade versi, dll.

SurvivabilityConfig

Konfigurasi kelangsungan cluster, misalnya, untuk kasus saat konektivitas jaringan terputus.

Kolom
offline_reboot_ttl

Duration

Opsional. Periode waktu yang memungkinkan node cluster di-reboot dan berfungsi tanpa konektivitas jaringan ke Google. Nilai default 0 berarti tidak diizinkan. Durasi maksimumnya adalah 7 hari.

SystemAddonsConfig

Konfigurasi yang dapat ditentukan pelanggan untuk add-on sistem GDCE.

Kolom
ingress

Ingress

Opsional. Konfigurasi untuk Ingress.

vm_service_config

VMServiceConfig

Opsional. Konfigurasi untuk Layanan VM.

Masuk

Konfigurasi untuk add-on Ingress yang memungkinkan pelanggan membuat objek Ingress untuk mengelola akses eksternal ke server dalam cluster. Add-on ini terdiri dari istiod dan istio-ingress.

Kolom
disabled

bool

Opsional. Apakah Ingress dinonaktifkan.

ipv4_vip

string

Opsional. VIP Ingress.

VMServiceConfig

VMServiceConfig menentukan konfigurasi untuk Layanan VM GDCE.

Kolom
vmm_enabled

bool

Opsional. Apakah VMM diaktifkan.

ZoneStorageEncryption

Konfigurasi untuk Dukungan CMEK Zone Storage

Kolom
kms_key

string

Opsional. Kunci Cloud KMS

kms_key_active_version

string

Hanya output. Cloud KMS CryptoKeyVersion yang saat ini digunakan untuk enkripsi/dekripsi

resource_state

ResourceState

Hanya output. Status resource CMEK saat ini

ClusterNetworking

Konfigurasi jaringan seluruh cluster.

Kolom
cluster_ipv4_cidr_blocks[]

string

Wajib. Semua pod dalam cluster akan mendapatkan alamat IPv4 RFC1918 dari blok ini. Hanya satu blok yang didukung. Kolom ini tidak dapat diubah setelah dibuat.

services_ipv4_cidr_blocks[]

string

Wajib. Semua layanan dalam cluster akan mendapatkan alamat IPv4 RFC1918 dari blok ini. Hanya satu blok yang didukung. Kolom ini tidak dapat diubah setelah dibuat.

ClusterUser

Akun utama pengguna untuk kebijakan RBAC.

Kolom
username

string

Wajib. Nama pengguna Google yang aktif.

ConfigData

Data konfigurasi menyimpan semua data terkait konfigurasi untuk zona.

Kolom
available_external_lb_pools_ipv4[]

string

daftar kumpulan IP v4 yang tersedia untuk load balancer eksternal

available_external_lb_pools_ipv6[]

string

daftar kumpulan IP v6 yang tersedia untuk load balancer eksternal

CreateClusterRequest

Membuat cluster.

Kolom
parent

string

Wajib. Lokasi induk tempat cluster ini akan dibuat.

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • edgecontainer.clusters.create
cluster_id

string

Wajib. ID unik yang ditentukan klien untuk cluster.

cluster

Cluster

Wajib. Cluster yang akan dibuat.

request_id

string

ID unik untuk permintaan ini. Dibatasi hingga 36 karakter ASCII. UUID acak direkomendasikan. Permintaan ini hanya bersifat idempoten jika request_id diberikan.

CreateNodePoolRequest

Membuat node pool.

Kolom
parent

string

Wajib. Cluster induk tempat kumpulan node ini akan dibuat.

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • edgecontainer.nodePools.create
node_pool_id

string

Wajib. ID unik yang ditentukan klien untuk kumpulan node.

node_pool

NodePool

Wajib. Node pool yang akan dibuat.

request_id

string

ID unik untuk permintaan ini. Dibatasi hingga 36 karakter ASCII. UUID acak direkomendasikan. Permintaan ini hanya bersifat idempoten jika request_id diberikan.

CreateVpnConnectionRequest

Membuat koneksi VPN.

Kolom
parent

string

Wajib. Lokasi induk tempat koneksi VPN ini akan dibuat.

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • edgecontainer.vpnConnections.create
vpn_connection_id

string

Wajib. ID koneksi VPN.

vpn_connection

VpnConnection

Wajib. Koneksi VPN yang akan dibuat.

request_id

string

ID unik untuk permintaan ini. Dibatasi hingga 36 karakter ASCII. UUID acak direkomendasikan. Permintaan ini hanya bersifat idempoten jika request_id diberikan.

DeleteClusterRequest

Menghapus cluster.

Kolom
name

string

Wajib. Nama resource cluster.

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • edgecontainer.clusters.delete
request_id

string

ID unik untuk permintaan ini. Dibatasi hingga 36 karakter ASCII. UUID acak direkomendasikan. Permintaan ini hanya bersifat idempoten jika request_id diberikan.

DeleteNodePoolRequest

Menghapus kumpulan node.

Kolom
name

string

Wajib. Nama resource node pool.

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • edgecontainer.nodePools.delete
request_id

string

ID unik untuk permintaan ini. Dibatasi hingga 36 karakter ASCII. UUID acak direkomendasikan. Permintaan ini hanya bersifat idempoten jika request_id diberikan.

DeleteVpnConnectionRequest

Menghapus koneksi VPN.

Kolom
name

string

Wajib. Nama resource koneksi VPN.

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • edgecontainer.vpnConnections.delete
request_id

string

ID unik untuk permintaan ini. Dibatasi hingga 36 karakter ASCII. UUID acak direkomendasikan. Permintaan ini hanya bersifat idempoten jika request_id diberikan.

Fleet

Konfigurasi terkait fleet.

Fleet adalah konsep Google Cloud untuk mengatur cluster secara logis, sehingga memungkinkan Anda menggunakan dan mengelola kemampuan multi-cluster serta menerapkan kebijakan yang konsisten di seluruh sistem Anda.

Kolom
project

string

Wajib. Nama project host Fleet tempat cluster ini akan didaftarkan.

Nama project diformat sebagai projects/<project-number>.

membership

string

Hanya output. Nama resource Keanggotaan Hub terkelola yang terkait dengan cluster ini.

Nama keanggotaan diformat sebagai projects/<project-number>/locations/global/membership/<cluster-id>.

GenerateAccessTokenRequest

Membuat token akses untuk cluster.

Kolom
cluster

string

Wajib. Nama resource cluster.

Otorisasi memerlukan izin IAM berikut pada cluster resource yang ditentukan:

  • edgecontainer.clusters.generateAccessToken

GenerateAccessTokenResponse

Token akses untuk cluster.

Kolom
access_token

string

Hanya output. Token akses untuk mengautentikasi ke server API k8s.

expire_time

Timestamp

Hanya output. Stempel waktu saat token akan berakhir masa berlakunya.

GenerateOfflineCredentialRequest

Membuat kredensial offline(offline) untuk cluster.

Kolom
cluster

string

Wajib. Nama resource cluster.

Otorisasi memerlukan izin IAM berikut pada cluster resource yang ditentukan:

  • edgecontainer.clusters.generateOfflineCredential

GenerateOfflineCredentialResponse

Kredensial offline untuk cluster.

Kolom
client_certificate

string

Hanya output. Sertifikat klien untuk mengautentikasi ke server API k8s.

client_key

string

Hanya output. Kunci pribadi klien untuk mengautentikasi ke server API k8s.

user_id

string

Hanya output. Identitas klien.

expire_time

Timestamp

Hanya output. Stempel waktu saat masa berlaku kredensial ini akan berakhir.

GetClusterRequest

Mendapatkan cluster.

Kolom
name

string

Wajib. Nama resource cluster.

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • edgecontainer.clusters.get

GetMachineRequest

Mendapatkan mesin.

Kolom
name

string

Wajib. Nama resource mesin.

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • edgecontainer.machines.get

GetNodePoolRequest

Mendapatkan node pool.

Kolom
name

string

Wajib. Nama resource node pool.

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • edgecontainer.nodePools.get

GetServerConfigRequest

Mendapatkan konfigurasi server.

Kolom
name

string

Wajib. Nama (project dan lokasi) konfigurasi server yang akan didapatkan, ditentukan dalam format projects/*/locations/*.

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • edgecontainer.serverConfig.get

GetVpnConnectionRequest

Mendapatkan koneksi VPN.

Kolom
name

string

Wajib. Nama resource koneksi VPN.

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • edgecontainer.vpnConnections.get

KmsKeyState

Mewakili status aksesibilitas kunci KMS yang dikelola pelanggan yang digunakan untuk integrasi CMEK.

Enum
KMS_KEY_STATE_UNSPECIFIED Tidak ditentukan.
KMS_KEY_STATE_KEY_AVAILABLE Kunci tersedia untuk digunakan, dan resource dependen harus dapat diakses.
KMS_KEY_STATE_KEY_UNAVAILABLE Kunci tidak tersedia karena alasan yang tidak ditentukan. Resource dependen mungkin tidak dapat diakses.

ListClustersRequest

Mencantumkan cluster di suatu lokasi.

Kolom
parent

string

Wajib. Lokasi induk, yang memiliki kumpulan cluster ini.

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • edgecontainer.clusters.list
page_size

int32

Jumlah maksimum resource yang akan dicantumkan.

page_token

string

Token halaman yang diterima dari permintaan daftar sebelumnya. Token halaman yang diterima dari permintaan daftar sebelumnya.

filter

string

Hanya resource yang cocok dengan filter ini yang akan dicantumkan.

order_by

string

Menentukan urutan resource akan dicantumkan.

ListClustersResponse

Daftar cluster di suatu lokasi.

Kolom
clusters[]

Cluster

Cluster di lokasi.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya.

unreachable[]

string

Lokasi yang tidak dapat dijangkau.

ListMachinesRequest

Mencantumkan komputer di situs.

Kolom
parent

string

Wajib. Situs induk, yang memiliki kumpulan mesin ini.

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • edgecontainer.machines.list
page_size

int32

Jumlah maksimum resource yang akan dicantumkan.

page_token

string

Token halaman yang diterima dari permintaan daftar sebelumnya.

filter

string

Hanya resource yang cocok dengan filter ini yang akan dicantumkan.

order_by

string

Menentukan urutan resource akan dicantumkan.

ListMachinesResponse

Daftar komputer di situs.

Kolom
machines[]

Machine

Mesin di situs.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya.

unreachable[]

string

Lokasi yang tidak dapat dijangkau.

ListNodePoolsRequest

Mencantumkan node pool dalam cluster.

Kolom
parent

string

Wajib. Cluster induk, yang memiliki kumpulan node ini.

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • edgecontainer.nodePools.list
page_size

int32

Jumlah maksimum resource yang akan dicantumkan.

page_token

string

Token halaman yang diterima dari permintaan daftar sebelumnya.

filter

string

Hanya resource yang cocok dengan filter ini yang akan dicantumkan.

order_by

string

Menentukan urutan resource akan dicantumkan.

ListNodePoolsResponse

Daftar node pool dalam cluster.

Kolom
node_pools[]

NodePool

Kumpulan node di cluster.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya.

unreachable[]

string

Lokasi yang tidak dapat dijangkau.

ListVpnConnectionsRequest

Mencantumkan koneksi VPN.

Kolom
parent

string

Wajib. Lokasi induk, yang memiliki kumpulan koneksi VPN ini.

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • edgecontainer.vpnConnections.list
page_size

int32

Jumlah maksimum resource yang akan dicantumkan.

page_token

string

Token halaman yang diterima dari permintaan daftar sebelumnya.

filter

string

Hanya resource yang cocok dengan filter ini yang akan dicantumkan.

order_by

string

Menentukan urutan resource akan dicantumkan.

ListVpnConnectionsResponse

Daftar koneksi VPN di suatu lokasi.

Kolom
vpn_connections[]

VpnConnection

VpnConnections di lokasi.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya.

unreachable[]

string

Lokasi yang tidak dapat dijangkau.

LocationMetadata

Metadata untuk google.cloud.location.Location tertentu.

Kolom
available_zones

map<string, ZoneMetadata>

Kumpulan zona Google Distributed Cloud Edge yang tersedia di lokasi. Peta dikunci oleh ID huruf kecil setiap zona.

Mesin

Mesin Google Distributed Cloud Edge yang dapat bertindak sebagai node Kubernetes.

Kolom
name

string

Wajib. Nama resource mesin.

create_time

Timestamp

Hanya output. Waktu saat kumpulan node dibuat.

update_time

Timestamp

Hanya output. Waktu saat kumpulan node terakhir diperbarui.

labels

map<string, string>

Label yang terkait dengan resource ini.

hosted_node

string

Nama resource kanonis node yang bertanggung jawab untuk menghosting mesin ini, misalnya projects/{project}/locations/{location}/clusters/{cluster_id}/nodePools/{pool_id}/{node}, atau kosong jika mesin tidak ditetapkan untuk mengambil peran node.

Untuk node bidang kontrol yang dihosting di mesin edge, perintah ini akan menampilkan format berikut: "projects/{project}/locations/{location}/clusters/{cluster_id}/controlPlaneNodes/{node}".

zone

string

Zona Google Distributed Cloud Edge dari mesin ini.

version

string

Hanya output. Versi software mesin.

disabled

bool

Hanya output. Apakah mesin dinonaktifkan. Jika dinonaktifkan, mesin tidak dapat memasuki layanan.

status

Status

Hanya output. Status mesin saat ini.

purpose

Purpose

Jenis cluster yang digunakan mesin.

Tujuan

Tujuan mesin dapat berupa VIRTUALIZED_WORKLOAD atau BAREMETAL_CLUSTER.

Enum
PURPOSE_UNSPECIFIED Tujuan tidak ditentukan.
VIRTUALIZED_WORKLOAD Mesin digunakan untuk workload virtual.
BAREMETAL_CLUSTER Machine digunakan untuk cluster pengguna bare metal.

Status

Menunjukkan status mesin.

Enum
STATUS_UNSPECIFIED Status tidak diketahui.
READY Komputer siap menghosting node. Ini adalah setelan defaultnya.
DISABLED_FOR_REPAIR Mesin telah dinonaktifkan untuk perbaikan dengan menambahkan 1 atau beberapa klaim penonaktifan.

MaintenanceExclusionWindow

Menunjukkan periode pengecualian pemeliharaan.

Kolom
window

TimeWindow

Opsional. Periode waktu.

id

string

Opsional. ID unik (per cluster) untuk jendela.

MaintenancePolicy

Konfigurasi kebijakan pemeliharaan.

Kolom
window

MaintenanceWindow

Menentukan masa pemeliharaan saat pemeliharaan dapat dilakukan.

maintenance_exclusions[]

MaintenanceExclusionWindow

Opsional. Pengecualian untuk pemeliharaan otomatis. Pemeliharaan non-darurat tidak boleh terjadi dalam periode ini. Setiap pengecualian memiliki nama unik dan dapat aktif atau sudah berakhir. Jumlah maksimum pengecualian pemeliharaan yang diizinkan pada waktu tertentu adalah 3.

MaintenanceWindow

Konfigurasi masa pemeliharaan

Kolom
recurring_window

RecurringTimeWindow

Konfigurasi masa pemeliharaan berulang.

NodePool

Sekumpulan node Kubernetes dalam cluster dengan konfigurasi dan spesifikasi yang sama.

Kolom
name

string

Wajib. Nama resource node pool.

create_time

Timestamp

Hanya output. Waktu saat kumpulan node dibuat.

update_time

Timestamp

Hanya output. Waktu saat kumpulan node terakhir diperbarui.

labels

map<string, string>

Label yang terkait dengan resource ini.

node_location

string

Nama zona Google Distributed Cloud Edge tempat node pool ini akan dibuat. Misalnya: us-central1-edge-customer-a.

node_count

int32

Wajib. Jumlah node dalam pool.

machine_filter

string

Hanya mesin yang cocok dengan filter ini yang akan diizinkan untuk bergabung dengan node pool. Bahasa pemfilteran menerima string seperti "name=", dan didokumentasikan secara lebih mendetail di AIP-160.

local_disk_encryption

LocalDiskEncryption

Opsional. Opsi enkripsi disk lokal. Kolom ini hanya digunakan saat mengaktifkan dukungan CMEK.

node_version

string

Hanya output. Versi rilis terendah di antara semua worker node.

node_config

NodeConfig

Opsional. Konfigurasi untuk setiap node di NodePool

LocalDiskEncryption

Konfigurasi untuk dukungan CMEK bagi enkripsi disk lokal mesin edge.

Kolom
kms_key

string

Opsional. Cloud KMS CryptoKey, misalnya projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey} yang akan digunakan untuk melindungi disk lokal node. Jika tidak ditentukan, kunci yang dikelola Google akan digunakan.

kms_key_active_version

string

Hanya output. CryptoKeyVersion Cloud KMS yang saat ini digunakan untuk melindungi disk lokal node. Hanya berlaku jika kms_key disetel.

kms_key_state

KmsKeyState

Hanya output. Ketersediaan CryptoKey Cloud KMS. Jika tidak KEY_AVAILABLE, node dapat menjadi offline karena tidak dapat mengakses data lokalnya. Hal ini dapat disebabkan oleh kurangnya izin untuk menggunakan kunci, atau jika kunci dinonaktifkan atau dihapus.

kms_status

Status

Hanya output. Status error yang ditampilkan oleh Cloud KMS saat menggunakan kunci ini. Kolom ini hanya dapat diisi jika kms_key_state bukan KMS_KEY_STATE_KEY_AVAILABLE. Jika terisi, kolom ini berisi status error yang dilaporkan oleh Cloud KMS.

resource_state

ResourceState

Hanya output. Status resource saat ini yang terkait dengan cmek.

NodeConfig

Konfigurasi untuk setiap node di NodePool

Kolom
labels

map<string, string>

Opsional. Label node Kubernetes

node_storage_schema

string

Opsional. Nama untuk skema penyimpanan node pekerja.

OperationMetadata

Metadata operasi yang berjalan lama untuk metode Edge Container API.

Kolom
create_time

Timestamp

Waktu pembuatan operasi.

end_time

Timestamp

Waktu selesainya operasi.

target

string

Jalur resource yang ditentukan server untuk target operasi.

verb

string

Kata kerja yang dijalankan oleh operasi.

status_message

string

Status operasi yang dapat dibaca manusia, jika ada.

requested_cancellation

bool

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

api_version

string

Versi API yang digunakan untuk memulai operasi.

warnings[]

string

Peringatan yang tidak memblokir operasi, tetapi tetap menyimpan informasi yang relevan untuk diterima pengguna akhir.

status_reason

StatusReason

Status operasi yang dapat dibaca mesin, jika ada.

StatusReason

Menunjukkan alasan status operasi.

Enum
STATUS_REASON_UNSPECIFIED Alasan tidak diketahui.
UPGRADE_PAUSED Upgrade cluster saat ini dijeda.

Kuota

Menunjukkan kuota untuk resource Edge Container.

Kolom
metric

string

Nama metrik kuota.

limit

double

Batas kuota untuk metrik ini.

usage

double

Penggunaan metrik ini saat ini.

RecurringTimeWindow

Mewakili periode waktu arbitrer yang berulang.

Kolom
window

TimeWindow

Periode pengulangan pertama.

recurrence

string

RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) untuk cara pengulangan periode ini. Mereka terus berlanjut selama rentang waktu antara waktu mulai dan akhir.

ResourceState

Menunjukkan apakah resource dalam status terkunci atau menunggu keputusan.

Enum
RESOURCE_STATE_UNSPECIFIED Nilai default.
RESOURCE_STATE_LOCK_DOWN Resource dalam status LOCK DOWN.
RESOURCE_STATE_LOCK_DOWN_PENDING Resource menunggu penonaktifan.

ServerConfig

Konfigurasi server untuk versi dan saluran rilis yang didukung.

Kolom
channels

map<string, ChannelConfig>

Hanya output. Pemetaan dari saluran rilis ke konfigurasi saluran.

versions[]

Version

Hanya output. Versi yang didukung, misalnya: ["1.4.0", "1.5.0"].

default_version

string

Hanya output. Versi default, misalnya: "1.4.0".

TimeWindow

Mewakili periode waktu arbitrer.

Kolom
start_time

Timestamp

Waktu saat jendela pertama kali dimulai.

end_time

Timestamp

Waktu berakhirnya periode. Waktu berakhir harus terjadi setelah waktu mulai.

UpdateClusterRequest

Memperbarui cluster.

Kolom
update_mask

FieldMask

Mask kolom digunakan untuk menentukan kolom yang akan diganti dalam resource Cluster oleh update. Kolom yang ditentukan dalam update_mask bersifat relatif terhadap resource, bukan permintaan lengkap. Kolom akan ditimpa jika ada di mask. Jika pengguna tidak memberikan mask, semua kolom akan ditimpa.

cluster

Cluster

Cluster yang diperbarui.

Otorisasi memerlukan izin IAM berikut pada cluster resource yang ditentukan:

  • edgecontainer.clusters.update
request_id

string

ID unik untuk permintaan ini. Dibatasi hingga 36 karakter ASCII. UUID acak direkomendasikan. Permintaan ini hanya bersifat idempoten jika request_id diberikan.

UpdateNodePoolRequest

Memperbarui node pool.

Kolom
update_mask

FieldMask

Mask kolom digunakan untuk menentukan kolom yang akan diganti dalam resource NodePool oleh pembaruan. Kolom yang ditentukan dalam update_mask bersifat relatif terhadap resource, bukan permintaan lengkap. Kolom akan ditimpa jika ada di mask. Jika pengguna tidak memberikan mask, semua kolom akan ditimpa.

node_pool

NodePool

Kumpulan node yang diperbarui.

Otorisasi memerlukan izin IAM berikut pada nodePool resource yang ditentukan:

  • edgecontainer.nodePools.update
request_id

string

ID unik untuk permintaan ini. Dibatasi hingga 36 karakter ASCII. UUID acak direkomendasikan. Permintaan ini hanya bersifat idempoten jika request_id diberikan.

UpgradeClusterRequest

Mengupgrade cluster.

Kolom
name

string

Wajib. Nama resource cluster.

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • edgecontainer.clusters.upgrade
target_version

string

Wajib. Versi yang akan diupgrade cluster.

schedule

Schedule

Jadwal upgrade.

request_id

string

ID unik untuk permintaan ini. Dibatasi hingga 36 karakter ASCII. UUID acak direkomendasikan. Permintaan ini hanya bersifat idempoten jika request_id diberikan.

Jadwal

Mewakili jadwal tentang kapan cluster akan diupgrade.

Enum
SCHEDULE_UNSPECIFIED Tidak ditentukan. Defaultnya adalah mengupgrade cluster secara langsung yang merupakan satu-satunya opsi saat ini.
IMMEDIATELY Cluster akan diupgrade segera setelah menerima permintaan.

Versi

Versi cluster.

Kolom
name

string

Hanya output. Nama versi, misalnya: "1.4.0".

VpnConnection

Koneksi VPN .

Kolom
name

string

Wajib. Nama resource koneksi VPN

create_time

Timestamp

Hanya output. Waktu saat koneksi VPN dibuat.

update_time

Timestamp

Hanya output. Waktu saat koneksi VPN terakhir diperbarui.

labels

map<string, string>

Label yang terkait dengan resource ini.

nat_gateway_ip

string

IP gateway NAT, atau alamat IP WAN. Jika pelanggan memiliki beberapa IP NAT, pelanggan harus mengonfigurasi NAT sehingga hanya satu IP eksternal yang dipetakan ke cluster Anthos GMEC. Kolom ini kosong jika NAT tidak digunakan.

bgp_routing_mode
(deprecated)

BgpRoutingMode

Mode perutean dinamis jaringan VPC, regional atau global.

cluster

string

Nama Cluster kanonis yang akan dihubungkan. Nilai ini dalam bentuk projects/{project}/locations/{location}/clusters/{cluster}.

vpc

string

ID jaringan VPC yang akan dihubungkan.

vpc_project

VpcProject

Opsional. Detail project jaringan VPC. Diperlukan jika VPC berada di project yang berbeda dengan project cluster.

enable_high_availability

bool

Apakah koneksi VPN ini mengaktifkan HA di sisi cluster. Jika diaktifkan, saat membuat koneksi VPN, kami akan mencoba menggunakan 2 IP mengambang ANG.

router

string

Opsional. Nama Cloud Router koneksi VPN.

details

Details

Hanya output. Detail koneksi yang dibuat.

BgpRoutingMode

Mode perutean.

Enum
BGP_ROUTING_MODE_UNSPECIFIED Tidak diketahui.
REGIONAL Mode regional.
GLOBAL Mode global.

Detail

Detail koneksi yang dibuat.

Kolom
state

State

Status koneksi ini.

error

string

Pesan error. Kolom ini hanya diisi jika state=ERROR.

cloud_router

CloudRouter

Info Cloud Router.

cloud_vpns[]

CloudVpn

Setiap koneksi memiliki beberapa gateway Cloud VPN.

CloudRouter

Info Cloud Router.

Kolom
name

string

Nama Cloud Router terkait.

CloudVpn

Info Cloud VPN.

Kolom
gateway

string

Nama gateway Cloud VPN yang dibuat.

Negara bagian/Provinsi

Status koneksi saat ini.

Enum
STATE_UNSPECIFIED Tidak diketahui.
STATE_CONNECTED Terhubung.
STATE_CONNECTING Masih menghubungkan.
STATE_ERROR Terjadi error.

VpcProject

Detail project jaringan VPC.

Kolom
project_id

string

Project VPC yang akan dihubungkan. Jika tidak ditentukan, project ini sama dengan project cluster.

service_account
(deprecated)

string

Opsional. Tidak digunakan lagi: jangan gunakan.

ZoneMetadata

Zona Google Distributed Cloud Edge tempat mesin edge berada.

Kolom
quota[]

Quota

Kuota untuk resource di zona ini.

rack_types

map<string, RackType>

Peta yang dikelompokkan berdasarkan nama rak dan memiliki nilai RackType.

config_data

ConfigData

Data konfigurasi untuk zona.

RackType

Jenis rak.

Enum
RACK_TYPE_UNSPECIFIED Jenis rak tidak ditentukan, rak tunggal juga termasuk dalam jenis ini.
BASE Jenis rak dasar, sepasang dua rak Config-1 yang dimodifikasi berisi switch Agregasi.
EXPANSION Jenis rak ekspansi, yang juga dikenal sebagai rak mandiri, ditambahkan oleh pelanggan sesuai permintaan.