Package google.cloud.edgecontainer.v1alpha

索引

• EdgeContainer（接口）
• Authorization（消息）
• ChannelConfig（消息）
• Cluster（消息）
• Cluster.ConnectionState（消息）
• Cluster.ConnectionState.State（枚举）
• Cluster.ControlPlane（消息）
• Cluster.ControlPlane.Local（消息）
• Cluster.ControlPlane.Remote（消息）
• Cluster.ControlPlane.SharedDeploymentPolicy（枚举）
• Cluster.ControlPlaneEncryption（消息）
• Cluster.MaintenanceEvent（消息）
• Cluster.MaintenanceEvent.Schedule（枚举）
• Cluster.MaintenanceEvent.State（枚举）
• Cluster.MaintenanceEvent.Type（枚举）
• Cluster.ReleaseChannel（枚举）
• Cluster.Status（枚举）
• Cluster.SurvivabilityConfig（消息）
• Cluster.SystemAddonsConfig（消息）
• Cluster.SystemAddonsConfig.Ingress（消息）
• Cluster.SystemAddonsConfig.VMServiceConfig（消息）
• ClusterNetworking（消息）
• ClusterUser（消息）
• CreateClusterRequest（消息）
• CreateNodePoolRequest（消息）
• CreateVpnConnectionRequest（消息）
• DeleteClusterRequest（消息）
• DeleteNodePoolRequest（消息）
• DeleteVpnConnectionRequest（消息）
• Fleet（消息）
• GenerateAccessTokenRequest（消息）
• GenerateAccessTokenResponse（消息）
• GenerateOfflineCredentialRequest（消息）
• GenerateOfflineCredentialResponse（消息）
• GetClusterRequest（消息）
• GetMachineRequest（消息）
• GetNodePoolRequest（消息）
• GetServerConfigRequest（消息）
• GetVpnConnectionRequest（消息）
• KmsKeyState（枚举）
• ListClustersRequest（消息）
• ListClustersResponse（消息）
• ListMachinesRequest（消息）
• ListMachinesResponse（消息）
• ListNodePoolsRequest（消息）
• ListNodePoolsResponse（消息）
• ListVpnConnectionsRequest（消息）
• ListVpnConnectionsResponse（消息）
• LocationMetadata（消息）
• Machine（消息）
• MaintenanceExclusionWindow（消息）
• MaintenancePolicy（消息）
• MaintenanceWindow（消息）
• NodePool（消息）
• NodePool.LocalDiskEncryption（消息）
• NodePool.NodeConfig（消息）
• OperationMetadata（消息）
• OperationMetadata.StatusReason（枚举）
• Quota（消息）
• RecurringTimeWindow（消息）
• ServerConfig（消息）
• TimeWindow（消息）
• UpdateClusterRequest（消息）
• UpdateNodePoolRequest（消息）
• UpgradeClusterRequest（消息）
• UpgradeClusterRequest.Schedule（枚举）
• Version（消息）
• VpnConnection（消息）
• VpnConnection.BgpRoutingMode（枚举）
• VpnConnection.Details（消息）
• VpnConnection.Details.CloudRouter（消息）
• VpnConnection.Details.CloudVpn（消息）
• VpnConnection.Details.State（枚举）
• VpnConnection.VpcProject（消息）
• ZoneMetadata（消息）
• ZoneMetadata.RackType（枚举）

EdgeContainer

EdgeContainer API 用于管理 Google Edge Cloud 部署中的 Kubernetes 集群。

CreateCluster
rpc CreateCluster(CreateClusterRequest) returns (Operation) 在给定的项目和位置中创建新的集群。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

CreateNodePool
rpc CreateNodePool(CreateNodePoolRequest) returns (Operation) 在给定的项目和位置中创建一个新 NodePool。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

CreateVpnConnection
rpc CreateVpnConnection(CreateVpnConnectionRequest) returns (Operation) 在给定的项目和位置中创建新的 VPN 连接。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

DeleteCluster
rpc DeleteCluster(DeleteClusterRequest) returns (Operation) 删除单个集群。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

DeleteNodePool
rpc DeleteNodePool(DeleteNodePoolRequest) returns (Operation) 删除单个 NodePool。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

