Package google.cloud.edgecontainer.v1alpha

索引

EdgeContainer

EdgeContainer API 可讓您管理 Google Edge Cloud 部署作業中的 Kubernetes 叢集。

CreateApiKey

rpc CreateApiKey(CreateApiKeyRequest) returns (Operation)

CreateApiKey 會為指定的專案服務帳戶建立 API 金鑰。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
CreateCluster

rpc CreateCluster(CreateClusterRequest) returns (Operation)

在指定專案和位置建立新叢集。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
CreateIdentityProvider

rpc CreateIdentityProvider(CreateIdentityProviderRequest) returns (Operation)

在基礎架構叢集中設定識別資訊提供者。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
CreateNodePool

rpc CreateNodePool(CreateNodePoolRequest) returns (Operation)

在指定專案和位置建立新的 NodePool。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
CreateServiceAccount

rpc CreateServiceAccount(CreateServiceAccountRequest) returns (Operation)

CreateServiceAccount 會在叢集的專案命名空間 (V2 為基礎架構叢集，V1 為使用者叢集) 中，建立專案服務帳戶 CR。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
CreateVpnConnection

rpc CreateVpnConnection(CreateVpnConnectionRequest) returns (Operation)

在指定專案和位置建立新的 VPN 連線。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
DeleteApiKey

rpc DeleteApiKey(DeleteApiKeyRequest) returns (Operation)

DeleteApiKey 會刪除指定專案服務帳戶的 API 金鑰。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
DeleteCluster

rpc DeleteCluster(DeleteClusterRequest) returns (Operation)

刪除單一叢集。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
DeleteIdentityProvider

rpc DeleteIdentityProvider(DeleteIdentityProviderRequest) returns (Operation)

DeleteIdentityProvider 會從基礎架構叢集移除識別資訊提供者。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
DeleteNodePool

rpc DeleteNodePool(DeleteNodePoolRequest) returns (Operation)

刪除單一 NodePool。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
DeleteServiceAccount

rpc DeleteServiceAccount(DeleteServiceAccountRequest) returns (Operation)

DeleteServiceAccount 會刪除叢集 (V2 為基礎架構叢集，V1 為使用者叢集) 專案命名空間中的專案服務帳戶 CR。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
DeleteVpnConnection

rpc DeleteVpnConnection(DeleteVpnConnectionRequest) returns (Operation)

刪除單一 VPN 連線。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
DescribeServiceAccountKey

rpc DescribeServiceAccountKey(DescribeServiceAccountKeyRequest) returns (DescribeServiceAccountKeyResponse)

DescribeServiceAccountKey 會列出指定服務帳戶資源的所有金鑰。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
DisableServiceAccountKey

rpc DisableServiceAccountKey(DisableServiceAccountKeyRequest) returns (DisableServiceAccountKeyResponse)

DisableServiceAccountKey 會停用指定的服務帳戶金鑰。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
EnableZonalProject

rpc EnableZonalProject(EnableZonalProjectRequest) returns (Operation)

EnableZonalProject 會在可用區啟用用戶專案。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
EnableZonalService

rpc EnableZonalService(EnableZonalServiceRequest) returns (Operation)

EnableZonalService 會在可用區啟用服務。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GenerateAccessToken

rpc GenerateAccessToken(GenerateAccessTokenRequest) returns (GenerateAccessTokenResponse)

產生叢集的存取權杖。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GenerateOfflineCredential

rpc GenerateOfflineCredential(GenerateOfflineCredentialRequest) returns (GenerateOfflineCredentialResponse)

產生叢集的離線憑證。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GenerateServiceAccountKey

rpc GenerateServiceAccountKey(GenerateServiceAccountKeyRequest) returns (GenerateServiceAccountKeyResponse)

GenerateServiceAccountKey 會為指定的服務帳戶資源產生金鑰組。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetApiKey

rpc GetApiKey(GetApiKeyRequest) returns (ApiKey)

取得單一 ApiKey 的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetCluster

rpc GetCluster(GetClusterRequest) returns (Cluster)

取得單一叢集的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetIamPolicy

rpc GetIamPolicy(GetIamPolicyRequest) returns (IamPolicy)

GetIamPolicy 會取得基礎架構叢集中專案的 IAM 政策。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetIdentityProvider

rpc GetIdentityProvider(GetIdentityProviderRequest) returns (IdentityProvider)

GetIdentityProvider 會取得識別資訊提供者詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetMachine

rpc GetMachine(GetMachineRequest) returns (Machine)

取得單一機器的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetNodePool

rpc GetNodePool(GetNodePoolRequest) returns (NodePool)

取得單一 NodePool 的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetServerConfig

rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig)

取得伺服器設定。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetServiceAccount

rpc GetServiceAccount(GetServiceAccountRequest) returns (ServiceAccount)

GetServiceAccount 會取得服務帳戶詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetVpnConnection

rpc GetVpnConnection(GetVpnConnectionRequest) returns (VpnConnection)

取得單一 VPN 連線的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetZonalProject

rpc GetZonalProject(GetZonalProjectRequest) returns (ZonalProject)

GetZonalProject 會取得 ZonalProject。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetZonalService

rpc GetZonalService(GetZonalServiceRequest) returns (ZonalService)

GetEnabledZonalService 會取得已啟用服務的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
GetZone

rpc GetZone(GetZoneRequest) returns (Zone)

取得已啟用上層組織的單一可用區詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListApiKeys

rpc ListApiKeys(ListApiKeysRequest) returns (ListApiKeysResponse)

列出指定專案和位置中的 ApiKey。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListClusters

rpc ListClusters(ListClustersRequest) returns (ListClustersResponse)

列出指定專案和位置中的叢集。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListIdentityProviders

rpc ListIdentityProviders(ListIdentityProvidersRequest) returns (ListIdentityProvidersResponse)

列出基礎架構叢集中設定的識別資訊提供者。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListMachines

rpc ListMachines(ListMachinesRequest) returns (ListMachinesResponse)

列出指定專案和位置中的機器。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListNodePools

rpc ListNodePools(ListNodePoolsRequest) returns (ListNodePoolsResponse)

列出指定專案和位置中的節點集區。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListRoles

rpc ListRoles(ListRolesRequest) returns (ListRolesResponse)

ListRoles 會列出可用區中專案的 IAM 角色。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListServiceAccountKeys

rpc ListServiceAccountKeys(ListServiceAccountKeysRequest) returns (ListServiceAccountKeysResponse)

ListServiceAccountKeys 會列出指定服務帳戶資源的所有金鑰。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListServiceAccounts

rpc ListServiceAccounts(ListServiceAccountsRequest) returns (ListServiceAccountsResponse)

ListServiceAccounts 會列出叢集內專案 (V2 為基礎架構叢集，V1 為使用者叢集) 所有服務帳戶資源的詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListVpnConnections

rpc ListVpnConnections(ListVpnConnectionsRequest) returns (ListVpnConnectionsResponse)

列出指定專案和位置中的 VPN 連線。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListZonalProjects

rpc ListZonalProjects(ListZonalProjectsRequest) returns (ListZonalProjectsResponse)

列出可用區中的 ZonalProjects。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListZonalServices

rpc ListZonalServices(ListZonalServicesRequest) returns (ListZonalServicesResponse)

列出指定專案和位置中的 ZonalServices。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
ListZones

rpc ListZones(ListZonesRequest) returns (ListZonesResponse)

列出已啟用上層組織的可用區。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
SetIamPolicy

rpc SetIamPolicy(SetIamPolicyRequest) returns (IamPolicy)

SetIamPolicy 會為基礎架構叢集中的專案設定 IAM 政策。並以提供的政策覆寫現有政策。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
UpdateCluster

rpc UpdateCluster(UpdateClusterRequest) returns (Operation)

更新單一叢集的參數。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
UpdateNodePool

rpc UpdateNodePool(UpdateNodePoolRequest) returns (Operation)

更新單一 NodePool 的參數。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。
UpgradeCluster

rpc UpgradeCluster(UpgradeClusterRequest) returns (Operation)

升級單一叢集。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。

ApiKey

代表 API 金鑰資源。

欄位
name

string

ID。API 金鑰的標準資源名稱，例如：projects/{project}/locations/{location}/apiKeys/{api_key}
service_account_name

string

