Package google.cloud.gkehub.v1alpha2

Índice

GkeHub

O serviço Hub do GKE lida com o registro de muitos clusters do Kubernetes no Google Cloud, representado pelo recurso Membership.

No momento, o GKE Hub está disponível na região global e em todas as regiões em https://cloud.google.com/compute/docs/regions-zones. O recurso está disponível apenas na região global, enquanto a assinatura é uma região global e todas as regiões.

O gerenciamento de assinaturas pode não ser trivial: quando possível, ao trabalhar com os recursos da assinatura, recomendamos usar uma das ferramentas ou bibliotecas de cliente fornecidas pelo Google.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Operation)

Cria uma nova assinatura.

No momento, isso só é compatível com clusters do GKE no Google Cloud. Para registrar outros clusters, siga as instruções em https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Operation)

Remove uma assinatura.

No momento, isso só é compatível com clusters do GKE no Google Cloud. Para cancelar o registro de outros clusters, siga as instruções em https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/unregistering-a-cluster.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
GenerateConnectManifest

rpc GenerateConnectManifest(GenerateConnectManifestRequest) returns (GenerateConnectManifestResponse)

Gera o manifesto para implantação do agente do GKE Connect.

Esse método é usado internamente pelas bibliotecas fornecidas pelo Google. A maioria dos clientes não precisa chamar esse método diretamente.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

Recebe os detalhes de uma assinatura.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
InitializeHub

rpc InitializeHub(InitializeHubRequest) returns (InitializeHubResponse)

Inicializa o Hub neste projeto, o que inclui a criação da conta de serviço de hub padrão e do pool de Identidade da carga de trabalho do hub. A inicialização é opcional e acontece automaticamente quando a primeira assinatura é criada.

O InitializeHub precisa ser chamado quando a primeira assinatura não pode ser registrada sem esses recursos. Um exemplo comum é conceder à conta de serviço de hub acesso a outro projeto, o que exige que a conta exista primeiro.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

Lista assinaturas em um determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Operation)

Atualiza uma assinatura existente.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

ApplianceCluster

ApplianceCluster contém informações específicas para clusters do dispositivo GDC Edge.

Campos

Autoridade

A autoridade codifica como o Google reconhecerá as identidades desta assinatura. Consulte a documentação de Identidade da carga de trabalho para mais detalhes: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity

Campos
issuer

string

Opcional. Um URI do emissor do JSON Web Token (JWT). issuer precisa começar com https:// e ser um URL válido com menos de 2.000 caracteres.

Se definido, o Google vai permitir que tokens OIDC válidos deste emissor sejam autenticados no workload_identity_pool. A descoberta do OIDC será executada neste URI para validar os tokens do emissor, a menos que oidc_jwks esteja definido.

Limpar issuer desativa a Identidade da carga de trabalho. Não é possível modificar issuer diretamente. Ela precisa ser removida (e a Identidade da carga de trabalho desativada) antes de usar um novo emissor (e reativar a Identidade da carga de trabalho).
oidc_jwks

bytes

Opcional. Chaves de verificação do OIDC para essa assinatura no formato JWKS (RFC 7517).

Quando este campo for definido, a descoberta do OIDC NÃO será realizada no issuer. Em vez disso, os tokens OIDC serão validados usando este campo.
identity_provider

string

Apenas saída. Um provedor de identidade que reflete o issuer no pool de Identidade da carga de trabalho.
workload_identity_pool

string

Apenas saída. O nome do pool de Identidade da carga de trabalho em que issuer será reconhecido.

Há um único pool de Identidade da carga de trabalho por hub compartilhado entre todas as assinaturas que pertencem a esse hub. Para um Hub hospedado em {PROJECT_ID}, o formato do pool de cargas de trabalho é {PROJECT_ID}.hub.id.goog, mas isso está sujeito a mudanças em versões mais recentes dessa API.

ConnectAgentResource

ConnectAgentResource representa um manifesto de recurso do Kubernetes para implantação do agente do Connect.

Campos
type

TypeMeta

Tipo do recurso no Kubernetes.
manifest

string

Manifesto YAML do recurso.