DeleteVpnConnection
rpc DeleteVpnConnection(DeleteVpnConnectionRequest) returns (Operation) 删除单个 VPN 连接。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

GenerateAccessToken
rpc GenerateAccessToken(GenerateAccessTokenRequest) returns (GenerateAccessTokenResponse) 为集群生成访问令牌。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

GenerateOfflineCredential
rpc GenerateOfflineCredential(GenerateOfflineCredentialRequest) returns (GenerateOfflineCredentialResponse) 为集群生成离线凭据。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

GetCluster
rpc GetCluster(GetClusterRequest) returns (Cluster) 获取单个集群的详细信息。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

GetMachine
rpc GetMachine(GetMachineRequest) returns (Machine) 获取单个虚拟机的详细信息。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

GetNodePool
rpc GetNodePool(GetNodePoolRequest) returns (NodePool) 获取单个 NodePool 的详细信息。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

GetServerConfig
rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig) 获取服务器配置。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

GetVpnConnection
rpc GetVpnConnection(GetVpnConnectionRequest) returns (VpnConnection) 获取单个 VPN 连接的详细信息。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

ListClusters
rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) 列出给定项目和位置中的集群。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

ListMachines
rpc ListMachines(ListMachinesRequest) returns (ListMachinesResponse) 列出给定项目和位置中的机器。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

ListNodePools
rpc ListNodePools(ListNodePoolsRequest) returns (ListNodePoolsResponse) 列出给定项目和位置中的 NodePool。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

ListVpnConnections
rpc ListVpnConnections(ListVpnConnectionsRequest) returns (ListVpnConnectionsResponse) 列出给定项目和位置中的 VPN 连接。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

UpdateCluster
rpc UpdateCluster(UpdateClusterRequest) returns (Operation) 更新单个集群的参数。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

UpdateNodePool
rpc UpdateNodePool(UpdateNodePoolRequest) returns (Operation) 更新单个 NodePool 的参数。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

UpgradeCluster
rpc UpgradeCluster(UpgradeClusterRequest) returns (Operation) 升级单个集群。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/cloud-platform 如需了解详情，请参阅身份验证概览。

授权

将由 GEC 应用和管理的 RBAC 政策。

字段
admin_users	ClusterUser 必需。将被授予集群上 cluster-admin 角色的用户，向该用户提供对集群的完整访问权限。目前，这是一个单数字段，但未来将扩展为允许多个管理员。

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 可选。如果没有为此集群中的节点池明确指定最大值，则系统会为每个节点使用的默认最大值。如果未指定，系统将使用 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 仅限输出。所有工作器节点中的最低发布版本。如果集群没有任何工作器节点，此字段可以为空。
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 仅限输出。集群的当前连接状态。

ConnectionState

ConnectionState 用于保存从集群到 Google 的当前连接状态。

字段
state	State 仅限输出。当前连接状态。
update_time	Timestamp 仅限输出。连接状态上次更改的时间。

州

连接状态。

枚举
STATE_UNSPECIFIED	连接状态未知。
DISCONNECTED	此集群目前已与 Google 断开连接。
CONNECTED	此集群目前已连接到 Google。
CONNECTED_AND_SYNCING	此集群目前已连接到 Google，但可能最近在断开连接后重新连接。仍在同步回。

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 可选。控制平面节点的存储架构的名称。 警告：可配置的节点本地存储空间架构功能是一项实验性功能，不建议在生产集群/节点池中常规使用。

远程

此类型没有字段。

特定于控制平面远程托管的集群的配置。

SharedDeploymentPolicy

表示有关如何部署用户应用的政策配置。

枚举
SHARED_DEPLOYMENT_POLICY_UNSPECIFIED	未指定。
ALLOWED	用户应用可以部署在控制平面和工作器节点上。
DISALLOWED	用户应用无法部署在控制平面节点上，只能部署在工作器节点上。

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 报告的错误状态。

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 表示不允许。最长为 7 天。

SystemAddonsConfig

客户可以为 GDCE 系统插件定义的配置。

字段
ingress	Ingress 可选。Ingress 的配置。
vm_service_config	VMServiceConfig 可选。虚拟机服务的配置。