這是必要旗標，與 API 金鑰相關聯的服務帳戶標準資源名稱。
zone

string

這是必要旗標，建立專案服務帳戶的可用區 ID。
validity

Duration

選用。僅限輸入。API 金鑰的有效期間。
api_targets[]

ApiTarget

選用。API 金鑰受限的 API 目標。如果留空，則允許所有 API。
labels

map<string, string>

選用。與這項資源相關聯的標籤。
key

string

僅供輸出。APIKey CR 狀態中的 apikey 字串。
expire_time

Timestamp

僅供輸出。根據 key_generation_time 和有效時間長度設定
state

State

僅供輸出。叢集中 API 金鑰 CR 的狀態。
reason

string

僅供輸出。APIKey CR 狀態的原因。
create_time

Timestamp

僅供輸出。API 金鑰的產生時間。
delete_time

Timestamp

僅供輸出。刪除 API 金鑰資源的時間。
update_time

Timestamp

僅供輸出。API 金鑰資源上次更新的時間。

ApiTarget

代表 API 金鑰的限制。這項資訊由使用者提供。

欄位
service

string

選用。服務的 FQDN (在 API 呼叫中會與 req.Host 進行比對)。
methods[]

string

選用。遵循 GCP API 目標限制中的規則，支援萬用字元。如果留空，則允許所有方法。

狀態

叢集中 API 金鑰的狀態。

列舉
STATE_UNKNOWN 如果尚未執行對帳，則狀態不明。
ACTIVE 金鑰有效，可用於驗證。
NOT_ACTIVE 金鑰未啟用，無法用於驗證。如果金鑰已過期、服務帳戶未啟用，或發生內部錯誤，就可能出現這種情況。
REPAIRING 正在修復/協調金鑰。

授權

由 GEC 套用及管理的 RBAC 政策。

欄位
admin_users

ClusterUser

這是必要旗標，會在叢集中獲得叢集管理員角色的使用者，具備叢集的完整存取權。目前這個欄位只能輸入一個值，但日後會擴充為可輸入多個管理員。

ChannelConfig

發布管道的設定。

欄位
default_version

string

僅供輸出。這個發布管道的預設版本，例如："1.4.0"。

叢集

Google Distributed Cloud Edge Kubernetes 叢集。

欄位
name

string

這是必要旗標，叢集的資源名稱。
create_time

Timestamp

僅供輸出。叢集的建立時間。
update_time

Timestamp

僅供輸出。上次更新叢集的時間。
labels

map<string, string>

與這項資源相關聯的標籤。
fleet

Fleet

這是必要旗標，機群設定。
networking

ClusterNetworking

這是必要旗標，叢集層級網路設定。
authorization

Authorization

這是必要旗標，不可變動。由 GEC 套用及管理的 RBAC 政策。
default_max_pods_per_node

int32

選用。當這個叢集中未明確指定節點集區的最大值時，每個節點的預設 pod 數量上限。如未指定，系統會使用 Kubernetes 預設值。
endpoint

string

僅供輸出。Kubernetes API 伺服器的 IP 位址。
port

int32

僅供輸出。Kubernetes API 伺服器的通訊埠號碼。
cluster_ca_certificate

string

僅供輸出。叢集 CA 的 PEM 編碼公開憑證。
maintenance_policy

MaintenancePolicy

選用。叢集層級維護政策設定。
control_plane_version

string

僅供輸出。控制層發布版本
node_version

string

僅供輸出。所有 worker 節點中最低的發布版本。如果叢集沒有任何 worker 節點，這個欄位可以留空。
control_plane

ControlPlane

選用。叢集控制層的設定。
system_addons_config

SystemAddonsConfig

選用。系統外掛程式的設定。
external_load_balancer_ipv4_address_pools[]

string

選用。叢集資料層外部負載平衡的 IPv4 位址集區。
control_plane_encryption

ControlPlaneEncryption

選用。遠端控制層磁碟加密選項。只有在啟用 CMEK 支援時，才會使用這個欄位。
status

Status

僅供輸出。叢集的目前狀態。
maintenance_events[]

MaintenanceEvent

僅供輸出。叢集排定的所有維護事件，包括進行中、未來計畫和過去完成的事件 (最多 90 天)。
target_version

string

選用。目標叢集版本。例如：「1.5.0」。
release_channel

ReleaseChannel

選用。叢集訂閱的發布管道。
survivability_config

SurvivabilityConfig

選用。叢集存續能力的設定，例如網路連線中斷時。注意：這項設定僅適用於本機控制層叢集。
external_load_balancer_ipv6_address_pools[]

string

選用。叢集資料層外部負載平衡的 IPv6 位址集區。
connection_state

ConnectionState

僅供輸出。叢集目前的連線狀態。
external_load_balancer_address_pools[]

ExternalLoadBalancerPool

選用。叢集的外部負載平衡器集區。
zone_storage_encryption

ZoneStorageEncryption

選用。可用區儲存空間加密設定
container_runtime_config

ContainerRuntimeConfig

選用。叢集的容器執行階段設定。
enable_remote_backup

bool

選用。如果設為 true，系統會為這個叢集啟用遠端備份/還原功能。
enable_cluster_isolation

bool

選用。這表示是否需要隔離叢集。go/cluster-isolation-in-gdcc-cluster
google_group_authentication

GoogleGroupAuthenticationConfig

選用。叢集的 Google 群組驗證設定。

ConnectionState

ConnectionState 會保留叢集與 Google 之間的目前連線狀態。

欄位
state

State

僅供輸出。目前的連線狀態。
update_time

Timestamp

僅供輸出。上次變更連線狀態的時間。

狀態

連線狀態。

列舉
STATE_UNSPECIFIED 連線狀態不明。
DISCONNECTED 這個叢集目前與 Google 中斷連線。
CONNECTED 這個叢集目前已連線至 Google。
CONNECTED_AND_SYNCING 這個叢集目前已連線至 Google，但最近可能曾中斷連線，然後重新連線。系統仍在同步處理。

ContainerRuntimeConfig

叢集的容器執行階段設定。

欄位
default_container_runtime

DefaultContainerRuntime

選用。要在叢集中設定的預設容器執行階段。

DefaultContainerRuntime

支援的容器執行階段清單。

列舉
DEFAULT_CONTAINER_RUNTIME_UNSPECIFIED 未指定容器執行階段。
RUNC 在叢集中使用 runc 做為預設容器執行階段。
GVISOR 在叢集中使用 gVisor 做為預設容器執行階段。

ControlPlane

叢集控制層的設定。

欄位

聯集欄位 config。

config 只能是下列其中一個設定：
remote

Remote

遠端控制層設定。
local

Local

本機控制層設定。

警告：本機控制層叢集必須在專屬專案中建立。本機控制層叢集無法與任何其他類型的叢集 (包括非 GDCE 叢集) 共存於同一個專案。在同一項專案中，將本機控制層 GDCE 叢集與任何其他類型的叢集混用，可能會導致資料遺失。

本機

控制層託管於本機的叢集專用設定。

警告：本機控制層叢集必須在專屬專案中建立。本機控制層叢集無法與任何其他類型的叢集 (包括非 GDCE 叢集) 共存於同一個專案。在同一項專案中，將本機控制層 GDCE 叢集與任何其他類型的叢集混用，可能會導致資料遺失。

欄位
node_location

string

要建立這個節點集區的 Google Distributed Cloud Edge 可用區名稱。例如：us-central1-edge-customer-a。
node_count

int32

做為控制層副本的節點數量。
machine_filter

string

只有符合這個篩選條件的機器，才能託管控制層節點。篩選語言接受「name=」等字串，詳情請參閱 AIP-160。
shared_deployment_policy

SharedDeploymentPolicy

使用者應用程式部署方式的政策設定。
control_plane_node_storage_schema

string

選用。控制層節點的儲存空間結構定義名稱。
control_plane_node_system_partition_size

SystemPartitionGiBSize

選用。控制層節點的系統分區大小 (以 GiB 為單位)。

遠端

這個類型沒有任何欄位。

控制層託管於遠端的叢集專用設定。

SharedDeploymentPolicy

代表使用者應用程式部署方式的政策設定。

列舉
SHARED_DEPLOYMENT_POLICY_UNSPECIFIED 未指定。
ALLOWED 使用者應用程式可以部署至控制層和 worker 節點。
DISALLOWED 使用者應用程式無法部署至控制層節點，只能部署至 worker 節點。