CreateMembershipRequest

Solicite mensagem para o método GkeHub.CreateMembership.

Campos
parent

string

Obrigatório. O pai (projeto e local) em que as assinaturas serão criadas. Especificado no formato projects/*/locations/*.

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

  • gkehub.memberships.create
membership_id

string

Obrigatório. ID escolhido pelo cliente para a assinatura. membership_id precisa ser um rótulo DNS válido e compatível com RFC 1123:

  1. No máximo 63 caracteres
  2. Precisa conter caracteres alfanuméricos minúsculos ou -
  3. Ele precisa começar e terminar com um caractere alfanumérico

Que pode ser expresso como o regex: [a-z0-9]([-a-z0-9]*[a-z0-9])?, com tamanho máximo de 63 caracteres.
resource

Membership

Obrigatório. A assinatura a ser criada.

DeleteMembershipRequest

Solicite uma mensagem para o método GkeHub.DeleteMembership.

Campos
name

string

Obrigatório. O nome do recurso de Assinatura no formato projects/*/locations/*/memberships/*.

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

  • gkehub.memberships.delete
force

bool

Opcional. Se definido como verdadeiro, todos os sub-recursos dessa assinatura também serão excluídos. Caso contrário, a solicitação só vai funcionar se a assinatura não tiver um sub-recurso.

EdgeCluster

O EdgeCluster contém informações específicas dos clusters do Google Edge.

Campos

GenerateConnectManifestRequest

Solicite uma mensagem para o método GkeHub.GenerateConnectManifest. .

Campos
name

string

Obrigatório. O nome do recurso de assinatura ao qual o Agente se associará, no formato projects/*/locations/*/memberships/*.

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

  • gkehub.memberships.generateConnectManifest
namespace

string

Opcional. Namespace para recursos do agente do GKE Connect. O valor padrão é gke-connect.

O agente do Connect é autorizado automaticamente quando executado no namespace padrão. Caso contrário, a autorização explícita precisa ser concedida com uma vinculação adicional do IAM.
proxy

bytes

Opcional. URI de um proxy se a conectividade do agente com gkeconnect.googleapis.com exigir o uso de um proxy. O formato precisa estar no formato http(s)://{proxy_address}, dependendo do protocolo HTTP/HTTPS aceito pelo proxy. Isso vai direcionar o tráfego de saída do agente de conexão por um proxy HTTP(S).
version

string

Opcional. A versão do agente do Connect a ser usada. O padrão é a versão mais atual.
is_upgrade

bool

Opcional. Se verdadeiro, gera os recursos apenas para upgrade. Alguns recursos gerados apenas para instalação (por exemplo, secrets) serão excluídos.
registry

string

Opcional. O registro em que a imagem do agente do Connect vai ser buscada. O padrão é gcr.io/gkeconnect.
image_pull_secret_content

bytes

Opcional. O conteúdo do secret de pull da imagem para o registro, se não for público.

GenerateConnectManifestResponse

GenerateConnectManifestResponse contém informações do manifesto para instalar/fazer upgrade de um agente do Connect.

Campos
manifest[]

ConnectAgentResource

A lista ordenada de recursos do Kubernetes que precisam ser aplicados ao cluster para instalação/upgrade do agente do GKE Connect.

GetMembershipRequest

Solicite uma mensagem para o método GkeHub.GetMembership.

Campos
name

string

Obrigatório. O nome do recurso de Assinatura no formato projects/*/locations/*/memberships/*.

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

  • gkehub.memberships.get

GkeCluster

O GkeCluster contém informações específicas para os clusters do GKE.

Campos
cluster_missing

bool

Apenas saída. Se cluster_missing estiver definido, ele vai indicar que o cluster do GKE não existe mais no plano de controle do GKE.

InitializeHubRequest

Mensagem de solicitação para o método InitializeHub.

Campos
project

string

Obrigatório. O hub a ser inicializado, no formato projects/*/locations/*/memberships/*.

InitializeHubResponse

Mensagem de resposta para o método InitializeHub.

Campos
service_identity

string

Nome da identidade do serviço padrão do Hub, no formato:

service-<project-number>@gcp-sa-gkehub.iam.gserviceaccount.com

A conta de serviço tem roles/gkehub.serviceAgent no projeto Hub.
workload_identity_pool

string

O pool de Identidade da carga de trabalho usado para clusters ativados por Identidade da carga de trabalho registrados neste hub. Formato: <project-id>.hub.id.goog

KubernetesMetadata

O KubernetesMetadata fornece metadados informativos para assinaturas criadas com endpoints do Kubernetes (atualmente, eles são equivalentes aos clusters do Kubernetes).

Campos
kubernetes_api_server_version

string

Apenas saída. String da versão do servidor da API Kubernetes, conforme informado por "/version".
node_provider_id

string

Apenas saída. O providerID do nó, conforme informado pelo primeiro nó na lista de nós no endpoint do Kubernetes. Nas plataformas do Kubernetes que oferecem suporte a clusters sem nó (como GKE-on-GCP), o node_count será zero, e o node_provider_id estará vazio.
node_count

int32

Apenas saída. Contagem de nós conforme relatado pelos recursos de nós do Kubernetes.
vcpu_count

int32

Apenas saída. Contagem de vCPUs conforme relatado pelos recursos de nós do Kubernetes.
memory_mb

int32

Apenas saída. A capacidade total de memória, conforme relatado pela soma de todos os recursos dos nós do Kubernetes, definida em MB.
update_time

Timestamp

Apenas saída. A hora em que esses detalhes foram atualizados pela última vez. Esse update_time é diferente do update_time no nível da assinatura, já que os EndpointDetails são atualizados internamente para consumidores da API.

KubernetesResource

KubernetesResource contém os manifestos YAML e a configuração dos recursos de assinatura do Kubernetes no cluster. Depois de CreateMembership ou UpdateMembership, esses recursos devem ser reaplicados no cluster.

Campos
membership_cr_manifest

string

Apenas entrada. A representação YAML da resposta automática de assinatura. Esse campo é ignorado para clusters do GKE em que o Hub pode ler a resposta automática diretamente.

Os autores da chamada precisam fornecer a resposta automática que está presente no cluster durante a criação ou atualização ou deixar este campo em branco se não houver nenhum. O manifesto da resposta automática é usado para validar se o cluster não foi registrado em outra assinatura.
membership_resources[]

ResourceManifest

Apenas saída. Outros recursos do Kubernetes que precisam ser aplicados ao cluster após a criação da assinatura e depois de cada atualização.

Esse campo só é preenchido na assinatura retornada de uma operação de longa duração bem-sucedida de CreateMembership ou UpdateMembership. Ele não é preenchido durante as solicitações GetMembership ou ListMemberships normais. Para receber o manifesto do recurso após o registro inicial, o autor da chamada precisa fazer uma chamada UpdateMembership com uma máscara de campo vazia.
connect_resources[]

ResourceManifest

Apenas saída. Os recursos do Kubernetes para instalar o agente do GKE Connect.

Esse campo só é preenchido na assinatura retornada de uma operação de longa duração bem-sucedida de CreateMembership ou UpdateMembership. Ele não é preenchido durante as solicitações GetMembership ou ListMemberships normais. Para receber o manifesto do recurso após o registro inicial, o autor da chamada precisa fazer uma chamada UpdateMembership com uma máscara de campo vazia.
resource_options

ResourceOptions

Opcional. Opções para geração de recursos do Kubernetes.

ListMembershipsRequest

Solicite uma mensagem para o método GkeHub.ListMemberships.

Campos
parent

string

Obrigatório. O pai (projeto e local) em que as assinaturas serão listadas. Especificado no formato projects/*/locations/*. projects/*/locations/- lista assinaturas em todas as regiões.

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

  • gkehub.memberships.list
