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.

CreateApiKey

rpc CreateApiKey(CreateApiKeyRequest) returns (Operation)

CreateApiKey crea una clave de API para 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.

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 NodePool 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.

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, 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.

CreateVpnConnection

rpc CreateVpnConnection(CreateVpnConnectionRequest) returns (Operation)

Crea una nueva conexión de VPN 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 la 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, 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.

DescribeServiceAccountKey

rpc DescribeServiceAccountKey(DescribeServiceAccountKeyRequest) returns (DescribeServiceAccountKeyResponse)

DescribeServiceAccountKey enumera todas las claves del 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.

DisableServiceAccountKey

rpc DisableServiceAccountKey(DisableServiceAccountKeyRequest) returns (DisableServiceAccountKeyResponse)

DisableServiceAccountKey inhabilita la clave de cuenta de servicio proporcionada.

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 los 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 superior.

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 ApiKeys 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 los 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 de 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.

ListNodePools

rpc ListNodePools(ListNodePoolsRequest) returns (ListNodePoolsResponse)

Enumera los 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.

ListRoles

rpc ListRoles(ListRolesRequest) returns (ListRolesResponse)

ListRoles enumera los roles de IAM de un proyecto 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.

ListServiceAccountKeys

rpc ListServiceAccountKeys(ListServiceAccountKeysRequest) returns (ListServiceAccountKeysResponse)

ListServiceAccountKeys enumera todas las claves del 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.

ListServiceAccounts

rpc ListServiceAccounts(ListServiceAccountsRequest) returns (ListServiceAccountsResponse)

