Package google.cloud.edgecontainer.v1alpha

Índice

EdgeContainer

La API de EdgeContainer proporciona administración de clústeres de Kubernetes en implementaciones de Google Edge Cloud.

CreateCluster

rpc CreateCluster(CreateClusterRequest) returns (Operation)

Crea un clúster nuevo en un proyecto y una ubicación determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

CreateIdentityProvider

rpc CreateIdentityProvider(CreateIdentityProviderRequest) returns (Operation)

Configura un proveedor de identidad en el clúster de infraestructura.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

CreateNodePool

rpc CreateNodePool(CreateNodePoolRequest) returns (Operation)

Crea un nuevo NodePool en un proyecto y una ubicación determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

CreateServiceAccount

rpc CreateServiceAccount(CreateServiceAccountRequest) returns (Operation)

CreateServiceAccount crea el CR de la cuenta de servicio del proyecto en el espacio de nombres del proyecto en el clúster (clúster de infraestructura para la versión 2 y clúster del usuario para la versión 1).

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

CreateVpnConnection

rpc CreateVpnConnection(CreateVpnConnectionRequest) returns (Operation)

Crea una conexión de VPN nueva en un proyecto y una ubicación determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

DeleteApiKey

rpc DeleteApiKey(DeleteApiKeyRequest) returns (Operation)

DeleteApiKey borra la clave de API de la cuenta de servicio del proyecto determinado.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

DeleteCluster

rpc DeleteCluster(DeleteClusterRequest) returns (Operation)

Borra un solo clúster.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

DeleteIdentityProvider

rpc DeleteIdentityProvider(DeleteIdentityProviderRequest) returns (Operation)

DeleteIdentityProvider quita el proveedor de identidad del clúster de infraestructura.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

DeleteNodePool

rpc DeleteNodePool(DeleteNodePoolRequest) returns (Operation)

Borra un solo NodePool.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

DeleteServiceAccount

rpc DeleteServiceAccount(DeleteServiceAccountRequest) returns (Operation)

DeleteServiceAccount borra el CR de la cuenta de servicio del proyecto en el espacio de nombres del proyecto en el clúster (clúster de infraestructura para la versión 2 y clúster de usuario para la versión 1).

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

DeleteVpnConnection

rpc DeleteVpnConnection(DeleteVpnConnectionRequest) returns (Operation)

Borra una sola conexión de VPN.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

EnableZonalProject

rpc EnableZonalProject(EnableZonalProjectRequest) returns (Operation)

EnableZonalProject habilita el proyecto de consumidor en la zona.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

EnableZonalService

rpc EnableZonalService(EnableZonalServiceRequest) returns (Operation)

EnableZonalService habilita un servicio en una zona.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GenerateAccessToken

rpc GenerateAccessToken(GenerateAccessTokenRequest) returns (GenerateAccessTokenResponse)

Genera un token de acceso para un clúster.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GenerateOfflineCredential

rpc GenerateOfflineCredential(GenerateOfflineCredentialRequest) returns (GenerateOfflineCredentialResponse)

Genera una credencial sin conexión para un clúster.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GenerateServiceAccountKey

rpc GenerateServiceAccountKey(GenerateServiceAccountKeyRequest) returns (GenerateServiceAccountKeyResponse)

GenerateServiceAccountKey genera un par de claves para el recurso de cuenta de servicio determinado.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetApiKey

rpc GetApiKey(GetApiKeyRequest) returns (ApiKey)

Obtiene detalles de una sola ApiKey.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetCluster

rpc GetCluster(GetClusterRequest) returns (Cluster)

Obtiene detalles de un solo clúster.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetIamPolicy

rpc GetIamPolicy(GetIamPolicyRequest) returns (IamPolicy)

GetIamPolicy obtiene las políticas de IAM para un proyecto en el clúster de infraestructura.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetIdentityProvider

rpc GetIdentityProvider(GetIdentityProviderRequest) returns (IdentityProvider)

GetIdentityProvider obtiene los detalles del proveedor de identidad.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetMachine

rpc GetMachine(GetMachineRequest) returns (Machine)

Obtiene detalles de una sola máquina.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetNodePool

rpc GetNodePool(GetNodePoolRequest) returns (NodePool)

Obtiene detalles de un solo NodePool.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetServerConfig

rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig)

Obtiene la configuración del servidor.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetServiceAccount

rpc GetServiceAccount(GetServiceAccountRequest) returns (ServiceAccount)

GetServiceAccount obtiene los detalles de la cuenta de servicio.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetVpnConnection

rpc GetVpnConnection(GetVpnConnectionRequest) returns (VpnConnection)

Obtiene detalles de una sola conexión de VPN.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetZonalProject

rpc GetZonalProject(GetZonalProjectRequest) returns (ZonalProject)

GetZonalProject obtiene el ZonalProject.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetZonalService

rpc GetZonalService(GetZonalServiceRequest) returns (ZonalService)

GetEnabledZonalService obtiene los detalles del servicio habilitado.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

GetZone

rpc GetZone(GetZoneRequest) returns (Zone)

Obtiene detalles de una sola zona en la que está habilitada la organización principal.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ListApiKeys

rpc ListApiKeys(ListApiKeysRequest) returns (ListApiKeysResponse)

Enumera las claves de API en una ubicación y un proyecto determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ListClusters

rpc ListClusters(ListClustersRequest) returns (ListClustersResponse)

Enumera clústeres en una ubicación y un proyecto determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ListIdentityProviders

rpc ListIdentityProviders(ListIdentityProvidersRequest) returns (ListIdentityProvidersResponse)

Enumera los proveedores de identidad que están configurados en el clúster de infraestructura.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ListMachines

rpc ListMachines(ListMachinesRequest) returns (ListMachinesResponse)

Enumera las máquinas en una ubicación y un proyecto determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ListNodePools

rpc ListNodePools(ListNodePoolsRequest) returns (ListNodePoolsResponse)

Enumera NodePools en una ubicación y un proyecto determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ListServiceAccounts

rpc ListServiceAccounts(ListServiceAccountsRequest) returns (ListServiceAccountsResponse)

ListServiceAccounts enumera los detalles de todos los recursos de cuentas de servicio para un proyecto en el clúster (clúster de infraestructura para la versión 2 y clúster de usuarios para la versión 1).

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ListVpnConnections

rpc ListVpnConnections(ListVpnConnectionsRequest) returns (ListVpnConnectionsResponse)

Enumera las conexiones VPN en una ubicación y un proyecto determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ListZonalProjects

rpc ListZonalProjects(ListZonalProjectsRequest) returns (ListZonalProjectsResponse)

Enumera los ZonalProjects en la zona.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ListZonalServices

rpc ListZonalServices(ListZonalServicesRequest) returns (ListZonalServicesResponse)

Enumera los ZonalServices en una ubicación y un proyecto determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ListZones

rpc ListZones(ListZonesRequest) returns (ListZonesResponse)

Enumera las zonas en las que está habilitada la organización principal.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

SetIamPolicy

rpc SetIamPolicy(SetIamPolicyRequest) returns (IamPolicy)

SetIamPolicy establece la política de IAM para un proyecto en el clúster de infraestructura. Anula la política existente con la que se proporciona.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

UpdateCluster

rpc UpdateCluster(UpdateClusterRequest) returns (Operation)

Actualiza los parámetros de un solo clúster.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

UpdateNodePool

rpc UpdateNodePool(UpdateNodePoolRequest) returns (Operation)

Actualiza los parámetros de un solo NodePool.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

UpgradeCluster

rpc UpgradeCluster(UpgradeClusterRequest) returns (Operation)

Actualiza un solo clúster.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ApiKey

Representa el recurso de la clave de API.

Campos
name

string

Es el identificador. Es el nombre canónico del recurso de la clave de API. p.ej., projects/{project}/locations/{location}/apiKeys/{api_key}

service_account_name

string

Obligatorio. Es el nombre canónico del recurso de la cuenta de servicio asociada con la clave de API.

zone

string

Obligatorio. Es el ID de la zona en la que se debe crear la cuenta de servicio del proyecto.

validity

Duration

Es opcional. Solo entrada. Es la duración durante la cual la clave de API es válida.

api_targets[]

ApiTarget

Es opcional. Son los destinos de la API a los que se restringe la clave de API. Si está vacío, se permiten todas las APIs.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a este recurso.

key

string

Solo salida. Es la cadena apikey del estado del CR de APIKey.

expire_time

Timestamp

Solo salida. Se establece según key_generation_time y la duración de la validez.

state

State

Solo salida. Es el estado del CR de la clave de API en el clúster.

reason

string

Solo salida. Es el motivo del estado del CR de APIKey.

create_time

Timestamp

Solo salida. Es la fecha y hora en que se generó la clave de API.

delete_time

Timestamp

Solo salida. Es la fecha y hora en que se borró el recurso de la clave de API.

update_time

Timestamp