page_size

int32

Opcional. Ao solicitar uma "página" de recursos, page_size especifica o número de recursos a serem retornados. Se não for especificado ou definido como 0, todos os recursos serão retornados.
page_token

string

Opcional. Token retornado pela chamada anterior para ListMemberships, que especifica a posição na lista de onde continuar listando os recursos.
filter

string

Opcional. Lista as assinaturas que correspondem à expressão de filtro, seguindo a sintaxe descrita em https://google.aip.dev/160.

Por exemplo:

  • O nome é bar no projeto foo-proj e o local global:
  name = "projects/foo-proj/locations/global/membership/bar"
  • Assinaturas com um rótulo chamado foo:
  labels.foo:*
  • Assinaturas com um rótulo chamado foo, cujo valor é bar:
  labels.foo = bar
  • Assinaturas no estado CRIANDO:
  state = CREATING
order_by

string

Opcional. Um ou mais campos para comparar e usar para ordenar a saída. Acesse https://google.aip.dev/132#ordering.

ListMembershipsResponse

Mensagem de resposta para o método GkeHub.ListMemberships.

Campos
resources[]

Membership

Lista de assinaturas correspondentes.
next_page_token

string

Um token para solicitar a próxima página de recursos do método ListMemberships. O valor de uma string vazia significa que não há mais recursos a serem retornados.
unreachable[]