ListServiceAccounts enumera los detalles de todos los recursos de la cuenta de servicio de un proyecto en el clúster (clúster de infraestructura para la versión 2, 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.

ListVpnConnections

rpc ListVpnConnections(ListVpnConnectionsRequest) returns (ListVpnConnectionsResponse)

Enumera las conexiones de 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 de 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 superior.

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 proporcionada.

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 de la validez de la clave de API.

api_targets[]

ApiTarget

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

labels

map<string, string>

Es opcional. Son las etiquetas asociadas con este recurso.

key

string

Solo salida. Es la cadena de apikey del estado de la 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. El estado de la CR de la clave de API en el clúster.

reason

string

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

create_time

Timestamp

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

delete_time

Timestamp

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

update_time

Timestamp

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

ApiTarget

Representa una restricción en la clave de API. El usuario lo proporciona 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 la conciliación aún no se ejecutó.
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.
REPAIRING La clave se está reparando o conciliando.

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 hora en la que se creó el clúster.

update_time

Timestamp

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

labels

map<string, string>

Son las etiquetas asociadas con 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 codificado con PEM de la AC del clúster.

maintenance_policy

MaintenancePolicy

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

control_plane_version

string

Solo salida. La versión de actualización del plano de control

node_version

string

Solo salida. Es la versión de actualización más baja entre todos los nodos trabajadores. Este campo puede estar vacío si el clúster no tiene ningún nodo 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 los grupos de direcciones IPv4 para el balanceo de cargas externo del plano de datos del clúster.

control_plane_encryption

ControlPlaneEncryption

Es opcional. Opciones de encriptación de discos 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 planificados para el futuro y los que se realizaron en el pasado (hasta 90 días).

target_version

string

Es opcional. Es la versión de destino del clúster. 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 supervivencia del clúster, p.ej., para el caso en que se pierde la conexión 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. 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. Grupos de balanceador de cargas externos para el clúster.

zone_storage_encryption

ZoneStorageEncryption

Es opcional. 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. Esto indica si es necesario aislar el clúster. go/cluster-isolation-in-gdcc-cluster

google_group_authentication

GoogleGroupAuthenticationConfig

Es opcional. Es la configuración de autenticación de Grupos 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 actual de la conexión.

update_time

Timestamp

Solo salida. Es la 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 Este clúster está desconectado de Google.
CONNECTED Este clúster está conectado a Google.
CONNECTED_AND_SYNCING 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 de contenedores predeterminado que se configurará en el clúster.

DefaultContainerRuntime

Es la lista de entornos 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 de contenedores predeterminado en el clúster.
GVISOR Usa gVisor como el entorno de ejecución de contenedores predeterminado en el clúster.

ControlPlane

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

Configuración del plano de control remoto.

local

Local

Configuración del plano de control local.

Advertencia: Los clústeres del plano de control local deben crearse en su propio proyecto. Los clústeres del plano de control local no pueden coexistir en el mismo proyecto con ningún otro tipo de clúster, incluidos los clústeres que no son de GDCE. Mezclar clústeres de GDCE con 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 de los clústeres con un plano de control alojado de forma local.

Advertencia: Los clústeres del plano de control local deben crearse en su propio proyecto. Los clústeres del plano de control local no pueden coexistir en el mismo proyecto con ningún otro tipo de clúster, incluidos los que no son de GDCE. Mezclar clústeres de GDCE del 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

Es el 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 se usarán como réplicas del plano de control.

machine_filter

string

Solo las máquinas que coincidan con este filtro podrán alojar 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 de los usuarios.

control_plane_node_storage_schema

string

Es opcional. Es el nombre del esquema de almacenamiento de los nodos del plano de control.

control_plane_node_system_partition_size

SystemPartitionGiBSize

Es opcional. Es el 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 para 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 de 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

Configuración de la compatibilidad con claves de KMS administradas por el cliente para los nodos del plano de control.

Campos
kms_key

string

Es opcional. La CryptoKey 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 CryptoKeyVersion de Cloud KMS que se usa actualmente para proteger los discos del plano de control. Solo se aplica si se establece 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 propagar si kms_key_state no es KMS_KEY_STATE_KEY_AVAILABLE. Si se completa, este campo contiene el estado de error que informó Cloud KMS.

resource_state

ResourceState

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

ExternalLoadBalancerPool

Grupo de balanceador de cargas externos con configuración personalizada, como nombre, asignación manual o automática, IPv4 que no se superpone y rango de direcciones IPv6 opcional.

Campos
address_pool

string

Es opcional. Es el nombre del grupo de balanceador de cargas externos.

ipv4_range[]

string

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

ipv6_range[]

string

Es opcional. Rango de direcciones IPv6 que no se superpone 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 de 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 de Grupos 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 Grupos de Google.

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 impulsadas por Google o iniciadas por el usuario, los cambios en la configuración del clúster iniciados por el usuario que requieren reiniciar los nodos, etcétera.

Campos
uuid

string

Solo salida. UUID del evento de mantenimiento.

target_version

string

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

operation

string

Solo salida. Es la 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 los 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 hora en la que se creó la solicitud de evento de mantenimiento.

start_time

Timestamp

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

end_time

Timestamp

Solo salida. Es la hora en la que finalizó el evento de mantenimiento, ya sea de forma correcta 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 hora en la que se actualizó el mensaje del evento de mantenimiento.

Programa

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 Se produjo un error en el evento de mantenimiento.

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 Es un canal de versiones sin especificar. Se establecerá de forma predeterminada en el canal REGULAR.
NONE Sin 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 mientras se conciliaba o borraba el clúster.
RECONCILING El clúster está en proceso de actualización de versión, entre otras tareas.

SurvivabilityConfig

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

Campos
offline_reboot_ttl

Duration

Es opcional. Es el período que permite que los nodos del clúster se reinicien y se vuelvan funcionales 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. Configuración para Ingress.

vm_service_config

VMServiceConfig

Es opcional. Configuración para el 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. VIP de Ingress.

VMServiceConfig

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

Campos
vmm_enabled

bool

Es opcional. Indica si VMM está habilitado.

ZoneStorageEncryption

Configuración de la compatibilidad con CMEK para el almacenamiento zonal

Campos
kms_key

string

Es opcional. La clave de Cloud KMS

kms_key_active_version

string

Solo salida. La CryptoKeyVersion de Cloud KMS que se usa actualmente para la encriptación y desencriptación

resource_state

ResourceState

Solo salida. El estado actual del recurso de la 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 una 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

lista de grupos de IP v4 disponibles para el balanceador de cargas externo

available_external_lb_pools_ipv6[]

string

lista de grupos de IP v6 disponibles para el balanceador de cargas externo

CreateApiKeyRequest

Es el proto de solicitud para crear una clave de API.

Campos
parent

string

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

api_key

ApiKey

Obligatorio. Es la clave de API que se creará.

api_key_id

string

Obligatorio. Es el ID de la clave de API que se creará.

request_id

string

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

CreateClusterRequest

Crea un clúster.

Campos
parent

string

Obligatorio. Es la ubicación superior 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. Restringido a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

CreateIdentityProviderRequest

Es el proto 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. Restringido 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 superior 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. Restringido a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

CreateServiceAccountRequest

Es el 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. Restringido 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 superior 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. Restringido a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

DeleteApiKeyRequest

Es el 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. Restringido a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

DeleteIdentityProviderRequest

Es el proto 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á. El nombre debe tener el siguiente formato: organizations/{organization}/locations/{location}/identityProviders/{identity_provider}

request_id

string

Es opcional. Es un identificador único para esta solicitud. Restringido 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. Restringido a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona request_id.

DeleteServiceAccountRequest

Es el 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. Por ejemplo, projects/{project}/locations/{location}/serviceAccounts/{service_account}

DeleteVpnConnectionRequest

Borra 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.delete
request_id

string

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

DescribeServiceAccountKeyRequest

Es el proto de solicitud para la API de DescribeServiceAccountKey.

Campos
parent

string

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

key_id

string

Obligatorio. Es el ID de la clave que se obtendrá.

DescribeServiceAccountKeyResponse

Es el proto de respuesta para la API de DescribeServiceAccountKey.

Campos
key_id

string

Solo salida. Es el ID de la clave pública.

expiry

string

Solo salida. Es el hora de vencimiento de la clave.

DisableServiceAccountKeyRequest

Es el proto de solicitud para la API de DisableServiceAccountKey.

Campos
parent

string

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

key_id

string

Obligatorio. Es el ID de la clave que se inhabilitará.

DisableServiceAccountKeyResponse

Es el proto de respuesta para la API de DisableServiceAccountKey.

Campos
key_id

string

Solo salida. Es el ID de la clave inhabilitada.

delete_time

Timestamp

Solo salida. Es la marca de tiempo de cuando se inhabilitó la clave.

EnableZonalProjectRequest

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

Campos
parent

string

Obligatorio. La zona superior en la que se creará el proyecto

zonal_project_id

string

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

zonal_project

ZonalProject

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

request_id

string

Es opcional. Es un identificador único para esta solicitud. Restringido 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

Habilitar la solicitud de ZonalService La API configurará el acceso de los productores de servicios en el clúster para crear recursos de servicio.

Campos
parent

string

Obligatorio. La ubicación superior, que es propietaria de esta colección de servicios.

zonal_service_id

string

Es opcional. Se especificó zonal_service_id.

zonal_service

ZonalService

Obligatorio. Es el servicio que se creará.

request_id

string

Es opcional. UUID de 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 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 autenticarte en api-server de k8s.

client_key

string

Solo salida. Clave privada del cliente para autenticarse en api-server de k8s.

user_id

string

Solo salida. Identidad del cliente.

expire_time

Timestamp

Solo salida. 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. Por ejemplo, projects/{project}/locations/{location}/serviceAccounts/{service_account}

validity

Duration

Es opcional. 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 la AC.

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. 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 la AC.

GetApiKeyRequest

Es el 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 el proto de solicitud para obtener la política de IAM asociada con un proyecto en una zona.

Campos
name

string

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

GetIdentityProviderRequest

Es el proto 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. El 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 el 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. Por ejemplo, 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

Obtén 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 la etiqueta de entidad de la política de IAM.

Vinculación

La vinculación 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 una principal en la política de IAM.

Campos
Campo de unión identity. 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}