Solo salida. Fecha y hora en la que se actualizó el recurso de clave de API por última vez.

ApiTarget

Representa una restricción en la clave de API. El usuario proporciona esta información como entrada.

Campos
service

string

Es opcional. Es el FQDN del servicio (se verifica con req.Host en las llamadas a la API).

methods[]

string

Es opcional. Sigue las reglas de las restricciones de apitarget de GCP y admite comodines. Si está vacío, se permiten todos los métodos.

Estado

Es el estado de la clave de API en el clúster.

Enums
STATE_UNKNOWN Estado desconocido si aún no se ejecutó la conciliación.
ACTIVE La clave está activa y se puede usar para la autenticación.
NOT_ACTIVE La clave no está activa y no se puede usar para la autenticación. Esto puede suceder si la clave venció, si la cuenta de servicio no está activa o si se produjo un error interno.

Autorización

Es la política de RBAC que aplicará y administrará GEC.

Campos
admin_users

ClusterUser

Obligatorio. Usuario al que se le otorgará el rol de administrador de clústeres, lo que le proporcionará acceso completo al clúster. Actualmente, este es un campo único, pero se expandirá para permitir varios administradores en el futuro.

ChannelConfig

Es la configuración de un canal de versiones.

Campos
default_version

string

Solo salida. Versión predeterminada para este canal de versiones, p.ej.: "1.4.0".

Clúster

Un clúster de Kubernetes de Google Distributed Cloud Edge.

Campos
name

string

Obligatorio. Es el nombre del recurso del clúster.

create_time

Timestamp

Solo salida. Es la fecha y hora en que se creó el clúster.

update_time

Timestamp

Solo salida. Fecha y hora en la que se actualizó el clúster por última vez.

labels

map<string, string>

Son las etiquetas asociadas a este recurso.

fleet

Fleet

Obligatorio. Configuración de la flota.

networking

ClusterNetworking

Obligatorio. Configuración de herramientas de redes de todo el clúster.

authorization

Authorization

Obligatorio. Inmutable. Es la política de RBAC que aplicará y administrará GEC.

default_max_pods_per_node

int32

Es opcional. Cantidad máxima predeterminada de Pods por nodo que se usa si no se especifica de forma explícita un valor máximo para un grupo de nodos en este clúster. En tal caso, se usará el valor predeterminado de Kubernetes.

endpoint

string

Solo salida. Es la dirección IP del servidor de la API de Kubernetes.

port

int32

Solo salida. Es el número de puerto del servidor de la API de Kubernetes.

cluster_ca_certificate

string

Solo salida. Es el certificado público de la CA del clúster codificado con PEM.

maintenance_policy

MaintenancePolicy

Es opcional. Es la configuración de la política de mantenimiento de todo el clúster.

control_plane_version

string

Solo salida. Versión de lanzamiento del plano de control

node_version

string

Solo salida. Es la versión de lanzamiento más baja entre todos los nodos trabajadores. Este campo puede estar vacío si el clúster no tiene nodos de trabajador.

control_plane

ControlPlane

Es opcional. Es la configuración del plano de control del clúster.

system_addons_config

SystemAddonsConfig

Es opcional. Es la configuración de los complementos del sistema.

external_load_balancer_ipv4_address_pools[]

string

Es opcional. Son grupos de direcciones IPv4 para el balanceo de cargas externo del plano de datos del clúster.

control_plane_encryption

ControlPlaneEncryption

Es opcional. Son opciones de encriptación de disco del plano de control remoto. Este campo solo se usa cuando se habilita la compatibilidad con CMEK.

status

Status

Solo salida. Es el estado actual del clúster.

maintenance_events[]

MaintenanceEvent

Solo salida. Todos los eventos de mantenimiento programados para el clúster, incluidos los que están en curso, los que se planificaron para el futuro y los que se realizaron en el pasado (hasta 90 días).

target_version

string

Es opcional. Es la versión del clúster de destino. Por ejemplo, “1.5.0”.

release_channel

ReleaseChannel

Es opcional. Es el canal de versiones al que está suscrito un clúster.

survivability_config

SurvivabilityConfig

Es opcional. Configuración de la capacidad de supervivencia del clúster, p. ej., para el caso en que se pierde la conectividad de red Nota: Esto solo se aplica a los clústeres del plano de control local.

external_load_balancer_ipv6_address_pools[]

string

Es opcional. Son grupos de direcciones IPv6 para el balanceo de cargas externo del plano de datos del clúster.

connection_state

ConnectionState

Solo salida. Es el estado de conexión actual del clúster.

external_load_balancer_address_pools[]

ExternalLoadBalancerPool

Es opcional. Son los grupos del balanceador de cargas externo para el clúster.

zone_storage_encryption

ZoneStorageEncryption

Es opcional. Es la configuración de encriptación del almacenamiento de la zona.

container_runtime_config

ContainerRuntimeConfig

Es opcional. Es la configuración del entorno de ejecución del contenedor del clúster.

enable_remote_backup

bool

Es opcional. Si es verdadero, se habilitará la función de copia de seguridad y restablecimiento remotos para este clúster.

enable_cluster_isolation

bool

Es opcional. Indica si el clúster debe estar aislado. go/cluster-isolation-in-gdcc-cluster

google_group_authentication

GoogleGroupAuthenticationConfig

Es opcional. Es la configuración de autenticación del grupo de Google del clúster.

ConnectionState

ConnectionState contiene el estado de conexión actual del clúster a Google.

Campos
state

State

Solo salida. Es el estado de conexión actual.

update_time

Timestamp

Solo salida. Es la fecha y hora en que se cambió el estado de la conexión por última vez.

Estado

Es el estado de la conexión.

Enums
STATE_UNSPECIFIED Estado de conexión desconocido.
DISCONNECTED Actualmente, este clúster está desconectado de Google.
CONNECTED Actualmente, este clúster está conectado a Google.
CONNECTED_AND_SYNCING Actualmente, este clúster está conectado a Google, pero es posible que se haya vuelto a conectar recientemente después de una desconexión. Aún se está sincronizando.

ContainerRuntimeConfig

Es la configuración del entorno de ejecución del contenedor del clúster.

Campos
default_container_runtime

DefaultContainerRuntime

Es opcional. Es el entorno de ejecución del contenedor predeterminado que se configurará en el clúster.

DefaultContainerRuntime

Es la lista de los tiempos de ejecución de contenedores compatibles.

Enums
DEFAULT_CONTAINER_RUNTIME_UNSPECIFIED No se especificó el entorno de ejecución del contenedor.
RUNC Usa runc como el entorno de ejecución del contenedor predeterminado en el clúster.
GVISOR Usa gVisor como el entorno de ejecución del contenedor predeterminado en el clúster.

ControlPlane

Es la configuración del plano de control del clúster.

Campos

Campo de unión config.

config puede ser una de las siguientes opciones:

remote

Remote

Es la configuración del plano de control remoto.

local

Local

Es la configuración del plano de control local.

Advertencia: Los clústeres de plano de control local se deben crear en su propio proyecto. Los clústeres de plano de control local no pueden coexistir en el mismo proyecto con ningún otro tipo de clústeres, incluidos los que no son de GDCE. Mezclar clústeres de GDCE de plano de control local con cualquier otro tipo de clústeres en el mismo proyecto puede provocar la pérdida de datos.

Local

Es la configuración específica para los clústeres con un plano de control alojado de forma local.

Advertencia: Los clústeres de plano de control local se deben crear en su propio proyecto. Los clústeres de plano de control local no pueden coexistir en el mismo proyecto con ningún otro tipo de clústeres, incluidos los que no son de GDCE. Mezclar clústeres de GDCE de plano de control local con cualquier otro tipo de clústeres en el mismo proyecto puede provocar la pérdida de datos.

Campos
node_location

string

Nombre de las zonas de Google Distributed Cloud Edge en las que se creará este grupo de nodos. Por ejemplo: us-central1-edge-customer-a.

node_count

int32

Es la cantidad de nodos que funcionarán como réplicas del plano de control.

machine_filter

string

Solo se permitirá que las máquinas que coincidan con este filtro alojen nodos del plano de control. El lenguaje de filtrado acepta cadenas como "name=" y se documenta aquí: AIP-160.

shared_deployment_policy

SharedDeploymentPolicy

Es la configuración de la política sobre cómo se implementan las aplicaciones del usuario.

control_plane_node_storage_schema

string

Es opcional. Nombre del esquema de almacenamiento de los nodos del plano de control.

control_plane_node_system_partition_size

SystemPartitionGiBSize

Es opcional. Tamaño de la partición del sistema para los nodos del plano de control en GiB.

Remoto

Este tipo no tiene campos.

Es la configuración específica de los clústeres con un plano de control alojado de forma remota.

SharedDeploymentPolicy

Representa la configuración de la política sobre cómo se implementan las aplicaciones del usuario.