string

Lista de locais que não puderam ser alcançados ao buscar esta lista.

Participação

A assinatura contém informações sobre um cluster de membro.

Campos
name

string

Apenas saída. O nome completo e exclusivo desse recurso de assinatura no formato projects/*/locations/*/memberships/{membership_id}, definido durante a criação.

membership_id precisa ser um rótulo DNS válido e compatível com RFC 1123:

  1. No máximo 63 caracteres
  2. Precisa conter caracteres alfanuméricos minúsculos ou -
  3. Ele precisa começar e terminar com um caractere alfanumérico

Que pode ser expresso como o regex: [a-z0-9]([-a-z0-9]*[a-z0-9])?, com tamanho máximo de 63 caracteres.
labels

map<string, string>

Opcional. Rótulos para esta assinatura.
description

string

Apenas saída. Descrição da assinatura, limitada a 63 caracteres. Precisa corresponder ao regex: [a-zA-Z0-9][a-zA-Z0-9_\-\.\ ]*

Esse campo está presente para fins legados.
state

MembershipState

Apenas saída. Estado do recurso Membership.
create_time

Timestamp

Apenas saída. Quando a assinatura foi criada.
update_time

Timestamp

Apenas saída. Quando a assinatura foi atualizada pela última vez.
delete_time

Timestamp

Apenas saída. Quando a assinatura foi excluída.
external_id

string

Opcional. Um ID gerado externamente e gerenciado para esta assinatura. Esse ID pode ser modificado após a criação, mas isso não é recomendado. Para clusters do GKE, o external_id é gerenciado pela API Hub, e as atualizações serão ignoradas.

O ID precisa corresponder ao regex: [a-zA-Z0-9][a-zA-Z0-9_\-\.]*

Se essa assinatura representar um cluster do Kubernetes, esse valor precisará ser definido como o UID do objeto de namespace kube-system.
authority

Authority

Opcional. Como identificar cargas de trabalho nesta assinatura. Consulte a documentação sobre a Identidade da carga de trabalho para mais detalhes: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity
last_connection_time

Timestamp

Apenas saída. Para clusters que usam o Connect, o carimbo de data/hora da conexão mais recente estabelecida com o Google Cloud. Esse horário é atualizado em intervalos de vários minutos, não continuamente. Para clusters que não usam o GKE Connect ou que nunca se conectaram corretamente, este campo não será definido.
unique_id

string

Apenas saída. UUID gerado pelo Google para este recurso. Isso é exclusivo em todos os recursos de assinatura. Se um recurso de assinatura for excluído e outro recurso com o mesmo nome for criado, ele receberá um unique_id diferente.
infrastructure_type

Membership.InfrastructureType

Opcional. O tipo de infraestrutura em que a assinatura está sendo executada.
monitoring_config

MonitoringConfig

Opcional. As informações de configuração de monitoramento para esta assinatura.
Campo de união type. O tipo de recurso representado por esta type de assinatura só pode ser um dos seguintes:
endpoint

MembershipEndpoint

Opcional. Informações do endpoint para alcançar este membro.

InfrastructureType