proxy_uri

string

Es opcional. Es el URI del proxy para llegar al proveedor de identidad.

create_time

Timestamp

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

update_time

Timestamp

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

delete_time

Timestamp

Solo salida. Es la hora en que se borró el proveedor de identidad.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas con este recurso.

state

State

Solo salida. Es el estado del proveedor de identidad.

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

La configuración del proveedor de OIDC.

saml_config

SAMLProviderConfig

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 de destino para el que se configurará el proveedor de identidad.

Estado

Es el estado del proveedor de identidad.

Enums
STATE_UNSPECIFIED Sin especificar.
CREATING El proveedor de identidad está en estado CREATING.
RUNNING El proveedor de identidad está en estado RUNNING.
DELETING El proveedor de identidad está en estado DELETING.
ERROR El proveedor de identidad está en estado de ERROR.
REPAIRING El proveedor de identidad está en estado REPAIRING.
DELETED El proveedor de identidad está en estado BORRADO.

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 el proto de solicitud para enumerar las claves de API.

Campos
parent

string

Obligatorio. Es el recurso superior 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 recibido de la solicitud de lista anterior.

ListApiKeysResponse

Es el proto 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 de una ubicación.

Campos
parent

string

Obligatorio. La ubicación superior, 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 recibido de una solicitud de lista anterior. Es un token de página recibido de la solicitud de lista anterior.

