Package google.cloud.edgecontainer.v1alpha

Índice

EdgeContainer

A API EdgeContainer gerencia clusters do Kubernetes em implantações do Google Edge Cloud.

CreateApiKey

rpc CreateApiKey(CreateApiKeyRequest) returns (Operation)

CreateApiKey cria uma chave de API para a conta de serviço do projeto em questão.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

CreateCluster

rpc CreateCluster(CreateClusterRequest) returns (Operation)

Cria um cluster em determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

CreateIdentityProvider

rpc CreateIdentityProvider(CreateIdentityProviderRequest) returns (Operation)

Configura um provedor de identidade no cluster de infraestrutura.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

CreateNodePool

rpc CreateNodePool(CreateNodePoolRequest) returns (Operation)

Cria um novo NodePool em um determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

CreateServiceAccount

rpc CreateServiceAccount(CreateServiceAccountRequest) returns (Operation)

CreateServiceAccount cria a CR da conta de serviço do projeto no namespace do projeto no cluster (cluster de infraestrutura para V2, cluster de usuário para V1).

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

CreateVpnConnection

rpc CreateVpnConnection(CreateVpnConnectionRequest) returns (Operation)

Cria uma conexão VPN em determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

DeleteApiKey

rpc DeleteApiKey(DeleteApiKeyRequest) returns (Operation)

DeleteApiKey exclui a chave de API da conta de serviço do projeto em questão.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

DeleteCluster

rpc DeleteCluster(DeleteClusterRequest) returns (Operation)

Exclui um único cluster.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

DeleteIdentityProvider

rpc DeleteIdentityProvider(DeleteIdentityProviderRequest) returns (Operation)

DeleteIdentityProvider remove o provedor de identidade do cluster de infraestrutura.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

DeleteNodePool

rpc DeleteNodePool(DeleteNodePoolRequest) returns (Operation)

Exclui um único NodePool.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

DeleteServiceAccount

rpc DeleteServiceAccount(DeleteServiceAccountRequest) returns (Operation)

DeleteServiceAccount exclui a CR da conta de serviço do projeto no namespace do projeto no cluster (cluster de infraestrutura para V2, cluster de usuário para V1).

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

DeleteVpnConnection

rpc DeleteVpnConnection(DeleteVpnConnectionRequest) returns (Operation)

Exclui uma única conexão VPN.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

DescribeServiceAccountKey

rpc DescribeServiceAccountKey(DescribeServiceAccountKeyRequest) returns (DescribeServiceAccountKeyResponse)

DescribeServiceAccountKey lista todas as chaves do recurso de conta de serviço fornecido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

DisableServiceAccountKey

rpc DisableServiceAccountKey(DisableServiceAccountKeyRequest) returns (DisableServiceAccountKeyResponse)

DisableServiceAccountKey desativa a chave da conta de serviço fornecida.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

EnableZonalProject

rpc EnableZonalProject(EnableZonalProjectRequest) returns (Operation)

EnableZonalProject ativa o projeto do consumidor na zona.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

EnableZonalService

rpc EnableZonalService(EnableZonalServiceRequest) returns (Operation)

EnableZonalService ativa um serviço em uma zona.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GenerateAccessToken

rpc GenerateAccessToken(GenerateAccessTokenRequest) returns (GenerateAccessTokenResponse)

Gera um token de acesso para um cluster.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GenerateOfflineCredential

rpc GenerateOfflineCredential(GenerateOfflineCredentialRequest) returns (GenerateOfflineCredentialResponse)

Gera uma credencial off-line para um cluster.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GenerateServiceAccountKey

rpc GenerateServiceAccountKey(GenerateServiceAccountKeyRequest) returns (GenerateServiceAccountKeyResponse)

GenerateServiceAccountKey gera um par de chaves para o recurso de conta de serviço fornecido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetApiKey

rpc GetApiKey(GetApiKeyRequest) returns (ApiKey)

Recebe detalhes de uma única ApiKey.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetCluster

rpc GetCluster(GetClusterRequest) returns (Cluster)

Recebe detalhes de um único cluster.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetIamPolicy

rpc GetIamPolicy(GetIamPolicyRequest) returns (IamPolicy)

GetIamPolicy recebe as políticas do IAM para um projeto no cluster de infraestrutura.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetIdentityProvider

rpc GetIdentityProvider(GetIdentityProviderRequest) returns (IdentityProvider)

GetIdentityProvider recebe os detalhes do provedor de identidade.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetMachine

rpc GetMachine(GetMachineRequest) returns (Machine)

Recebe detalhes de uma única máquina.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetNodePool

rpc GetNodePool(GetNodePoolRequest) returns (NodePool)

Recebe detalhes de um único NodePool.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetServerConfig

rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig)

Recebe a configuração do servidor.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetServiceAccount

rpc GetServiceAccount(GetServiceAccountRequest) returns (ServiceAccount)

GetServiceAccount recebe os detalhes da conta de serviço.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetVpnConnection

rpc GetVpnConnection(GetVpnConnectionRequest) returns (VpnConnection)

Recebe detalhes de uma única conexão VPN.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetZonalProject

rpc GetZonalProject(GetZonalProjectRequest) returns (ZonalProject)

GetZonalProject recebe o ZonalProject.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetZonalService

rpc GetZonalService(GetZonalServiceRequest) returns (ZonalService)

GetEnabledZonalService recebe os detalhes do serviço ativado.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetZone

rpc GetZone(GetZoneRequest) returns (Zone)

Recebe detalhes de uma única zona em que a organização mãe está ativada.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListApiKeys

rpc ListApiKeys(ListApiKeysRequest) returns (ListApiKeysResponse)

Lista as ApiKeys em determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListClusters

rpc ListClusters(ListClustersRequest) returns (ListClustersResponse)

Lista os clusters em determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListIdentityProviders

rpc ListIdentityProviders(ListIdentityProvidersRequest) returns (ListIdentityProvidersResponse)

Lista os provedores de identidade configurados no cluster de infraestrutura.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListMachines

rpc ListMachines(ListMachinesRequest) returns (ListMachinesResponse)

Lista as máquinas em determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListNodePools

rpc ListNodePools(ListNodePoolsRequest) returns (ListNodePoolsResponse)

Lista os NodePools em determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListRoles

rpc ListRoles(ListRolesRequest) returns (ListRolesResponse)

ListRoles lista os papéis do IAM de um projeto na zona.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListServiceAccountKeys

rpc ListServiceAccountKeys(ListServiceAccountKeysRequest) returns (ListServiceAccountKeysResponse)

ListServiceAccountKeys lista todas as chaves do recurso de conta de serviço fornecido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListServiceAccounts

rpc ListServiceAccounts(ListServiceAccountsRequest) returns (ListServiceAccountsResponse)

ListServiceAccounts lista os detalhes de todos os recursos de conta de serviço de um projeto no cluster (cluster de infraestrutura para V2, cluster de usuário para V1).

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListVpnConnections

rpc ListVpnConnections(ListVpnConnectionsRequest) returns (ListVpnConnectionsResponse)

Lista as conexões VPN em um determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListZonalProjects

rpc ListZonalProjects(ListZonalProjectsRequest) returns (ListZonalProjectsResponse)

Lista ZonalProjects na zona.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListZonalServices

rpc ListZonalServices(ListZonalServicesRequest) returns (ListZonalServicesResponse)

Lista os ZonalServices em determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListZones

rpc ListZones(ListZonesRequest) returns (ListZonesResponse)

Lista as zonas em que a organização pai está ativada.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

SetIamPolicy

rpc SetIamPolicy(SetIamPolicyRequest) returns (IamPolicy)

SetIamPolicy define a política do IAM para um projeto no cluster de infraestrutura. Ela substitui a política atual pela fornecida.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

UpdateCluster

rpc UpdateCluster(UpdateClusterRequest) returns (Operation)

Atualiza os parâmetros de um único cluster.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

UpdateNodePool

rpc UpdateNodePool(UpdateNodePoolRequest) returns (Operation)

Atualiza os parâmetros de um único NodePool.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

UpgradeCluster

rpc UpgradeCluster(UpgradeClusterRequest) returns (Operation)

Faz upgrade de um único cluster.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ApiKey

Representa o recurso de chave de API.

Campos
name

string

Identificador. O nome canônico do recurso da chave de API. Por exemplo, projects/{project}/locations/{location}/apiKeys/{api_key}

service_account_name

string

Obrigatório. O nome de recurso canônico da conta de serviço associada à chave de API.

zone

string

Obrigatório. O ID da zona em que a conta de serviço do projeto precisa ser criada.

validity

Duration

Opcional. Somente entrada. Duração em que a chave de API é válida.

api_targets[]

ApiTarget

Opcional. As APIs de destino a que a chave de API está restrita. Se estiver vazio, todas as APIs serão permitidas.

labels

map<string, string>

Opcional. Rótulos associados a este recurso.

key

string

Apenas saída. A string apikey do status da CR APIKey.

expire_time

Timestamp

Apenas saída. Definido com base em key_generation_time e na duração da validade

state

State

Apenas saída. O estado da CR da chave de API no cluster.

