REST Resource: projects.locations.clusters

리소스: 클러스터

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 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 클러스터가 마지막으로 업데이트된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "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)

선택사항입니다. 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

출력 전용입니다. 모든 워커 노드 중 가장 낮은 출시 버전입니다. 클러스터에 작업자 노드가 없는 경우 이 필드는 비어 있을 수 있습니다.

Fleet

Fleet 관련 구성입니다.

Fleet는 클러스터를 논리적으로 구성하기 위한 Google Cloud 개념으로, 이를 사용하면 멀티 클러스터 기능을 사용 및 관리하고 시스템 전체에 일관된 정책을 적용할 수 있습니다.

JSON 표현 
{
  "project": string,
  "membership": string
}
필드
project

string

필수 항목입니다. 이 클러스터가 등록되는 Fleet 호스트 프로젝트의 이름입니다.

프로젝트 이름은 projects/<project-number> 형식으로 지정됩니다.
membership

string

출력 전용입니다. 이 클러스터에 연결된 관리되는 허브 멤버십 리소스의 이름입니다.

멤버십 이름은 projects/<project-number>/locations/global/membership/<cluster-id> 형식으로 지정됩니다.

ClusterNetworking

클러스터 전체 네트워킹 구성입니다.

JSON 표현 
{
  "clusterIpv4CidrBlocks": [
    string
  ],
  "servicesIpv4CidrBlocks": [
    string
  ]
}
필드
clusterIpv4CidrBlocks[]

string

필수 항목입니다. 클러스터의 모든 포드에 이 블록의 RFC1918 IPv4 주소가 할당됩니다. 단일 블록만 지원됩니다. 이 필드는 생성 후 변경할 수 없습니다.
servicesIpv4CidrBlocks[]

string

필수 항목입니다. 클러스터의 모든 서비스에 이 블록의 RFC1918 IPv4 주소가 할당됩니다. 단일 블록만 지원됩니다. 이 필드는 생성 후 변경할 수 없습니다.

승인

GEC에서 적용하고 관리할 RBAC 정책입니다.

JSON 표현 
{
  "adminUsers": {
    object (ClusterUser)
  }
}
필드
adminUsers

object (ClusterUser)

필수 항목입니다. 클러스터 관리자 액세스 권한을 부여하여 클러스터에 대한 전체 액세스 권한을 제공할 사용자입니다. 현재는 단일 필드이지만 향후 여러 관리자를 허용하도록 확장될 예정입니다.

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 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
endTime

string (Timestamp format)

기간이 종료되는 시간입니다. 종료 시간은 시작 시간 이후여야 합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

메서드

create

 특정 프로젝트와 위치에 새 클러스터를 만듭니다.

delete

 단일 클러스터를 삭제합니다.

generateAccessToken

 클러스터의 액세스 토큰을 생성합니다.

get

 단일 클러스터의 세부정보를 가져옵니다.

list

 특정 프로젝트 및 위치의 클러스터를 나열합니다.

patch

 단일 클러스터의 매개변수를 업데이트합니다.