ControlPlaneEncryption

控制層節點的客戶自行管理 KMS 金鑰支援設定。

欄位
kms_key

string

選用。Cloud KMS CryptoKey，例如 projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}，用於保護控制層磁碟。如未指定，系統會改用 Google 代管的金鑰。
kms_key_active_version

string

僅供輸出。目前用於保護控制層磁碟的 Cloud KMS CryptoKeyVersion。只有在設定 kms_key 時才適用。
kms_key_state

KmsKeyState

僅供輸出。Cloud KMS CryptoKey 的可用性。如果不是 KEY_AVAILABLE，節點可能會因為無法存取店面資料而離線。這可能是因為您沒有使用金鑰的權限，或是金鑰已停用或刪除。
kms_status

Status

僅供輸出。使用這組金鑰時，Cloud KMS 傳回的錯誤狀態。只有在 kms_key_state 不是 KMS_KEY_STATE_KEY_AVAILABLE 時，才能填入這個欄位。如果填入這個欄位，則會包含 Cloud KMS 回報的錯誤狀態。
resource_state

ResourceState

僅供輸出。與 CMEK 相關聯的目前資源狀態。

ExternalLoadBalancerPool

外部負載平衡器集區，可自訂名稱、手動/自動指派、不重疊的 IPv4 和選用的 IPv6 位址範圍等設定。

欄位
address_pool

string

選用。外部負載平衡器集區的名稱。
ipv4_range[]

string

這是必要旗標，外部負載平衡器集區的 IPv4 位址範圍，不得重疊。
ipv6_range[]

string

選用。外部負載平衡器集區的非重疊 IPv6 位址範圍。
avoid_buggy_ips

bool

選用。如果設為 true，集區會省略結尾為 .0 和 .255 的 IP 位址。部分網路硬體會捨棄傳送至這些特殊位址的流量。預設值為 false。
manual_assign

bool

選用。如果設為 true，這個集區中的位址不會自動指派給 Kubernetes Service。如果設為 true，只有在服務明確指定時，才會使用這個集區中的 IP 位址。預設值為 false。

GoogleGroupAuthenticationConfig

叢集的 Google 群組驗證設定。go/gdc-google-group-authentication

欄位
enable

bool

選用。如果設為 true，叢集會設為使用 Google 群組驗證。

MaintenanceEvent

維護事件是指可能導致叢集工作負載暫時中斷的作業，包括 Google 驅動或使用者啟動的叢集升級、使用者啟動的叢集設定變更 (需要重新啟動節點) 等。

欄位
uuid

string

僅供輸出。維護事件的 UUID。
target_version

string

僅供輸出。叢集的目標版本。
operation

string