reason

string

Apenas saída. O motivo do estado da CR da APIKey.

create_time

Timestamp

Apenas saída. A hora em que a chave de API foi gerada.

delete_time

Timestamp

Apenas saída. O horário em que o recurso de chave de API foi excluído.

update_time

Timestamp

Apenas saída. O horário em que o recurso de chave de API foi atualizado pela última vez.

ApiTarget

Representa uma restrição na chave de API. Isso é fornecido pelo usuário como entrada.

Campos
service

string

Opcional. O fqdn do serviço (verificado em relação a req.Host em chamadas de API).

methods[]

string

Opcional. Segue as regras nas restrições de apitarget do GCP, aceita caracteres curinga. Se estiver vazio, todos os métodos serão permitidos.

Estado

O estado da chave de API no cluster.

Tipos enumerados
STATE_UNKNOWN Estado desconhecido se a reconciliação ainda não tiver sido executada.
ACTIVE A chave está ativa e pode ser usada para autenticação.
NOT_ACTIVE A chave não está ativa e não pode ser usada para autenticação. Isso pode acontecer se a chave tiver expirado, se a conta de serviço não estiver ativa ou se tiver ocorrido um erro interno.
REPAIRING A chave está sendo reparada/reconciliada.

Autorização

Política de RBAC que será aplicada e gerenciada pelo GEC.

Campos
admin_users

ClusterUser

Obrigatório. Usuário que receberá o papel de administrador do cluster e terá acesso total a ele. No momento, esse é um campo único, mas será expandido para permitir vários administradores no futuro.

ChannelConfig

Configuração de um canal de lançamento.

Campos
default_version

string

Apenas saída. Versão padrão para este canal de lançamento, por exemplo: "1.4.0".

Cluster

Um cluster do Kubernetes do Google Distributed Cloud Edge.

Campos
name

string

Obrigatório. O nome do recurso do cluster.

create_time

Timestamp

Apenas saída. A hora em que o cluster foi criado.

update_time

Timestamp

Apenas saída. A hora em que o cluster foi atualizado pela última vez.

labels

map<string, string>

Rótulos associados a este recurso.

fleet

Fleet

Obrigatório. Configuração da frota.

networking

ClusterNetworking

Obrigatório. Configuração de rede em todo o cluster.

authorization

Authorization

Obrigatório. Imutável. Política de RBAC que será aplicada e gerenciada pelo GEC.

default_max_pods_per_node

int32

Opcional. O número máximo padrão de pods por nó usado se um valor máximo não for especificado explicitamente para um pool de nós neste cluster. Se não for especificado, o valor padrão do Kubernetes será usado.

endpoint

string

Apenas saída. O endereço IP do servidor de API Kubernetes.

port

int32

Apenas saída. O número da porta do servidor de API do Kubernetes.

cluster_ca_certificate

string

Apenas saída. O certificado público codificado em PEM da CA do cluster.

maintenance_policy

MaintenancePolicy

Opcional. Configuração da política de manutenção em todo o cluster.

control_plane_version

string

Apenas saída. A versão de lançamento do plano de controle

node_version

string

Apenas saída. A versão de lançamento mais antiga entre todos os nós de trabalho. Esse campo pode ficar vazio se o cluster não tiver nós de trabalho.

control_plane

ControlPlane

Opcional. A configuração do plano de controle do cluster.

system_addons_config

SystemAddonsConfig

Opcional. A configuração dos complementos do sistema.

external_load_balancer_ipv4_address_pools[]

string

Opcional. Pools de endereços IPv4 para balanceamento de carga externo do plano de dados do cluster.

control_plane_encryption

ControlPlaneEncryption

Opcional. Opções de criptografia de disco do plano de controle remoto. Este campo é usado apenas ao ativar o suporte a CMEK.

status

Status

Apenas saída. O status atual do cluster.

maintenance_events[]

MaintenanceEvent

Apenas saída. Todos os eventos de manutenção programados para o cluster, incluindo os que estão em andamento, planejados para o futuro e concluídos no passado (até 90 dias).

target_version

string

Opcional. A versão do cluster de destino. Por exemplo: "1.5.0".

release_channel

ReleaseChannel

Opcional. O canal de lançamento em que um cluster está inscrito.

survivability_config

SurvivabilityConfig

Opcional. Configuração da capacidade de sobrevivência do cluster, por exemplo, para o caso de perda de conectividade de rede. Observação: isso se aplica apenas a clusters de plano de controle local.

external_load_balancer_ipv6_address_pools[]

string

Opcional. Pools de endereços IPv6 para balanceamento de carga externo do plano de dados do cluster.

connection_state

ConnectionState

Apenas saída. O estado de conexão atual do cluster.

external_load_balancer_address_pools[]

ExternalLoadBalancerPool

Opcional. Pools de balanceadores de carga externos para o cluster.

zone_storage_encryption

ZoneStorageEncryption

Opcional. A configuração de criptografia de armazenamento da zona

container_runtime_config

ContainerRuntimeConfig

Opcional. A configuração do ambiente de execução do contêiner do cluster.

enable_remote_backup

bool

Opcional. Se for verdadeiro, o recurso de backup/restauração remota será ativado para esse cluster.

enable_cluster_isolation

bool

Opcional. Indica se o cluster precisa ser isolado. go/cluster-isolation-in-gdcc-cluster

google_group_authentication

GoogleGroupAuthenticationConfig

Opcional. A configuração de autenticação do Grupo do Google do cluster.

ConnectionState

ConnectionState contém o estado atual da conexão do cluster com o Google.

Campos
state

State

Apenas saída. O estado atual da conexão.

update_time

Timestamp

Apenas saída. O horário em que o estado da conexão foi alterado pela última vez.

Estado

O estado da conexão.

Tipos enumerados
STATE_UNSPECIFIED Estado de conexão desconhecido.
DISCONNECTED No momento, este cluster está desconectado do Google.
CONNECTED No momento, este cluster está conectado ao Google.
CONNECTED_AND_SYNCING Este cluster está conectado ao Google, mas pode ter sido reconectado recentemente após uma desconexão. A sincronização ainda está em andamento.

ContainerRuntimeConfig

Configuração do ambiente de execução do contêiner do cluster.

Campos
default_container_runtime

DefaultContainerRuntime

Opcional. O ambiente de execução de contêiner padrão a ser configurado no cluster.

DefaultContainerRuntime

Lista de ambientes de execução de contêiner compatíveis.

Tipos enumerados
DEFAULT_CONTAINER_RUNTIME_UNSPECIFIED O ambiente de execução do contêiner não foi especificado.
RUNC Use o runc como o ambiente de execução de contêiner padrão no cluster.
GVISOR Usar o gVisor como o ambiente de execução de contêiner padrão no cluster.

ControlPlane

Configuração do plano de controle do cluster.

Campos

Campo de união config.

config pode ser apenas de um dos tipos a seguir:

remote

Remote

Configuração do plano de controle remoto.

local

Local

Configuração do plano de controle local.

Aviso: os clusters do plano de controle local precisam ser criados no próprio projeto. Os clusters do plano de controle local não podem coexistir no mesmo projeto com nenhum outro tipo de cluster, incluindo os que não são do GDCE. Misturar clusters do GDCE de plano de controle local com qualquer outro tipo de cluster no mesmo projeto pode resultar em perda de dados.

Local

Configuração específica para clusters com um plano de controle hospedado localmente.

Aviso: os clusters do plano de controle local precisam ser criados no próprio projeto. Os clusters do plano de controle local não podem coexistir no mesmo projeto com nenhum outro tipo de cluster, incluindo os que não são do GDCE. Misturar clusters do GDCE de plano de controle local com qualquer outro tipo de cluster no mesmo projeto pode resultar em perda de dados.

Campos
node_location

string

Nome das zonas do Google Distributed Cloud Edge em que esse pool de nós será criado. Por exemplo, us-central1-edge-customer-a.

node_count

int32

O número de nós que vão servir como réplicas do plano de controle.

machine_filter

string

Somente as máquinas que correspondem a esse filtro poderão hospedar nós do plano de controle. A linguagem de filtragem aceita strings como "name=" e está documentada aqui: AIP-160.

shared_deployment_policy

SharedDeploymentPolicy

Configuração de política sobre como os aplicativos do usuário são implantados.

control_plane_node_storage_schema

string

Opcional. Nome do esquema de armazenamento dos nós do plano de controle.

control_plane_node_system_partition_size

SystemPartitionGiBSize

Opcional. Tamanho da partição do sistema para nós do plano de controle em GiB.

Remoto

Esse tipo não tem campos.

Configuração específica para clusters com um plano de controle hospedado remotamente.

SharedDeploymentPolicy

Representa a configuração da política sobre como os aplicativos do usuário são implantados.

Tipos enumerados
SHARED_DEPLOYMENT_POLICY_UNSPECIFIED Não especificado.
ALLOWED Os aplicativos do usuário podem ser implantados no plano de controle e nos nós de trabalho.
DISALLOWED Os aplicativos do usuário não podem ser implantados em nós do plano de controle, apenas em nós de trabalho.

ControlPlaneEncryption