Enums
SHARED_DEPLOYMENT_POLICY_UNSPECIFIED Sin especificar.
ALLOWED Las aplicaciones de usuario se pueden implementar tanto en el plano de control como en los nodos trabajadores.
DISALLOWED Las aplicaciones de usuario no se pueden implementar en los nodos del plano de control y solo se pueden implementar en los nodos trabajadores.

ControlPlaneEncryption

Es la configuración de la compatibilidad con la clave de KMS administrada por el cliente para los nodos del plano de control.

Campos
kms_key

string

Es opcional. Es la clave criptográfica de Cloud KMS, p.ej., projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, que se usará para proteger los discos del plano de control. Si no se especifica, se usará una clave administrada por Google.

kms_key_active_version

string

Solo salida. Es la versión de CryptoKey de Cloud KMS que se usa actualmente para proteger los discos del plano de control. Solo se aplica si se configura kms_key.

kms_key_state

KmsKeyState

Solo salida. Disponibilidad de la CryptoKey de Cloud KMS. Si no es KEY_AVAILABLE, es posible que los nodos se desconecten, ya que no pueden acceder a sus datos locales. Esto puede deberse a la falta de permisos para usar la clave o a que la clave está inhabilitada o borrada.

kms_status

Status

Solo salida. Es el estado de error que devuelve Cloud KMS cuando se usa esta clave. Este campo solo se puede completar si kms_key_state no es KMS_KEY_STATE_KEY_AVAILABLE. Si se propaga, este campo contiene el estado de error que informa Cloud KMS.

resource_state

ResourceState

Solo salida. Es el estado actual del recurso asociado con la CMEK.

ExternalLoadBalancerPool

Es un grupo de balanceador de cargas externo con configuración personalizada, como nombre, asignación manual o automática, IPv4 no superpuesta y rango de direcciones IPv6 opcional.

Campos
address_pool

string

Es opcional. Nombre del grupo del balanceador de cargas externo.

ipv4_range[]

string

Obligatorio. Es el rango de direcciones IPv4 que no se superponen del grupo de balanceador de cargas externos.

ipv6_range[]

string

Es opcional. Es el rango de direcciones IPv6 que no se superponen del grupo de balanceador de cargas externos.

avoid_buggy_ips

bool

Es opcional. Si es verdadero, el grupo omite las direcciones IP que terminan en .0 y .255. Algunos hardware de red descartan el tráfico hacia estas direcciones especiales. Su valor predeterminado es falso.

manual_assign

bool

Es opcional. Si es verdadero, las direcciones en este grupo no se asignan automáticamente a los servicios de Kubernetes. Si es verdadero, una dirección IP en este grupo se usa solo cuando un servicio lo especifica de manera explícita. Su valor predeterminado es falso.

GoogleGroupAuthenticationConfig

Es la configuración de autenticación del grupo de Google del clúster. go/gdc-google-group-authentication

Campos
enable

bool

Es opcional. Si es verdadero, el clúster se configurará para usar la autenticación de Google Group.

MaintenanceEvent

Un evento de mantenimiento es una operación que podría causar interrupciones temporales en las cargas de trabajo del clúster, incluidas las actualizaciones del clúster iniciadas por Google o por el usuario, los cambios en la configuración del clúster iniciados por el usuario que requieren el reinicio de los nodos, etcétera.

Campos
uuid

string

Solo salida. Es el UUID del evento de mantenimiento.

target_version

string

Solo salida. Es la versión de destino del clúster.

operation

string