入站流量

Ingress 插件的配置，可让客户创建 Ingress 对象来管理对集群中服务器的外部访问。该插件由 istiod 和 istio-ingress 组成。

字段
disabled	bool 可选。Ingress 是否已停用。
ipv4_vip	string 可选。入站流量 VIP。

VMServiceConfig

VMServiceConfig 定义了 GDCE 虚拟机服务的配置。

字段
vmm_enabled	bool 可选。VMM 是否已启用。

ClusterNetworking

集群级网络配置。

字段
cluster_ipv4_cidr_blocks[]	string 必需。集群中的所有 pod 都会分配有这些块中的 RFC1918 IPv4 地址。仅支持单个块。此字段一经创建便无法更改。
services_ipv4_cidr_blocks[]	string 必需。集群中的所有服务都会分配有这些块中的 RFC1918 IPv4 地址。仅支持单个块。此字段一经创建便无法更改。

ClusterUser

RBAC 政策的用户主账号。

字段
username	string 必需。有效的 Google 用户名。

CreateClusterRequest

创建集群。

字段
parent	string 必需。将在其中创建此集群的父级位置。 必须对指定的资源 parent 具有以下 IAM 权限才能进行授权： edgecontainer.clusters.create
cluster_id	string 必需。由客户端指定的集群唯一标识符。
cluster	Cluster 必需。要创建的集群。
request_id	string 相应请求的唯一标识符。仅限 36 个 ASCII 字符。建议使用随机 UUID。仅当提供 request_id 时，此请求才是幂等的。

CreateNodePoolRequest

创建节点池。

字段
parent	string 必需。将在其中创建此节点池的父级集群。 必须对指定的资源 parent 具有以下 IAM 权限才能进行授权： edgecontainer.nodePools.create
node_pool_id	string 必需。节点池的客户端指定唯一标识符。
node_pool	NodePool 必需。要创建的节点池。
request_id	string 相应请求的唯一标识符。仅限 36 个 ASCII 字符。建议使用随机 UUID。仅当提供 request_id 时，此请求才是幂等的。

CreateVpnConnectionRequest

创建 VPN 连接。

字段
parent	string 必需。将在其中创建相应 VPN 连接的父级位置。 必须对指定的资源 parent 具有以下 IAM 权限才能进行授权： edgecontainer.vpnConnections.create
vpn_connection_id	string 必需。VPN 连接标识符。
vpn_connection	VpnConnection 必需。要创建的 VPN 连接。
request_id	string 相应请求的唯一标识符。仅限 36 个 ASCII 字符。建议使用随机 UUID。仅当提供 request_id 时，此请求才是幂等的。

DeleteClusterRequest

删除集群。

字段
name	string 必需。集群的资源名称。 必须对指定的资源 name 具有以下 IAM 权限才能进行授权： edgecontainer.clusters.delete
request_id	string 相应请求的唯一标识符。仅限 36 个 ASCII 字符。建议使用随机 UUID。仅当提供 request_id 时，此请求才是幂等的。

DeleteNodePoolRequest

删除节点池。

字段
name	string 必需。节点池的资源名称。 必须对指定的资源 name 具有以下 IAM 权限才能进行授权： edgecontainer.nodePools.delete
request_id	string 相应请求的唯一标识符。仅限 36 个 ASCII 字符。建议使用随机 UUID。仅当提供 request_id 时，此请求才是幂等的。

DeleteVpnConnectionRequest

删除 VPN 连接。

字段
name	string 必需。VPN 连接的资源名称。 必须对指定的资源 name 具有以下 IAM 权限才能进行授权： edgecontainer.vpnConnections.delete
request_id	string 相应请求的唯一标识符。仅限 36 个 ASCII 字符。建议使用随机 UUID。仅当提供 request_id 时，此请求才是幂等的。

舰队

与舰队相关的配置。

舰队是 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.get

GenerateAccessTokenResponse

集群的访问令牌。

字段
access_token	string 仅限输出。用于向 k8s api-server 进行身份验证的访问令牌。
expire_time	Timestamp 仅限输出。令牌过期时的时间戳。

GenerateOfflineCredentialRequest

