Package google.cloud.edgecontainer.v1

색인

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)

특정 프로젝트와 위치의 NodePools를 나열합니다.

승인 범위

다음 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

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

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

필수 항목입니다. 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

사용자 애플리케이션이 배포되는 방식에 관한 정책 구성입니다.

원격

이 유형에는 필드가 없습니다.

원격으로 호스팅되는 컨트롤 플레인이 있는 클러스터와 관련된 구성입니다.

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 암호화 키의 가용성입니다. KEY_AVAILABLE이 아닌 경우 노드가 로컬 데이터에 액세스할 수 없으므로 오프라인 상태가 될 수 있습니다. 키를 사용할 권한이 없거나 키가 사용 중지되었거나 삭제된 경우에 발생할 수 있습니다.

kms_status

Status

출력 전용입니다. 이 키를 사용할 때 Cloud KMS에서 반환된 오류 상태입니다. 이 필드는 kms_key_stateKMS_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

선택사항입니다. 인그레스 구성입니다.

vm_service_config

VMServiceConfig

선택사항입니다. VM 서비스 구성입니다.

인그레스

고객이 인그레스 객체를 만들어 클러스터의 서버에 대한 외부 액세스를 관리할 수 있도록 하는 인그레스 부가기능 구성입니다. 부가기능은 istiod와 istio-ingress로 구성됩니다.

필드
disabled

bool

선택사항입니다. 인그레스가 사용 중지되었는지 여부입니다.

ipv4_vip

string

선택사항입니다. 인그레스 VIP입니다.

VMServiceConfig

VMServiceConfig는 GDCE VM 서비스의 구성을 정의합니다.

필드
vmm_enabled

bool

선택사항입니다. VMM 사용 설정 여부입니다.

ClusterNetworking

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

필드
cluster_ipv4_cidr_blocks[]

string

필수 항목입니다. 클러스터의 모든 포드에 이 블록의 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

이 요청의 고유 식별자입니다. ASCII 문자 36자로 제한됩니다. 임의의 UUID를 사용하는 것이 좋습니다. 이 요청은 request_id가 제공된 경우에만 멱등성을 갖습니다.

CreateNodePoolRequest

노드 풀을 만듭니다.

필드
parent

string

필수 항목입니다. 이 노드 풀이 생성될 상위 클러스터입니다.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • edgecontainer.nodePools.create
node_pool_id

string

필수 항목입니다. 노드 풀의 클라이언트 지정 고유 식별자입니다.

node_pool

NodePool

필수 항목입니다. 생성할 노드 풀입니다.

request_id

string

이 요청의 고유 식별자입니다. ASCII 문자 36자로 제한됩니다. 임의의 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

이 요청의 고유 식별자입니다. ASCII 문자 36자로 제한됩니다. 임의의 UUID를 사용하는 것이 좋습니다. 이 요청은 request_id가 제공된 경우에만 멱등성을 갖습니다.

DeleteClusterRequest

클러스터를 삭제합니다.

필드
name

string

필수 항목입니다. 클러스터의 리소스 이름입니다.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • edgecontainer.clusters.delete
request_id

string

이 요청의 고유 식별자입니다. ASCII 문자 36자로 제한됩니다. 임의의 UUID를 사용하는 것이 좋습니다. 이 요청은 request_id가 제공된 경우에만 멱등성을 갖습니다.

DeleteNodePoolRequest

노드 풀을 삭제합니다.

필드
name

string

필수 항목입니다. 노드 풀의 리소스 이름입니다.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • edgecontainer.nodePools.delete
request_id

string

이 요청의 고유 식별자입니다. ASCII 문자 36자로 제한됩니다. 임의의 UUID를 사용하는 것이 좋습니다. 이 요청은 request_id가 제공된 경우에만 멱등성을 갖습니다.

DeleteVpnConnectionRequest

VPN 연결을 삭제합니다.

필드
name

string

필수 항목입니다. VPN 연결의 리소스 이름입니다.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • edgecontainer.vpnConnections.delete
request_id

string

이 요청의 고유 식별자입니다. ASCII 문자 36자로 제한됩니다. 임의의 UUID를 사용하는 것이 좋습니다. 이 요청은 request_id가 제공된 경우에만 멱등성을 갖습니다.

Fleet

Fleet 관련 구성입니다.

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

필드
project

string

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

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

membership

string

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

멤버십 이름은 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

출력 전용입니다. 클라이언트의 ID입니다.

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

위치의 VpnConnections입니다.

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

반복 유지보수 기간의 구성입니다.

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

