Índice
EdgeContainer(interfaz)Authorization(mensaje)ChannelConfig(mensaje)Cluster(mensaje)Cluster.ConnectionState(mensaje)Cluster.ConnectionState.State(enum)Cluster.ContainerRuntimeConfig(mensaje)Cluster.ContainerRuntimeConfig.DefaultContainerRuntime(enum)Cluster.ControlPlane(mensaje)Cluster.ControlPlane.Local(mensaje)Cluster.ControlPlane.Remote(mensaje)Cluster.ControlPlane.SharedDeploymentPolicy(enum)Cluster.ControlPlaneEncryption(mensaje)Cluster.ExternalLoadBalancerPool(mensaje)Cluster.GoogleGroupAuthenticationConfig(mensaje)Cluster.MaintenanceEvent(mensaje)Cluster.MaintenanceEvent.Schedule(enum)Cluster.MaintenanceEvent.State(enum)Cluster.MaintenanceEvent.Type(enum)Cluster.ReleaseChannel(enum)Cluster.Status(enum)Cluster.SurvivabilityConfig(mensaje)Cluster.SystemAddonsConfig(mensaje)Cluster.SystemAddonsConfig.Ingress(mensaje)Cluster.SystemAddonsConfig.VMServiceConfig(mensaje)Cluster.ZoneStorageEncryption(mensaje)ClusterNetworking(mensaje)ClusterUser(mensaje)ConfigData(mensaje)CreateClusterRequest(mensaje)CreateNodePoolRequest(mensaje)CreateVpnConnectionRequest(mensaje)DeleteClusterRequest(mensaje)DeleteNodePoolRequest(mensaje)DeleteVpnConnectionRequest(mensaje)Fleet(mensaje)GenerateAccessTokenRequest(mensaje)GenerateAccessTokenResponse(mensaje)GenerateOfflineCredentialRequest(mensaje)GenerateOfflineCredentialResponse(mensaje)GetClusterRequest(mensaje)GetMachineRequest(mensaje)GetNodePoolRequest(mensaje)GetServerConfigRequest(mensaje)GetVpnConnectionRequest(mensaje)KmsKeyState(enum)ListClustersRequest(mensaje)ListClustersResponse(mensaje)ListMachinesRequest(mensaje)ListMachinesResponse(mensaje)ListNodePoolsRequest(mensaje)ListNodePoolsResponse(mensaje)ListVpnConnectionsRequest(mensaje)ListVpnConnectionsResponse(mensaje)LocationMetadata(mensaje)Machine(mensaje)Machine.Purpose(enum)Machine.Status(enum)MaintenanceExclusionWindow(mensaje)MaintenancePolicy(mensaje)MaintenanceWindow(mensaje)NodePool(mensaje)NodePool.LocalDiskEncryption(mensaje)NodePool.NodeConfig(mensaje)OperationMetadata(mensaje)OperationMetadata.StatusReason(enum)Quota(mensaje)RecurringTimeWindow(mensaje)ResourceState(enum)ServerConfig(mensaje)SystemPartitionGiBSize(enum)TimeWindow(mensaje)UpdateClusterRequest(mensaje)UpdateNodePoolRequest(mensaje)UpgradeClusterRequest(mensaje)UpgradeClusterRequest.Schedule(enum)Version(mensaje)VersionRollout(mensaje)VpnConnection(mensaje)VpnConnection.BgpRoutingMode(enum)VpnConnection.Details(mensaje)VpnConnection.Details.CloudRouter(mensaje)VpnConnection.Details.CloudVpn(mensaje)VpnConnection.Details.State(enum)VpnConnection.VpcProject(mensaje)ZoneMetadata(mensaje)ZoneMetadata.RackType(enum)
EdgeContainer
La API de EdgeContainer proporciona administración de clústeres de Kubernetes en implementaciones de Google Edge Cloud.
| CreateCluster |
|---|
|
Crea un clúster nuevo en un proyecto y una ubicación determinados.
|
| CreateNodePool |
|---|
|
Crea un NodePool nuevo en un proyecto y una ubicación determinados.
|
| CreateVpnConnection |
|---|
|
Crea una nueva conexión de VPN en un proyecto y una ubicación determinados.
|
| DeleteCluster |
|---|
|
Borra un solo clúster.
|
| DeleteNodePool |
|---|
|
Borra un solo NodePool.
|
| DeleteVpnConnection |
|---|
|
Borra una sola conexión de VPN.
|
| GenerateAccessToken |
|---|
|
Genera un token de acceso para un clúster.
|
| GenerateOfflineCredential |
|---|
|
Genera una credencial sin conexión para un clúster.
|
| GetCluster |
|---|
|
Obtiene detalles de un solo clúster.
|
| GetMachine |
|---|
|
Obtiene detalles de una sola máquina.
|
| GetNodePool |
|---|
|
Obtiene detalles de un solo NodePool.
|
| GetServerConfig |
|---|
|
Obtiene la configuración del servidor.
|
| GetVpnConnection |
|---|
|
Obtiene los detalles de una sola conexión de VPN.
|
| ListClusters |
|---|
|
Enumera los clústeres en una ubicación y un proyecto determinados.
|
| ListMachines |
|---|
|
Enumera las máquinas de un proyecto y una ubicación determinados.
|
| ListNodePools |
|---|
|
Enumera los NodePools en una ubicación y un proyecto determinados.
|
| ListVpnConnections |
|---|
|
Enumera las conexiones de VPN en una ubicación y un proyecto determinados.
|
| UpdateCluster |
|---|
|
Actualiza los parámetros de un solo clúster.
|
| UpdateNodePool |
|---|
|
Actualiza los parámetros de un solo NodePool.
|
| UpgradeCluster |
|---|
|
Actualiza un solo clúster.
|
Autorización
Es la política de RBAC que aplicará y administrará GEC.
| Campos | |
|---|---|
admin_users |
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 |
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 |
Obligatorio. Es el nombre del recurso del clúster. |
create_time |
Solo salida. Es la hora en la que se creó el clúster. |
update_time |
Solo salida. La hora en la que se actualizó el clúster por última vez. |
labels |
Son las etiquetas asociadas con este recurso. |
fleet |
Obligatorio. Configuración de la flota. |
networking |
Obligatorio. Configuración de herramientas de redes de todo el clúster. |
authorization |
Obligatorio. Inmutable. Es la política de RBAC que aplicará y administrará GEC. |
default_max_pods_per_node |
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 |
Solo salida. Es la dirección IP del servidor de la API de Kubernetes. |
port |
Solo salida. Es el número de puerto del servidor de la API de Kubernetes. |
cluster_ca_certificate |
Solo salida. Es el certificado público codificado con PEM de la AC del clúster. |
maintenance_policy |
Es opcional. Configuración de la política de mantenimiento de todo el clúster. |
control_plane_version |
Solo salida. La versión de actualización del plano de control |
node_version |
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 |
Es opcional. Es la configuración del plano de control del clúster. |
system_addons_config |
Es opcional. Es la configuración de los complementos del sistema. |
external_load_balancer_ipv4_address_pools[] |
Es opcional. Son los grupos de direcciones IPv4 para el balanceo de cargas externo del plano de datos del clúster. |
control_plane_encryption |
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 |
Solo salida. Es el estado actual del clúster. |
maintenance_events[] |
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 |
Es opcional. Es la versión de destino del clúster. Por ejemplo: "1.5.0". |
release_channel |
Es opcional. Es el canal de versiones al que está suscrito un clúster. |
survivability_config |
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[] |
Es opcional. Grupos de direcciones IPv6 para el balanceo de cargas externo del plano de datos del clúster. |
connection_state |
Solo salida. Es el estado de conexión actual del clúster. |
external_load_balancer_address_pools[] |
Es opcional. Grupos de balanceador de cargas externos para el clúster. |
zone_storage_encryption |
Es opcional. La configuración de encriptación del almacenamiento de la zona |
container_runtime_config |
Es opcional. Es la configuración del entorno de ejecución del contenedor del clúster. |
enable_remote_backup |
Es opcional. Si es verdadero, se habilitará la función de copia de seguridad y restablecimiento remotos para este clúster. |
enable_cluster_isolation |
Es opcional. Esto indica si es necesario aislar el clúster. go/cluster-isolation-in-gdcc-cluster |
google_group_authentication |
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 |
Solo salida. Es el estado actual de la conexión. |
update_time |
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 |
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
|
|
remote |
Configuración del plano de control remoto. |
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 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. |
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 |
Es el nombre de las zonas de Google Distributed Cloud Edge en las que se creará este grupo de nodos. Por ejemplo: |
node_count |
Es la cantidad de nodos que se usarán como réplicas del plano de control. |
machine_filter |
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= |
shared_deployment_policy |
Es la configuración de la política sobre cómo se implementan las aplicaciones de los usuarios. |
control_plane_node_storage_schema |
Es opcional. Es el nombre del esquema de almacenamiento de los nodos del plano de control. |
control_plane_node_system_partition_size |
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.
ControlPlaneEncryption
Configuración de la compatibilidad con claves de KMS administradas por el cliente para los nodos del plano de control.
| Campos | |
|---|---|
kms_key |
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 |
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 |
Solo salida. Disponibilidad de la CryptoKey de Cloud KMS. Si no es |
kms_status |
Solo salida. Es el estado de error que devuelve Cloud KMS cuando se usa esta clave. Este campo solo se puede propagar si |
resource_state |
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 |
Es opcional. Es el nombre del grupo de balanceador de cargas externos. |
ipv4_range[] |
Obligatorio. Es el rango de direcciones IPv4 que no se superpone del grupo de balanceador de cargas externos. |
ipv6_range[] |
Es opcional. Rango de direcciones IPv6 que no se superpone del grupo de balanceador de cargas externos. |
avoid_buggy_ips |
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 |
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 |
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 |
Solo salida. UUID del evento de mantenimiento. |
target_version |
Solo salida. Es la versión de destino del clúster. |
operation |
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 |
Solo salida. Es el tipo de evento de mantenimiento. |
schedule |
Solo salida. Es el programa del evento de mantenimiento. |
state |
Solo salida. Es el estado del evento de mantenimiento. |
create_time |
Solo salida. Es la hora en la que se creó la solicitud de evento de mantenimiento. |
start_time |
Solo salida. Es la hora en la que comenzó el evento de mantenimiento. |
end_time |
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 |
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 |
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 |
Es opcional. Configuración para Ingress. |
vm_service_config |
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 |
Es opcional. Indica si Ingress está inhabilitado. |
ipv4_vip |
Es opcional. VIP de Ingress. |
VMServiceConfig
VMServiceConfig define la configuración del servicio de VM de GDCE.
| Campos | |
|---|---|
vmm_enabled |
Es opcional. Indica si VMM está habilitado. |
ZoneStorageEncryption
Configuración de la compatibilidad con CMEK para el almacenamiento zonal
| Campos | |
|---|---|
kms_key |
Es opcional. La clave de Cloud KMS |
kms_key_active_version |
Solo salida. La CryptoKeyVersion de Cloud KMS que se usa actualmente para la encriptación y desencriptación |
resource_state |
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[] |
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[] |
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 |
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[] |
lista de grupos de IP v4 disponibles para el balanceador de cargas externo |
available_external_lb_pools_ipv6[] |
lista de grupos de IP v6 disponibles para el balanceador de cargas externo |
CreateClusterRequest
Crea un clúster.
| Campos | |
|---|---|
parent |
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
|
cluster_id |
Obligatorio. Es un identificador único especificado por el cliente para el clúster. |
cluster |
Obligatorio. Es el clúster que se creará. |
request_id |
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 |
CreateNodePoolRequest
Crea un grupo de nodos.
| Campos | |
|---|---|
parent |
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
|
node_pool_id |
Obligatorio. Es un identificador único especificado por el cliente para el grupo de nodos. |
node_pool |
Obligatorio. Es el grupo de nodos que se creará. |
request_id |
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 |
CreateVpnConnectionRequest
Crea una conexión de VPN.
| Campos | |
|---|---|
parent |
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
|
vpn_connection_id |
Obligatorio. Es el identificador de la conexión de VPN. |
vpn_connection |
Obligatorio. Es la conexión de VPN que se creará. |
request_id |
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 |
DeleteClusterRequest
Borra un clúster.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso del clúster. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
request_id |
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 |
DeleteNodePoolRequest
Borra un grupo de nodos.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso del grupo de nodos. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
request_id |
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 |
DeleteVpnConnectionRequest
Borra una conexión de VPN.
| Campos | |
|---|---|
name |
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
|
request_id |
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 |
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 |
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 |
membership |
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 |
GenerateAccessTokenRequest
Genera un token de acceso para un clúster.
| Campos | |
|---|---|
cluster |
Obligatorio. Es el nombre del recurso del clúster. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
GenerateAccessTokenResponse
Es un token de acceso para un clúster.
| Campos | |
|---|---|
access_token |
Solo salida. Token de acceso para autenticarte en api-server de k8s. |
expire_time |
Solo salida. Marca de tiempo en la que vencerá el token. |
GenerateOfflineCredentialRequest
Genera una credencial sin conexión para un clúster.
| Campos | |
|---|---|
cluster |
Obligatorio. Es el nombre del recurso del clúster. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
GenerateOfflineCredentialResponse
Es una credencial sin conexión para un clúster.
| Campos | |
|---|---|
client_certificate |
Solo salida. Certificado de cliente para autenticarte en api-server de k8s. |
client_key |
Solo salida. Clave privada del cliente para autenticarse en api-server de k8s. |
user_id |
Solo salida. Identidad del cliente. |
expire_time |
Solo salida. Marca de tiempo en la que vencerá esta credencial. |
GetClusterRequest
Obtiene un clúster.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso del clúster. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
GetMachineRequest
Obtiene una máquina.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso de la máquina. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
GetNodePoolRequest
Obtiene un grupo de nodos.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso del grupo de nodos. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
GetServerConfigRequest
Obtiene la configuración del servidor.
| Campos | |
|---|---|
name |
Obligatorio. El nombre (proyecto y ubicación) de la configuración del servidor que se obtendrá, especificado en el formato La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
GetVpnConnectionRequest
Obtiene una conexión de VPN.
| Campos | |
|---|---|
name |
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
|
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. |
ListClustersRequest
Enumera los clústeres de una ubicación.
| Campos | |
|---|---|
parent |
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
|
page_size |
Es la cantidad máxima de recursos que se pueden incluir en la lista. |
page_token |
Es un token de página recibido de la solicitud de lista anterior. Es un token de página recibido de la solicitud de lista anterior. |
filter |
Solo se mostrarán los recursos que coincidan con este filtro. |
order_by |
Especifica el orden en el que se mostrarán los recursos. |
ListClustersResponse
Lista de clústeres en una ubicación.
| Campos | |
|---|---|
clusters[] |
Son los clústeres de la ubicación. |
next_page_token |
Un token para recuperar la siguiente página de resultados. |
unreachable[] |
Ubicaciones a las que no se pudo llegar. |
ListMachinesRequest
Enumera las máquinas de un sitio.
| Campos | |
|---|---|
parent |
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
|
page_size |
Es la cantidad máxima de recursos que se pueden incluir en la lista. |
page_token |
Es un token de página recibido de la solicitud de lista anterior. |
filter |
Solo se mostrarán los recursos que coincidan con este filtro. |
order_by |
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: * Ejemplo: "name desc". |
ListMachinesResponse
Es la lista de máquinas de un sitio.
| Campos | |
|---|---|
machines[] |
Máquinas en el sitio. |
next_page_token |
Un token para recuperar la siguiente página de resultados. |
unreachable[] |
Ubicaciones a las que no se pudo llegar. |
ListNodePoolsRequest
Enumera los grupos de nodos de un clúster.
| Campos | |
|---|---|
parent |
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
|
page_size |
Es la cantidad máxima de recursos que se pueden incluir en la lista. |
page_token |
Es un token de página recibido de la solicitud de lista anterior. |
filter |
Solo se mostrarán los recursos que coincidan con este filtro. |
order_by |
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[] |
Son los grupos de nodos del clúster. |
next_page_token |
Un token para recuperar la siguiente página de resultados. |
unreachable[] |
Ubicaciones a las que no se pudo llegar. |
ListVpnConnectionsRequest
Enumera las conexiones de VPN.
| Campos | |
|---|---|
parent |
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
|
page_size |
Es la cantidad máxima de recursos que se pueden incluir en la lista. |
page_token |
Es un token de página recibido de la solicitud de lista anterior. |
filter |
Solo se mostrarán los recursos que coincidan con este filtro. |
order_by |
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[] |
VpnConnections en la ubicación. |
next_page_token |
Un token para recuperar la siguiente página de resultados. |
unreachable[] |
Ubicaciones a las que no se pudo llegar. |
LocationMetadata
Son los metadatos de un google.cloud.location.Location determinado.
| Campos | |
|---|---|
available_zones |
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 |
Obligatorio. Es el nombre del recurso de la máquina. |
create_time |
Solo salida. Es la hora en la que se creó el grupo de nodos. |
update_time |
Solo salida. La hora en la que se actualizó el grupo de nodos por última vez. |
labels |
Son las etiquetas asociadas con este recurso. |
hosted_node |
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 |
Es la zona de Google Distributed Cloud Edge de esta máquina. |
version |
Solo salida. Es la versión de software de la máquina. |
disabled |
Solo salida. Indica si la máquina está inhabilitada. Si se inhabilita, la máquina no podrá entrar en servicio. |
status |
Solo salida. Es el estado actual de la máquina. |
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 |
Es opcional. Es el período. |
id |
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 |
Especifica el período de mantenimiento en el que se puede realizar el mantenimiento. |
maintenance_exclusions[] |
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 |
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 |
Obligatorio. Es el nombre del recurso del grupo de nodos. |
create_time |
Solo salida. Es la hora en la que se creó el grupo de nodos. |
update_time |
Solo salida. La hora en la que se actualizó el grupo de nodos por última vez. |
labels |
Son las etiquetas asociadas con este recurso. |
node_location |
Es el nombre de la zona de Google Distributed Cloud Edge en la que se creará este grupo de nodos. Por ejemplo: |
node_count |
Obligatorio. Es la cantidad de nodos del grupo. |
machine_filter |
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= |
local_disk_encryption |
Es opcional. Opciones de encriptación de discos locales Este campo solo se usa cuando se habilita la compatibilidad con CMEK. |
node_version |
Solo salida. Es la versión de actualización más baja entre todos los nodos trabajadores. |
node_config |
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 |
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 |
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 |
Solo salida. Disponibilidad de la CryptoKey de Cloud KMS. Si no es |
kms_status |
Solo salida. Es el estado de error que devuelve Cloud KMS cuando se usa esta clave. Este campo solo se puede propagar si |
resource_state |
Solo salida. Es el estado actual del recurso asociado a la CMEK. |
NodeConfig
Configuración de cada nodo en el NodePool
| Campos | |
|---|---|
labels |
Es opcional. Las etiquetas de nodo de Kubernetes |
node_storage_schema |
Es opcional. Es el nombre del esquema de almacenamiento de los nodos trabajadores. |
node_system_partition_size |
Es opcional. Es el tamaño de la partición del sistema para los nodos trabajadores en GiB. |
OperationMetadata
Metadatos de operaciones de larga duración para los métodos de la API de Edge Container.
| Campos | |
|---|---|
create_time |
Es la hora en que se creó la operación. |
end_time |
Es la hora a la que finalizó la operación. |
target |
Es la ruta de acceso al recurso definida por el servidor para el destino de la operación. |
verb |
Es el verbo que ejecuta la operación. |
status_message |
Es el estado legible por humanos de la operación, si corresponde. |
requested_cancellation |
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 |
api_version |
Es la versión de la API que se usó para iniciar la operación. |
warnings[] |
Son advertencias que no bloquean la operación, pero que contienen información relevante para que la reciba el usuario final. |
status_reason |
Es el estado de la operación legible por máquinas, si corresponde. |
public_error |
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 |
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 |
Es el nombre de la métrica de cuota. |
limit |
Es el límite de cuota para esta métrica. |
usage |
Es el uso actual de esta métrica. |
RecurringTimeWindow
Representa un período arbitrario que se repite.
| Campos | |
|---|---|
window |
Es el período de la primera recurrencia. |
recurrence |
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. |
ServerConfig
Configuración del servidor para las versiones y los canales de versiones compatibles.
| Campos | |
|---|---|
channels |
Solo salida. Asignación del canal de versiones a la configuración del canal. |
versions[] |
Solo salida. Versiones compatibles, p.ej.: ["1.4.0", "1.5.0"]. |
default_version |
Solo salida. Versión predeterminada, p.ej.: "1.4.0". |
version_rollouts[] |
Solo salida. Información de lanzamiento de la configuración del servidor. |
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 |
Es la hora en la que se inicia la ventana por primera vez. |
end_time |
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 |
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 |
Es el clúster actualizado. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
request_id |
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 |
UpdateNodePoolRequest
Actualiza un grupo de nodos.
| Campos | |
|---|---|
update_mask |
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 |
Es el grupo de nodos actualizado. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
request_id |
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 |
UpgradeClusterRequest
Actualiza un clúster.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso del clúster. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
target_version |
Obligatorio. Es la versión a la que se actualizará el clúster. |
schedule |
Es el programa de la actualización. |
request_id |
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 |
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 |
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 |
Solo salida. Versión semántica, p.ej.: "1.4.0". |
available_zones[] |
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 |
Obligatorio. Es el nombre del recurso de la conexión de VPN. |
create_time |
Solo salida. Es la hora en la que se creó la conexión de VPN. |
update_time |
Solo salida. Es la hora en la que se actualizó la conexión de VPN por última vez. |
labels |
Son las etiquetas asociadas con este recurso. |
nat_gateway_ip |
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 |
Es el modo de enrutamiento dinámico de la red de VPC, |
cluster |
Es el nombre canónico del clúster al que se conectará. Tiene el formato projects/{project}/locations/{location}/clusters/{cluster}. |
vpc |
Es el ID de red de la VPC a la que se conectará. |
vpc_project |
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 |
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 |
Es opcional. Es el nombre del Cloud Router de la conexión de VPN. |
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 |
Es el estado de esta conexión. |
error |
Mensaje de error. Esto solo se propaga cuando state=ERROR. |
cloud_router |
Es la información de Cloud Router. |
cloud_vpns[] |
Cada conexión tiene varias puertas de enlace de Cloud VPN. |
CloudRouter
Es la información de Cloud Router.
| Campos | |
|---|---|
name |
Es el nombre del Cloud Router asociado. |
CloudVpn
La información de Cloud VPN.
| Campos | |
|---|---|
gateway |
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 |
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 |
Es opcional. Obsoleto: No usar. |
ZoneMetadata
Es una zona de Google Distributed Cloud Edge en la que se encuentran las máquinas perimetrales.
| Campos | |
|---|---|
quota[] |
Es la cuota para los recursos de esta zona. |
rack_types |
El mapa se identifica por el nombre del bastidor y tiene el valor de RackType. |
config_data |
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. |