Especifica o tipo de infraestrutura de uma assinatura. O tipo de infraestrutura é usado pelo Hub para controlar o comportamento específico da infraestrutura, incluindo preços.

Cada distribuição do GKE (on-GCP, no local, on-X etc.) definirá esse campo automaticamente, mas os clientes de clusters anexados precisam especificar um tipo durante o registro.

Enums
INFRASTRUCTURE_TYPE_UNSPECIFIED Nenhum tipo foi especificado. Algumas funcionalidades do Hub podem exigir a especificação de um tipo e não são compatíveis com assinaturas com esse valor.
ON_PREM Infraestrutura privada que pertence ou é operada pelo cliente. Isso inclui distribuições do GKE como GKE-OnPrem e GKE-OnBareMetal.
MULTI_CLOUD Infraestrutura em nuvem pública.

MembershipEndpoint

O MembershipEndpoint contém as informações necessárias para entrar em contato com uma API Kubernetes, um endpoint e quaisquer metadados adicionais do Kubernetes.

Campos
kubernetes_metadata

KubernetesMetadata

Apenas saída. Metadados úteis específicos do Kubernetes.
kubernetes_resource

KubernetesResource

Opcional. Os recursos do Kubernetes no cluster que precisam ser aplicados a um cluster registrado corretamente, no estado estável. Estes recursos:

  • Verifique se o cluster está registrado exclusivamente para uma e apenas uma assinatura do hub.
  • Propagar informações do pool de carga de trabalho disponíveis no campo Autoridade de assinatura.
  • Garanta a configuração inicial adequada dos recursos padrão do Hub.
Campo de união type. Informações do cluster registrado. type pode ser apenas de um dos tipos a seguir:
gke_cluster

GkeCluster

Opcional. Informações específicas de um cluster do GKE no GCP.
on_prem_cluster

OnPremCluster

Opcional. Informações específicas de um cluster do GKE On-Prem. Um cluster de usuário local que não tem resourceLink não tem permissão para usar este campo. Em vez disso, ele deve ter um "type" nulo.
multi_cloud_cluster

MultiCloudCluster

Opcional. Informações específicas de um cluster GKE Multi-cloud.
edge_cluster

EdgeCluster

Opcional. Informações específicas de um cluster do Google Edge.
appliance_cluster

ApplianceCluster

Opcional. Informações específicas de um cluster do GDC Edge Appliance.

MembershipState

MembershipState descreve o estado de um recurso Membership.

Campos
code

MembershipState.Code

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

Programar

O código descreve o estado de um recurso de assinatura.

Enums
CODE_UNSPECIFIED O código não foi definido.
CREATING O cluster está sendo registrado.
READY O cluster está registrado.
DELETING O registro do cluster está sendo cancelado.
UPDATING A assinatura está sendo atualizada.
SERVICE_UPDATING A assinatura está sendo atualizada pelo serviço de hub.

MonitoringConfig

O MonitoringConfig informa aos aplicativos/serviços/interfaces baseados em frota como as métricas do cluster subjacente são informadas aos serviços do Cloud Monitoring. Ele pode ser definido de vazio para não vazio, mas não pode ser mudado diretamente para evitar a quebra acidental da consistência das métricas.

Campos
project_id

string

Opcional. Projeto usado para informar métricas
location

string

Opcional. Local usado para relatar métricas
cluster

string

Opcional. Nome do cluster usado para relatar métricas. Para o Anthos nos clusters VMWare/Baremetal/MultiCloud, ele estaria no formato {cluster_type}/{cluster_name}, por exemplo, "awsClusters/cluster_1".
kubernetes_metrics_prefix

string

Opcional. As métricas do sistema do Kubernetes, se disponíveis, são gravadas nesse prefixo. O padrão é kubernetes.io para GKE e kubernetes.io/anthos para Anthos em algum momento. Observação: o Anthos MultiCloud terá o prefixo kubernetes.io hoje, mas a migração vai ficar em kubernetes.io/anthos.
cluster_hash

string

Opcional. Para clusters do GKE e Multicloud, esse é o UUID do recurso do cluster. Para clusters VMWare e baremetal, esse é o UID do kube-system.