출력 전용입니다. 모든 워커 노드 중 가장 낮은 출시 버전입니다.

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 암호화 키의 가용성입니다. KEY_AVAILABLE이 아닌 경우 노드가 로컬 데이터에 액세스할 수 없으므로 오프라인 상태가 될 수 있습니다. 키를 사용할 권한이 없거나 키가 사용 중지되었거나 삭제된 경우에 발생할 수 있습니다.

kms_status

Status

출력 전용입니다. 이 키를 사용할 때 Cloud KMS에서 반환된 오류 상태입니다. 이 필드는 kms_key_stateKMS_KEY_STATE_KEY_AVAILABLE이 아닌 경우에만 채워질 수 있습니다. 채워진 경우 이 필드에는 Cloud KMS에서 보고한 오류 상태가 포함됩니다.

NodeConfig

NodePool의 각 노드 구성

필드
labels

map<string, string>

선택사항입니다. Kubernetes 노드 라벨

OperationMetadata

Edge Container API 메서드의 장기 실행 작업 메타데이터입니다.

필드
create_time

Timestamp

작업이 생성된 시간입니다.

end_time

Timestamp

작업 실행이 완료된 시간입니다.

target

string

작업 대상에 대한 서버 정의 리소스 경로입니다.

verb

string

작업에 의해 실행된 동사입니다.

status_message

string

작업의 사람이 읽을 수 있는 상태입니다(있는 경우).

requested_cancellation

bool

사용자가 작업 취소를 요청했는지를 나타냅니다. 성공적으로 취소된 작업은 Code.CANCELLED에 해당하는 google.rpc.Status.code가 1인 [Operation.error][] 값을 갖습니다.

api_version

string

작업을 시작하는 데 사용되는 API 버전입니다.

warnings[]

string

작업을 차단하지는 않지만 최종 사용자가 수신할 관련 정보가 포함된 경고입니다.

status_reason

StatusReason

작업의 머신 판독 가능 상태입니다(있는 경우).

StatusReason

작업 상태의 이유를 나타냅니다.

열거형
STATUS_REASON_UNSPECIFIED 이유를 알 수 없습니다.
UPGRADE_PAUSED 현재 클러스터 업그레이드가 일시중지되어 있습니다.

할당량

Edge 컨테이너 리소스의 할당량을 나타냅니다.

필드
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

필드 마스크는 업데이트로 클러스터 리소스에서 덮어쓸 필드를 지정하는 데 사용됩니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 사용자가 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

cluster

Cluster

업데이트된 클러스터입니다.

승인을 처리하려면 지정된 리소스 cluster에 대해 다음과 같은 IAM 권한이 필요합니다.

  • edgecontainer.clusters.update
request_id

string

이 요청의 고유 식별자입니다. ASCII 문자 36자로 제한됩니다. 임의의 UUID를 사용하는 것이 좋습니다. 이 요청은 request_id가 제공된 경우에만 멱등성을 갖습니다.

UpdateNodePoolRequest

노드 풀을 업데이트합니다.

필드
update_mask

FieldMask

필드 마스크는 업데이트로 NodePool 리소스에서 덮어쓸 필드를 지정하는 데 사용됩니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 사용자가 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

node_pool

NodePool

업데이트된 노드 풀입니다.

승인을 처리하려면 지정된 리소스 nodePool에 대해 다음과 같은 IAM 권한이 필요합니다.

  • edgecontainer.nodePools.update
request_id

string

이 요청의 고유 식별자입니다. ASCII 문자 36자로 제한됩니다. 임의의 UUID를 사용하는 것이 좋습니다. 이 요청은 request_id가 제공된 경우에만 멱등성을 갖습니다.

UpgradeClusterRequest

클러스터를 업그레이드합니다.

필드
name

string

필수 항목입니다. 클러스터의 리소스 이름입니다.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • edgecontainer.clusters.upgrade
target_version

string

필수 항목입니다. 클러스터가 업그레이드될 버전입니다.

schedule

Schedule

업그레이드 일정입니다.

request_id

string

이 요청의 고유 식별자입니다. ASCII 문자 36자로 제한됩니다. 임의의 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가 여러 개 있는 경우 외부 IP 하나만 GMEC Anthos 클러스터에 매핑되도록 NAT를 구성해야 합니다. 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 연결에 클러스터 측에서 HA가 사용 설정되어 있는지 여부입니다. 사용 설정된 경우 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 고객이 요청 시 추가한 확장 랙 유형(독립형 랙이라고도 함)입니다.