Configuração para suporte à chave KMS gerenciada pelo cliente para nós do plano de controle.

Campos
kms_key

string

Opcional. A CryptoKey do Cloud KMS, por exemplo, projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, que será usada para proteger os discos do plano de controle. Se não for especificada, uma chave gerenciada pelo Google será usada.

kms_key_active_version

string

Apenas saída. A CryptoKeyVersion do Cloud KMS atualmente em uso para proteger os discos do plano de controle. Aplicável apenas se kms_key estiver definido.

kms_key_state

KmsKeyState

Apenas saída. Disponibilidade da CryptoKey do Cloud KMS. Se não for KEY_AVAILABLE, os nós poderão ficar off-line porque não conseguem acessar os dados locais. Isso pode ser causado por falta de permissões para usar a chave ou se ela estiver desativada ou excluída.

kms_status

Status

Apenas saída. Status de erro retornado pelo Cloud KMS ao usar essa chave. Esse campo só pode ser preenchido se kms_key_state não for KMS_KEY_STATE_KEY_AVAILABLE. Se preenchido, esse campo contém o status de erro informado pelo Cloud KMS.

resource_state

ResourceState

Apenas saída. O estado atual do recurso associado à CMEK.

ExternalLoadBalancerPool

Pool de balanceador de carga externo com configuração personalizada, como nome, atribuição manual/automática, IPv4 não sobreposto e intervalo de endereços IPv6 opcional.

Campos
address_pool

string

Opcional. Nome do pool do balanceador de carga externo.

ipv4_range[]

string

Obrigatório. Intervalo de endereços IPv4 não sobrepostos do pool do balanceador de carga externo.

ipv6_range[]

string

Opcional. Intervalo de endereços IPv6 não sobreposto do pool do balanceador de carga externo.

avoid_buggy_ips

bool

Opcional. Se for verdadeiro, o pool vai omitir os endereços IP que terminam em .0 e .255. Alguns hardwares de rede descartam tráfego para esses endereços especiais. O valor padrão é falso.

manual_assign

bool

Opcional. Se for verdadeiro, os endereços neste pool não serão atribuídos automaticamente aos serviços do Kubernetes. Se verdadeiro, um endereço IP nesse pool só será usado quando for especificado explicitamente por um serviço. O valor padrão é falso.

GoogleGroupAuthenticationConfig

Configuração de autenticação do Grupo do Google do cluster. go/gdc-google-group-authentication

Campos
enable

bool

Opcional. Se for verdadeiro, o cluster será configurado para usar a autenticação dos Grupos do Google.

MaintenanceEvent

Um Evento de Manutenção é uma operação que pode causar interrupções temporárias nas cargas de trabalho do cluster, incluindo upgrades de cluster iniciados pelo Google ou pelo usuário, alterações de configuração de cluster iniciadas pelo usuário que exigem a reinicialização de nós etc.

Campos
uuid

string

Apenas saída. UUID do evento de manutenção.

target_version

string

Apenas saída. A versão de destino do cluster.

operation

string

