Índice
GkeHubMembershipService(interfaz)ApplianceCluster(mensaje)Authority(mensaje)ConnectAgent(mensaje)ConnectAgentResource(mensaje)CreateMembershipRequest(mensaje)DeleteMembershipRequest(mensaje)EdgeCluster(mensaje)GenerateConnectManifestRequest(mensaje)GenerateConnectManifestResponse(mensaje)GenerateExclusivityManifestRequest(mensaje)GenerateExclusivityManifestResponse(mensaje)GetMembershipRequest(mensaje)GkeCluster(mensaje)KubernetesMetadata(mensaje)KubernetesResource(mensaje)ListMembershipsRequest(mensaje)ListMembershipsResponse(mensaje)Membership(mensaje)Membership.InfrastructureType(enum)MembershipEndpoint(mensaje)MembershipState(mensaje)MembershipState.Code(enum)MonitoringConfig(mensaje)MultiCloudCluster(mensaje)OnPremCluster(mensaje)OnPremCluster.ClusterType(enum)OperationMetadata(mensaje)ResourceManifest(mensaje)ResourceOptions(mensaje)TypeMeta(mensaje)UpdateMembershipRequest(mensaje)ValidateExclusivityRequest(mensaje)ValidateExclusivityResponse(mensaje)
GkeHubMembershipService
El MembershipService de GKE Hub controla el registro de muchos clústeres de Kubernetes en Google Cloud, representados con el recurso Membership.
En la actualidad, GKE Hub está disponible en la región global y en todas las regiones en https://cloud.google.com/compute/docs/regions-zones. La función solo está disponible en la región global mientras la membresía es región global y todas las regiones.
Puede que la administración de membresía no sea trivial: se recomienda usar una de las bibliotecas cliente o herramientas proporcionadas por Google siempre que sea posible cuando se trabaja con recursos de la membresía.
| CreateMembership |
|---|
|
Crea un recurso Membership nuevo. Por el momento, esto solo es compatible con los clústeres de GKE en Google Cloud. Para registrar otros clústeres, sigue las instrucciones en https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster.
|
| DeleteMembership |
|---|
|
Quita un recurso Membership. Por el momento, esto solo es compatible con los clústeres de GKE en Google Cloud. Para cancelar el registro de otros clústeres, sigue las instrucciones en https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/unregistering-a-cluster.
|
| GenerateConnectManifest |
|---|
|
Genera el manifiesto para la implementación del agente de conexión de GKE. Las bibliotecas proporcionadas por Google usan este método de forma interna. La mayoría de los clientes no deberían necesitar llamar a este método directamente.
|
| GenerateExclusivityManifest |
|---|
|
GenerateExclusivityManifest genera los manifiestos para actualizar los artefactos de exclusividad en el clúster, si es necesario. Los artefactos de exclusión incluyen la definición de recurso personalizado (CRD) de la membresía y el recurso personalizado (CR) de la membresía singleton. Junto con ValidateExclusivity, los artefactos de exclusividad garantizan que un clúster de Kubernetes solo se registre en un solo GKE Hub. La CRD de membresía tiene una versión y es posible que se requiera conversión cuando el servidor de la API de GKE Hub comienza a entregar una versión más reciente del CRD y el CR correspondiente. La respuesta será la CRD y la CR convertidas si hay diferencias entre las versiones.
|
| GetMembership |
|---|
|
Obtiene los detalles de un recurso Membership.
|
| ListMemberships |
|---|
|
Enumera recursos Membership en una ubicación y un proyecto determinados.
|
| UpdateMembership |
|---|
|
Actualiza una membresía existente.
|
| ValidateExclusivity |
|---|
|
ValidExclusivity valida el estado de exclusividad en el clúster. La validación no depende de un recurso de membresía de Hub existente.
|
ApplianceCluster
ApplianceCluster contiene información específica de los clústeres de dispositivos perimetrales de GDC.
| Campos | |
|---|---|
resource_link |
Inmutable. Vínculo propio del recurso de GCP para el clúster de Appliance. Por ejemplo: //transferappliance.googleapis.com/projects/my-project/locations/us-west1-a/appliances/my-appliance |
Autoridad
La autoridad codifica la forma en la que Google reconocerá las identidades de este recurso Membership. Consulta la documentación de Workload Identity para obtener más detalles: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity
| Campos | |
|---|---|
issuer |
Opcional. Un URI de la entidad emisora de un token web JSON (JWT). Si se configura, Google permitirá que los tokens de OIDC válidos de esta entidad emisora se autentiquen dentro del grupo de identidades para cargas de trabajo. Se realizará la detección de OIDC en este URI para validar los tokens de la entidad emisora. Si se borra |
workload_identity_pool |
Solo salida. El nombre del grupo de identidades para cargas de trabajo en el que se reconocerá Hay un solo grupo de identidades para cargas de trabajo por Hub que se comparte entre todos los recursos Membership que pertenecen a ese concentrador. Para un concentrador alojado en {PROJECT_ID}, el formato del grupo de cargas de trabajo es |
identity_provider |
Solo salida. Un proveedor de identidad que refleja el |
oidc_jwks |
Opcional. Claves de verificación de OIDC para este recurso Membership en formato JWKS (RFC 7517). Cuando se configura este campo, el descubrimiento de OIDC NO se realizará en |
ConnectAgent
La información requerida de los usuarios finales para usar GKE Connect.
| Campos | |
|---|---|
name |
No establecer. |
proxy |
Opcional. Es el URI de un proxy si la conectividad del agente a gkeconnect.googleapis.com requiere el uso de un proxy. El formato debe tener el formato |
namespace |
Opcional. Espacio de nombres para los recursos del agente de GKE Connect. La configuración predeterminada es El agente de Connect se autoriza automáticamente cuando se ejecuta en el espacio de nombres predeterminado. De lo contrario, se debe otorgar la autorización explícita con una vinculación de IAM adicional. |
ConnectAgentResource
ConnectAgentResource representa un manifiesto de recursos de Kubernetes para la implementación del agente Connect.
| Campos | |
|---|---|
type |
Tipo de Kubernetes del recurso. |
manifest |
Manifiesto YAML del recurso. |
CreateMembershipRequest
Mensaje de la solicitud para el método GkeHubMembershipService.CreateMembership.
| Campos | |
|---|---|
parent |
Obligatorio. El elemento superior (proyecto y ubicación) en el que se crearán los recursos Membership. Especificado en el formato La autorización requiere el siguiente permiso IAM en el recurso especificado
|
membership_id |
Obligatorio. El ID de cliente que eligió para la membresía.
que se puede expresar como la regex: |
resource |
Obligatorio. La membresía que se creará. |
request_id |
Opcional. Un ID de solicitud para identificar solicitudes. Especifica un ID de solicitud único para que, si debes reintentar la solicitud, el servidor sepa que debe ignorarla si ya se completó. El servidor lo garantizará durante al menos 60 minutos después de la primera solicitud. Por ejemplo, imagina una situación en la que haces una solicitud inicial y se agota el tiempo de espera de la solicitud. Si vuelves a hacer la solicitud con el mismo ID de solicitud, el servidor puede verificar si se recibió la operación original con el mismo ID de solicitud y, de ser así, ignorar la segunda solicitud. Esto evita que los clientes creen compromisos duplicados por accidente. El ID de solicitud debe ser un UUID válido, con la excepción de que no se admite ningún UUID cero (00000000-0000-0000-0000-000000000000). |
DeleteMembershipRequest
Mensaje de solicitud para el método GkeHubMembershipService.DeleteMembership.
| Campos | |
|---|---|
name |
Obligatorio. El nombre del recurso de la membresía en el formato La autorización requiere el siguiente permiso IAM en el recurso especificado
|
request_id |
Opcional. Un ID de solicitud para identificar solicitudes. Especifica un ID de solicitud único para que, si debes reintentar la solicitud, el servidor sepa que debe ignorarla si ya se completó. El servidor lo garantizará durante al menos 60 minutos después de la primera solicitud. Por ejemplo, imagina una situación en la que haces una solicitud inicial y se agota el tiempo de espera de la solicitud. Si vuelves a hacer la solicitud con el mismo ID de solicitud, el servidor puede verificar si se recibió la operación original con el mismo ID de solicitud y, de ser así, ignorar la segunda solicitud. Esto evita que los clientes creen compromisos duplicados por accidente. El ID de solicitud debe ser un UUID válido, con la excepción de que no se admite ningún UUID cero (00000000-0000-0000-0000-000000000000). |
force |
Opcional. Si se establece como verdadero, también se borrará cualquier subrecurso de esta membresía. De lo contrario, la solicitud solo funcionará si la membresía no tiene un subrecurso. |
EdgeCluster
EdgeCluster contiene información específica de los clústeres de Google Edge.
| Campos | |
|---|---|
resource_link |
Inmutable. Vínculo propio del recurso de GCP para el clúster de Edge. Por ejemplo: //edgecontainer.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster |
GenerateConnectManifestRequest
Mensaje de solicitud para el método GkeHubMembershipService.GenerateConnectManifest.
| Campos | |
|---|---|
name |
Obligatorio. El nombre del recurso de la membresía con el que se asociará el agente, en el formato La autorización requiere el siguiente permiso IAM en el recurso especificado
|
connect_agent |
Opcional. El agente de conexión para el que se generará el manifiesto. |
version |
Opcional. La versión del agente de Connect que se usará. El valor predeterminado es la versión más reciente. |
is_upgrade |
Opcional. Si es verdadero, genera los recursos solo para la actualización. Se excluirán algunos recursos generados solo para la instalación (p. ej., los secretos). |
registry |
Opcional. El registro desde el que se recupera la imagen del agente de conexión. La configuración predeterminada es gcr.io/gkeconnect. |
image_pull_secret_content |
Opcional. La imagen extrae contenido del Secret para el registro, si no es público. |
GenerateConnectManifestResponse
GenerateConnectManifestResponse contiene información del manifiesto para instalar o actualizar un agente de Connect.
| Campos | |
|---|---|
manifest[] |
La lista ordenada de recursos de Kubernetes que se deben aplicar al clúster para la instalación o actualización del agente de GKE Connect. |
GenerateExclusivityManifestRequest
La solicitud para generar los manifiestos de artefactos de exclusividad.
| Campos | |
|---|---|
name |
Obligatorio. El nombre del recurso de la membresía en el formato La autorización requiere el siguiente permiso IAM en el recurso especificado
|
crd_manifest |
Opcional. El manifiesto YAML de la CRD de membresía que recuperó |
cr_manifest |
Opcional. El manifiesto YAML de la CR de membresía que recuperó |
GenerateExclusivityManifestResponse
La respuesta del manifiesto de artefactos de exclusividad para que el cliente los aplique.
| Campos | |
|---|---|
crd_manifest |
El manifiesto YAML de la CRD de membresía que se debe aplicar si hay una versión más reciente de la CRD disponible. Está vacío si no es necesario aplicar actualizaciones. |
cr_manifest |
El manifiesto YAML de la CR de membresía que se debe aplicar si hay una nueva versión del CR disponible. Está vacío si no es necesario aplicar actualizaciones. |
GetMembershipRequest
Mensaje de solicitud para el método GkeHubMembershipService.GetMembership.
| Campos | |
|---|---|
name |
Obligatorio. El nombre del recurso de la membresía en el formato La autorización requiere el siguiente permiso IAM en el recurso especificado
|
GkeCluster
GkeCluster contiene información específica de los clústeres de GKE.
| Campos | |
|---|---|
resource_link |
Inmutable. Vínculo propio del recurso de GCP para el clúster de GKE. Por ejemplo: También se admiten clústeres zonales. |
cluster_missing |
Solo salida. Si se configura cluster_Missing, significa que el clúster de GKE ya no existe en el plano de control de GKE. |
KubernetesMetadata
KubernetesMetadata proporciona metadatos informativos para los recursos de Membership que representan los clústeres de Kubernetes.
| Campos | |
|---|---|
kubernetes_api_server_version |
Solo salida. Cadena de la versión del servidor de la API de Kubernetes que informa '/version'. |
node_provider_id |
Solo salida. ProviderID del nodo informado por el primer nodo de la lista de nodos en el extremo de Kubernetes. En las plataformas de Kubernetes que admiten clústeres de cero nodos (como GKE en GCP), el node_count será cero y el node_provider_id estará vacío. |
node_count |
Solo salida. Recuento de nodos que informan los recursos de nodos de Kubernetes. |
vcpu_count |
Solo salida. Recuento de CPU virtuales que informan los recursos de nodos de Kubernetes. |
memory_mb |
Solo salida. La capacidad de memoria total informada por la suma de todos los recursos de nodos de Kubernetes, definida en MB. |
update_time |
Solo salida. La hora a la que se actualizaron estos detalles por última vez. Este update_time es diferente del valor de update_time a nivel de la membresía, ya que EndpointDetails se actualiza internamente para los consumidores de API. |
KubernetesResource
KubernetesResource contiene los manifiestos YAML y la configuración de los recursos de Kubernetes de membresía en el clúster. Después de CreateMembership o UpdateMembership, estos recursos se deben volver a aplicar en el clúster.
| Campos | |
|---|---|
membership_cr_manifest |
Solo entrada. La representación YAML de la CR de membresía. Este campo se ignora para los clústeres de GKE en los que el concentrador puede leer la CR directamente. Los emisores deben proporcionar la CR que se encuentra actualmente en el clúster durante CreateMembership o UpdateMembership, o dejar este campo vacío si no existe ninguno. El manifiesto de CR se usa para validar que el clúster no se haya registrado con otra membresía. |
membership_resources[] |
Solo salida. Recursos adicionales de Kubernetes que se deben aplicar al clúster después de la creación de la membresía y después de cada actualización. Este campo solo se propaga en la membresía que se muestra luego de una operación de larga duración exitosa de CreateMembership o UpdateMembership. No se propaga durante las solicitudes normales de GetMembership o ListMemberships. Para obtener el manifiesto de recursos después del registro inicial, el emisor debe realizar una llamada UpdateMembership con una máscara de campo vacía. |
connect_resources[] |
Solo salida. Los recursos de Kubernetes para instalar el agente de GKE Connect Este campo solo se propaga en la membresía que se muestra luego de una operación de larga duración exitosa de CreateMembership o UpdateMembership. No se propaga durante las solicitudes normales de GetMembership o ListMemberships. Para obtener el manifiesto de recursos después del registro inicial, el emisor debe realizar una llamada UpdateMembership con una máscara de campo vacía. |
resource_options |
Opcional. Opciones para la generación de recursos de Kubernetes. |
ListMembershipsRequest
Mensaje de solicitud para el método GkeHubMembershipService.ListMemberships.
| Campos | |
|---|---|
parent |
Obligatorio. El elemento superior (proyecto y ubicación) en el que se mostrarán las membresías. Especificado en el formato La autorización requiere el siguiente permiso IAM en el recurso especificado
|
page_size |
Opcional. Cuando se solicita una “página” de recursos, |
page_token |
Opcional. Token que se muestra en la llamada anterior a |
filter |
Opcional. Listas que coinciden con la expresión de filtro, según la sintaxis descrita en https://google.aip.dev/160. Ejemplos:
|
order_by |
Opcional. Se comparan y usan uno o más campos para ordenar el resultado. Consulta https://google.aip.dev/132#ordering. |
ListMembershipsResponse
Mensaje de respuesta para el método GkeHubMembershipService.ListMemberships.
| Campos | |
|---|---|
resources[] |
La lista de membresías que coinciden. |
next_page_token |
Un token para solicitar la página siguiente de recursos del método |
unreachable[] |
Lista de ubicaciones a las que no se pudo acceder cuando se recuperaba esta lista. |
Membresía
La membresía contiene información sobre un clúster miembro.
| Campos | |
|---|---|
name |
Solo salida. El nombre completo y único de este recurso de membresía en el formato
que se puede expresar como la regex: |
labels |
Opcional. Etiquetas de GCP para esta membresía. |
description |
Opcional. Descripción de esta membresía, con un límite de 63 caracteres. Debe coincidir con la regex: |
state |
Solo salida. Estado del recurso de la membresía. |
authority |
Opcional. Cómo identificar las cargas de trabajo de esta membresía. Consulta la documentación sobre Workload Identity para obtener más detalles: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity |
create_time |
Solo salida. Cuando se creó Membership. |
update_time |
Solo salida. Cuando se actualizó Membership por última vez. |
delete_time |
Solo salida. Cuándo se borró la membresía. |
external_id |
Opcional. Un ID generado y administrado de forma externa para esta membresía. Este ID se puede modificar después de su creación, pero no se recomienda. En el caso de los clústeres de GKE, la API de Hub administra external_id y se ignorarán las actualizaciones. El ID debe coincidir con la regex: Si esta membresía representa un clúster de Kubernetes, este valor se debe establecer en el UID del objeto de espacio de nombres |
last_connection_time |
Solo salida. Para los clústeres que usan Connect, la marca de tiempo de la conexión más reciente establecida con Google Cloud. Esta hora se actualiza cada varios minutos, no de forma continua. Para los clústeres que no usen GKE Connect o que nunca se hayan conectado de forma correcta, no se configurará este campo. |
unique_id |
Solo salida. UUID generado por Google para este recurso. Es único en todos los recursos de la membresía. Si se borra un recurso de la membresía y se crea otro recurso con el mismo nombre, obtiene un unique_id diferente. |
infrastructure_type |
Opcional. El tipo de infraestructura en el que se ejecuta esta membresía. |
monitoring_config |
Opcional. La información de la configuración de supervisión para esta membresía. |
Campo de unión type. El tipo de recurso representado por esta membresía type puede ser solo uno de los siguientes: |
|
endpoint |
Opcional. Información del extremo para llegar a este miembro. |
InfrastructureType
Especifica el tipo de infraestructura de una membresía. Hub usa el tipo de infraestructura para controlar el comportamiento específico de la infraestructura, incluidos los precios.
Cada distribución de GKE (GCP, local, en X, etc.) configurará este campo automáticamente, pero los clientes de clústeres adjuntos deben especificar un tipo durante el registro.
| Enums | |
|---|---|
INFRASTRUCTURE_TYPE_UNSPECIFIED |
No se especificó ningún tipo. Es posible que algunas funciones de Hub requieran que se especifique un tipo y no admitirán membresías con este valor. |
ON_PREM |
Infraestructura privada administrada por el cliente o propiedad de él. Esto incluye las distribuciones de GKE, como GKE OnPrem y GKE-OnBareMetal. |
MULTI_CLOUD |
Infraestructura de nube pública. |
MembershipEndpoint
MembershipEndpoint contiene información necesaria para comunicarse con una API de Kubernetes, un extremo y cualquier metadato adicional de Kubernetes.
| Campos | |
|---|---|
kubernetes_metadata |
Solo salida. Metadatos útiles específicos de Kubernetes. |
kubernetes_resource |
Opcional. Los recursos de Kubernetes en el clúster que se deben aplicar a un clúster registrado de forma correcta, en estado estable Sobre estos recursos:
|
Campo de unión type. Información del clúster del clúster registrado. type puede ser solo uno de los siguientes: |
|
gke_cluster |
Opcional. Información específica para un clúster de GKE en GCP. |
on_prem_cluster |
Opcional. Información específica para un clúster de GKE On-Prem. Un clúster de usuario local que no tiene resourceLink no puede usar este campo; en su lugar, debe tener un “tipo” nulo. |
multi_cloud_cluster |
Opcional. Información específica para un clúster de GKE Multi-cloud. |
edge_cluster |
Opcional. Información específica sobre un clúster de Google Edge. |
appliance_cluster |
Opcional. Información específica para un clúster de dispositivos perimetrales de GDC. |
MembershipState
Estado del recurso de la membresía.
| Campos | |
|---|---|
code |
Solo salida. El estado actual del recurso de la membresía. |
description |
Hub Service nunca configura este campo. |
update_time |
Hub Service nunca configura este campo. |
Código
El código describe el estado de un recurso de la membresía.
| Enums | |
|---|---|
CODE_UNSPECIFIED |
No se estableció el código. |
CREATING |
El clúster se está registrando. |
READY |
El clúster está registrado. |
DELETING |
Se anuló el registro del clúster. |
UPDATING |
La membresía se está actualizando. |
SERVICE_UPDATING |
El servicio Hub está actualizando la membresía. |
MonitoringConfig
MonitoringConfig informa a las IU, los servicios y las aplicaciones basados en la flota cómo se informan las métricas del clúster subyacente a los servicios de supervisión en la nube. Se puede configurar de vacía a no vacía, pero no se puede mutar directamente para evitar romper la contención de las métricas por accidente.
| Campos | |
|---|---|
project_id |
Opcional. Proyecto usado para informar las métricas |
location |
Opcional. Ubicación que se usa para informar las métricas |
cluster |
Opcional. Nombre del clúster usado para informar las métricas. Para los clústeres de Anthos en VMWare/Baremetal/MultiCloud, tendría el formato {cluster_type}/{cluster_name}, p. ej., "awsClusters/cluster_1". |
kubernetes_metrics_prefix |
Opcional. Las métricas del sistema de Kubernetes, si están disponibles, se escriben en este prefijo. La configuración predeterminada es kubernetes.io para GKE y, finalmente, kubernetes.io/anthos para Anthos. Nota: Anthos MultiCloud tendrá el prefijo kubernetes.io hoy, pero la migración estará en kubernetes.io/anthos. |
cluster_hash |
Opcional. En el caso de los clústeres de GKE y de múltiples nubes, este es el UUID del recurso del clúster. Para los clústeres de VMWare y Baremetal, este es el UID del sistema de Kubernetes. |
MultiCloudCluster
MultiCloudCluster contiene información específica de los clústeres de múltiples nubes de GKE.
| Campos | |
|---|---|
resource_link |
Inmutable. Vínculo propio del recurso de GCP para el clúster de GKE Multi-cloud. Por ejemplo: //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/awsClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/azureClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/attachedClusters/my-cluster |
cluster_missing |
Solo salida. Si cluster_missing está configurado, indica que el recurso de API(gkemulticloud.googleapis.com) para este clúster de GKE Multi-Cloud ya no existe. |
OnPremCluster
On-PremCluster contiene información específica de los clústeres de GKE On-Prem.
| Campos | |
|---|---|
resource_link |
Inmutable. Vínculo propio del recurso de GCP para el clúster de GKE On-Prem. Por ejemplo: //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vmwareClusters/my-cluster //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/bareMetalClusters/my-cluster |
cluster_missing |
Solo salida. Si cluster_Missing está configurado, indica que el recurso de API(gkeonprem.googleapis.com) para este clúster de GKE On-Prem ya no existe. |
admin_cluster |
Inmutable. Si el clúster es de administrador. |
cluster_type |
Inmutable. El tipo de clúster local. |
ClusterType
ClusterType describe el tipo de clúster local.
| Enums | |
|---|---|
CLUSTERTYPE_UNSPECIFIED |
El ClusterType no está configurado. |
BOOTSTRAP |
El ClusterType es un clúster de arranque. |
HYBRID |
El ClusterType es un clúster híbrido de equipos físicos. |
STANDALONE |
ClusterType es un clúster independiente de equipos físicos. |
USER |
El ClusterType es clúster de usuario. |
OperationMetadata
Representa los metadatos de la operación de larga duración.
| Campos | |
|---|---|
create_time |
Solo salida. La hora en que se creó la operación. |
end_time |
Solo salida. La hora a la que finalizó la operación. |
target |
Solo salida. Ruta de recurso definida por el servidor para el destino de la operación. |
verb |
Solo salida. Nombre del verbo que ejecuta la operación. |
status_detail |
Solo salida. Estado legible de la operación, si lo hay. |
cancel_requested |
Solo salida. Identifica si el usuario solicitó la cancelación de la operación. Las operaciones que se cancelaron de forma correcta tienen el valor [Operation.error][] con un |
api_version |
Solo salida. La versión de la API solo se usa para iniciar la operación. |
ResourceManifest
ResourceManifest representa un solo recurso de Kubernetes que se aplicará al clúster.
| Campos | |
|---|---|
manifest |
Manifiesto YAML del recurso. |
cluster_scoped |
Indica si el recurso proporcionado en el manifiesto es Este campo se usa para la asignación de REST cuando se aplica el recurso en un clúster. |
ResourceOptions
ResourceOptions representan opciones para la generación de recursos de Kubernetes.
| Campos | |
|---|---|
connect_version |
Opcional. La versión del agente de Connect que se usará para connect_resources. La configuración predeterminada es la última versión de GKE Connect. La versión debe ser una versión compatible actualmente; se rechazarán las versiones obsoletas. |
v1beta1_crd |
Opcional. Usa |
k8s_version |
Opcional. Versión principal del clúster de Kubernetes. Esto solo se usa con el objetivo de determinar qué versión usar para los recursos CustomResourceDefinition, |
TypeMeta
TypeMeta es la información de tipo necesaria para la deserialización del contenido de recursos de Kubernetes en el manifiesto.
| Campos | |
|---|---|
kind |
Tipo del recurso (p. ej., Deployment) |
api_version |
APIVersion del recurso (p. ej., v1). |
UpdateMembershipRequest
Mensaje de solicitud para el método GkeHubMembershipService.UpdateMembership.
| Campos | |
|---|---|
name |
Obligatorio. El nombre del recurso de la membresía en el formato: La autorización requiere el siguiente permiso IAM en el recurso especificado
|
update_mask |
Obligatorio. Máscara de campos que se actualizarán. Se debe especificar al menos una ruta de campo en esta máscara. |
resource |
Obligatorio. Solo se actualizan los campos especificados en update_mask. Si especificas un campo en update_mask, pero no especificas su valor aquí, ese campo se borrará. Si actualizas un campo de mapa, configura el valor de una clave como una cadena nula o vacía para borrar la clave del mapa. No es posible actualizar el valor de una clave a la cadena vacía. Si especificas update_mask para que sea una ruta especial “*”, se reemplazan por completo todos los campos modificables por el usuario para que coincidan con |
request_id |
Opcional. Un ID de solicitud para identificar solicitudes. Especifica un ID de solicitud único para que, si debes reintentar la solicitud, el servidor sepa que debe ignorarla si ya se completó. El servidor lo garantizará durante al menos 60 minutos después de la primera solicitud. Por ejemplo, imagina una situación en la que haces una solicitud inicial y se agota el tiempo de espera de la solicitud. Si vuelves a hacer la solicitud con el mismo ID de solicitud, el servidor puede verificar si se recibió la operación original con el mismo ID de solicitud y, de ser así, ignorar la segunda solicitud. Esto evita que los clientes creen compromisos duplicados por accidente. El ID de solicitud debe ser un UUID válido, con la excepción de que no se admite ningún UUID cero (00000000-0000-0000-0000-000000000000). |
ValidateExclusivityRequest
La solicitud para validar el estado existente de la CR de membresía en el clúster.
| Campos | |
|---|---|
parent |
Obligatorio. El elemento superior (proyecto y ubicación) en el que se crearán los recursos Membership. Especificado en el formato La autorización requiere el siguiente permiso IAM en el recurso especificado
|
cr_manifest |
Opcional. El YAML de la CR de membresía en el clúster. Está vacío si la CR de membresía no existe. |
intended_membership |
Obligatorio. El nombre de la membresía deseado en |
ValidateExclusivityResponse
La respuesta del estado del resultado de la validación de artefactos de exclusividad.
| Campos | |
|---|---|
status |
El resultado de la validación.
|