MultiCloudCluster

O MultiCloudCluster contém informações específicas dos clusters GKE Multi-cloud.

Campos
cluster_missing

bool

Apenas saída. Se cluster_missing estiver definido, ele vai indicar que o recurso API(gkemulticloud.googleapis.com) para o cluster GKE Multi-cloud não existe mais.

OnPremCluster

O OnPremCluster contém informações específicas dos clusters do GKE On-Prem.

Campos
cluster_missing

bool

Apenas saída. Se cluster_missing estiver definido, ele vai indicar que o recurso API(gkeonprem.googleapis.com) para esse cluster do GKE On-Prem não existe mais.
admin_cluster

bool

Imutável. Se o cluster é de administrador.
cluster_type

OnPremCluster.ClusterType

Imutável. O tipo do cluster local.

ClusterType

ClusterType descreve o tipo do cluster no local.

Enums
CLUSTERTYPE_UNSPECIFIED O ClusterType não está definido.
BOOTSTRAP O ClusterType é um cluster de inicialização.
HYBRID O ClusterType é um cluster híbrido baremetal.
STANDALONE O ClusterType é um cluster independente baremetal.
USER O ClusterType é um cluster de usuário.

OperationMetadata

Representa os metadados da operação de longa duração.

Campos
create_time

Timestamp

Somente saída: a hora em que a operação foi criada.
end_time

Timestamp

Somente saída: a hora em que a operação terminou de ser executada.
target

string

Apenas saída. Caminho do recurso definido pelo servidor para o destino da operação.
verb

string

Apenas saída. Nome do verbo executado pela operação.
status_detail

string

Apenas saída. Status legível da operação, caso haja um.
cancel_requested

bool

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

string

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

ResourceManifest

ResourceManifest representa um único recurso do Kubernetes a ser aplicado ao cluster.

Campos
manifest

string

Manifesto YAML do recurso.
cluster_scoped

bool

Indica se o recurso fornecido no manifesto é cluster_scoped. Se não definido, o manifesto será considerado com escopo para o namespace.

Esse campo é usado para o mapeamento REST ao aplicar o recurso em um cluster.

ResourceOptions

ResourceOptions representam opções para geração de recursos do Kubernetes.

Campos
connect_version

string

Opcional. A versão do agente do Connect a ser usada em connect_resources. O padrão é a versão mais recente do GKE Connect. A versão precisa ter suporte atualmente. As versões obsoletas serão rejeitadas.
v1beta1_crd

bool

Opcional. Uso de apiextensions/v1beta1 em vez de apiextensions/v1 para recursos CustomResourceDefinition. Esta opção deve ser definida para clusters com versões do apiserver do Kubernetes anteriores à 1.16.
k8s_version

string

Opcional. Versão principal do cluster do Kubernetes. Usado apenas para determinar qual versão usar para os recursos CustomResourceDefinition, apiextensions/v1beta1 ou apiextensions/v1.

TypeMeta

TypeMeta é a informação de tipo necessária para a desmarcação de conteúdo dos recursos do Kubernetes no manifesto.

Campos
kind

string

Tipo do recurso (por exemplo, implantação).
api_version

string

APIVersion do recurso (por exemplo, v1).

UpdateMembershipRequest

Solicite uma mensagem para o método GkeHub.UpdateMembership.

Campos
name

string

Obrigatório. O nome do recurso de Assinatura no formato projects/*/locations/*/memberships/*.

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

  • gkehub.memberships.update
update_mask

FieldMask

Obrigatório. Máscara de campos para atualizar.
resource

Membership

Obrigatório. Somente os campos especificados em update_mask são atualizados. Se você especificar um campo em update_mask, mas não especificar o valor dele aqui, esse campo será excluído. Se você estiver atualizando um campo de mapa, defina o valor de uma chave como "null" ou uma string vazia para excluir a chave do mapa. Não é possível atualizar o valor de uma chave para uma string vazia. Se você especificar a update_mask como um caminho especial "*", substituirá totalmente todos os campos modificáveis pelo usuário para corresponder a resource.