Solo salida. Operación para ejecutar el evento de mantenimiento. Se especifica en el formato projects/*/locations/*/operations/*. Si el evento de mantenimiento se divide en varias operaciones (p.ej., debido a períodos de mantenimiento), se registra la más reciente.

type

Type

Solo salida. Es el tipo de evento de mantenimiento.

schedule

Schedule

Solo salida. Es el programa del evento de mantenimiento.

state

State

Solo salida. Es el estado del evento de mantenimiento.

create_time

Timestamp

Solo salida. Es la fecha y hora en que se creó la solicitud del evento de mantenimiento.

start_time

Timestamp

Solo salida. Es la fecha y hora en que comenzó el evento de mantenimiento.

end_time

Timestamp

Solo salida. Es la fecha y hora en que finalizó el evento de mantenimiento, ya sea que se haya completado correctamente o no. Si el evento de mantenimiento se divide en varios períodos de mantenimiento, end_time solo se actualiza cuando finaliza todo el flujo.

update_time

Timestamp

Solo salida. Es la fecha y hora en que se actualizó el mensaje del evento de mantenimiento.

Programar

Indica cuándo se debe realizar el evento de mantenimiento.

Enums
SCHEDULE_UNSPECIFIED Sin especificar.
IMMEDIATELY Inmediatamente después de recibir la solicitud

Estado

Indica el estado del evento de mantenimiento.

Enums
STATE_UNSPECIFIED Sin especificar.
RECONCILING El evento de mantenimiento está en curso. Es posible que el clúster no se pueda usar.
SUCCEEDED El evento de mantenimiento se completó correctamente.
FAILED El evento de mantenimiento falló.

Tipo

Indica el tipo de evento de mantenimiento.

Enums
TYPE_UNSPECIFIED Sin especificar.
USER_INITIATED_UPGRADE Actualización iniciada por los usuarios.
GOOGLE_DRIVEN_UPGRADE Actualización impulsada por Google.

ReleaseChannel

Es el canal de versiones al que está suscrito un clúster.

Enums
RELEASE_CHANNEL_UNSPECIFIED Canal de versiones sin especificar. De forma predeterminada, se seleccionará el canal REGULAR.
NONE No hay canal de versiones.
REGULAR Canal de versiones regular.

Estado

Indica el estado del clúster.

Enums
STATUS_UNSPECIFIED Estado desconocido.
PROVISIONING El clúster se está creando.
RUNNING El clúster se creó y se puede usar por completo.
DELETING El clúster se está borrando.
ERROR El estado indica que se produjeron algunos errores durante la conciliación o el borrado del clúster.
RECONCILING El clúster está en proceso de actualización de versión, etc.

SurvivabilityConfig

Configuración de la capacidad de supervivencia del clúster, p. ej., para el caso en que se pierde la conectividad de red

Campos
offline_reboot_ttl

Duration

Es opcional. Período que permite que los nodos del clúster se reinicien y funcionen sin conectividad de red a Google. El valor predeterminado 0 significa que no se permite. La cantidad máxima es de 30 días.

SystemAddonsConfig

Es la configuración que los clientes pueden definir para los complementos del sistema de GDCE.

Campos
ingress

Ingress

Es opcional. Es la configuración de Ingress.

vm_service_config

VMServiceConfig

Es opcional. Es la configuración del servicio de VM.

Entrada

Es la configuración del complemento de Ingress que permite a los clientes crear un objeto Ingress para administrar el acceso externo a los servidores de un clúster. El complemento consta de istiod y istio-ingress.

Campos
disabled

bool

Es opcional. Indica si Ingress está inhabilitado.

ipv4_vip

string

Es opcional. Es la VIP de entrada.

VMServiceConfig

VMServiceConfig define la configuración del servicio de VM de GDCE.

Campos
vmm_enabled

bool

Es opcional. Indica si el VMM está habilitado.

ZoneStorageEncryption

Configuración para la compatibilidad con CMEK de Zone Storage

Campos
kms_key

string

Es opcional. La clave de Cloud KMS

kms_key_active_version

string

Solo salida. Es la versión de CryptoKey de Cloud KMS que se usa actualmente para la encriptación o desencriptación.

resource_state

ResourceState

Solo salida. Estado actual del recurso de CMEK

ClusterNetworking

Configuración de herramientas de redes de todo el clúster.

Campos
cluster_ipv4_cidr_blocks[]

string

Obligatorio. A todos los pods del clúster se les asigna una dirección IPv4 RFC1918 de estos bloques. Solo se admite un bloque. No se puede cambiar este campo después de crearlo.

services_ipv4_cidr_blocks[]

string

Obligatorio. A todos los servicios del clúster se les asigna una dirección IPv4 RFC1918 de estos bloques. Solo se admite un bloque. No se puede cambiar este campo después de crearlo.

ClusterUser

Es un principal de usuario para una política de RBAC.

Campos
username

string

Obligatorio. Un nombre de usuario de Google activo

ConfigData

Los datos de configuración contienen todos los datos relacionados con la configuración de la zona.

Campos
available_external_lb_pools_ipv4[]

string

Es la lista de grupos de IP de IPv4 disponibles para el balanceador de cargas externo.

available_external_lb_pools_ipv6[]

string

Es la lista de grupos de IP de IPv6 disponibles para el balanceador de cargas externo.

CreateClusterRequest

Crea un clúster.

Campos
parent

string

Obligatorio. Es la ubicación principal en la que se creará este clúster.

La autorización requiere el siguiente permiso de IAM en el recurso especificado parent:

  • edgecontainer.clusters.create
cluster_id

string

Obligatorio. Es un identificador único especificado por el cliente para el clúster.

cluster

Cluster

Obligatorio. Es el clúster que se creará.

request_id

string

Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

CreateIdentityProviderRequest

Es un arquetipo de solicitud para configurar el proveedor de identidad de una organización.

Campos
parent

string

Obligatorio. Es el nombre del recurso del proveedor de identidad que se configurará, p. ej., organizations/{organization}/locations/{location}.

identity_provider_id

string

Obligatorio. Es el ID del proveedor de identidad.

identity_provider

IdentityProvider

Obligatorio. Es el proveedor de identidad que se configurará.

request_id

string

Es opcional. Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

CreateNodePoolRequest

Crea un grupo de nodos.

Campos
parent

string

Obligatorio. Es el clúster principal en el que se creará este grupo de nodos.

La autorización requiere el siguiente permiso de IAM en el recurso especificado parent:

  • edgecontainer.nodePools.create
node_pool_id

string

Obligatorio. Es un identificador único especificado por el cliente para el grupo de nodos.

node_pool

NodePool

Obligatorio. Es el grupo de nodos que se creará.

request_id

string

Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

CreateServiceAccountRequest

Es un proto de solicitud para crear un recurso de cuenta de servicio.

Campos
parent

string

Obligatorio. Es el nombre del recurso del proveedor de identidad que se configurará, p. ej., project/{project}/locations/{location}.

service_account_id

string

Obligatorio. Es el ID de la cuenta de servicio.

service_account

ServiceAccount

Obligatorio. Es la cuenta de servicio que se configurará.

request_id

string

Es opcional. Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

CreateVpnConnectionRequest

Crea una conexión de VPN.

Campos
parent

string

Obligatorio. Es la ubicación principal en la que se creará esta conexión de VPN.

La autorización requiere el siguiente permiso de IAM en el recurso especificado parent:

  • edgecontainer.vpnConnections.create
vpn_connection_id

string

Obligatorio. Es el identificador de la conexión de VPN.

vpn_connection

VpnConnection

Obligatorio. Es la conexión de VPN que se creará.

request_id

string

Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

DeleteApiKeyRequest

Es un proto de solicitud para borrar una clave de API.

Campos
name

string

Obligatorio. Es el nombre canónico del recurso de la clave de API. p.ej., projects/{project}/locations/{location}/apiKeys/{api_key}

DeleteClusterRequest

Borra un clúster.

Campos
name

string

Obligatorio. Es el nombre del recurso del clúster.

La autorización requiere el siguiente permiso de IAM en el recurso especificado name:

  • edgecontainer.clusters.delete
request_id

string

Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

DeleteIdentityProviderRequest

Es un arquetipo de solicitud para borrar el proveedor de identidad de una organización.

Campos
name

string

Obligatorio. Es el nombre del recurso del proveedor de identidad que se borrará. Nombre que se formateará de la siguiente manera: organizations/{organization}/locations/{location}/identityProviders/{identity_provider}

request_id

string

Es opcional. Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

DeleteNodePoolRequest

Borra un grupo de nodos.

Campos
name

string

Obligatorio. Es el nombre del recurso del grupo de nodos.

La autorización requiere el siguiente permiso de IAM en el recurso especificado name:

  • edgecontainer.nodePools.delete
request_id

string

Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

DeleteServiceAccountRequest

Es un proto de solicitud para borrar un recurso de cuenta de servicio del proyecto.

Campos
name

string

Obligatorio. Es el nombre canónico del recurso de la cuenta de servicio del proyecto. P.ej., projects/{project}/locations/{location}/serviceAccounts/{service_account}

DeleteVpnConnectionRequest

Borra una conexión VPN.

Campos
name

string

Obligatorio. Es el nombre del recurso de la conexión de VPN.

La autorización requiere el siguiente permiso de IAM en el recurso especificado name:

  • edgecontainer.vpnConnections.delete
request_id

string

Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

EnableZonalProjectRequest

Habilita un proyecto de consumidor (que corresponde al proyecto de consumidor de Cloud) en una o más zonas.

Campos
parent

string

Obligatorio. Zona principal en la que se creará el proyecto

zonal_project_id

string

Obligatorio. Es el project_id especificado del proyecto del consumidor que se habilitará.

zonal_project

ZonalProject

Obligatorio. Es el proyecto del consumidor que se habilitará.

request_id

string

Es opcional. Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

EnableZonalProjectResponse

Es el mensaje de respuesta para habilitar un proyecto zonal.

Campos
zonal_project

ZonalProject

Es el proyecto zonal habilitado.

EnableZonalServiceRequest

Habilita la solicitud de ZonalService. La API configurará el acceso para que los productores de servicios del clúster creen recursos de servicio.

Campos
parent

string

Obligatorio. Es la ubicación principal, que es propietaria de esta colección de servicios.

zonal_service_id

string

Es opcional. Es el zonal_service_id especificado.

zonal_service

ZonalService

Obligatorio. Es el servicio que se creará.

request_id

string

Es opcional. Es el UUID de la solicitud idempotente.

Flota

Configuración relacionada con la flota.

Las flotas son un concepto de Google Cloud que organiza los clústeres de manera lógica, lo que te permite usar y administrar capacidades de varios clústeres y aplicar políticas coherentes en tus sistemas.

Campos
project

string

Obligatorio. El número del proyecto host de la flota en el que se registrará este clúster.

Los nombres de los proyectos tienen el formato projects/<project-number>.

membership

string

Solo salida. El nombre del recurso de membresía del concentrador administrado asociado a este clúster.

Los nombres de las membresías tienen el formato projects/<project-number>/locations/global/membership/<cluster-id>.

GenerateAccessTokenRequest

Genera un token de acceso para un clúster.

Campos
cluster

string

Obligatorio. Es el nombre del recurso del clúster.

La autorización requiere el siguiente permiso de IAM en el recurso especificado cluster:

  • edgecontainer.clusters.generateAccessToken

GenerateAccessTokenResponse

Es un token de acceso para un clúster.

Campos
access_token

string

Solo salida. Token de acceso para autenticarte en api-server de k8s.

expire_time

Timestamp

Solo salida. Marca de tiempo en la que vencerá el token.

GenerateOfflineCredentialRequest

Genera una credencial sin conexión(offline) para un clúster.

Campos
cluster

string

Obligatorio. Es el nombre del recurso del clúster.

La autorización requiere el siguiente permiso de IAM en el recurso especificado cluster:

  • edgecontainer.clusters.generateOfflineCredential

GenerateOfflineCredentialResponse

Es una credencial sin conexión para un clúster.

Campos
client_certificate

string

Solo salida. Certificado de cliente para autenticarse en el servidor de la API de k8s.

client_key

string

Solo salida. Clave privada del cliente para autenticarse en el servidor de la API de k8s.

user_id

string

Solo salida. Identidad del cliente.

expire_time

Timestamp

Solo salida. Es la marca de tiempo en la que vencerá esta credencial.

GenerateServiceAccountKeyRequest

Es el proto de solicitud para la API de GenerateServiceAccountKey.

Campos
name

string

Obligatorio. Es el nombre canónico del recurso de la cuenta de servicio del proyecto. P.ej., projects/{project}/locations/{location}/serviceAccounts/{service_account}

validity

Duration

Es opcional. Es la vida útil de la clave. Si no se especifica, la vida útil predeterminada se establece en 14 días.

ca_cert_path

string

Es opcional. Es la ruta de acceso del certificado de CA.

GenerateServiceAccountKeyResponse

Es el proto de respuesta para la API de GenerateServiceAccountKey.

Campos
type

string

Es el tipo de credencial.

project

string

Solo salida. Es el proyecto al que pertenece la cuenta de servicio.

private_key_id

string

Solo salida. Es el ID de la clave privada.

private_key

string

Solo salida. Es la clave privada.

name

string

Solo salida. Es el nombre de la identidad del servicio.

token_uri

string

Solo salida. Es el URI del token.

format_version

string

Solo salida. Es la versión del formato.

ca_cert_path

string

Solo salida. Es la ruta de acceso del certificado de CA.

GetApiKeyRequest

Es un proto de solicitud para obtener una clave de API.

Campos
name

string

Obligatorio. Es el nombre de la clave de API que se recuperará. Formato: projects/{project}/locations/{location}/apiKeys/{api_key}

GetClusterRequest

Obtiene un clúster.

Campos
name

string

Obligatorio. Es el nombre del recurso del clúster.

La autorización requiere el siguiente permiso de IAM en el recurso especificado name:

  • edgecontainer.clusters.get

GetIamPolicyRequest

Es un proto de solicitud para obtener la política de IAM asociada a un proyecto en una zona.

Campos
name

string

Obligatorio. Es el nombre canónico de la zona desde la que se recuperará el IamPolicy. P.ej., projects/*/locations/*/zones/*

GetIdentityProviderRequest

Es un arquetipo de solicitud para obtener el proveedor de identidad de una organización.

Campos
name

string

Obligatorio. Es el nombre canónico del recurso del proveedor de identidad. P.ej., organizations/*/locations/*/identityProviders/*

GetMachineRequest

Obtiene una máquina.

Campos
name

string

Obligatorio. Es el nombre del recurso de la máquina.

La autorización requiere el siguiente permiso de IAM en el recurso especificado name:

  • edgecontainer.machines.get

GetNodePoolRequest

Obtiene un grupo de nodos.

Campos
name

string

Obligatorio. Es el nombre del recurso del grupo de nodos.

La autorización requiere el siguiente permiso de IAM en el recurso especificado name:

  • edgecontainer.nodePools.get

GetServerConfigRequest

Obtiene la configuración del servidor.

Campos
name

string

Obligatorio. Nombre (proyecto y ubicación) de la configuración del servidor que se obtendrá, especificado en el formato projects/*/locations/*.

La autorización requiere el siguiente permiso de IAM en el recurso especificado name:

  • edgecontainer.serverConfig.get

GetServiceAccountRequest

Es un proto de solicitud para obtener un recurso de cuenta de servicio.

Campos
name

string

Obligatorio. Es el nombre canónico del recurso de la cuenta de servicio del proyecto. P.ej., projects/{project}/locations/{location}/serviceAccounts/{service_account}

GetVpnConnectionRequest

Obtiene una conexión de VPN.

Campos
name

string

Obligatorio. Es el nombre del recurso de la conexión de VPN.

La autorización requiere el siguiente permiso de IAM en el recurso especificado name:

  • edgecontainer.vpnConnections.get

GetZonalProjectRequest

Obtiene un recurso de proyecto zonal.

Campos
name

string

Obligatorio. Es el nombre canónico del recurso del proyecto zonal. P.ej., organizations/*/locations/*/zonalProjects/*

GetZonalServiceRequest

Es la forma de obtener la solicitud de ZonalService.

Campos
name

string

Obligatorio. Es el nombre del recurso del servicio.

GetZoneRequest

Obtiene una zona.

Campos
name

string

Obligatorio. Es el nombre canónico del recurso de la zona. P.ej., organizations/*/locations/*/zone/*

IamPolicy

IamPolicy representa una política de IAM.

Campos
bindings[]

Binding

Es opcional. La política es una lista de vinculaciones.

etag

string

Es opcional. Es el ETag de la política de IAM.

Vinculación

Binding representa una vinculación de rol en la política de IAM.

Campos
role

string

Obligatorio. Es el rol en la política de IAM al que se vincularán los miembros.

members[]

Principal

Es opcional. Son los miembros a los que se vinculará el rol.

Principal

Principal representa un principal en la política de IAM.

Campos
Campo de unión identity. Es la principal a la que se vinculará el rol. identity puede ser solo uno de los parámetros siguientes:
user

string

Es opcional. Representa a un usuario en la política de IAM.

service_account

string

Es opcional. Representa una cuenta de servicio en la política de IAM.

group

string

Es opcional. Representa un grupo en la política de IAM.

IdentityProvider

Representa un recurso de proveedor de identidad que representa la configuración del proveedor de identidad para la organización.

Campos
name

string

Es el identificador. Es el nombre canónico del recurso del proveedor de identidad. p.ej., organizations/{organization}/locations/{location}/identityProviders/{identity_provider}

create_time

Timestamp

Solo salida. Es la fecha y hora en que se creó el proveedor de identidad.

update_time

Timestamp

Solo salida. Fecha y hora en la que se actualizó el proveedor de identidad por última vez.

delete_time

Timestamp

Solo salida. Fecha y hora en que se borró el proveedor de identidad.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a este recurso.

Campo de unión config. Es la configuración del proveedor de identidad. config puede ser solo uno de los parámetros siguientes:
oidc_config

OIDCProviderConfig

Es la configuración del proveedor de OIDC.

saml_config

SAMLProviderConfig

Es la configuración del proveedor de SAML.

Campo de unión target. Es el destino del proveedor de identidad. target puede ser solo uno de los parámetros siguientes:
zone_id

string

Es el ID de la zona de destino del clúster de infraestructura para el que se configurará el proveedor de identidad.

cluster

string

Es el nombre completamente calificado del BMUC objetivo para el que se configurará el proveedor de identidad.

KmsKeyState

Representa el estado de accesibilidad de una clave de KMS administrada por el cliente que se usa para la integración de CMEK.

Enums
KMS_KEY_STATE_UNSPECIFIED Sin especificar.
KMS_KEY_STATE_KEY_AVAILABLE La clave está disponible para su uso y se debería poder acceder a los recursos dependientes.
KMS_KEY_STATE_KEY_UNAVAILABLE La clave no está disponible por un motivo no especificado. Es posible que no se pueda acceder a los recursos dependientes.

ListApiKeysRequest

Es un proto de solicitud para enumerar claves de API.

Campos
parent

string

Obligatorio. Es el recurso principal en el que se creará esta clave. Formato: projects/{project}/locations/{location}

page_size

int32

Es opcional. Es la cantidad máxima de recursos que se pueden incluir en la lista.

page_token

string

Es opcional. Es un token de página que se recibió de una solicitud de lista anterior.

ListApiKeysResponse

Es el arquetipo de respuesta para enumerar las claves de API.

Campos
api_keys[]

ApiKey

Es la lista de claves de API.

next_page_token

string

Un token para recuperar la siguiente página de resultados.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

ListClustersRequest

Enumera los clústeres en una ubicación.

Campos
parent

string

Obligatorio. Es la ubicación principal, que es propietaria de esta colección de clústeres.

La autorización requiere el siguiente permiso de IAM en el recurso especificado parent:

  • edgecontainer.clusters.list
page_size

int32

Es la cantidad máxima de recursos que se pueden incluir en la lista.

page_token

string

Es un token de página que se recibió de una solicitud de lista anterior. Es un token de página que se recibió de una solicitud de lista anterior.

filter

string

Solo se mostrarán los recursos que coincidan con este filtro.

order_by

string

Especifica el orden en que se mostrarán los recursos.

ListClustersResponse

Es una lista de clústeres en una ubicación.

Campos
clusters[]

Cluster

Son los clústeres en la ubicación.

next_page_token

string

Un token para recuperar la siguiente página de resultados.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

ListIdentityProvidersRequest

Es un arquetipo de solicitud para enumerar los proveedores de identidad de una organización.

Campos
parent

string

Obligatorio. Organización principal y región de los proveedores de identidad.

page_size

int32

Es opcional. Es la cantidad máxima de recursos que se pueden incluir en la lista.

page_token

string

Es opcional. Es un token de página que se recibió de una solicitud de lista anterior.

filter

string

Es opcional. Solo se mostrarán los recursos que coincidan con este filtro.

order_by

string

Es opcional. Especifica el orden en que se mostrarán los recursos. Son los campos por los que se ordena el resultado.

ListIdentityProvidersResponse

Es el arquetipo de respuesta para enumerar los proveedores de identidad de una organización.

Campos
identity_providers[]

IdentityProvider

Es una lista de proveedores de identidad que coinciden con la solicitud.

next_page_token

string

Un token para recuperar la siguiente página de resultados.

unreachable[]

string

Lista sin ordenar. Ubicaciones a las que no se pudo llegar.

ListMachinesRequest

Enumera las máquinas de un sitio.

Campos
parent

string

Obligatorio. Es el sitio principal, que es propietario de esta colección de máquinas.

La autorización requiere el siguiente permiso de IAM en el recurso especificado parent:

  • edgecontainer.machines.list
page_size

int32

Es la cantidad máxima de recursos que se pueden incluir en la lista.

page_token

string

Es un token de página que se recibió de una solicitud de lista anterior.

filter

string

Solo se mostrarán los recursos que coincidan con este filtro.

order_by

string

Especifica el orden en que se mostrarán los recursos.

ListMachinesResponse

Es la lista de máquinas en un sitio.

Campos
machines[]

Machine

Son las máquinas que se encuentran en el sitio.

next_page_token

string

Un token para recuperar la siguiente página de resultados.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

ListNodePoolsRequest

Enumera los grupos de nodos en un clúster.

Campos
parent

string

Obligatorio. Es el clúster principal, que es propietario de esta colección de grupos de nodos.

La autorización requiere el siguiente permiso de IAM en el recurso especificado parent:

  • edgecontainer.nodePools.list
page_size

int32

Es la cantidad máxima de recursos que se pueden incluir en la lista.

page_token

string

Es un token de página que se recibió de una solicitud de lista anterior.

filter

string

Solo se mostrarán los recursos que coincidan con este filtro.

order_by

string

Especifica el orden en que se mostrarán los recursos.

ListNodePoolsResponse

Es una lista de grupos de nodos en un clúster.

Campos
node_pools[]

NodePool

Son los grupos de nodos del clúster.

next_page_token

string

Un token para recuperar la siguiente página de resultados.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

ListServiceAccountsRequest

Es la solicitud de ListServiceAccounts.

Campos
parent

string

Obligatorio. Es la ubicación principal, que es propietaria de esta colección de cuentas de servicio del proyecto.

page_size

int32

Es opcional. Es la cantidad máxima de recursos que se pueden incluir en la lista.

page_token

string

Es opcional. Es un token de página que se recibió de una solicitud de lista anterior.

filter

string

Es opcional. Solo se mostrarán los recursos que coincidan con este filtro.

order_by

string

Es opcional. Especifica el orden en que se mostrarán los recursos. Son los campos por los que se ordena el resultado.

ListServiceAccountsResponse

Es la respuesta de List ServiceAccounts.

Campos
service_accounts[]

ServiceAccount

Es la lista de ServiceAccounts que coinciden con la solicitud.

next_page_token

string

Un token para recuperar la siguiente página de resultados.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

ListVpnConnectionsRequest

Enumera las conexiones de VPN.

Campos
parent

string

Obligatorio. Es la ubicación principal, que es propietaria de esta colección de conexiones de VPN.

La autorización requiere el siguiente permiso de IAM en el recurso especificado parent:

  • edgecontainer.vpnConnections.list
page_size

int32

Es la cantidad máxima de recursos que se pueden incluir en la lista.

page_token

string

Es un token de página que se recibió de una solicitud de lista anterior.

filter

string

Solo se mostrarán los recursos que coincidan con este filtro.

order_by

string

Especifica el orden en que se mostrarán los recursos.

ListVpnConnectionsResponse

Es una lista de las conexiones VPN en una ubicación.

Campos
vpn_connections[]

VpnConnection

Son las VpnConnections en la ubicación.

next_page_token

string

Un token para recuperar la siguiente página de resultados.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

ListZonalProjectsRequest

Enumera los proyectos de consumidor de una organización.

Campos
parent

string

Obligatorio. Es la zona principal en la que se creará el proyecto.

page_size

int32

Es opcional. Es la cantidad máxima de recursos que se pueden incluir en la lista.

page_token

string

Es opcional. Es un token de página que se recibió de una solicitud de lista anterior.

filter

string

Es opcional. Solo se mostrarán los recursos que coincidan con este filtro.

order_by

string

Es opcional. Especifica el orden en que se mostrarán los recursos. Son los campos por los que se ordena el resultado.

ListZonalProjectsResponse

Es la lista de proyectos de consumidor en una respuesta de organización.

Campos
zonal_projects[]

ZonalProject

Son los clústeres en la ubicación.

next_page_token

string

Un token para recuperar la siguiente página de resultados.

unreachable[]

string

Zonas a las que no se pudo llegar.

ListZonalServicesRequest

Es la solicitud para enumerar los servicios zonales.

Campos
parent

string

Obligatorio. Es la ubicación principal, que es propietaria de esta colección de servicios.

page_size

int32

Es opcional. Es la cantidad máxima de recursos que se pueden incluir en la lista.

page_token

string

Es opcional. Es un token de página que se recibió de una solicitud de lista anterior.

filter

string

Es opcional. Solo se mostrarán los recursos que coincidan con este filtro.

order_by

string

Es opcional. Especifica el orden en que se mostrarán los recursos. Son los campos por los que se ordena el resultado.

ListZonalServicesResponse

Es la respuesta de List ZonalServices.

Campos
zonal_services[]

ZonalService

Son los servicios zonales en la ubicación.

next_page_token

string

Un token para recuperar la siguiente página de resultados.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

ListZonesRequest

Enumera las zonas en las que está habilitada la organización principal.

Campos
parent

string

Obligatorio. Organización y ubicación principal.

page_size

int32

Es opcional. La cantidad máxima de elementos que se mostrarán.

page_token

string

Es opcional. El valor next_page_token que se muestra de una solicitud de lista anterior, si existe.

filter

string

Es opcional. Solo se mostrarán los recursos que coincidan con este filtro.

order_by

string

Es opcional. Especifica el orden en que se mostrarán los recursos.

ListZonesResponse

Es el mensaje de respuesta para enumerar zonas.

Campos
zones[]

Zone

Es una lista de zonas que coinciden con la solicitud.

next_page_token

string

Un token para recuperar la siguiente página de resultados.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

LocationMetadata

Son los metadatos de un google.cloud.location.Location determinado.

Campos
available_zones

map<string, ZoneMetadata>

Es el conjunto de zonas de Google Distributed Cloud Edge disponibles en la ubicación. El mapa se indexa con el ID en minúsculas de cada zona.

Máquina

Una máquina de Google Distributed Cloud Edge capaz de actuar como un nodo de Kubernetes

Campos
name

string

Obligatorio. Es el nombre del recurso de la máquina.

create_time

Timestamp

Solo salida. Es la fecha y hora en que se creó el grupo de nodos.

update_time

Timestamp

Solo salida. Fecha y hora en la que se actualizó el grupo de nodos por última vez.

labels

map<string, string>

Son las etiquetas asociadas a este recurso.

hosted_node

string

Es el nombre canónico del recurso del nodo que esta máquina es responsable de alojar, p.ej., projects/{project}/locations/{location}/clusters/{cluster_id}/nodePools/{pool_id}/{node}, o bien está vacío si la máquina no está asignada para asumir el rol de un nodo.

Para los nodos del plano de control alojados en máquinas perimetrales, se devolverá el siguiente formato: "projects/{project}/locations/{location}/clusters/{cluster_id}/controlPlaneNodes/{node}".

zone

string

Es la zona de Google Distributed Cloud Edge de esta máquina.

version

string

Solo salida. Es la versión de software de la máquina.

disabled

bool

Solo salida. Indica si la máquina está inhabilitada. Si está inhabilitada, la máquina no puede entrar en servicio.

status

Status

Solo salida. Es el estado actual de la máquina.

purpose

Purpose

Es el tipo de clúster para el que se usa la máquina.

Objetivo

El propósito de la máquina puede ser VIRTUALIZED_WORKLOAD o BAREMETAL_CLUSTER.

Enums
PURPOSE_UNSPECIFIED Propósito no especificado.
VIRTUALIZED_WORKLOAD La máquina se usa para la carga de trabajo virtual.
BAREMETAL_CLUSTER La máquina se usa para un clúster de usuario de Bare Metal.

Estado

Indica el estado de la máquina.

Enums
STATUS_UNSPECIFIED Estado desconocido.
READY La máquina está lista para alojar un nodo. Esta es la opción predeterminada.
DISABLED_FOR_REPAIR Se inhabilitó la máquina para su reparación agregando 1 o más reclamos de inhabilitación.

MaintenanceExclusionWindow

Representa un período de exclusión de mantenimiento.

Campos
window

TimeWindow

Es opcional. Es el período.

id

string

Es opcional. Es un ID único (por clúster) para la ventana.

MaintenancePolicy

Es la configuración de la política de mantenimiento.

Campos
window

MaintenanceWindow

Especifica el período de mantenimiento en el que se puede realizar el mantenimiento.

maintenance_exclusions[]

MaintenanceExclusionWindow

Es opcional. Son las exclusiones del mantenimiento automático. El mantenimiento que no sea de emergencia no debe ocurrir en estos períodos. Cada exclusión tiene un nombre único y puede estar activa o vencida. La cantidad máxima de exclusiones de mantenimiento permitidas en un momento determinado es 3.

MaintenanceWindow

Configuración del período de mantenimiento

Campos
recurring_window

RecurringTimeWindow

Es la configuración de un período de mantenimiento recurrente.

Grupo de nodos

Es un conjunto de nodos de Kubernetes en un clúster con configuración y especificaciones comunes.

Campos
name

string

Obligatorio. Es el nombre del recurso del grupo de nodos.

create_time

Timestamp

Solo salida. Es la fecha y hora en que se creó el grupo de nodos.

update_time

Timestamp

Solo salida. Fecha y hora en la que se actualizó el grupo de nodos por última vez.

labels

map<string, string>

Son las etiquetas asociadas a este recurso.

node_location

string

Es el nombre de la zona de Google Distributed Cloud Edge en la que se creará este grupo de nodos. Por ejemplo: us-central1-edge-customer-a.

node_count

int32

Obligatorio. Es la cantidad de nodos del grupo.

machine_filter

string

Solo se permitirá que las máquinas que coincidan con este filtro se unan al grupo de nodos. El lenguaje de filtrado acepta cadenas como "name=" y se documenta con más detalle en AIP-160.

local_disk_encryption

LocalDiskEncryption

Es opcional. Opciones de encriptación de disco local Este campo solo se usa cuando se habilita la compatibilidad con CMEK.

node_version

string

Solo salida. Es la versión de lanzamiento más baja entre todos los nodos trabajadores.

node_config

NodeConfig

Es opcional. Es la configuración de cada nodo del NodePool.

LocalDiskEncryption

Es la configuración de la compatibilidad con CMEK para la encriptación de discos locales de la máquina perimetral.

Campos
kms_key

string

Es opcional. Es la CryptoKey de Cloud KMS (p.ej., projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}) que se usará para proteger los discos locales del nodo. Si no se especifica, se usará una clave administrada por Google.

kms_key_active_version

string

Solo salida. Es la versión de CryptoKey de Cloud KMS que se usa actualmente para proteger los discos locales del nodo. Solo se aplica si se configura kms_key.

kms_key_state

KmsKeyState

Solo salida. Disponibilidad de la CryptoKey de Cloud KMS. Si no es KEY_AVAILABLE, es posible que los nodos se desconecten, ya que no pueden acceder a sus datos locales. Esto puede deberse a la falta de permisos para usar la clave o a que la clave está inhabilitada o borrada.

kms_status

Status

Solo salida. Es el estado de error que devuelve Cloud KMS cuando se usa esta clave. Este campo solo se puede completar si kms_key_state no es KMS_KEY_STATE_KEY_AVAILABLE. Si se propaga, este campo contiene el estado de error que informa Cloud KMS.

resource_state

ResourceState

Solo salida. Es el estado actual del recurso asociado con la CMEK.

NodeConfig

Es la configuración de cada nodo del NodePool.

Campos
labels

map<string, string>

Es opcional. Las etiquetas de nodos de Kubernetes

node_storage_schema

string

Es opcional. Nombre del esquema de almacenamiento de los nodos trabajadores.

node_system_partition_size

SystemPartitionGiBSize

Es opcional. Tamaño de la partición del sistema para los nodos trabajadores en GiB.

OIDCProviderConfig

Representa la configuración del proveedor de OIDC.

Campos
client_id

string

Obligatorio. Es el ID de cliente del proveedor de identidad.

client_secret

string

Es opcional. Es el secreto del cliente del proveedor de identidad.

issuer_uri

string

Obligatorio. Es el URI del emisor del proveedor de identidad.

scopes

string

Obligatorio. Son los alcances del proveedor de identidad.

user_claim

string

Es opcional. Es el reclamo del usuario del proveedor de identidad.

extra_params

string

Es opcional. Lista de pares clave-valor separados por comas que se codificarán en consultas y se enviarán con la solicitud del extremo de autenticación.

certificate_authority_data

string

Es opcional. Son los datos de la autoridad certificadora del proveedor de identidad.

group_claim

string

Es opcional. Es la reclamación del grupo del proveedor de identidad.

attribute_mapping

map<string, string>

Es opcional. Es la asignación de atributos del proveedor de identidad.

OperationMetadata

Son los metadatos de la operación de larga duración para los métodos de la API de Edge Container.

Campos
create_time

Timestamp

Es la fecha y hora en que se creó la operación.

end_time

Timestamp

Es la hora a la que finalizó la operación.

target

string

Es la ruta de acceso al recurso definida por el servidor para el destino de la operación.

verb

string

Verbo que ejecuta la operación.

status_message

string

Estado legible de la operación, si lo hay.

requested_cancellation

bool

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 google.rpc.Status.code de 1, que corresponde a Code.CANCELLED.

api_version

string

Versión de la API que se usó para iniciar la operación.

warnings[]

string

Advertencias que no bloquean la operación, pero que contienen información relevante para el usuario final.

status_reason

StatusReason

Estado de la operación legible por máquina, si lo hay.

StatusReason

Indica el motivo del estado de la operación.

Enums
STATUS_REASON_UNSPECIFIED Motivo desconocido.
UPGRADE_PAUSED Actualmente, la actualización del clúster está en pausa.
RETRYABLE_ERROR Se produjo un error en la solicitud, pero se puede volver a intentar.

Cuota

Representa la cuota para los recursos de contenedores de Edge.

Campos
metric

string

Es el nombre de la métrica de cuota.

limit

double

Es el límite de cuota para esta métrica.

usage

double

Es el uso actual de esta métrica.

RecurringTimeWindow

Representa un período arbitrario que se repite.

Campos
window

TimeWindow

Es el período de la primera recurrencia.

recurrence

string

Es una RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) que indica cómo se repite este período. Se extienden durante el período comprendido entre la hora de inicio y la hora de finalización.

ResourceState

Representa si el recurso está en estado de bloqueo o pendiente.

Enums
RESOURCE_STATE_UNSPECIFIED Valor predeterminado.
RESOURCE_STATE_LOCK_DOWN El recurso está en estado de BLOQUEO.
RESOURCE_STATE_LOCK_DOWN_PENDING El recurso está pendiente de bloqueo.

SAMLProviderConfig

Representa la configuración del proveedor de SAML.

Campos
entity_id

string

Obligatorio. Es el ID de entidad del proveedor de identidad.

single_sign_on_uri

string

Obligatorio. Es el URI de inicio de sesión único del proveedor de identidad.

certificate_data[]

string

Es opcional. Son los datos del certificado del proveedor de identidad.

user_attribute

string

Es opcional. Es el atributo del usuario del proveedor de identidad.

group_attribute

string

Es opcional. Es el atributo de grupo del proveedor de identidad.

attribute_mapping

map<string, string>

Es opcional. Es la asignación de atributos del proveedor de identidad.

ServerConfig

Es la configuración del servidor para las versiones y los canales de versiones compatibles.

Campos
channels

map<string, ChannelConfig>

Solo salida. Es la asignación del canal de versiones a la configuración del canal.

versions[]

Version

Solo salida. Versiones compatibles, p.ej.: ["1.4.0", "1.5.0"].

default_version

string

Solo salida. Versión predeterminada, p.ej.: "1.4.0".

version_rollouts[]

VersionRollout

Solo salida. Es la información del lanzamiento de la configuración del servidor.

ServiceAccount

Representa el recurso de la cuenta de servicio.

Campos
name

string

Es el identificador. Es el nombre canónico del recurso de la cuenta de servicio del proyecto. P.ej., projects/{project}/locations/{location}/serviceAccounts/{service_account}

zone

string

Obligatorio. Es el ID de la zona en la que se debe crear la cuenta de servicio del proyecto.

create_time

Timestamp

Solo salida. Es la fecha y hora en que se creó la cuenta de servicio del proyecto.

update_time

Timestamp

Solo salida. Fecha y hora en que se actualizó la cuenta de servicio del proyecto por última vez.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a este recurso.

state

State

Solo salida. Es el estado de la cuenta de servicio.

Estado

Es el estado de la cuenta de servicio.

Enums
STATE_UNSPECIFIED Sin especificar.
CREATING La cuenta de servicio está en estado CREATING.
RUNNING La cuenta de servicio está en estado RUNNING.
DELETING La cuenta de servicio está en estado DELETING.
ERROR La cuenta de servicio está en estado de ERROR.
REPAIRING La cuenta de servicio está en estado REPAIRING.

SetIamPolicyRequest

Es un arquetipo de solicitud para establecer la política de IAM de un proyecto en una zona.

Campos
name

string

Obligatorio. Es el nombre canónico del recurso de la zona. projects/{project}/locations/{location}/zones/{zone}

policy

IamPolicy

Obligatorio. Es la política de IAM que se establecerá.

request_id

string

Es opcional. Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

SystemPartitionGiBSize

SystemPartitionGiBSize representa los tamaños de partición del sistema permitidos en GiB.

Enums
SYSTEM_PARTITION_GIB_SIZE_UNSPECIFIED El usuario no especifica el tamaño de la partición del sistema. Esto hará que el tamaño de la partición del sistema se establezca en el tamaño especificado en el esquema de almacenamiento del sistema aplicable a ese nodo, que es de 100 GiB.
SYSTEM_PARTITION_GIB_SIZE100 Tamaño de la partición del sistema de 100 GiB, que también es el tamaño predeterminado.
SYSTEM_PARTITION_GIB_SIZE300 Tamaño de partición del sistema de 300 GiB. Se puede usar para anular el valor predeterminado de 100 GiB.

TimeWindow

Representa un período arbitrario.

Campos
start_time

Timestamp

Es la hora en la que comienza el período.

end_time

Timestamp

Es la fecha y hora en que finaliza el período. La hora de finalización debe ser posterior a la de inicio.

UpdateClusterRequest

Actualiza un clúster.

Campos
update_mask

FieldMask

La máscara de campo se usa para especificar los campos que la actualización reemplazará en el recurso Cluster. Los campos especificados en update_mask se relacionan con el recurso, no con la solicitud completa. Un campo se reemplazará si está en la máscara. Si el usuario no proporciona una máscara, se reemplazarán todos los campos.

cluster

Cluster

Es el clúster actualizado.

La autorización requiere el siguiente permiso de IAM en el recurso especificado cluster:

  • edgecontainer.clusters.update
request_id

string

Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

UpdateNodePoolRequest

Actualiza un grupo de nodos.

Campos
update_mask

FieldMask

La máscara de campo se usa para especificar los campos que la actualización reemplazará en el recurso NodePool. Los campos especificados en update_mask se relacionan con el recurso, no con la solicitud completa. Un campo se reemplazará si está en la máscara. Si el usuario no proporciona una máscara, se reemplazarán todos los campos.

node_pool

NodePool

Es el grupo de nodos actualizado.

La autorización requiere el siguiente permiso de IAM en el recurso especificado nodePool:

  • edgecontainer.nodePools.update
request_id

string

Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

UpgradeClusterRequest

Actualiza un clúster.

Campos
name

string

Obligatorio. Es el nombre del recurso del clúster.

La autorización requiere el siguiente permiso de IAM en el recurso especificado name:

  • edgecontainer.clusters.upgrade
target_version

string

Obligatorio. Es la versión a la que se actualizará el clúster.

schedule

Schedule

Es la programación de la actualización.

request_id

string

Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

Programar

Representa el programa de cuándo se actualizará el clúster.

Enums
SCHEDULE_UNSPECIFIED Sin especificar. La opción predeterminada es actualizar el clúster de inmediato, que es la única opción disponible actualmente.
IMMEDIATELY El clúster se actualizará inmediatamente después de recibir la solicitud.

Versión

Es la versión de un clúster.

Campos
name

string

Solo salida. Nombre de la versión, p.ej.: "1.4.0".

VersionRollout

VersionRollout contiene la información del lanzamiento de la versión.

Campos
version

string

Solo salida. Versión semántica, p.ej.: "1.4.0".

available_zones[]

string

Solo salida. Lista de zonas en las que se lanzó la versión, p.ej.: ["us-central1", "us-west1"]

VpnConnection

Una conexión de VPN .

Campos
name

string

Obligatorio. Nombre del recurso de la conexión de VPN

create_time

Timestamp

Solo salida. Es la fecha y hora en que se creó la conexión de VPN.

update_time

Timestamp

Solo salida. Fecha y hora en la que se actualizó la conexión de VPN por última vez.

labels

map<string, string>

Son las etiquetas asociadas a este recurso.

nat_gateway_ip

string

IP de la puerta de enlace NAT o dirección IP de WAN Si un cliente tiene varias IPs de NAT, debe configurar la NAT de modo que solo una IP externa se asigne al clúster de Anthos de GMEC. Este campo está vacío si no se usa NAT.

bgp_routing_mode
(deprecated)

BgpRoutingMode

Modo de enrutamiento dinámico de la red de VPC, regional o global.

cluster

string

Es el nombre canónico del clúster al que se conectará. Tiene el formato projects/{project}/locations/{location}/clusters/{cluster}.

vpc

string

Es el ID de la red de VPC a la que se conectará.

vpc_project

VpcProject

Es opcional. Detalles del proyecto de la red de VPC. Se requiere si la VPC se encuentra en un proyecto diferente del proyecto del clúster.

enable_high_availability

bool

Indica si esta conexión de VPN tiene habilitada la alta disponibilidad en el clúster. Si está habilitada, cuando se cree la conexión de VPN, intentaremos usar 2 IPs flotantes de ANG.

router

string

Es opcional. Es el nombre del Cloud Router de la conexión de VPN.

details

Details

Solo salida. Son los detalles de la conexión creada.

BgpRoutingMode

Modo de enrutamiento.

Enums
BGP_ROUTING_MODE_UNSPECIFIED Desconocido.
REGIONAL Modo regional.
GLOBAL Modo global

Detalles

Son los detalles de la conexión creada.

Campos
state

State

Es el estado de esta conexión.

error

string

Mensaje de error. Este campo solo se propaga cuando state=ERROR.

cloud_router

CloudRouter

Es la información del Cloud Router.

cloud_vpns[]

CloudVpn

Cada conexión tiene varias puertas de enlace de Cloud VPN.

CloudRouter

Es la información del Cloud Router.

Campos
name

string

Es el nombre del Cloud Router asociado.

CloudVpn

Es la información de Cloud VPN.

Campos
gateway

string

Es el nombre de la puerta de enlace de Cloud VPN creada.

Estado

Es el estado de conexión actual.

Enums
STATE_UNSPECIFIED Desconocido.
STATE_CONNECTED Conectado.
STATE_CONNECTING Aún conectándose.
STATE_ERROR Se produjo un error.

VpcProject

Detalles del proyecto de la red de VPC.

Campos
project_id

string

Es el proyecto de la VPC a la que se conectará. Si no se especifica, es el mismo que el proyecto del clúster.

service_account
(deprecated)

string

Es opcional. Obsoleto: No usar.

ZonalProject

Es el proyecto zonal (correspondiente al proyecto de consumidor de Cloud) que se habilita en las zonas.

Campos
name

string

Es el identificador. Es el nombre del recurso del proyecto.

create_time

Timestamp

Solo salida. La hora en la que se creó el proyecto

update_time

Timestamp

Solo salida. Fecha y hora en la que se actualizó el proyecto por última vez.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a este recurso.

state

State

Solo salida. Es el estado del proyecto en la zona.

Estado

Es el estado del proyecto en la zona.

Enums
STATE_UNSPECIFIED Sin especificar.
STATE_ON El proyecto está habilitado en la zona.
STATE_OFF El proyecto está inhabilitado en la zona.

ZonalService

El servicio está habilitado en el proyecto.

Campos
name

string

Es el identificador. Es el nombre del recurso del servicio.

service_selector

ServiceSelector

Es opcional. Es el servicio que se habilitará o inhabilitará. Solo se debe especificar uno de los campos service_selector o service_name.

state

State

Solo salida. Es el estado del servicio.

create_time

Timestamp

Solo salida. Es la fecha y hora en que se habilitó el servicio.

update_time

Timestamp

Solo salida. Fecha y hora en la que se actualizó el servicio por última vez.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a este recurso.

Campo de unión zone_or_cluster. Es la zona o el clúster en el que se debe habilitar o inhabilitar el servicio. zone_or_cluster puede ser solo uno de los parámetros siguientes:
zone

string

Es el ID de la zona en la que se debe habilitar o inhabilitar el servicio.

cluster

string

Es el nombre completamente calificado del clúster en el que se debe habilitar o inhabilitar el servicio.

service_name

string

Es opcional. Nombre completo del servicio, p.ej., alloydb.googleapis.com. Solo se debe especificar uno de los campos service_selector o service_name. Se usará para habilitar o inhabilitar el servicio en el proyecto.

ServiceSelector

Son los servicios que se pueden habilitar o inhabilitar.

Enums
SERVICE_SELECTOR_UNSPECIFIED Sin especificar.
ALLOYDB Servicio de AlloyDB, alloydb.googleapis.com.
VMM Servicio de VMM, gdcvmmanager.googleapis.com.
BOOKSTORE Servicio de librería, bookstore.googleapis.com.
VERTEX Servicio de Vertex, aiplatform.googleapis.com.
BOOKSTORE_AI Servicio Bookstore.AI, bookstore-ai.googleapis.com.

Estado

Es el estado del servicio.

Enums
STATE_UNSPECIFIED Sin especificar.
STATE_ENABLED El servicio está habilitado en el proyecto.
STATE_DISABLED El servicio está inhabilitado en el proyecto.
STATE_ENABLING Se está habilitando el servicio en el proyecto.
STATE_DISABLING Se está inhabilitando el servicio en el proyecto.
STATE_REPAIRING Se está reparando el servicio.

Zona

Representa una zona.

Campos
name

string

Es el identificador. Es el nombre canónico del recurso de la zona. p.ej., organizations/{organization}/locations/{location}/zones/{zone}

create_time

Timestamp

Solo salida. Es la fecha y hora en que se creó la zona.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a este recurso.

certificate_authorities[]

string

Solo salida. Es el certificado de la CA web de la zona.

dns_servers[]

DNSServer

Solo salida. Son los servidores DNS de la zona.

state

State

Solo salida. Es el estado de la zona.

DNSServer

Representa un servidor DNS para la zona.

Campos
ip_address

string

Solo salida. Es la dirección IP del servidor DNS.

tld

string

Solo salida. Es el dominio de nivel superior del servidor DNS.

Estado

Es el estado de la zona.

Enums
STATE_UNSPECIFIED Sin especificar.
STATE_RUNNING La zona está en estado RUNNING.
STATE_ERROR La zona está en estado ERROR.
STATE_CREATING La zona está en estado CREATING.
STATE_REPAIRING La zona está en estado REPAIRING.

ZoneMetadata

Es una zona de Google Distributed Cloud Edge en la que se encuentran las máquinas perimetrales.

Campos
quota[]

Quota

Es la cuota para los recursos en esta zona.

rack_types

map<string, RackType>

Es el mapa que se codifica según el nombre del rack y tiene el valor de RackType.

config_data

ConfigData

Son los datos de configuración de la zona.

RackType

Es el tipo de estructura.

Enums
RACK_TYPE_UNSPECIFIED Tipo de estructura no especificado. Las estructuras individuales también pertenecen a este tipo.
BASE Tipo de rack base, un par de dos racks Config-1 modificados que contienen conmutadores de agregación.
EXPANSION Tipo de estructura de expansión, también conocidas como estructuras independientes, que los clientes agregan a pedido.