filter

string

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

order_by

string

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

ListClustersResponse

Lista de clústeres en una ubicación.

Campos
clusters[]

Cluster

Son los clústeres de 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 el proto de solicitud para enumerar los proveedores de identidad de una organización.

Campos
parent

string

Obligatorio. La organización y la región superiores 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 recibido de la 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 el que se mostrarán los recursos. Ordena por campos para el resultado.

ListIdentityProvidersResponse

Es el proto 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. El sitio superior, 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 recibido 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 el que se mostrarán las máquinas. De acuerdo con AIP-132, el valor debe ser una lista de campos separados por comas. Se puede agregar un " desc" a un campo para especificar el orden descendente.

Campos admitidos: * name (predeterminado) : Es el nombre canónico del recurso de la máquina.

Ejemplo: "name desc".

ListMachinesResponse

Es la lista de máquinas de un sitio.

Campos
machines[]

Machine

Máquinas 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 de un clúster.

Campos
parent

string

Obligatorio. Es el clúster superior, 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 recibido 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 el que se mostrarán los recursos.

ListNodePoolsResponse

Es la 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.

ListRolesRequest

Es el proto de solicitud para enumerar los roles asociados con un proyecto en una zona.

Campos
parent

string

Obligatorio. Es el nombre canónico de la zona de la que se enumerarán los roles. P.ej., projects/*/locations/*/zones/*

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 recibido de la solicitud de lista anterior.

ListRolesResponse

Es el proto de respuesta para enumerar los roles asociados con un proyecto en una zona.

Campos
roles[]

Role

Es una lista de roles asociados con un proyecto en una zona.

next_page_token

string

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

ListServiceAccountKeysRequest

Es el proto de solicitud para la API de ListServiceAccountKeys.

Campos
parent

string

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

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 recibido de la solicitud de lista anterior.

ListServiceAccountKeysResponse

Es el proto de respuesta para la API de ListServiceAccountKeys.

Campos
service_account_keys[]

ServiceAccountKeyInfo

Es la lista de claves de la cuenta de servicio.

next_page_token

string

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

ServiceAccountKeyInfo

ServiceAccountKeyInfo representa la información de una clave de cuenta de servicio.

Campos
key_id

string

Solo salida. Es el ID de la clave pública.

expiry

string

Solo salida. Es el hora de vencimiento de la clave.

ListServiceAccountsRequest

Solicitud de ListServiceAccounts.

Campos
parent

string

Obligatorio. La ubicación superior, 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 recibido de la 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 el que se mostrarán los recursos. Ordena por campos para el resultado.

ListServiceAccountsResponse

Respuesta de ListServiceAccounts.

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. La ubicación superior, 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 recibido 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 el que se mostrarán los recursos.

ListVpnConnectionsResponse

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

Campos
vpn_connections[]

VpnConnection

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 consumidores de una organización.

Campos
parent

string

Obligatorio. Es la zona superior 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 recibido de la 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 el que se mostrarán los recursos. Ordena por campos para el resultado.

ListZonalProjectsResponse

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

Campos
zonal_projects[]

ZonalProject

Son los clústeres de 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 acceder.

ListZonalServicesRequest

Solicitud para enumerar recursos ZonalService.

Campos
parent

string

Obligatorio. La ubicación superior, 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 recibido de la 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 el que se mostrarán los recursos. Ordena por campos para el resultado.

ListZonalServicesResponse

Respuesta de ListZonalServices.

Campos
zonal_services[]

ZonalService

ZonalServices 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 superior.

Campos
parent

string

Obligatorio. La organización y la ubicación superiores.

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 el que se mostrarán los recursos.

ListZonesResponse

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

Es 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 hora en la que se creó el grupo de nodos.

update_time

Timestamp

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

labels

map<string, string>

Son las etiquetas asociadas con este recurso.

hosted_node

string

Nombre de recurso canónico del nodo que esta máquina es responsable de alojar, p.ej., projects/{project}/locations/{location}/clusters/{cluster_id}/nodePools/{pool_id}/{node}, o 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 se inhabilita, la máquina no podrá 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 La máquina se inhabilitó para su reparación con 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. Exclusiones del mantenimiento automático El mantenimiento que no sea de emergencia no debería realizarse 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 una configuración y una especificación comunes.

Campos
name

string

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

create_time

Timestamp

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

update_time

Timestamp

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

labels

map<string, string>

Son las etiquetas asociadas con 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 podrán unir al grupo de nodos las máquinas que coincidan con este filtro. 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 discos locales Este campo solo se usa cuando se habilita la compatibilidad con CMEK.

node_version

string

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

node_config

NodeConfig

Es opcional. Configuración de cada nodo en el NodePool

LocalDiskEncryption

Configuración de la compatibilidad con CMEK para la encriptación de discos locales de máquinas perimetrales.

Campos
kms_key

string

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

kms_key_active_version

string

Solo salida. Es la CryptoKeyVersion de Cloud KMS que se usa actualmente para proteger los discos locales del nodo. Solo se aplica si se establece 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 propagar si kms_key_state no es KMS_KEY_STATE_KEY_AVAILABLE. Si se completa, este campo contiene el estado de error que informó Cloud KMS.

resource_state

ResourceState

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

NodeConfig

Configuración de cada nodo en el NodePool

Campos
labels

map<string, string>

Es opcional. Las etiquetas de nodo de Kubernetes

node_storage_schema

string

Es opcional. Es el nombre del esquema de almacenamiento de los nodos trabajadores.

node_system_partition_size

SystemPartitionGiBSize

Es opcional. Es el 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 de la entidad emisora del proveedor de identidad.

scopes

string

Obligatorio. Los permisos del proveedor de identidad.

user_claim

string

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

extra_params

string

Es opcional. Es una lista separada por comas de pares clave-valor que se codificarán como consulta 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 de grupo del proveedor de identidad.

attribute_mapping

map<string, string>

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

OperationMetadata

Metadatos de operaciones de larga duración para los métodos de la API de Edge Container.

Campos
create_time

Timestamp

Es la 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

Es el verbo que ejecuta la operación.

status_message

string

Es el estado legible por humanos de la operación, si corresponde.

requested_cancellation

bool

Identifica si el usuario solicitó la cancelación de la operación. Operatio/1.13.0/docs/successfully been cancelled have [Operation.error][] value with a google.rpc.Status.code of 1, corresponding to Code.CANCELLED.

api_version

string

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

warnings[]

string

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

status_reason

StatusReason

Es el estado de la operación legible por máquinas, si corresponde.

public_error

Status

Es una representación de error pública, diseñada para el consumo del cliente. Este campo se completa a partir del error de la operación y es especialmente útil para proporcionar detalles de error más enriquecidos a los clientes cuando el código de error canónico es INTERNAL y el mensaje de error principal se puede limpiar.

StatusReason

Indica el motivo del estado de la operación.

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

Cuota

Representa la cuota de los recursos de Edge Container.

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

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 intervalo de tiempo entre la hora de inicio y la 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.

Rol

Representa un rol de IAM de GDC que corresponde a un rol de K8s en la zona.

Campos
gdc_role

string

Obligatorio. Es el nombre del rol de IAM de GDC.

display_name

string

Es opcional. Es el nombre visible del rol.

state

State

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

Estado

Es el estado del rol en la zona.

Enums
STATE_UNKNOWN Es el valor predeterminado. Este valor se usa si falla la verificación de estado.
READY El rol está presente en la zona.
NOT_READY El rol no está presente en la zona.

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 de 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. La asignación de atributos del proveedor de identidad.

ServerConfig

Configuración del servidor para las versiones y los canales de versiones compatibles.

Campos
channels

map<string, ChannelConfig>

Solo salida. 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. Información de 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. Por ejemplo, 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. La hora en la que se creó la cuenta de servicio del proyecto.

update_time

Timestamp

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

labels

map<string, string>

Es opcional. Son las etiquetas asociadas con 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 BORRANDO.
ERROR La cuenta de servicio está en estado de ERROR.
REPAIRING La cuenta de servicio está en estado REPAIRING.

SetIamPolicyRequest

Es el proto 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. Restringido 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 la 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 se inicia la ventana por primera vez.

end_time

Timestamp

Es la hora en que finaliza el período. La hora de finalización debe ser posterior a la hora 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 del clúster. 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. Restringido 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. Restringido 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 el programa de la actualización.

request_id

string

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

Programa

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 de lanzamiento de la versión.

Campos
version

string

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

available_zones[]

string

Solo salida. Es la 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. Es el nombre del recurso de la conexión de VPN.

create_time

Timestamp

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

update_time

Timestamp

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

labels

map<string, string>

Son las etiquetas asociadas con este recurso.

nat_gateway_ip

string

IP de la puerta de enlace de NAT o dirección IP de WAN Si un cliente tiene varias IP 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

Es el 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 red de la VPC a la que se conectará.

vpc_project

VpcProject

Es opcional. Detalles del proyecto de la red de VPC. Es obligatorio 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 lado del clúster. Si se habilita, cuando se cree la conexión de VPN, intentaremos usar 2 IP flotantes de ANG.

router

string

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

details

Details

Solo salida. Los detalles de la conexión creada.

BgpRoutingMode

Modo de enrutamiento.

Enums
BGP_ROUTING_MODE_UNSPECIFIED Desconocido.
REGIONAL Modo regional.
GLOBAL Modo global.

Detalles

Los detalles de la conexión creada.

Campos
state

State

Es el estado de esta conexión.

error

string

Mensaje de error. Esto solo se propaga cuando state=ERROR.

cloud_router

CloudRouter

Es la información de Cloud Router.

cloud_vpns[]

CloudVpn

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

CloudRouter

Es la información de Cloud Router.

Campos
name

string

Es el nombre del Cloud Router asociado.

CloudVpn

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 actual de la conexión.

Enums
STATE_UNSPECIFIED Desconocido.
STATE_CONNECTED Conectado.
STATE_CONNECTING Aún conectando.
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

Proyecto zonal (correspondiente al proyecto del consumidor de la nube) 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. La hora en la que se actualizó el proyecto por última vez

labels

map<string, string>

Es opcional. Son las etiquetas asociadas con 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.
STATE_ENABLING Se está habilitando el proyecto en la zona.
STATE_REPAIRING Se está reparando el proyecto.
STATE_ERROR Se está inhabilitando el proyecto en la zona.

ZonalService

Se habilitó el servicio 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 service_selector o service_name.

state

State

Solo salida. Es el estado del servicio.

create_time

Timestamp

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

update_time

Timestamp

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

labels

map<string, string>

Es opcional. Son las etiquetas asociadas con este recurso.

Campo de unión zone_or_cluster. 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. Es el nombre completo del servicio, p.ej., alloydb.googleapis.com. Solo se debe especificar service_selector o service_name. Se usará para habilitar o inhabilitar el servicio en el proyecto.

ServiceSelector

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 Bookstore, bookstore.googleapis.com.
VERTEX Servicio de Vertex, aiplatform.googleapis.com.
BOOKSTORE_AI Servicio de 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.
STATE_ERROR El servicio está en estado de ERROR.

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 hora en la que se creó la zona.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas con este recurso.

certificate_authorities[]

string

Solo salida. Es el certificado de la AC web para 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 de 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 de esta zona.

rack_types

map<string, RackType>

El mapa se identifica por el nombre del bastidor y tiene el valor de RackType.

config_data

ConfigData

Son los datos de configuración de la zona.

RackType

Es el tipo de bastidor.

Enums
RACK_TYPE_UNSPECIFIED Tipo de bastidor sin especificar. El bastidor único también pertenece a este tipo.
BASE Tipo de bastidor base, un par de dos bastidores Config-1 modificados que contienen conmutadores de agregación.
EXPANSION Tipo de bastidor de expansión, también conocido como bastidores independientes, que los clientes agregan a pedido.