为集群生成离线凭据（离线）。

字段
cluster	string 必需。集群的资源名称。 必须对指定的资源 cluster 具有以下 IAM 权限才能进行授权： edgecontainer.clusters.get

GenerateOfflineCredentialResponse

集群的离线凭据。

字段
client_certificate	string 仅限输出。用于向 k8s api-server 进行身份验证的客户端证书。
client_key	string 仅限输出。用于向 k8s api-server 进行身份验证的客户端私钥。
user_id	string 仅限输出。客户的身份。
expire_time	Timestamp 仅限输出。相应凭据的过期时间戳。

GetClusterRequest

获取集群。

字段
name	string 必需。集群的资源名称。 必须对指定的资源 name 具有以下 IAM 权限才能进行授权： edgecontainer.clusters.get

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

GetVpnConnectionRequest

获取 VPN 连接。

字段
name	string 必需。VPN 连接的资源名称。 必须对指定的资源 name 具有以下 IAM 权限才能进行授权： edgecontainer.vpnConnections.get

KmsKeyState

表示用于 CMEK 集成的客户管理的 KMS 密钥的可访问性状态。

枚举
KMS_KEY_STATE_UNSPECIFIED	未指定。
KMS_KEY_STATE_KEY_AVAILABLE	密钥可供使用，并且应可访问依赖资源。
KMS_KEY_STATE_KEY_UNAVAILABLE	密钥因不明原因而不可用。依赖资源可能无法访问。

ListClustersRequest

列出位置中的集群。

字段
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 无法到达的位置。

ListMachinesRequest

列出网站中的机器。

字段
parent	string 必需。拥有此机器集合的父级网站。 必须对指定的资源 parent 具有以下 IAM 权限才能进行授权： edgecontainer.machines.list
page_size	int32 要列出的资源数量上限。
page_token	string 从上一个列表请求收到的页面令牌。
filter	string 系统只会列出与此过滤条件匹配的资源。
order_by	string 指定资源的列出顺序。

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 无法到达的位置。

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 相应位置中的 VpnConnection。
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 仅限输出。相应机器是否已停用。如果停用，机器将无法进入服务模式。

MaintenanceExclusionWindow

表示维护排除窗口。

字段
window	TimeWindow 可选。时间窗口。
id	string 可选。窗口的唯一（每个集群）ID。

MaintenancePolicy

维护政策配置。

字段
window	MaintenanceWindow 指定可执行维护的维护窗口。
maintenance_exclusions[]	MaintenanceExclusionWindow 可选。自动维护的排除项。在这些时段内不应进行非紧急维护。每项排除对象都有一个唯一的名称，并且可能处于有效状态或已过期。在给定时间允许的维护排除项数量上限为 3。

MaintenanceWindow

维护窗口配置

字段
recurring_window	RecurringTimeWindow 周期性维护窗口的配置。

节点池

集群中具有相同配置和规范的一组 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 仅限输出。所有工作器节点中的最低发布版本。
node_config	NodeConfig 可选。NodePool 中每个节点的配置

LocalDiskEncryption

边缘机器本地磁盘加密的 CMEK 支持配置。

字段
kms_key	string 可选。用于保护节点本地磁盘的 Cloud KMS 加密密钥，例如 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 报告的错误状态。

NodeConfig

NodePool 中每个节点的配置

字段
labels	map<string, string> 可选。Kubernetes 节点标签
node_storage_schema	string 可选。工作器节点的存储架构的名称。 警告：可配置的节点本地存储空间架构功能是一项实验性功能，不建议在生产集群/节点池中常规使用。

OperationMetadata

Edge Container API 方法的长时间运行的操作元数据。

字段
create_time	Timestamp 操作的创建时间。
end_time	Timestamp 操作完成运行的时间。
target	string 由服务器定义的操作目标的资源路径。
verb	string 操作执行的谓词。
status_message	string 人类可读的操作状态（如果有）。
requested_cancellation	bool 标识用户是否已请求取消操作。已成功取消的操作具有 [Operation.error][] 值且 google.rpc.Status.code 为 1，对应于 Code.CANCELLED。
api_version	string 用于启动操作的 API 版本。
warnings[]	string 不会阻止操作，但仍包含相关信息供最终用户接收的警告。
status_reason	StatusReason 机器可读的操作状态（如果有）。