僅供輸出。執行維護事件的操作。格式為 projects/*/locations/*/operations/*。如果維護事件分成多項作業 (例如因維護期間)，系統會記錄最新作業。
type

Type

僅供輸出。維護事件的類型。
schedule

Schedule

僅供輸出。維護事件的時間表。
state

State

僅供輸出。維護事件的狀態。
create_time

Timestamp

僅供輸出。建立維護活動支援申請的時間。
start_time

Timestamp

僅供輸出。維護事件開始時間。
end_time

Timestamp

僅供輸出。維護事件結束的時間 (無論是否成功)。如果維護事件分成多個維護期間，則只有在整個流程結束時，end_time 才會更新。
update_time

Timestamp

僅供輸出。維護事件訊息的更新時間。

排程

指出應執行維護事件的時間。

列舉
SCHEDULE_UNSPECIFIED 未指定。
IMMEDIATELY 收到要求後立即生效。

狀態

指出維護事件狀態。

列舉
STATE_UNSPECIFIED 未指定。
RECONCILING 維護事件正在進行中。叢集可能無法使用。
SUCCEEDED 維護事件已成功。
FAILED 維護事件失敗。

類型

指出維護事件類型。

列舉
TYPE_UNSPECIFIED 未指定。
USER_INITIATED_UPGRADE 由使用者啟動升級。
GOOGLE_DRIVEN_UPGRADE 由 Google 執行的升級作業。

ReleaseChannel

叢集訂閱的發布管道。

列舉
RELEASE_CHANNEL_UNSPECIFIED 未指定發布管道。預設為一般版。
NONE 沒有發布管道。
REGULAR 一般發布管道。

狀態

指出叢集的狀態。

列舉
STATUS_UNSPECIFIED 狀態不明。
PROVISIONING 正在建立叢集。
RUNNING 叢集已建立，可完全使用。
DELETING 正在刪除叢集。
ERROR 這個狀態表示在協調/刪除叢集時發生錯誤。
RECONCILING 叢集正在進行版本升級等作業。

SurvivabilityConfig

叢集存續性設定，例如網路連線中斷時。

欄位
offline_reboot_ttl

Duration

選用。叢集節點可重新啟動並運作，而無需連線至 Google 網路的時間範圍。預設值為 0，表示不允許。最長不得超過 30 天。

SystemAddonsConfig

客戶可為 GDCE 系統外掛程式定義的設定。

欄位
ingress

Ingress

選用。Ingress 設定。
vm_service_config

VMServiceConfig

選用。VM 服務設定。

輸入

Ingress 外掛程式的設定，可讓客戶建立 Ingress 物件，管理叢集內伺服器的外部存取權。這個外掛程式包含 istiod 和 istio-ingress。

欄位
disabled

bool

選用。是否停用輸入。
ipv4_vip

string

選用。Ingress VIP。

VMServiceConfig

VMServiceConfig 定義 GDCE VM 服務的設定。

欄位
vmm_enabled

bool

選用。是否啟用 VMM。

ZoneStorageEncryption

可用區儲存空間 CMEK 支援設定

欄位
kms_key

string

選用。Cloud KMS 金鑰
kms_key_active_version

string

僅供輸出。目前用於加密/解密的 Cloud KMS CryptoKeyVersion
resource_state

ResourceState

僅供輸出。CMEK 目前的資源狀態

ClusterNetworking

叢集層級網路設定。

欄位
cluster_ipv4_cidr_blocks[]

string

這是必要旗標，系統會為叢集中的所有 Pod 指派這些區塊中的 RFC1918 IPv4 位址。僅支援單一區塊。這個欄位在建立後即無法變更。
services_ipv4_cidr_blocks[]

string

這是必要旗標，系統會為叢集中的所有服務指派這些區塊中的 RFC1918 IPv4 位址。僅支援單一區塊。這個欄位在建立後即無法變更。

ClusterUser

RBAC 政策的使用者主體。

欄位
username

string

這是必要旗標，有效 Google 使用者名稱。

ConfigData

設定資料包含區域的所有設定相關資料。

欄位
available_external_lb_pools_ipv4[]

string

外部負載平衡器的可用 v4 IP 集區清單
available_external_lb_pools_ipv6[]

string

外部負載平衡器可用的 v6 IP 集區清單

CreateApiKeyRequest

要求 proto 建立 API 金鑰。

欄位
parent

string

這是必要旗標，表示將建立這個金鑰的父項資源。格式：projects/{project}/locations/{location}
api_key

ApiKey

這是必要旗標，要建立的 API 金鑰。
api_key_id

string

這是必要旗標，要建立的 API 金鑰 ID。
request_id

string

選用。這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

建立叢集要求

建立叢集。

欄位
parent

string

這是必要旗標，要建立這個叢集的父項位置。

授權需要指定資源 parent 的下列 IAM 權限：

  • edgecontainer.clusters.create
cluster_id

string

這是必要旗標，用戶端指定的叢集專屬 ID。
cluster

Cluster

這是必要旗標，要建立的叢集。
request_id

string

這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

CreateIdentityProviderRequest

要求 proto 為組織設定識別資訊提供者。

欄位
parent

string

這是必要旗標，要設定的身分識別提供者資源名稱，例如 organizations/{organization}/locations/{location}
identity_provider_id

string

這是必要旗標，識別資訊提供者 ID。
identity_provider

IdentityProvider

這是必要旗標，要設定的識別資訊提供者。
request_id

string

選用。這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

CreateNodePoolRequest

建立節點集區。

欄位
parent

string

這是必要旗標，要建立這個節點集區的父項叢集。

授權需要指定資源 parent 的下列 IAM 權限：

  • edgecontainer.nodePools.create
node_pool_id

string

這是必要旗標，用戶端指定的節點集區專屬 ID。
node_pool

NodePool

這是必要旗標，要建立的節點集區。
request_id

string

這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

CreateServiceAccountRequest

要求 proto 建立服務帳戶資源。

欄位
parent

string

這是必要旗標，要設定的識別資訊提供者資源名稱，例如 project/{project}/locations/{location}
service_account_id

string

這是必要旗標，服務帳戶 ID。
service_account

ServiceAccount

這是必要旗標，要設定的服務帳戶。
request_id

string

選用。這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

CreateVpnConnectionRequest

建立 VPN 連線。

欄位
parent

string

這是必要旗標，要建立這個 VPN 連線的父項位置。

授權需要指定資源 parent 的下列 IAM 權限：

  • edgecontainer.vpnConnections.create
vpn_connection_id

string

這是必要旗標，VPN 連線 ID。
vpn_connection

VpnConnection

這是必要旗標，要建立的 VPN 連線。
request_id

string

這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

DeleteApiKeyRequest

要求 proto 刪除 API 金鑰。

欄位
name

string

這是必要旗標，API 金鑰的標準資源名稱，例如：projects/{project}/locations/{location}/apiKeys/{api_key}

刪除叢集要求

刪除叢集。

欄位
name

string

這是必要旗標，叢集的資源名稱。

授權需要指定資源 name 的下列 IAM 權限：

  • edgecontainer.clusters.delete
request_id

string

這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

DeleteIdentityProviderRequest

刪除組織識別資訊提供者的 Proto 要求。

欄位
name

string

這是必要旗標，要刪除的識別資訊提供者資源名稱，名稱格式須為：organizations/{organization}/locations/{location}/identityProviders/{identity_provider}
request_id

string

選用。這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

DeleteNodePoolRequest

刪除節點集區。

欄位
name

string

這是必要旗標，節點集區的資源名稱。

授權需要指定資源 name 的下列 IAM 權限：

  • edgecontainer.nodePools.delete
request_id

string

這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

DeleteServiceAccountRequest

要求 proto 刪除專案服務帳戶資源。

欄位
name

string

這是必要旗標，專案服務帳戶的標準資源名稱。例如：projects/{project}/locations/{location}/serviceAccounts/{service_account}

DeleteVpnConnectionRequest

刪除 VPN 連線。

欄位
name

string

這是必要旗標，VPN 連線的資源名稱。

授權需要指定資源 name 的下列 IAM 權限：

  • edgecontainer.vpnConnections.delete
request_id

string

這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

DescribeServiceAccountKeyRequest

DescribeServiceAccountKey API 的要求 Proto。

欄位
parent

string

這是必要旗標，專案服務帳戶的標準資源名稱。例如：projects/{project}/locations/{location}/serviceAccounts/{service_account}
key_id

string

這是必要旗標，要取得的金鑰 ID。

DescribeServiceAccountKeyResponse

DescribeServiceAccountKey API 的回應 Proto。

欄位
key_id

string

僅供輸出。公開金鑰 ID。
expiry

string

僅供輸出。金鑰的到期時間。

DisableServiceAccountKeyRequest

DisableServiceAccountKey API 的要求原型。

欄位
parent

string

這是必要旗標，專案服務帳戶的標準資源名稱。例如：projects/{project}/locations/{location}/serviceAccounts/{service_account}
key_id

string

這是必要旗標，要停用的金鑰 ID。

DisableServiceAccountKeyResponse

DisableServiceAccountKey API 的回應 Proto。

欄位
key_id

string

僅供輸出。已停用的金鑰 ID。
delete_time

Timestamp

僅供輸出。停用金鑰的時間戳記。

EnableZonalProjectRequest

在可用區啟用用戶專案 (對應至雲端用戶專案)。

欄位
parent

string

這是必要旗標，要建立專案的上層可用區
zonal_project_id

string

這是必要旗標，要啟用的用戶專案指定 project_id。
zonal_project

ZonalProject

這是必要旗標，要啟用的用戶專案。
request_id

string

選用。這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

EnableZonalProjectResponse

啟用可用區專案的回應訊息。

欄位
zonal_project

ZonalProject

已啟用的可用區專案。

EnableZonalServiceRequest

啟用 ZonalService 要求。API 會為叢集上的服務生產者設定存取權，以便建立服務資源。

欄位
parent

string

這是必要旗標，上層位置，擁有這組服務。
zonal_service_id

string

選用。指定的 zonal_service_id。
zonal_service

ZonalService

這是必要旗標，要建立的服務。
request_id

string

選用。冪等要求 UUID。

機群

機群相關設定。

「機群」是 Google Cloud 的概念，可按照邏輯整理叢集，方便您使用及管理多叢集功能，並在不同系統中套用一致的政策。

欄位
project

string

這是必要旗標，這個叢集要註冊的機群主專案名稱。

專案名稱的格式為 projects/<project-number>。
membership

string

僅供輸出。與這個叢集相關聯的代管 Hub 成員資格資源名稱。

會員名稱格式為 projects/<project-number>/locations/global/membership/<cluster-id>。

GenerateAccessTokenRequest

為叢集產生存取權杖。

欄位
cluster

string

這是必要旗標，叢集的資源名稱。

授權需要指定資源 cluster 的下列 IAM 權限：

  • edgecontainer.clusters.generateAccessToken

GenerateAccessTokenResponse

叢集的存取權杖。

欄位
access_token

string

僅供輸出。用於向 k8s API 伺服器進行驗證的存取權杖。
expire_time

Timestamp

僅供輸出。權杖到期的時間戳記。

GenerateOfflineCredentialRequest

為叢集產生離線憑證。

欄位
cluster

string

這是必要旗標，叢集的資源名稱。

授權需要指定資源 cluster 的下列 IAM 權限：

  • edgecontainer.clusters.generateOfflineCredential

GenerateOfflineCredentialResponse

叢集的離線憑證。

欄位
client_certificate

string

僅供輸出。用於向 k8s API 伺服器驗證身分的用戶端憑證。
client_key

string

僅供輸出。用於向 k8s API 伺服器驗證身分的用戶端私密金鑰。
user_id

string

僅供輸出。用戶端的身分。
expire_time

Timestamp

僅供輸出。這組憑證的到期時間戳記。

GenerateServiceAccountKeyRequest

GenerateServiceAccountKey API 的 Proto 要求。

欄位
name

string

這是必要旗標，專案服務帳戶的標準資源名稱。例如：projects/{project}/locations/{location}/serviceAccounts/{service_account}
validity

Duration

選用。金鑰的生命週期。如未指定，預設生命週期為 14 天。
ca_cert_path

string

選用。CA 憑證路徑。

GenerateServiceAccountKeyResponse

GenerateServiceAccountKey API 的回應 Proto。

欄位
type

string

憑證類型。
project

string

僅供輸出。服務帳戶所屬的專案。
private_key_id

string

僅供輸出。私密金鑰 ID。
private_key

string

僅供輸出。私密金鑰。
name

string

僅供輸出。服務身分的名稱。
token_uri

string

僅供輸出。權杖 URI。
format_version

string

僅供輸出。格式版本。
ca_cert_path

string

僅供輸出。CA 憑證路徑。

GetApiKeyRequest

要求 proto 取得 API 金鑰。

欄位
name

string

這是必要旗標，要擷取的 API 金鑰名稱。格式：projects/{project}/locations/{location}/apiKeys/{api_key}

取得叢集要求

取得叢集。

欄位
name

string

這是必要旗標，叢集的資源名稱。

授權需要指定資源 name 的下列 IAM 權限：

  • edgecontainer.clusters.get

GetIamPolicyRequest

要求 proto 取得與可用區中專案相關聯的 IAM 政策。

欄位
name

string

這是必要旗標，要擷取 IamPolicy 的可用區標準名稱，例如 projects/*/locations/*/zones/*

GetIdentityProviderRequest

要求 proto 取得組織的識別資訊提供者。

欄位
name

string

這是必要旗標，識別資訊提供者的標準資源名稱。例如 organizations/*/locations/*/identityProviders/*

GetMachineRequest

取得機器。

欄位
name

string

這是必要旗標，機器的資源名稱。

授權需要指定資源 name 的下列 IAM 權限：

  • edgecontainer.machines.get

GetNodePoolRequest

取得節點集區。

欄位
name

string

這是必要旗標，節點集區的資源名稱。

授權需要指定資源 name 的下列 IAM 權限：

  • edgecontainer.nodePools.get

GetServerConfigRequest

取得伺服器設定。

欄位
name

string

這是必要旗標，要取得的伺服器設定名稱 (專案和位置)，格式為 projects/*/locations/*。

授權需要指定資源 name 的下列 IAM 權限：

  • edgecontainer.serverConfig.get

GetServiceAccountRequest

要求 proto 以取得服務帳戶資源。

欄位
name

string

這是必要旗標，專案服務帳戶的標準資源名稱。例如：projects/{project}/locations/{location}/serviceAccounts/{service_account}

GetVpnConnectionRequest

取得 VPN 連線。

欄位
name

string

這是必要旗標，VPN 連線的資源名稱。

授權需要指定資源 name 的下列 IAM 權限：

  • edgecontainer.vpnConnections.get

GetZonalProjectRequest

取得可用區專案資源。

欄位
name

string

這是必要旗標，可用區專案的標準資源名稱，例如 organizations/*/locations/*/zonalProjects/*

GetZonalServiceRequest

取得 ZonalService 要求。

欄位
name

string

這是必要旗標，服務的資源名稱。

GetZoneRequest

取得可用區。

欄位
name

string

這是必要旗標，可用區的標準資源名稱。例如 organizations/*/locations/*/zone/*

IamPolicy

IamPolicy 代表 IAM 政策。

欄位
bindings[]

Binding

選用。政策是一份繫結清單。
etag

string

選用。IAM 政策的 etag。

繫結

繫結代表 IAM 政策中的角色繫結。

欄位
role

string

這是必要旗標，IAM 政策中要繫結成員的角色。
members[]

Principal

選用。要繫結角色的成員。

主體

主體代表 IAM 政策中的主體。

欄位
聯集欄位 identity。要繫結角色的主體。identity 只能是下列其中一個設定：
user

string

選用。代表 IAM 政策中的使用者。
service_account

string

選用。代表 IAM 政策中的服務帳戶。
group

string

選用。代表 IAM 政策中的群組。

IdentityProvider

代表組織的識別資訊提供者設定。

欄位
name

string

ID。識別資訊提供者的標準資源名稱。例如：organizations/{organization}/locations/{location}/identityProviders/{identity_provider}
proxy_uri

string

選用。用於連線至識別資訊提供者的 Proxy URI。
create_time

Timestamp

僅供輸出。建立識別資訊提供者的時間。
update_time

Timestamp

僅供輸出。上次更新識別資訊提供者的時間。
delete_time

Timestamp

僅供輸出。刪除識別資訊提供者的時間。
labels

map<string, string>

選用。與這項資源相關聯的標籤。
state

State

僅供輸出。識別資訊提供者的狀態。
聯集欄位 config。識別資訊提供者的設定。config 只能是下列其中一個設定：
oidc_config

OIDCProviderConfig

OIDC 供應商設定。
saml_config

SAMLProviderConfig

SAML 提供者設定。
聯集欄位 target。識別資訊提供者的目標。target 只能是下列其中一個設定：
zone_id

string

要設定識別資訊提供者的基礎架構叢集目標可用區 ID。
cluster

string

要設定識別資訊提供者的目標 BMUC 完整名稱。

狀態

識別資訊提供者的狀態。

列舉
STATE_UNSPECIFIED 未指定。
CREATING 識別資訊提供者處於「建立中」狀態。
RUNNING 識別資訊提供者處於 RUNNING 狀態。
DELETING 識別資訊提供者處於 DELETING 狀態。
ERROR 識別資訊提供者處於錯誤狀態。
REPAIRING 識別資訊提供者處於 REPAIRING 狀態。
DELETED 識別資訊提供者處於「已刪除」狀態。

KmsKeyState

代表用於 CMEK 整合的客戶自行管理 KMS 金鑰的無障礙狀態。

列舉
KMS_KEY_STATE_UNSPECIFIED 未指定。
KMS_KEY_STATE_KEY_AVAILABLE 金鑰可供使用，且應可存取依附資源。
KMS_KEY_STATE_KEY_UNAVAILABLE 因不明原因而無法使用金鑰。可能無法存取依附資源。

ListApiKeysRequest

要求 proto 列出 API 金鑰。

欄位
parent

string

這是必要旗標，表示將建立這個金鑰的父項資源。格式：projects/{project}/locations/{location}
page_size

int32

選用。要列出的資源數量上限。
page_token

string

選用。從先前清單要求收到的頁面符記。

ListApiKeysResponse

列出 API 金鑰的回應 Proto。

欄位
api_keys[]

ApiKey

API 金鑰清單。
next_page_token

string

用於擷取下一頁結果的權杖。
unreachable[]

string

無法連線的位置。

列出叢集要求

列出某個位置的叢集。

欄位
parent

string

這是必要旗標，擁有這個叢集集合的父項位置。

授權需要指定資源 parent 的下列 IAM 權限：

  • edgecontainer.clusters.list
page_size

int32

要列出的資源數量上限。
page_token

string

從先前清單要求收到的頁面符記。從先前清單要求收到的頁面符記。
filter

string

系統只會列出符合這項篩選條件的資源。
order_by

string

指定資源的列出順序。

ListClustersResponse

某個位置的叢集清單。

欄位
clusters[]

Cluster

位置中的叢集。
next_page_token

string

用於擷取下一頁結果的權杖。
unreachable[]

string

無法連線的位置。

ListIdentityProvidersRequest

要求 proto 列出組織的識別資訊提供者。

欄位
parent

string

這是必要旗標，識別資訊提供者的上層組織和區域。
page_size

int32

選用。要列出的資源數量上限。
page_token

string

選用。從先前清單要求收到的頁面符記。
filter

string

選用。系統只會列出符合這項篩選條件的資源。
order_by

string

選用。指定資源的列出順序。結果的排序依據欄位。

ListIdentityProvidersResponse

列出組織識別資訊提供者的回應 Proto。

欄位
identity_providers[]

IdentityProvider

符合要求的識別資訊提供者清單。
next_page_token

string

用於擷取下一頁結果的權杖。
unreachable[]

string

未排序的清單。無法連線的位置。

ListMachinesRequest

列出網站中的機器。

欄位
parent

string

這是必要旗標，擁有這組機器的父項站點。

授權需要指定資源 parent 的下列 IAM 權限：

  • edgecontainer.machines.list
page_size

int32

要列出的資源數量上限。
page_token

string

從先前清單要求收到的頁面符記。
filter

string

系統只會列出符合這項篩選條件的資源。
order_by

string

指定機器列出的順序。根據 AIP-132，值應為以半形逗號分隔的欄位清單。您可以在欄位後方加上「 desc」，指定遞減排序。

支援的欄位：* name (預設)：機器的標準資源名稱。

例如：「name desc」。

ListMachinesResponse

站點中的機器清單。

欄位
machines[]

Machine

站點中的機器。
next_page_token

string

用於擷取下一頁結果的權杖。
unreachable[]

string

無法連線的位置。

ListNodePoolsRequest

列出叢集中的節點集區。

欄位
parent

string

這是必要旗標，擁有這個節點集區集合的上層叢集。

授權需要指定資源 parent 的下列 IAM 權限：

  • edgecontainer.nodePools.list
page_size

int32

要列出的資源數量上限。
page_token

string

從先前清單要求收到的頁面符記。
filter

string

系統只會列出符合這項篩選條件的資源。
order_by

string

指定資源的列出順序。

ListNodePoolsResponse

叢集中的節點集區清單。

欄位
node_pools[]

NodePool

叢集中的節點集區。
next_page_token

string

用於擷取下一頁結果的權杖。
unreachable[]

string

無法連線的位置。

ListRolesRequest

要求 proto 列出與可用區中專案相關聯的角色。

欄位
parent

string

這是必要旗標，要列出角色的區域標準名稱。例如 projects/*/locations/*/zones/*
page_size

int32

選用。要列出的資源數量上限。
page_token

string

選用。從先前清單要求收到的頁面符記。

ListRolesResponse

回應 Proto，用於列出與可用區中專案相關聯的角色。

欄位
roles[]

Role

與可用區中專案相關聯的角色清單。
next_page_token

string

用於擷取下一頁結果的權杖。

ListServiceAccountKeysRequest

ListServiceAccountKeys API 的要求原型。

欄位
parent

string

這是必要旗標，專案服務帳戶的標準資源名稱。例如：projects/{project}/locations/{location}/serviceAccounts/{service_account}
page_size

int32

選用。要列出的資源數量上限。
page_token

string

選用。從先前清單要求收到的頁面符記。

ListServiceAccountKeysResponse

ListServiceAccountKeys API 的回應 Proto。

欄位
service_account_keys[]

ServiceAccountKeyInfo

服務帳戶金鑰清單。
next_page_token

string

用於擷取下一頁結果的權杖。

ServiceAccountKeyInfo

ServiceAccountKeyInfo 代表服務帳戶金鑰的資訊。

欄位
key_id

string

僅供輸出。公開金鑰 ID。
expiry

string

僅供輸出。金鑰的到期時間。

ListServiceAccountsRequest

List ServiceAccounts 要求。

欄位
parent

string

這是必要旗標，擁有這組專案服務帳戶的父項位置。
page_size

int32

選用。要列出的資源數量上限。
page_token

string

選用。從先前清單要求收到的頁面符記。
filter

string

選用。系統只會列出符合這項篩選條件的資源。
order_by

string

選用。指定資源的列出順序。結果的排序依據欄位。

ListServiceAccountsResponse

List ServiceAccounts 回應。

欄位
service_accounts[]

ServiceAccount

符合要求的 ServiceAccount 清單。
next_page_token

string

用於擷取下一頁結果的權杖。
unreachable[]

string

無法連線的位置。

ListVpnConnectionsRequest

列出 VPN 連線。

欄位
parent

string

這是必要旗標，上層位置，擁有這組 VPN 連線。

授權需要指定資源 parent 的下列 IAM 權限：

  • edgecontainer.vpnConnections.list
page_size

int32

要列出的資源數量上限。
page_token

string

從先前清單要求收到的頁面符記。
filter

string

系統只會列出符合這項篩選條件的資源。
order_by

string

指定資源的列出順序。

ListVpnConnectionsResponse

某個位置的 VPN 連線清單。

欄位
vpn_connections[]

VpnConnection

該位置中的 VpnConnections。
next_page_token

string

用於擷取下一頁結果的權杖。
unreachable[]

string

無法連線的位置。

ListZonalProjectsRequest

列出組織中的消費者專案。

欄位
parent

string

這是必要旗標，要建立專案的父項可用區。
page_size

int32

選用。要列出的資源數量上限。
page_token

string

選用。從先前清單要求收到的頁面符記。
filter

string

選用。系統只會列出符合這項篩選條件的資源。
order_by

string

選用。指定資源的列出順序。結果的排序依據欄位。

ListZonalProjectsResponse

機構回應中的消費者專案清單。

欄位
zonal_projects[]

ZonalProject

位置中的叢集。
next_page_token

string

用於擷取下一頁結果的權杖。
unreachable[]

string

無法連線的可用區。

ListZonalServicesRequest

List ZonalServices 要求。

欄位
parent

string

這是必要旗標，上層位置，擁有這組服務。
page_size

int32

選用。要列出的資源數量上限。
page_token

string

選用。從先前清單要求收到的頁面符記。
filter

string

選用。系統只會列出符合這項篩選條件的資源。
order_by

string

選用。指定資源的列出順序。結果的排序依據欄位。

ListZonalServicesResponse

List ZonalServices 回應。

欄位
zonal_services[]

ZonalService

位置中的 ZonalServices。
next_page_token

string

用於擷取下一頁結果的權杖。
unreachable[]

string

無法連線的位置。

ListZonesRequest

列出已啟用上層組織的可用區。

欄位
parent

string

這是必要旗標，母機構和地點。
page_size

int32

選用。要傳回的項目數量上限。
page_token

string

選用。先前的 List 要求傳回的 next_page_token 值 (如有)。
filter

string

選用。系統只會列出符合這項篩選條件的資源。
order_by

string

選用。指定資源的列出順序。

ListZonesResponse

列出可用區的回應訊息。

欄位
zones[]

Zone

符合要求的可用區清單。
next_page_token

string

用於擷取下一頁結果的權杖。
unreachable[]

string

無法連線的位置。

LocationMetadata

指定 google.cloud.location.Location 的中繼資料。

欄位
available_zones

map<string, ZoneMetadata>

該位置中可用的 Google Distributed Cloud Edge 可用區組合。對應關係是以每個可用區的小寫 ID 做為索引鍵。

機器

可做為 Kubernetes 節點的 Google Distributed Cloud Edge 機器。

欄位
name

string

這是必要旗標，機器的資源名稱。
create_time

Timestamp

僅供輸出。建立節點集區的時間。
update_time

Timestamp

僅供輸出。上次更新節點集區的時間。
labels

map<string, string>

與這項資源相關聯的標籤。
hosted_node

string

這部機器負責託管的節點標準資源名稱，例如 projects/{project}/locations/{location}/clusters/{cluster_id}/nodePools/{pool_id}/{node}。如果機器未指派節點角色，則為空白。

如果控制層節點託管於邊緣機器，則會傳回下列格式：「projects/{project}/locations/{location}/clusters/{cluster_id}/controlPlaneNodes/{node}」。
zone

string

這部機器的 Google Distributed Cloud Edge 可用區。
version

string

僅供輸出。機器的軟體版本。
disabled

bool

僅供輸出。機器是否已停用。如果停用，機器就無法進入服務。
status

Status

僅供輸出。機器目前的狀態。
purpose

Purpose

機器用於哪種叢集。

目的

機器用途可以是 VIRTUALIZED_WORKLOAD 或 BAREMETAL_CLUSTER。

列舉
PURPOSE_UNSPECIFIED 未指定用途。
VIRTUALIZED_WORKLOAD 機器用於虛擬工作負載。
BAREMETAL_CLUSTER 機器用於裸機使用者叢集。

狀態

指出機器狀態。

列舉
STATUS_UNSPECIFIED 狀態不明。
READY 機器已準備好託管節點。這是目前的預設做法。
DISABLED_FOR_REPAIR 已新增 1 項以上的停用聲明，因此機器已停用並進行維修。

MaintenanceExclusionWindow

代表維護作業排除期。

欄位
window

TimeWindow

選用。時間範圍。
id

string

選用。視窗的專屬 ID (每個叢集)。

MaintenancePolicy

維護政策設定。

欄位
window

MaintenanceWindow

指定可執行維護作業的維護期間。
maintenance_exclusions[]

MaintenanceExclusionWindow

選用。自動維護作業排除項目。非緊急維護作業不應在這些時段進行。每個排除項目都有不重複的名稱，且可能有效或已過期。在特定時間，最多可有 3 個維護作業排除項目。

MaintenanceWindow

維護期間設定

欄位
recurring_window

RecurringTimeWindow

週期性維護期間的設定。

NodePool

叢集中的一組 Kubernetes 節點，具有共同的設定和規格。

欄位
name

string

這是必要旗標，節點集區的資源名稱。
create_time

Timestamp

僅供輸出。建立節點集區的時間。
update_time

Timestamp

僅供輸出。上次更新節點集區的時間。
labels

map<string, string>

與這項資源相關聯的標籤。
node_location

string

要建立這個節點集區的 Google Distributed Cloud Edge 可用區名稱。例如：us-central1-edge-customer-a。
node_count

int32

這是必要旗標，集區中的節點數量。
machine_filter

string

只有符合這個篩選條件的機器才能新增至節點集區。篩選語言接受「name=」等字串，詳情請參閱 AIP-160。
local_disk_encryption

LocalDiskEncryption

選用。本機磁碟加密選項。只有在啟用 CMEK 支援時，才會使用這個欄位。
node_version

string

僅供輸出。所有 worker 節點中最低的發布版本。
node_config

NodeConfig

選用。NodePool 中各節點的設定

LocalDiskEncryption

CMEK 支援邊緣機器本機磁碟加密的設定。

欄位
kms_key

string

選用。Cloud KMS CryptoKey，例如 projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}，用於保護節點本機磁碟。如未指定，系統會改用 Google 代管的金鑰。
kms_key_active_version

string

僅供輸出。目前用於保護節點本機磁碟的 Cloud KMS CryptoKeyVersion。只有在設定 kms_key 時才適用。
kms_key_state

KmsKeyState

僅供輸出。Cloud KMS CryptoKey 的可用性。如果不是 KEY_AVAILABLE，節點可能會因為無法存取店面資料而離線。這可能是因為您沒有使用金鑰的權限，或是金鑰已停用或刪除。
kms_status

Status

僅供輸出。使用這組金鑰時，Cloud KMS 傳回的錯誤狀態。只有在 kms_key_state 不是 KMS_KEY_STATE_KEY_AVAILABLE 時，才能填入這個欄位。如果填入這個欄位，則會包含 Cloud KMS 回報的錯誤狀態。
resource_state

ResourceState

僅供輸出。與 CMEK 相關聯的目前資源狀態。

NodeConfig

NodePool 中各節點的設定

欄位
labels

map<string, string>

選用。Kubernetes 節點標籤
node_storage_schema

string

選用。worker 節點儲存空間結構定義的名稱。
node_system_partition_size

SystemPartitionGiBSize

選用。worker 節點的系統分區大小 (以 GiB 為單位)。

OIDCProviderConfig

代表 OIDC 提供者設定。

欄位
client_id

string

這是必要旗標，識別資訊提供者的用戶端 ID。
client_secret

string

選用。識別資訊提供者的用戶端密鑰。
issuer_uri

string

這是必要旗標，識別資訊提供者的核發者 URI。
scopes

string

這是必要旗標，識別資訊提供者的範圍。
user_claim

string

選用。識別資訊提供者的使用者要求。
extra_params

string

選用。以半形逗號分隔的鍵/值組合清單，會經過查詢編碼，並與驗證端點要求一併傳送。
certificate_authority_data

string

選用。識別資訊提供者的憑證授權單位資料。
group_claim

string

選用。識別資訊提供者的群組要求。
attribute_mapping

map<string, string>

選用。識別資訊提供者的屬性對應。

OperationMetadata

Edge Container API 方法的長時間執行作業中繼資料。

欄位
create_time

Timestamp

作業的建立時間。
end_time

Timestamp

作業執行完成的時間。
target

string

作業目標的伺服器定義資源路徑。
verb

string

作業執行的動詞。
status_message

string

作業的人類可讀狀態 (如有)。
requested_cancellation

bool

指出使用者是否已要求取消作業。Operatio/1.13.0/docs/successfully been cancelled have [Operation.error][] value with a google.rpc.Status.code of 1, corresponding to Code.CANCELLED.
api_version

string

用於啟動作業的 API 版本。
warnings[]

string

不會封鎖作業，但仍會保留相關資訊供使用者接收的警告。
status_reason

StatusReason

作業的機器可讀狀態 (如有)。
public_error

Status

公開的錯誤表示法，供用戶端使用。這個欄位會填入作業錯誤，在標準錯誤代碼為 INTERNAL 且主要錯誤訊息可能經過清理時，特別適合用來向用戶端提供更豐富的錯誤詳細資料。

StatusReason

指出作業狀態的原因。

列舉
STATUS_REASON_UNSPECIFIED 原因不明。
UPGRADE_PAUSED 叢集升級作業目前已暫停。
RETRYABLE_ERROR 要求發生錯誤，但可以重試。

配額

代表 Edge Container 資源的配額。

欄位
metric

string

配額指標的名稱。
limit

double

這項指標的配額限制。
usage

double

這項指標的目前用量。

RecurringTimeWindow

代表任意重複的時間範圍。

欄位
window

TimeWindow

首次重複的時間範圍。
recurrence

string

這個時段週期性規則 (RRULE) (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) 的重複方式。並在開始和結束時間之間持續進行。

ResourceState

表示資源處於鎖定狀態或待處理。

列舉
RESOURCE_STATE_UNSPECIFIED 預設值。
RESOURCE_STATE_LOCK_DOWN 資源處於鎖定狀態。
RESOURCE_STATE_LOCK_DOWN_PENDING 資源待鎖定。

角色

代表與可用區中 K8s 角色對應的 GDC IAM 角色。

欄位
gdc_role

string

這是必要旗標，GDC IAM 角色名稱。
display_name

string

選用。角色的顯示名稱。
state

State

僅供輸出。角色在區域中的狀態。

狀態

可用區中角色的狀態。

列舉
STATE_UNKNOWN 預設值。如果狀態檢查失敗，系統會使用這個值。
READY 可用區中已有該角色。
NOT_READY 該區域中沒有這個角色。

SAMLProviderConfig

代表 SAML 提供者設定。

欄位
entity_id

string

這是必要旗標，識別資訊提供者的實體 ID。
single_sign_on_uri

string

這是必要旗標，識別資訊提供者的單一登入 URI。
certificate_data[]

string

選用。識別資訊提供者的憑證資料。
user_attribute

string

選用。識別資訊提供者的使用者屬性。
group_attribute

string

選用。識別資訊提供者的群組屬性。
attribute_mapping

map<string, string>

選用。識別資訊提供者的屬性對應。

ServerConfig

支援版本和發布管道的伺服器設定。

欄位
channels

map<string, ChannelConfig>

僅供輸出。從發布管道對應至管道設定。
versions[]

Version

僅供輸出。支援的版本，例如：["1.4.0", "1.5.0"]。
default_version

string

僅供輸出。預設版本，例如："1.4.0"。
version_rollouts[]

VersionRollout

僅供輸出。伺服器設定的推出資訊。

ServiceAccount

代表服務帳戶資源。

欄位
name

string

ID。專案服務帳戶的標準資源名稱。例如：projects/{project}/locations/{location}/serviceAccounts/{service_account}
zone

string

這是必要旗標，建立專案服務帳戶的可用區 ID。
create_time

Timestamp

僅供輸出。建立專案服務帳戶的時間。
update_time

Timestamp

僅供輸出。上次更新專案服務帳戶的時間。
labels

map<string, string>

選用。與這項資源相關聯的標籤。
state

State

僅供輸出。服務帳戶的狀態。

狀態

服務帳戶的狀態。

列舉
STATE_UNSPECIFIED 未指定。
CREATING 服務帳戶處於 CREATING 狀態。
RUNNING 服務帳戶處於 RUNNING 狀態。
DELETING 服務帳戶處於「DELETING」狀態。
ERROR 服務帳戶處於錯誤狀態。
REPAIRING 服務帳戶處於 REPAIRING 狀態。

SetIamPolicyRequest

要求 proto 設定可用區中專案的 IAM 政策。

欄位
name

string

這是必要旗標，可用區的標準資源名稱。projects/{project}/locations/{location}/zones/{zone}
policy

IamPolicy

這是必要旗標，要設定的 IAM 政策。
request_id

string

選用。這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

SystemPartitionGiBSize

SystemPartitionGiBSize 代表允許的系統分區大小 (以 GiB 為單位)。

列舉
SYSTEM_PARTITION_GIB_SIZE_UNSPECIFIED 使用者未指定系統分區大小。系統分區大小會設為該節點適用的系統儲存空間結構定義中指定的大小，也就是 100 GiB。
SYSTEM_PARTITION_GIB_SIZE100 100 GiB 系統分區大小，這也是預設大小。
SYSTEM_PARTITION_GIB_SIZE300 300 GiB 系統分區大小。可用於覆寫 100 GiB 的預設值。

TimeWindow

代表任意時間範圍。

欄位
start_time

Timestamp

時段首次開始的時間。
end_time

Timestamp

時間範圍的結束時間。結束時間必須晚於開始時間。

UpdateClusterRequest

更新叢集。

欄位
update_mask

FieldMask

欄位遮罩用於指定更新作業要在叢集資源中覆寫的欄位。update_mask 中指定的欄位與資源相關，而非完整要求。如果欄位在遮罩中，系統會覆寫該欄位。如果使用者未提供遮罩，系統會覆寫所有欄位。
cluster

Cluster

更新後的叢集。

授權需要指定資源 cluster 的下列 IAM 權限：

  • edgecontainer.clusters.update
request_id

string

這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

UpdateNodePoolRequest

更新節點集區。

欄位
update_mask

FieldMask

欄位遮罩用於指定更新作業要在 NodePool 資源中覆寫的欄位。update_mask 中指定的欄位與資源相關，而非完整要求。如果欄位在遮罩中，系統會覆寫該欄位。如果使用者未提供遮罩，系統會覆寫所有欄位。
node_pool

NodePool

更新後的節點集區。

授權需要指定資源 nodePool 的下列 IAM 權限：

  • edgecontainer.nodePools.update
request_id

string

這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

UpgradeClusterRequest

升級叢集。

欄位
name

string

這是必要旗標，叢集的資源名稱。

授權需要指定資源 name 的下列 IAM 權限：

  • edgecontainer.clusters.upgrade
target_version

string

這是必要旗標，叢集要升級至的版本。
schedule

Schedule

升級作業時間表。
request_id

string

這項要求的專屬 ID。長度限制為 36 個 ASCII 字元。建議使用隨機 UUID。只有在提供 request_id 時，這項要求才具有冪等性。

排程

代表叢集升級的時間表。

列舉
SCHEDULE_UNSPECIFIED 不明。預設為立即升級叢集，這是目前唯一的選項。
IMMEDIATELY 叢集會在收到要求後立即升級。

版本

叢集版本。

欄位
name

string

僅供輸出。版本名稱，例如："1.4.0"。

VersionRollout

VersionRollout 包含版本推出資訊。

欄位
version

string

僅供輸出。語意版本，例如："1.4.0"。
available_zones[]

string

僅供輸出。已推出版本的可用區清單，例如：["us-central1", "us-west1"]。

VpnConnection

VPN 連線。

欄位
name

string

這是必要旗標，VPN 連線的資源名稱
create_time

Timestamp

僅供輸出。建立 VPN 連線的時間。
update_time

Timestamp

僅供輸出。上次更新 VPN 連線的時間。
labels

map<string, string>

與這項資源相關聯的標籤。
nat_gateway_ip

string

NAT 閘道 IP 或 WAN IP 位址。如果客戶有多個 NAT IP，則須設定 NAT，讓只有一個外部 IP 對應至 GMEC Anthos 叢集。如果未使用 NAT，則這個欄位會留空。
bgp_routing_mode
(deprecated)

BgpRoutingMode

虛擬私有雲網路的動態轉送模式：regional 或 global。
cluster

string

要連線的標準叢集名稱。格式為 projects/{project}/locations/{location}/clusters/{cluster}。
vpc

string

要連線的虛擬私有雲網路 ID。
vpc_project

VpcProject

選用。虛擬私有雲網路的專案詳細資料。如果虛擬私有雲與叢集專案位於不同專案，則必須提供這項資訊。
enable_high_availability

bool

這個 VPN 連線是否在叢集端啟用高可用性。如果啟用，建立 VPN 連線時，系統會嘗試使用 2 個 ANG 浮動 IP。
router

string

選用。VPN 連線 Cloud Router 名稱。
details

Details

僅供輸出。已建立的連線詳細資料。

BgpRoutingMode

轉送模式。

列舉
BGP_ROUTING_MODE_UNSPECIFIED 不明。
REGIONAL 區域模式。
GLOBAL 全域模式。

詳細資料

已建立的連線詳細資料。

欄位
state

State

這個連線的狀態。
error

string

錯誤訊息。只有在 state=ERROR 時，系統才會填入這個欄位。
cloud_router

CloudRouter

Cloud Router 資訊。
cloud_vpns[]

CloudVpn

每個連線都有多個 Cloud VPN 閘道。

CloudRouter

Cloud Router 資訊。

欄位
name

string

相關聯的 Cloud Router 名稱。

CloudVpn

Cloud VPN 資訊。

欄位
gateway

string

建立的 Cloud VPN 閘道名稱。

狀態

目前的連線狀態。

列舉
STATE_UNSPECIFIED 不明。
STATE_CONNECTED 已連線。
STATE_CONNECTING 仍在連線中。
STATE_ERROR 發生錯誤。

VpcProject

虛擬私有雲網路的專案詳細資料。

欄位
project_id

string

要連線的虛擬私有雲專案。如未指定，則與叢集專案相同。
service_account
(deprecated)

string

選用。已淘汰：請勿使用。

ZonalProject

在可用區啟用的可用區專案 (對應至雲端消費者專案)。

欄位
name

string

ID。專案的資源名稱。
create_time

Timestamp

僅供輸出。專案的建立時間。
update_time

Timestamp

僅供輸出。上次更新專案的時間。
labels

map<string, string>

選用。與這項資源相關聯的標籤。
state

State

僅供輸出。專案在可用區中的狀態。

狀態

專案在可用區的狀態。

列舉
STATE_UNSPECIFIED 未指定。
STATE_ON 專案已在可用區啟用。
STATE_OFF 專案在該可用區已停用。
STATE_ENABLING 正在區域啟用專案。
STATE_REPAIRING 正在修復專案。
STATE_ERROR 正在停用可用區中的專案。

ZonalService

已為專案啟用服務。

欄位
name

string

ID。服務的資源名稱。
service_selector

ServiceSelector

選用。要啟用/停用的服務。只能指定 service_selector 或 service_name 其中之一。
state

State

僅供輸出。服務狀態。
create_time

Timestamp

僅供輸出。啟用服務的時間。
update_time

Timestamp

僅供輸出。上次更新服務的時間。
labels

map<string, string>

選用。與這項資源相關聯的標籤。
聯集欄位 zone_or_cluster。要啟用/停用服務的可用區或叢集。zone_or_cluster 只能是下列其中一個設定：
zone

string

要啟用/停用服務的可用區 ID。
cluster

string

要啟用/停用服務的叢集完整名稱。
service_name

string

選用。完整服務名稱，例如 alloydb.googleapis.com。只能指定 service_selector 或 service_name 其中之一。用於啟用/停用專案的服務。

ServiceSelector

可啟用/停用的服務。

列舉
SERVICE_SELECTOR_UNSPECIFIED 未指定。
ALLOYDB AlloyDB 服務，alloydb.googleapis.com。
VMM VMM 服務：gdcvmmanager.googleapis.com。
BOOKSTORE 書店服務，bookstore.googleapis.com。
VERTEX Vertex 服務：aiplatform.googleapis.com。
BOOKSTORE_AI Bookstore.AI 服務：bookstore-ai.googleapis.com。

狀態

服務狀態。

列舉
STATE_UNSPECIFIED 未指定。
STATE_ENABLED 專案已啟用服務。
STATE_DISABLED 專案已停用該服務。
STATE_ENABLING 正在專案啟用服務。
STATE_DISABLING 正在停用專案中的服務。
STATE_REPAIRING 正在維修服務。
STATE_ERROR 服務處於「錯誤狀態」。

可用區

代表可用區。

欄位
name

string

ID。可用區的標準資源名稱。例如：organizations/{organization}/locations/{location}/zones/{zone}
create_time

Timestamp

僅供輸出。建立可用區的時間。
labels

map<string, string>

選用。與這項資源相關聯的標籤。
certificate_authorities[]

string

僅供輸出。區域的網路 CA 憑證。
dns_servers[]

DNSServer

僅供輸出。區域的 DNS 伺服器。
state

State

僅供輸出。可用區的狀態。

DNSServer

代表區域的 DNS 伺服器。

欄位
ip_address

string

僅供輸出。DNS 伺服器的 IP 位址。
tld

string

僅供輸出。DNS 伺服器的頂層網域。

狀態

區域的狀態。

列舉
STATE_UNSPECIFIED 未指定。
STATE_RUNNING 區域處於「執行中」狀態。
STATE_ERROR 區域處於「錯誤」狀態。
STATE_CREATING 可用區處於 CREATING 狀態。
STATE_REPAIRING 可用區處於 REPAIRING 狀態。

ZoneMetadata

邊緣機器所在的 Google Distributed Cloud Edge 可用區。

欄位
quota[]

Quota

這個可用區的資源配額。
rack_types

map<string, RackType>

對應關係以機架名稱為索引鍵，值為 RackType。
config_data

ConfigData

可用區的設定資料。

RackType

機架類型。

列舉
RACK_TYPE_UNSPECIFIED 未指定機架類型，單一機架也屬於這種類型。
BASE 基本機架類型，一對兩個經過修改的 Config-1 機架，內含匯總交換器。
EXPANSION 擴充機架類型，也稱為獨立機架，由客戶視需求新增。