REST Resource: projects.locations.clusters

资源：Cluster

Google Distributed Cloud Edge Kubernetes 集群。

JSON 表示法 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "fleet": {
    object (Fleet)
  },
  "networking": {
    object (ClusterNetworking)
  },
  "authorization": {
    object (Authorization)
  },
  "defaultMaxPodsPerNode": integer,
  "endpoint": string,
  "clusterCaCertificate": string,
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "controlPlaneVersion": string,
  "nodeVersion": string
}
字段
name

string

必需。集群的资源名称。
createTime

string (Timestamp format)

仅限输出。集群的创建时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

仅限输出。集群上次更新的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
labels

map (key: string, value: string)

与此资源关联的标签。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
fleet

object (Fleet)

可选。舰队配置。
networking

object (ClusterNetworking)

必需。集群级网络配置。
authorization

object (Authorization)

必需。不可变。将由 GEC 应用和管理的 RBAC 政策。
defaultMaxPodsPerNode

integer

可选。如果没有为此集群中的节点池明确指定最大值，则系统会为每个节点使用的默认最大值。如果未指定，系统将使用 Kubernetes 默认值。
endpoint

string

仅限输出。Kubernetes API 服务器的 IP 地址。
clusterCaCertificate

string

仅限输出。集群 CA 的 PEM 编码的公共证书。
maintenancePolicy

object (MaintenancePolicy)

可选。集群范围的维护政策配置。
controlPlaneVersion

string

仅限输出。控制平面发布版本
nodeVersion

string

仅限输出。所有工作器节点中的最低发布版本。如果集群没有任何工作器节点，此字段可以为空。

舰队

与舰队相关的配置。

舰队是 Google Cloud 关于以逻辑方式整理集群的概念，让您可以使用和管理多集群功能，并在您的所有系统中应用一致的政策。

JSON 表示法 
{
  "project": string,
  "membership": string
}
字段
project

string

必需。将在其中注册此集群的舰队宿主项目的名称。

项目名称的格式为 projects/<project-number>。
membership

string

仅限输出。与此集群关联的托管式 Hub 成员资格资源的名称。

成员资格名称的格式为 projects/<project-number>/locations/global/membership/<cluster-id>。

ClusterNetworking

集群级网络配置。

JSON 表示法 
{
  "clusterIpv4CidrBlocks": [
    string
  ],
  "servicesIpv4CidrBlocks": [
    string
  ]
}
字段
clusterIpv4CidrBlocks[]

string

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

string

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

授权

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

JSON 表示法 
{
  "adminUsers": {
    object (ClusterUser)
  }
}
字段
adminUsers

object (ClusterUser)

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

ClusterUser

RBAC 政策的用户主账号。

JSON 表示法 
{
  "username": string
}
字段
username

string

必需。有效的 Google 用户名。

MaintenancePolicy

维护政策配置。

JSON 表示法 
{
  "window": {
    object (MaintenanceWindow)
  }
}
字段
window

object (MaintenanceWindow)

指定可执行维护的维护窗口。

MaintenanceWindow

维护窗口配置

JSON 表示法 
{
  "recurringWindow": {
    object (RecurringTimeWindow)
  }
}
字段
recurringWindow

object (RecurringTimeWindow)

周期性维护窗口的配置。

RecurringTimeWindow

表示会重复出现的任意时间段。

JSON 表示法 
{
  "window": {
    object (TimeWindow)
  },
  "recurrence": string
}
字段
window

object (TimeWindow)

首次重复出现的窗口。
recurrence

string

用于指定相应窗口重复方式的 RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3)。它们会在开始时间和结束时间之间持续显示。

TimeWindow

表示任意时间窗口。

JSON 表示法 
{
  "startTime": string,
  "endTime": string
}
字段
startTime

string (Timestamp format)

时间段首次开始的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
endTime

string (Timestamp format)

窗口结束的时间。结束时间必须晚于开始时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

方法

create

 在给定的项目和位置中创建新的集群。

delete

 删除单个集群。

generateAccessToken

 为集群生成访问令牌。

get

 获取单个集群的详细信息。

list

 列出给定项目和位置中的集群。

patch

 更新单个集群的参数。