Apenas saída. A operação para executar o evento de manutenção. Especificado no formato projects/*/locations/*/operations/*. Se o evento de manutenção for dividido em várias operações (por exemplo, devido a janelas de manutenção), a mais recente será registrada.

type

Type

Apenas saída. O tipo do evento de manutenção.

schedule

Schedule

Apenas saída. A programação do evento de manutenção.

state

State

Apenas saída. O estado do evento de manutenção.

create_time

Timestamp

Apenas saída. A hora em que a solicitação de evento de manutenção foi criada.

start_time

Timestamp

Apenas saída. O horário em que o evento de manutenção começou.

end_time

Timestamp

Apenas saída. O horário em que o evento de manutenção terminou, seja com sucesso ou não. Se o evento de manutenção for dividido em várias janelas de manutenção, end_time só será atualizado quando todo o fluxo terminar.

update_time

Timestamp

Apenas saída. O horário em que a mensagem do evento de manutenção foi atualizada.

Programação

Indica quando o evento de manutenção deve ser realizado.

Tipos enumerados
SCHEDULE_UNSPECIFIED Não especificado.
IMMEDIATELY Imediatamente após receber a solicitação.

Estado

Indica o estado do evento de manutenção.

Tipos enumerados
STATE_UNSPECIFIED Não especificado.
RECONCILING O evento de manutenção está em andamento. O cluster pode ficar inutilizável.
SUCCEEDED O evento de manutenção foi concluído.
FAILED O evento de manutenção falhou.

Tipo

Indica o tipo de evento de manutenção.

Tipos enumerados
TYPE_UNSPECIFIED Não especificado.
USER_INITIATED_UPGRADE Upgrade iniciado pelos usuários.
GOOGLE_DRIVEN_UPGRADE Upgrade feito pelo Google.

ReleaseChannel

O canal de lançamento em que um cluster está inscrito.

Tipos enumerados
RELEASE_CHANNEL_UNSPECIFIED Canal de lançamento não especificado. O padrão é o canal normal.
NONE Nenhum canal de lançamento.
REGULAR Canal de lançamento normal.

Status

Indica o status do cluster.

Tipos enumerados
STATUS_UNSPECIFIED Status desconhecido.
PROVISIONING O cluster está sendo criado.
RUNNING O cluster foi criado e está totalmente utilizável.
DELETING O cluster está sendo excluído.
ERROR O status indica que ocorreram alguns erros ao reconciliar/excluir o cluster.
RECONCILING O cluster está passando por algum trabalho, como upgrades de versão etc.

SurvivabilityConfig

Configuração da capacidade de sobrevivência do cluster, por exemplo, para o caso de perda de conectividade de rede.

Campos
offline_reboot_ttl

Duration

Opcional. Período que permite que os nós do cluster sejam reinicializados e se tornem funcionais sem conectividade de rede com o Google. O padrão 0 significa que não é permitido. O máximo é de 30 dias.

SystemAddonsConfig

Configuração que os clientes podem definir para os complementos do sistema do GDCE.

Campos
ingress

Ingress

Opcional. Configuração para Entrada.

vm_service_config

VMServiceConfig

Opcional. Configuração do serviço de VM.

Entrada

Configuração do complemento de entrada que permite aos clientes criar um objeto de entrada para gerenciar o acesso externo aos servidores em um cluster. O complemento consiste em istiod e istio-ingress.

Campos
disabled

bool

Opcional. Se a entrada está desativada.

ipv4_vip

string

Opcional. VIP de entrada.

VMServiceConfig

VMServiceConfig define a configuração do serviço de VM do GDCE.

Campos
vmm_enabled

bool

Opcional. Se o VMM está ativado.

ZoneStorageEncryption

Configuração para suporte a CMEK do Zone Storage

Campos
kms_key

string

Opcional. A chave do Cloud KMS

kms_key_active_version

string

Apenas saída. A CryptoKeyVersion do Cloud KMS usada atualmente para criptografia/descriptografia

resource_state

ResourceState

Apenas saída. O estado atual do recurso da CMEK

ClusterNetworking

Configuração de rede em todo o cluster.

Campos
cluster_ipv4_cidr_blocks[]

string

Obrigatório. Todos os pods no cluster recebem um endereço IPv4 RFC1918 desses blocos. Só é possível usar um bloco. Este campo não pode ser alterado após a criação.

services_ipv4_cidr_blocks[]

string

Obrigatório. Todos os serviços do cluster recebem um endereço IPv4 RFC1918 desses blocos. Só é possível usar um bloco. Este campo não pode ser alterado após a criação.

ClusterUser

Um principal de usuário para uma política de RBAC.

Campos
username

string

Obrigatório. Um nome de usuário do Google ativo.

ConfigData

Os dados de configuração contêm todos os dados relacionados à configuração da zona.

Campos
available_external_lb_pools_ipv4[]

string

lista de pools de IP v4 disponíveis para balanceador de carga externo

available_external_lb_pools_ipv6[]

string

lista de pools de IP v6 disponíveis para balanceador de carga externo

CreateApiKeyRequest

Solicite o proto para criar uma chave de API.

Campos
parent

string

Obrigatório. O recurso pai em que essa chave será criada. Formato: projects/{project}/locations/{location}

api_key

ApiKey

Obrigatório. A chave de API a ser criada.

api_key_id

string

Obrigatório. O ID da chave de API a ser criada.

request_id

string

Opcional. Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

CreateClusterRequest

Cria um cluster.

Campos
parent

string

Obrigatório. O local pai em que esse cluster será criado.

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • edgecontainer.clusters.create
cluster_id

string

Obrigatório. Um identificador exclusivo especificado pelo cliente para o cluster.

cluster

Cluster

Obrigatório. O cluster a ser criado.

request_id

string

Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

CreateIdentityProviderRequest

Solicita o proto para configurar o provedor de identidade de uma organização.

Campos
parent

string

Obrigatório. O nome do recurso do provedor de identidade a ser configurado. Por exemplo, organizations/{organization}/locations/{location}

identity_provider_id

string

Obrigatório. O ID do provedor de identidade.

identity_provider

IdentityProvider

Obrigatório. O provedor de identidade a ser configurado.

request_id

string

Opcional. Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

CreateNodePoolRequest

Cria um pool de nós.

Campos
parent

string

Obrigatório. O cluster pai em que esse pool de nós será criado.

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • edgecontainer.nodePools.create
node_pool_id

string

Obrigatório. Um identificador exclusivo especificado pelo cliente para o pool de nós.

node_pool

NodePool

Obrigatório. O pool de nós a ser criado.

request_id

string

Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

CreateServiceAccountRequest

Solicite o proto para criar um recurso de conta de serviço.

Campos
parent

string

Obrigatório. O nome do recurso do provedor de identidade a ser configurado. Por exemplo, project/{project}/locations/{location}

service_account_id

string

Obrigatório. O ID da conta de serviço.

service_account

ServiceAccount

Obrigatório. A conta de serviço a ser configurada.

request_id

string

Opcional. Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

CreateVpnConnectionRequest

Cria uma conexão VPN.

Campos
parent

string

Obrigatório. O local pai em que essa conexão VPN será criada.

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • edgecontainer.vpnConnections.create
vpn_connection_id

string

Obrigatório. O identificador da conexão VPN.

vpn_connection

VpnConnection

Obrigatório. A conexão VPN a ser criada.

request_id

string

Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

DeleteApiKeyRequest

Solicitação de proto para excluir uma chave de API.

Campos
name

string

Obrigatório. O nome canônico do recurso da chave de API. Por exemplo, projects/{project}/locations/{location}/apiKeys/{api_key}

DeleteClusterRequest

Exclui um cluster.

Campos
name

string

Obrigatório. O nome do recurso do cluster.

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • edgecontainer.clusters.delete
request_id

string

Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

DeleteIdentityProviderRequest

Solicite o proto para excluir o provedor de identidade de uma organização.

Campos
name

string

Obrigatório. O nome do recurso do provedor de identidade a ser excluído. O nome a ser formatado como: organizations/{organization}/locations/{location}/identityProviders/{identity_provider}

request_id

string

Opcional. Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

DeleteNodePoolRequest

Exclui um pool de nós.

Campos
name

string

Obrigatório. O nome do recurso do pool de nós.

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • edgecontainer.nodePools.delete
request_id

string

Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

DeleteServiceAccountRequest

Solicite o proto para excluir um recurso de conta de serviço do projeto.

Campos
name

string

Obrigatório. O nome de recurso canônico da conta de serviço do projeto. Por exemplo, projects/{project}/locations/{location}/serviceAccounts/{service_account}

DeleteVpnConnectionRequest

Exclui uma conexão VPN.

Campos
name

string

Obrigatório. O nome do recurso da conexão VPN.

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • edgecontainer.vpnConnections.delete
request_id

string

Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

DescribeServiceAccountKeyRequest

Solicite o proto para a API DescribeServiceAccountKey.

Campos
parent

string

Obrigatório. O nome de recurso canônico da conta de serviço do projeto. Por exemplo, projects/{project}/locations/{location}/serviceAccounts/{service_account}

key_id

string

Obrigatório. O ID da chave a ser recebido.

DescribeServiceAccountKeyResponse

Proto de resposta para a API DescribeServiceAccountKey.

Campos
key_id

string

Apenas saída. O ID da chave pública.

expiry

string

Apenas saída. O expiry time da chave.

DisableServiceAccountKeyRequest

Solicita o proto para a API DisableServiceAccountKey.

Campos
parent

string

Obrigatório. O nome de recurso canônico da conta de serviço do projeto. Por exemplo, projects/{project}/locations/{location}/serviceAccounts/{service_account}

key_id

string

Obrigatório. O ID da chave a ser desativada.

DisableServiceAccountKeyResponse

Proto de resposta para a API DisableServiceAccountKey.

Campos
key_id

string

Apenas saída. O ID da chave desativada.

delete_time

Timestamp

Apenas saída. O carimbo de data/hora de quando a chave foi desativada.

EnableZonalProjectRequest

Ativa um projeto de consumidor (correspondente ao projeto de consumidor do Cloud) em zonas.

Campos
parent

string

Obrigatório. A zona pai em que o projeto será criado.

zonal_project_id

string

Obrigatório. O project_id especificado do projeto do consumidor a ser ativado.

zonal_project

ZonalProject

Obrigatório. O projeto do consumidor a ser ativado.

request_id

string

Opcional. Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

EnableZonalProjectResponse

Mensagem de resposta para ativar um projeto zonal.

Campos
zonal_project

ZonalProject

O projeto zonal ativado.

EnableZonalServiceRequest

Ativar a solicitação do ZonalService. A API vai configurar o acesso dos produtores de serviços no cluster para criar recursos de serviço.

Campos
parent

string

Obrigatório. O local pai, que é proprietário dessa coleção de serviços.

zonal_service_id

string

Opcional. zonal_service_id especificado.

zonal_service

ZonalService

Obrigatório. O serviço a ser criado.

request_id

string

Opcional. UUID da solicitação idempotente.

Frota

Configuração relacionada à frota.

As frotas são um conceito do Google Cloud voltado à organização lógica de clusters. Com elas, é possível usar e gerenciar recursos de vários clusters e aplicar políticas consistentes em todos os sistemas.

Campos
project

string

Obrigatório. O número do projeto host da frota em que este cluster será registrado.

Os nomes de projetos são formatados como projects/<project-number>.

membership

string

Apenas saída. O nome do recurso de assinatura de hub gerenciado associado a esse cluster.

Os nomes de assinaturas são formatados como projects/<project-number>/locations/global/membership/<cluster-id>.

GenerateAccessTokenRequest

Gera um token de acesso para um cluster.

Campos
cluster

string

Obrigatório. O nome do recurso do cluster.

A autorização requer a seguinte permissão do IAM no recurso especificado cluster:

  • edgecontainer.clusters.generateAccessToken

GenerateAccessTokenResponse

Um token de acesso para um cluster.

Campos
access_token

string

Apenas saída. Token de acesso para autenticação no api-server do K8s.

expire_time

Timestamp

Apenas saída. Carimbo de data/hora em que o token vai expirar.

GenerateOfflineCredentialRequest

Gera uma credencial off-line para um cluster.

Campos
cluster

string

Obrigatório. O nome do recurso do cluster.

A autorização requer a seguinte permissão do IAM no recurso especificado cluster:

  • edgecontainer.clusters.generateOfflineCredential

GenerateOfflineCredentialResponse

Uma credencial off-line para um cluster.

Campos
client_certificate

string

Apenas saída. Certificado do cliente para autenticação no api-server do K8s.

client_key

string

Apenas saída. Chave privada do cliente para autenticação no api-server do K8s.

user_id

string

Apenas saída. Identidade do cliente.

expire_time

Timestamp

Apenas saída. Carimbo de data/hora em que essa credencial vai expirar.

GenerateServiceAccountKeyRequest

Solicite o proto para a API GenerateServiceAccountKey.

Campos
name

string

Obrigatório. O nome de recurso canônico da conta de serviço do projeto. Por exemplo, projects/{project}/locations/{location}/serviceAccounts/{service_account}

validity

Duration

Opcional. O ciclo de vida da chave. Se não for especificado, o ciclo de vida padrão será definido como 14 dias.

ca_cert_path

string

Opcional. O caminho do certificado de CA.

GenerateServiceAccountKeyResponse

Proto de resposta para a API GenerateServiceAccountKey.

Campos
type

string

O tipo de credencial.

project

string

Apenas saída. O projeto ao qual a conta de serviço pertence.

private_key_id

string

Apenas saída. O ID da chave privada.

private_key

string

Apenas saída. A chave privada.

name

string

Apenas saída. O nome da identidade de serviço.

token_uri

string

Apenas saída. O URI do token.

format_version

string

Apenas saída. A versão do formato.

ca_cert_path

string

Apenas saída. O caminho do certificado de CA.

GetApiKeyRequest

Solicite o proto para receber uma chave de API.

Campos
name

string

Obrigatório. O nome da chave de API a ser recuperada. Formato: projects/{project}/locations/{location}/apiKeys/{api_key}

GetClusterRequest

Recebe um cluster.

Campos
name

string

Obrigatório. O nome do recurso do cluster.

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • edgecontainer.clusters.get

GetIamPolicyRequest

Solicite o proto para receber a política do IAM associada a um projeto em uma zona.

Campos
name

string

Obrigatório. O nome canônico da zona de onde a IamPolicy será buscada. Por exemplo, projects/*/locations/*/zones/*

GetIdentityProviderRequest

Proto de solicitação para receber o provedor de identidade de uma organização.

Campos
name

string

Obrigatório. O nome canônico do recurso do provedor de identidade. Por exemplo, organizations/*/locations/*/identityProviders/*

GetMachineRequest

Recebe uma máquina.

Campos
name

string

Obrigatório. O nome do recurso da máquina.

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • edgecontainer.machines.get

GetNodePoolRequest

Recebe um pool de nós.

Campos
name

string

Obrigatório. O nome do recurso do pool de nós.

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • edgecontainer.nodePools.get

GetServerConfigRequest

Recebe a configuração do servidor.

Campos
name

string

Obrigatório. O nome (projeto e local) da configuração do servidor a ser recebida, especificado no formato projects/*/locations/*.

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • edgecontainer.serverConfig.get

GetServiceAccountRequest

Solicite o proto para receber um recurso de conta de serviço.

Campos
name

string

Obrigatório. O nome de recurso canônico da conta de serviço do projeto. Por exemplo, projects/{project}/locations/{location}/serviceAccounts/{service_account}

GetVpnConnectionRequest

Recebe uma conexão VPN.

Campos
name

string

Obrigatório. O nome do recurso da conexão VPN.

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • edgecontainer.vpnConnections.get

GetZonalProjectRequest

Recebe um recurso de projeto zonal.

Campos
name

string

Obrigatório. O nome canônico do recurso do projeto zonal. Por exemplo, organizations/*/locations/*/zonalProjects/*

GetZonalServiceRequest

Receber solicitação do ZonalService.

Campos
name

string

Obrigatório. O nome do recurso do serviço.

GetZoneRequest

Recebe uma zona.

Campos
name

string

Obrigatório. O nome canônico do recurso da zona. Por exemplo, organizations/*/locations/*/zone/*

IamPolicy

IamPolicy representa uma política do IAM.

Campos
bindings[]

Binding

Opcional. A política é uma lista de vinculações.

etag

string

Opcional. A tag de entidade da política do IAM.

Vinculação

Binding representa uma vinculação de papel na política do IAM.

Campos
role

string

Obrigatório. O papel na política do IAM ao qual os membros serão vinculados.

members[]

Principal

Opcional. Os membros a serem vinculados ao papel.

Principal

Principal representa um principal na política do IAM.

Campos
Campo de união identity. O principal ao qual o papel será vinculado. identity pode ser apenas de um dos tipos a seguir:
user

string

Opcional. Representa um usuário na política do IAM.

service_account

string

Opcional. Representa uma conta de serviço na política do IAM.

group

string

Opcional. Representa um grupo na política do IAM.

IdentityProvider

Representa um recurso de provedor de identidade que representa a configuração do provedor de identidade para a organização.

Campos
name

string

Identificador. O nome canônico do recurso do provedor de identidade. Por exemplo, organizations/{organization}/locations/{location}/identityProviders/{identity_provider}

proxy_uri

string

Opcional. O URI de proxy para acessar o provedor de identidade.

create_time

Timestamp

Apenas saída. O horário em que o provedor de identidade foi criado.

update_time

Timestamp

Apenas saída. O horário em que o provedor de identidade foi atualizado pela última vez.

delete_time

Timestamp

Apenas saída. A data e hora em que o provedor de identidade foi excluído.

labels

map<string, string>

Opcional. Rótulos associados a este recurso.

state

State

Apenas saída. O estado do provedor de identidade.

Campo de união config. A configuração do provedor de identidade. config pode ser apenas de um dos tipos a seguir:
oidc_config

OIDCProviderConfig

A configuração do provedor OIDC.

saml_config

SAMLProviderConfig

A configuração do provedor SAML.

Campo de união target. O destino do provedor de identidade. target pode ser apenas de um dos tipos a seguir:
zone_id

string

O ID da zona de destino do cluster de infraestrutura para o qual o provedor de identidade será configurado.

cluster

string

O nome totalmente qualificado do BMUC de destino para o qual o provedor de identidade será configurado.

Estado

O estado do provedor de identidade.

Tipos enumerados
STATE_UNSPECIFIED Não especificado.
CREATING O provedor de identidade está no estado CRIANDO.
RUNNING O provedor de identidade está no estado EM EXECUÇÃO.
DELETING O provedor de identidade está no estado DELETING.
ERROR O provedor de identidade está no estado de erro.
REPAIRING O provedor de identidade está no estado REPAIRING.
DELETED O provedor de identidade está no estado DELETED.

KmsKeyState

Representa o estado de acessibilidade de uma chave do KMS gerenciada pelo cliente usada para integração com CMEK.

Tipos enumerados
KMS_KEY_STATE_UNSPECIFIED Não especificado.
KMS_KEY_STATE_KEY_AVAILABLE A chave está disponível para uso, e os recursos dependentes precisam estar acessíveis.
KMS_KEY_STATE_KEY_UNAVAILABLE A chave está indisponível por um motivo não especificado. Os recursos dependentes podem estar inacessíveis.

ListApiKeysRequest

Solicite o proto para listar as chaves de API.

Campos
parent

string

Obrigatório. O recurso pai em que essa chave será criada. Formato: projects/{project}/locations/{location}

page_size

int32

Opcional. O número máximo de recursos a serem listados.

page_token

string

Opcional. Um token de página recebido de uma solicitação de lista anterior.

ListApiKeysResponse

Proto de resposta para listar chaves de API.

Campos
api_keys[]

ApiKey

A lista de chaves de API.

next_page_token

string

Token para recuperar a próxima página de resultados.

unreachable[]

string

Locais que não puderam ser alcançados.

ListClustersRequest

Lista clusters em um local.

Campos
parent

string

Obrigatório. O local pai, que é proprietário dessa coleção de clusters.

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • edgecontainer.clusters.list
page_size

int32

O número máximo de recursos a serem listados.

page_token

string

Um token de página recebido de uma solicitação de lista anterior. Um token de página recebido de uma solicitação de lista anterior.

filter

string

Somente os recursos que corresponderem a esse filtro serão listados.

order_by

string

Especifica a ordem em que os recursos serão listados.

ListClustersResponse

Lista de clusters em um local.

Campos
clusters[]

Cluster

Clusters no local.

next_page_token

string

Token para recuperar a próxima página de resultados.

unreachable[]

string

Locais que não puderam ser alcançados.

ListIdentityProvidersRequest

Proto de solicitação para listar os provedores de identidade de uma organização.

Campos
parent

string

Obrigatório. A organização mãe e a região dos provedores de identidade.

page_size

int32

Opcional. O número máximo de recursos a serem listados.

page_token

string

Opcional. Um token de página recebido de uma solicitação de lista anterior.

filter

string

Opcional. Somente os recursos que corresponderem a esse filtro serão listados.

order_by

string

Opcional. Especifica a ordem em que os recursos serão listados. Ordenar por campos para o resultado.

ListIdentityProvidersResponse

Proto de resposta para listar os provedores de identidade de uma organização.

Campos
identity_providers[]

IdentityProvider

Uma lista de provedores de identidade que correspondem à solicitação.

next_page_token

string

Token para recuperar a próxima página de resultados.

unreachable[]

string

Lista não ordenada. Locais que não puderam ser alcançados.

ListMachinesRequest

Lista as máquinas em um site.

Campos
parent

string

Obrigatório. O site pai, que é proprietário dessa coleção de máquinas.

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • edgecontainer.machines.list
page_size

int32

O número máximo de recursos a serem listados.

page_token

string

Um token de página recebido de uma solicitação de lista anterior.

filter

string

Somente os recursos que corresponderem a esse filtro serão listados.

order_by

string

Especifica a ordem em que as máquinas serão listadas. De acordo com a AIP-132, o valor precisa ser uma lista separada por vírgulas de campos. É possível anexar " desc" a um campo para especificar a ordem decrescente.

Campos compatíveis: * name (padrão) : nome de recurso canônico da máquina.

Exemplo: "name desc".

ListMachinesResponse

Lista de máquinas em um site.

Campos
machines[]

Machine

Máquinas no site.

next_page_token

string

Token para recuperar a próxima página de resultados.

unreachable[]

string

Locais que não puderam ser alcançados.

ListNodePoolsRequest

Lista os pools de nós em um cluster.

Campos
parent

string

Obrigatório. O cluster pai, que é proprietário dessa coleção de pools de nós.

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • edgecontainer.nodePools.list
page_size

int32

O número máximo de recursos a serem listados.

page_token

string

Um token de página recebido de uma solicitação de lista anterior.

filter

string

Somente os recursos que corresponderem a esse filtro serão listados.

order_by

string

Especifica a ordem em que os recursos serão listados.

ListNodePoolsResponse

Lista de pools de nós em um cluster.

Campos
node_pools[]

NodePool

Pools de nós no cluster.

next_page_token

string

Token para recuperar a próxima página de resultados.

unreachable[]

string

Locais que não puderam ser alcançados.

ListRolesRequest

Proto de solicitação para listar os papéis associados a um projeto em uma zona.

Campos
parent

string

Obrigatório. O nome canônico da zona em que os papéis serão listados. Por exemplo, projects/*/locations/*/zones/*

page_size

int32

Opcional. O número máximo de recursos a serem listados.

page_token

string

Opcional. Um token de página recebido de uma solicitação de lista anterior.

ListRolesResponse

Proto de resposta para listar os papéis associados a um projeto em uma zona.

Campos
roles[]

Role

Uma lista de papéis associados a um projeto em uma zona.

next_page_token

string

Token para recuperar a próxima página de resultados.

ListServiceAccountKeysRequest

Solicite o proto para a API ListServiceAccountKeys.

Campos
parent

string

Obrigatório. O nome de recurso canônico da conta de serviço do projeto. Por exemplo, projects/{project}/locations/{location}/serviceAccounts/{service_account}

page_size

int32

Opcional. O número máximo de recursos a serem listados.

page_token

string

Opcional. Um token de página recebido de uma solicitação de lista anterior.

ListServiceAccountKeysResponse

Proto de resposta para a API ListServiceAccountKeys.

Campos
service_account_keys[]

ServiceAccountKeyInfo

A lista de chaves da conta de serviço.

next_page_token

string

Token para recuperar a próxima página de resultados.

ServiceAccountKeyInfo

ServiceAccountKeyInfo representa as informações de uma chave de conta de serviço.

Campos
key_id

string

Apenas saída. O ID da chave pública.

expiry

string

Apenas saída. O expiry time da chave.

ListServiceAccountsRequest

Solicitação List ServiceAccounts.

Campos
parent

string

Obrigatório. O local pai, que é proprietário dessa coleção de contas de serviço do projeto.

page_size

int32

Opcional. O número máximo de recursos a serem listados.

page_token

string

Opcional. Um token de página recebido de uma solicitação de lista anterior.

filter

string

Opcional. Somente os recursos que corresponderem a esse filtro serão listados.

order_by

string

Opcional. Especifica a ordem em que os recursos serão listados. Ordenar por campos para o resultado.

ListServiceAccountsResponse

Resposta de List ServiceAccounts.

Campos
service_accounts[]

ServiceAccount

Lista de ServiceAccounts que correspondem à solicitação.

next_page_token

string

Token para recuperar a próxima página de resultados.

unreachable[]

string

Locais que não puderam ser alcançados.

ListVpnConnectionsRequest

Lista as conexões VPN.

Campos
parent

string

Obrigatório. O local pai, que é proprietário dessa coleção de conexões VPN.

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • edgecontainer.vpnConnections.list
page_size

int32

O número máximo de recursos a serem listados.

page_token

string

Um token de página recebido de uma solicitação de lista anterior.

filter

string

Somente os recursos que corresponderem a esse filtro serão listados.

order_by

string

Especifica a ordem em que os recursos serão listados.

ListVpnConnectionsResponse

Lista de conexões VPN em um local.

Campos
vpn_connections[]

VpnConnection

VpnConnections no local.

next_page_token

string

Token para recuperar a próxima página de resultados.

unreachable[]

string

Locais que não puderam ser alcançados.

ListZonalProjectsRequest

Lista os projetos de consumidor em uma organização.

Campos
parent

string

Obrigatório. A zona pai em que o projeto será criado.

page_size

int32

Opcional. O número máximo de recursos a serem listados.

page_token

string

Opcional. Um token de página recebido de uma solicitação de lista anterior.

filter

string

Opcional. Somente os recursos que corresponderem a esse filtro serão listados.

order_by

string

Opcional. Especifica a ordem em que os recursos serão listados. Ordenar por campos para o resultado.

ListZonalProjectsResponse

Lista de projetos de consumidor em uma resposta da organização.

Campos
zonal_projects[]

ZonalProject

Clusters no local.

next_page_token

string

Token para recuperar a próxima página de resultados.

unreachable[]

string

zonas que não puderam ser alcançadas.

ListZonalServicesRequest

Solicitação List ZonalServices.

Campos
parent

string

Obrigatório. O local pai, que é proprietário dessa coleção de serviços.

page_size

int32

Opcional. O número máximo de recursos a serem listados.

page_token

string

Opcional. Um token de página recebido de uma solicitação de lista anterior.

filter

string

Opcional. Somente os recursos que corresponderem a esse filtro serão listados.

order_by

string

Opcional. Especifica a ordem em que os recursos serão listados. Ordenar por campos para o resultado.

ListZonalServicesResponse

Resposta de List ZonalServices.

Campos
zonal_services[]

ZonalService

Serviços zonais no local.

next_page_token

string

Token para recuperar a próxima página de resultados.

unreachable[]

string

Locais que não puderam ser alcançados.

ListZonesRequest

Lista as zonas em que a organização pai está ativada.

Campos
parent

string

Obrigatório. A organização mãe e o local.

page_size

int32

Opcional. O número máximo de itens para retornar.

page_token

string

Opcional. O valor next_page_token retornado de uma solicitação List anterior, se houver.

filter

string

Opcional. Somente os recursos que corresponderem a esse filtro serão listados.

order_by

string

Opcional. Especifica a ordem em que os recursos serão listados.

ListZonesResponse

Mensagem de resposta para listar zonas.

Campos
zones[]

Zone

Uma lista de zonas que correspondem à solicitação.

next_page_token

string

Token para recuperar a próxima página de resultados.

unreachable[]

string

Locais que não puderam ser alcançados.

LocationMetadata

Metadados de um determinado google.cloud.location.Location.

Campos
available_zones

map<string, ZoneMetadata>

O conjunto de zonas disponíveis do Google Distributed Cloud Edge no local. O mapa é codificado pelo ID em minúsculas de cada zona.

Máquina

Uma máquina do Google Distributed Cloud Edge capaz de atuar como um nó do Kubernetes.

Campos
name

string

Obrigatório. O nome do recurso da máquina.

create_time

Timestamp

Apenas saída. A hora em que o pool de nós foi criado.

update_time

Timestamp

Apenas saída. A hora em que o pool de nós foi atualizado pela última vez.

labels

map<string, string>

Rótulos associados a este recurso.

hosted_node

string

Nome de recurso canônico do nó que esta máquina é responsável por hospedar, por exemplo, projects/{project}/locations/{location}/clusters/{cluster_id}/nodePools/{pool_id}/{node}, ou vazio se a máquina não estiver atribuída para assumir o papel de um nó.

Para nós do plano de controle hospedados em máquinas de borda, isso vai retornar o seguinte formato: "projects/{project}/locations/{location}/clusters/{cluster_id}/controlPlaneNodes/{node}".

zone

string

A zona do Google Distributed Cloud Edge desta máquina.

version

string

Apenas saída. A versão do software da máquina.

disabled

bool

Apenas saída. Se a máquina está desativada. Se desativada, a máquina não poderá entrar em serviço.

status

Status

Apenas saída. O status atual da máquina.

purpose

Purpose

O tipo de cluster em que a máquina é usada.

Finalidade

A finalidade da máquina pode ser VIRTUALIZED_WORKLOAD ou BAREMETAL_CLUSTER.

Tipos enumerados
PURPOSE_UNSPECIFIED Finalidade não especificada.
VIRTUALIZED_WORKLOAD A máquina é usada para carga de trabalho virtual.
BAREMETAL_CLUSTER A máquina é usada para um cluster de usuário bare metal.

Status

Indica o status da máquina.

Tipos enumerados
STATUS_UNSPECIFIED Status desconhecido.
READY A máquina está pronta para hospedar um nó. Esse é o padrão.
DISABLED_FOR_REPAIR A máquina foi desativada para reparo com a adição de uma ou mais declarações de desativação.

MaintenanceExclusionWindow

Representa uma janela de exclusão de manutenção.

Campos
window

TimeWindow

Opcional. A janela de tempo.

id

string

Opcional. Um ID exclusivo (por cluster) para a janela.

MaintenancePolicy

Configuração da política de manutenção.

Campos
window

MaintenanceWindow

Especifica a janela de manutenção em que a manutenção pode ser realizada.

maintenance_exclusions[]

MaintenanceExclusionWindow

Opcional. Exclusões da manutenção automática. A manutenção que não é de emergência não deve ocorrer nessas janelas. Cada exclusão tem um nome exclusivo e pode estar ativa ou expirada. O número máximo de exclusões de manutenção permitidas em um determinado momento é 3.

MaintenanceWindow

Configuração da janela de manutenção

Campos
recurring_window

RecurringTimeWindow

Configuração de uma janela de manutenção recorrente.

NodePool

Um conjunto de nós do Kubernetes em um cluster com configuração e especificação comuns.

Campos
name

string

Obrigatório. O nome do recurso do pool de nós.

create_time

Timestamp

Apenas saída. A hora em que o pool de nós foi criado.

update_time

Timestamp

Apenas saída. A hora em que o pool de nós foi atualizado pela última vez.

labels

map<string, string>

Rótulos associados a este recurso.

node_location

string

Nome da zona do Google Distributed Cloud Edge em que este pool de nós será criado. Por exemplo, us-central1-edge-customer-a.

node_count

int32

Obrigatório. O número de nós no pool.

machine_filter

string

Somente as máquinas que correspondem a esse filtro poderão participar do pool de nós. A linguagem de filtragem aceita strings como "name=" e está documentada com mais detalhes em AIP-160.

local_disk_encryption

LocalDiskEncryption

Opcional. Opções de criptografia de disco local. Este campo é usado apenas ao ativar o suporte a CMEK.

node_version

string

Apenas saída. A versão de lançamento mais antiga entre todos os nós de trabalho.

node_config

NodeConfig

Opcional. Configuração de cada nó no NodePool.

LocalDiskEncryption

Configuração de suporte de CMEK para criptografia de disco local de máquina de borda.

Campos
kms_key

string

Opcional. A CryptoKey do Cloud KMS, por exemplo, projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, que será usada para proteger os discos locais do nó. Se não for especificada, uma chave gerenciada pelo Google será usada.

kms_key_active_version

string

Apenas saída. A CryptoKeyVersion do Cloud KMS atualmente em uso para proteger os discos locais do nó. Aplicável apenas se kms_key estiver definido.

kms_key_state

KmsKeyState

Apenas saída. Disponibilidade da CryptoKey do Cloud KMS. Se não for KEY_AVAILABLE, os nós poderão ficar off-line porque não conseguem acessar os dados locais. Isso pode ser causado por falta de permissões para usar a chave ou se ela estiver desativada ou excluída.

kms_status

Status

Apenas saída. Status de erro retornado pelo Cloud KMS ao usar essa chave. Esse campo só pode ser preenchido se kms_key_state não for KMS_KEY_STATE_KEY_AVAILABLE. Se preenchido, esse campo contém o status de erro informado pelo Cloud KMS.

resource_state

ResourceState

Apenas saída. O estado atual do recurso associado à CMEK.

NodeConfig

Configuração de cada nó no NodePool

Campos
labels

map<string, string>

Opcional. Os rótulos de nó do Kubernetes

node_storage_schema

string

Opcional. Nome do esquema de armazenamento dos nós de trabalho.

node_system_partition_size

SystemPartitionGiBSize

Opcional. Tamanho da partição do sistema para nós de trabalho em GiB.

OIDCProviderConfig

Representa a configuração do provedor OIDC.

Campos
client_id

string

Obrigatório. O ID do cliente do provedor de identidade.

client_secret

string

Opcional. A chave secreta do cliente do provedor de identidade.

issuer_uri

string

Obrigatório. O URI do emissor do provedor de identidade.

scopes

string

Obrigatório. Os escopos do provedor de identidade.

user_claim

string

Opcional. A declaração do usuário do provedor de identidade.

extra_params

string

Opcional. Lista separada por vírgulas de pares de chave-valor que serão codificados por consulta e enviados com a solicitação do endpoint de autenticação.

certificate_authority_data

string

Opcional. Os dados da autoridade certificadora do provedor de identidade.

group_claim

string

Opcional. A declaração de grupo do provedor de identidade.

attribute_mapping

map<string, string>

Opcional. O mapeamento de atributos do provedor de identidade.

OperationMetadata

Metadados de operação de longa duração para métodos da API Edge Container.

Campos
create_time

Timestamp

A hora em que a operação foi criada.

end_time

Timestamp

A hora em que a operação terminou de ser executada.

target

string

Caminho do recurso definido pelo servidor para o destino da operação.

verb

string

O verbo executado pela operação.

status_message

string

Status legível por humanos da operação, caso haja um.

requested_cancellation

bool

Identifica se o usuário solicitou o cancelamento da operação. As operações que foram canceladas têm o valor [Operation.error][] com um google.rpc.Status.code de 1, correspondente a Code.CANCELLED.

api_version

string

Versão da API usada para iniciar a operação.

warnings[]

string

Avisos que não bloqueiam a operação, mas ainda contêm informações relevantes para o usuário final.

status_reason

StatusReason

Status legível por máquina da operação, caso haja um.

public_error

Status

Uma representação de erro voltada ao público, destinada ao consumo do cliente. Esse campo é preenchido com base no erro da operação e é especialmente útil para fornecer detalhes mais completos sobre o erro aos clientes quando o código de erro canônico é INTERNAL e a mensagem de erro principal pode ser limpa.

StatusReason

Indica o motivo do status da operação.

Tipos enumerados
STATUS_REASON_UNSPECIFIED Motivo desconhecido.
UPGRADE_PAUSED O upgrade do cluster está pausado.
RETRYABLE_ERROR A solicitação apresentou um erro, mas é possível tentar novamente.

Cota

Representa a cota para recursos do Edge Container.

Campos
metric

string

Nome da métrica de cota.

limit

double

Limite de cota para essa métrica.

usage

double

Uso atual dessa métrica.

RecurringTimeWindow

Representa uma janela de tempo arbitrária que se repete.

Campos
window

TimeWindow

A janela da primeira recorrência.

recurrence

string

Uma RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) para a recorrência dessa janela. Eles continuam pelo período entre o horário de início e de término.

ResourceState

Representa se o recurso está no estado de bloqueio ou pendente.

Tipos enumerados
RESOURCE_STATE_UNSPECIFIED Valor padrão.
RESOURCE_STATE_LOCK_DOWN O recurso está no estado LOCK DOWN.
RESOURCE_STATE_LOCK_DOWN_PENDING O recurso está com o bloqueio pendente.

Papel

Representa um papel do IAM do GDC correspondente a um papel do K8s na zona.

Campos
gdc_role

string

Obrigatório. O nome do papel do IAM do GDC.

display_name

string

Opcional. O nome de exibição do papel.

state

State

Apenas saída. O estado do papel na zona.

Estado

Estado do papel na zona.

Tipos enumerados
STATE_UNKNOWN O valor padrão. Esse valor será usado se a verificação de estado falhar.
READY O papel está presente na zona.
NOT_READY O papel não está presente na zona.

SAMLProviderConfig

Representa a configuração do provedor SAML.

Campos
entity_id

string

Obrigatório. O ID da entidade do provedor de identidade.

single_sign_on_uri

string

Obrigatório. O URI de logon único do provedor de identidade.

certificate_data[]

string

Opcional. Os dados do certificado do provedor de identidade.

user_attribute

string

Opcional. O atributo de usuário do provedor de identidade.

group_attribute

string

Opcional. O atributo de grupo do provedor de identidade.

attribute_mapping

map<string, string>

Opcional. O mapeamento de atributos do provedor de identidade.

ServerConfig

Configuração do servidor para versões e canais de lançamento compatíveis.

Campos
channels

map<string, ChannelConfig>

Apenas saída. Mapeamento do canal de lançamento para a configuração do canal.

versions[]

Version

Apenas saída. Versões compatíveis, por exemplo: ["1.4.0", "1.5.0"].

default_version

string

Apenas saída. Versão padrão, por exemplo: "1.4.0".

version_rollouts[]

VersionRollout

Apenas saída. Informações de lançamento para a configuração do servidor.

ServiceAccount

Representa o recurso da conta de serviço.

Campos
name

string

Identificador. O nome de recurso canônico da conta de serviço do projeto. Por exemplo, projects/{project}/locations/{location}/serviceAccounts/{service_account}

zone

string

Obrigatório. O ID da zona em que a conta de serviço do projeto precisa ser criada.

create_time

Timestamp

Apenas saída. A hora em que a conta de serviço do projeto foi criada.

update_time

Timestamp

Apenas saída. A hora em que a conta de serviço do projeto foi atualizada pela última vez.

labels

map<string, string>

Opcional. Rótulos associados a este recurso.

state

State

Apenas saída. O estado da conta de serviço.

Estado

O estado da conta de serviço.

Tipos enumerados
STATE_UNSPECIFIED Não especificado.
CREATING A conta de serviço está no estado CREATING.
RUNNING A conta de serviço está no estado RUNNING.
DELETING A conta de serviço está no estado DELETING.
ERROR A conta de serviço está no estado de erro.
REPAIRING A conta de serviço está no estado REPAIRING.

SetIamPolicyRequest

Solicite o proto para definir a política do IAM de um projeto em uma zona.

Campos
name

string

Obrigatório. O nome de recurso canônico da zona. projects/{project}/locations/{location}/zones/{zone}

policy

IamPolicy

Obrigatório. A política do IAM a ser definida.

request_id

string

Opcional. Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

SystemPartitionGiBSize

SystemPartitionGiBSize representa os tamanhos permitidos de partição do sistema em GiB.

Tipos enumerados
SYSTEM_PARTITION_GIB_SIZE_UNSPECIFIED O tamanho da partição do sistema não é especificado pelo usuário. Isso fará com que o tamanho da partição do sistema seja definido como o tamanho especificado no esquema de armazenamento do sistema aplicável a esse nó, que é de 100 GiB.
SYSTEM_PARTITION_GIB_SIZE100 Tamanho da partição do sistema de 100 GiB, que também é o tamanho padrão.
SYSTEM_PARTITION_GIB_SIZE300 Partição do sistema de 300 GiB. Pode ser usado para substituir o padrão de 100 GiB.

TimeWindow

Representa uma janela de tempo arbitrária.

Campos
start_time

Timestamp

O horário em que a janela começa.

end_time

Timestamp

O horário em que a janela termina. O horário de término precisa ser posterior ao horário de início.

UpdateClusterRequest

Atualiza um cluster.

Campos
update_mask

FieldMask

A máscara de campo é usada para especificar os campos a serem substituídos no recurso Cluster pela atualização. Os campos especificados em update_mask são relativos ao recurso, não à solicitação completa. Um campo será substituído se estiver na máscara. Se o usuário não fornecer uma máscara, todos os campos serão substituídos.

cluster

Cluster

O cluster atualizado.

A autorização requer a seguinte permissão do IAM no recurso especificado cluster:

  • edgecontainer.clusters.update
request_id

string

Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

UpdateNodePoolRequest

Atualiza um pool de nós.

Campos
update_mask

FieldMask

A máscara de campo é usada para especificar os campos a serem substituídos no recurso NodePool pela atualização. Os campos especificados em update_mask são relativos ao recurso, não à solicitação completa. Um campo será substituído se estiver na máscara. Se o usuário não fornecer uma máscara, todos os campos serão substituídos.

node_pool

NodePool

O pool de nós atualizado.

A autorização requer a seguinte permissão do IAM no recurso especificado nodePool:

  • edgecontainer.nodePools.update
request_id

string

Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

UpgradeClusterRequest

Faz upgrade de um cluster.

Campos
name

string

Obrigatório. O nome do recurso do cluster.

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • edgecontainer.clusters.upgrade
target_version

string

Obrigatório. A versão para a qual o cluster será atualizado.

schedule

Schedule

A programação do upgrade.

request_id

string

Um identificador exclusivo da solicitação. Restrito a 36 caracteres ASCII. Recomendamos um UUID aleatório. Essa solicitação só será idempotente se request_id for fornecido.

Programação

Representa a programação de quando o cluster será atualizado.

Tipos enumerados
SCHEDULE_UNSPECIFIED Não especificado. O padrão é fazer o upgrade do cluster imediatamente, que é a única opção disponível no momento.
IMMEDIATELY O cluster será atualizado imediatamente após o recebimento da solicitação.

Versão

Versão de um cluster.

Campos
name

string

Apenas saída. Nome da versão, por exemplo: "1.4.0".

VersionRollout

VersionRollout contém as informações de lançamento da versão.

Campos
version

string

Apenas saída. Versão semântica, por exemplo: "1.4.0".

available_zones[]

string

Apenas saída. Lista de zonas em que a versão foi lançada, por exemplo: ["us-central1", "us-west1"].

VpnConnection

Uma conexão VPN .

Campos
name

string

Obrigatório. O nome do recurso da conexão VPN

create_time

Timestamp

Apenas saída. A hora em que a conexão VPN foi criada.

update_time

Timestamp

Apenas saída. A hora em que a conexão VPN foi atualizada pela última vez.

labels

map<string, string>

Rótulos associados a este recurso.

nat_gateway_ip

string

IP do gateway NAT ou endereço IP WAN. Se um cliente tiver vários IPs NAT, ele precisará configurar o NAT para que apenas um IP externo seja mapeado para o cluster do Anthos do GMEC. Esse campo fica vazio se a NAT não for usada.

bgp_routing_mode
(deprecated)

BgpRoutingMode

Modo de roteamento dinâmico da rede VPC, regional ou global.

cluster

string

O nome canônico do cluster ao qual se conectar. Ele está no formato projects/{project}/locations/{location}/clusters/{cluster}.

vpc

string

O ID da rede VPC para conexão.

vpc_project

VpcProject

Opcional. Detalhes do projeto da rede VPC. Obrigatório se a VPC estiver em um projeto diferente do projeto do cluster.

enable_high_availability

bool

Indica se essa conexão VPN tem a alta disponibilidade ativada no lado do cluster. Se ativado, ao criar uma conexão VPN, vamos tentar usar dois IPs flutuantes do ANG.

router

string

Opcional. O nome do Cloud Router da conexão VPN.

details

Details

Apenas saída. Os detalhes da conexão criada.

BgpRoutingMode

Modo de roteamento.

Tipos enumerados
BGP_ROUTING_MODE_UNSPECIFIED Desconhecido.
REGIONAL Modo regional.
GLOBAL Modo global.

Detalhes

Os detalhes da conexão criada.

Campos
state

State

O estado dessa conexão.

error

string

A mensagem de erro. Isso é preenchido apenas quando state=ERROR.

cloud_router

CloudRouter

As informações do Cloud Router.

cloud_vpns[]

CloudVpn

Cada conexão tem vários gateways do Cloud VPN.

CloudRouter

As informações do Cloud Router.

Campos
name

string

O nome do Cloud Router associado.

CloudVpn

As informações do Cloud VPN.

Campos
gateway

string

O nome do gateway do Cloud VPN criado.

Estado

O estado atual da conexão.

Tipos enumerados
STATE_UNSPECIFIED Desconhecido.
STATE_CONNECTED Conectado.
STATE_CONNECTING Ainda conectando.
STATE_ERROR Ocorreu um erro.

VpcProject

Detalhes do projeto da rede VPC.

Campos
project_id

string

O projeto da VPC a ser conectada. Se não for especificado, será o mesmo que o projeto do cluster.

service_account
(deprecated)

string

Opcional. Descontinuado: não use.

ZonalProject

Projeto zonal (correspondente ao projeto do consumidor de nuvem) que é ativado em zonas.

Campos
name

string

Identificador. O nome do recurso do projeto.

create_time

Timestamp

Apenas saída. a hora em que o projeto foi criado.

update_time

Timestamp

Apenas saída. A hora em que o projeto foi atualizado pela última vez.

labels

map<string, string>

Opcional. Rótulos associados a este recurso.

state

State

Apenas saída. O estado do projeto na zona.

Estado

O estado do projeto na zona.

Tipos enumerados
STATE_UNSPECIFIED Não especificado.
STATE_ON O projeto está ativado na zona.
STATE_OFF O projeto está desativado na zona.
STATE_ENABLING O projeto está sendo ativado na zona.
STATE_REPAIRING O projeto está sendo reparado.
STATE_ERROR O projeto está sendo desativado na zona.

ZonalService

Serviço ativado no projeto.

Campos
name

string

Identificador. O nome do recurso do serviço.

service_selector

ServiceSelector

Opcional. O serviço a ser ativado/desativado. É preciso especificar apenas um service_selector ou service_name.

state

State

Apenas saída. O estado do serviço.

create_time

Timestamp

Apenas saída. A hora em que o serviço foi ativado.

update_time

Timestamp

Apenas saída. A hora em que o serviço foi atualizado pela última vez.

labels

map<string, string>

Opcional. Rótulos associados a este recurso.

Campo de união zone_or_cluster. A zona ou o cluster em que o serviço precisa ser ativado/desativado. zone_or_cluster pode ser apenas de um dos tipos a seguir:
zone

string

O ID da zona em que o serviço precisa ser ativado/desativado.

cluster

string

O nome totalmente qualificado do cluster em que o serviço precisa ser ativado/desativado.

service_name

string

Opcional. O nome completo do serviço, por exemplo: alloydb.googleapis.com. Somente um dos campos service_selector ou service_name precisa ser especificado. Ele será usado para ativar/desativar o serviço no projeto.

ServiceSelector

Serviços que podem ser ativados/desativados.

Tipos enumerados
SERVICE_SELECTOR_UNSPECIFIED Não especificado.
ALLOYDB Serviço do AlloyDB, alloydb.googleapis.com.
VMM Serviço de VMM, gdcvmmanager.googleapis.com.
BOOKSTORE Serviço Bookstore, bookstore.googleapis.com.
VERTEX Serviço da Vertex, aiplatform.googleapis.com.
BOOKSTORE_AI Serviço Bookstore.AI, bookstore-ai.googleapis.com.

Estado

O estado do serviço.

Tipos enumerados
STATE_UNSPECIFIED Não especificado.
STATE_ENABLED O serviço está ativado no projeto.
STATE_DISABLED O serviço está desativado no projeto.
STATE_ENABLING O serviço está sendo ativado no projeto.
STATE_DISABLING O serviço está sendo desativado no projeto.
STATE_REPAIRING O serviço está sendo reparado.
STATE_ERROR O serviço está no estado de erro.

Zona

Representa uma zona.

Campos
name

string

Identificador. O nome canônico do recurso da zona. Por exemplo, organizations/{organization}/locations/{location}/zones/{zone}

create_time

Timestamp

Apenas saída. A hora em que a zona foi criada.

labels

map<string, string>

Opcional. Rótulos associados a este recurso.

certificate_authorities[]

string

Apenas saída. O certificado de CA da Web para a zona.

dns_servers[]

DNSServer

Apenas saída. Os servidores DNS da zona.

state

State

Apenas saída. O estado da zona.

DNSServer

Representa um servidor DNS para a zona.

Campos
ip_address

string

Apenas saída. O endereço IP do servidor DNS.

tld

string

Apenas saída. O domínio de nível superior do servidor DNS.

Estado

O estado da zona.

Tipos enumerados
STATE_UNSPECIFIED Não especificado.
STATE_RUNNING A zona está no estado RUNNING.
STATE_ERROR A zona está no estado de erro.
STATE_CREATING A zona está no estado CRIANDO.
STATE_REPAIRING A zona está no estado REPAIRING.

ZoneMetadata

Uma zona do Google Distributed Cloud Edge em que as máquinas de borda estão localizadas.

Campos
quota[]

Quota

Cota para recursos nessa zona.

rack_types

map<string, RackType>

O mapa é codificado pelo nome do rack e tem o valor de RackType.

config_data

ConfigData

Dados de configuração da zona.

RackType

Tipo de rack.

Tipos enumerados
RACK_TYPE_UNSPECIFIED Tipo de rack não especificado. O rack único também pertence a esse tipo.
BASE Tipo de rack base, um par de dois racks Config-1 modificados que contêm switches de agregação.
EXPANSION Tipo de rack de expansão, também conhecido como rack independente, adicionado pelos clientes sob demanda.