StatusReason

指明操作状态的原因。

枚举
STATUS_REASON_UNSPECIFIED	原因未知。
UPGRADE_PAUSED	集群升级目前已暂停。

配额

表示 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)。它们会在开始时间和结束时间之间持续显示。

ServerConfig

支持的版本和发布渠道的服务器配置。

字段
channels	map<string, ChannelConfig> 仅限输出。从发布渠道到渠道配置的映射。
versions[]	Version 仅限输出。支持的版本，例如：["1.4.0", "1.5.0"]。
default_version	string 仅限输出。默认版本，例如：“1.4.0”。

TimeWindow

表示任意时间窗口。

字段
start_time	Timestamp 时间段首次开始的时间。
end_time	Timestamp 窗口结束的时间。结束时间必须晚于开始时间。

UpdateClusterRequest

更新集群。

字段
update_mask	FieldMask 字段掩码用于指定更新要在集群资源中覆盖的字段。updateMask 中指定的字段与资源相关，而不是与完整请求相关。如果字段在掩码中，则会被覆盖。 如果用户未提供掩码，则所有字段都将被覆盖。
cluster	Cluster 更新后的集群。 必须对指定的资源 cluster 具有以下 IAM 权限才能进行授权： edgecontainer.clusters.update
request_id	string 相应请求的唯一标识符。仅限 36 个 ASCII 字符。建议使用随机 UUID。仅当提供 request_id 时，此请求才是幂等的。

UpdateNodePoolRequest

更新节点池。

字段
update_mask	FieldMask 字段掩码用于指定更新要在 NodePool 资源中覆盖的字段。updateMask 中指定的字段与资源相关，而不是与完整请求相关。如果字段在掩码中，则会被覆盖。 如果用户未提供掩码，则所有字段都将被覆盖。
node_pool	NodePool 更新后的节点池。 必须对指定的资源 nodePool 具有以下 IAM 权限才能进行授权： edgecontainer.nodePools.update
request_id	string 相应请求的唯一标识符。仅限 36 个 ASCII 字符。建议使用随机 UUID。仅当提供 request_id 时，此请求才是幂等的。

UpgradeClusterRequest

升级集群。

字段
name	string 必需。集群的资源名称。 必须对指定的资源 name 具有以下 IAM 权限才能进行授权： edgecontainer.clusters.upgrade
target_version	string 必需。集群将升级到的版本。
schedule	Schedule 升级时间表。
request_id	string 相应请求的唯一标识符。仅限 36 个 ASCII 字符。建议使用随机 UUID。仅当提供 request_id 时，此请求才是幂等的。

时间表

表示集群将要升级的时间安排。

枚举
SCHEDULE_UNSPECIFIED	未指定。默认设置为立即升级集群，这也是目前唯一的选项。
IMMEDIATELY	集群将在收到请求后立即升级。

版本

集群的版本。

字段
name	string 仅限输出。版本的名称，例如：“1.4.0”。

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 此项已弃用！ VPC 网络的动态路由模式，regional 或 global。
cluster	string 要连接的规范集群名称。格式为 projects/{project}/locations/{location}/clusters/{cluster}。
vpc	string 要连接的 VPC 的网络 ID。
vpc_project	VpcProject 可选。VPC 网络的项目详细信息。如果 VPC 与集群项目位于不同的项目中，则必须提供此参数。
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

VPC 网络的项目详细信息。

字段
project_id	string 要连接的 VPC 的项目。如果未指定，则与集群项目相同。

ZoneMetadata

Google Distributed Cloud Edge 可用区，边缘机器位于其中。

字段
quota[]	Quota 相应可用区中资源的配额。
rack_types	map<string, RackType> 以机架名称为键，以 RackType 为值的映射。

RackType

机架类型。

枚举
RACK_TYPE_UNSPECIFIED	未指定的机架类型，单个机架也属于此类型。
BASE	基本机架类型，一对包含聚合交换机的修改后的 Config-1 机架。
EXPANSION	扩展机架类型，也称为独立机架，由客户根据需求添加。