Índice
EdgeContainer(interfaz)Authorization(mensaje)ChannelConfig(mensaje)Cluster(mensaje)Cluster.ConnectionState(mensaje)Cluster.ConnectionState.State(enum)Cluster.ControlPlane(mensaje)Cluster.ControlPlane.Local(mensaje)Cluster.ControlPlane.Remote(mensaje)Cluster.ControlPlane.SharedDeploymentPolicy(enum)Cluster.ControlPlaneEncryption(mensaje)Cluster.ExternalLoadBalancerPool(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)TimeWindow(mensaje)UpdateClusterRequest(mensaje)UpdateNodePoolRequest(mensaje)UpgradeClusterRequest(mensaje)UpgradeClusterRequest.Schedule(enum)Version(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 nuevo NodePool en un proyecto y una ubicación determinados.
|
| CreateVpnConnection |
|---|
|
Crea una conexión de VPN nueva 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 detalles de una sola conexión de VPN.
|
| ListClusters |
|---|
|
Enumera clústeres en una ubicación y un proyecto determinados.
|
| ListMachines |
|---|
|
Enumera las máquinas en una ubicación y un proyecto determinados.
|
| ListNodePools |
|---|
|
Enumera NodePools en una ubicación y un proyecto determinados.
|
| ListVpnConnections |
|---|
|
Enumera las conexiones 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_ |
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_ |
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_ |
Solo salida. Es la fecha y hora en que se creó el clúster. |
update_ |
Solo salida. Fecha y hora en la que se actualizó el clúster por última vez. |
labels |
Son las etiquetas asociadas a 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_ |
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_ |
Solo salida. Es el certificado público de la CA del clúster codificado con PEM. |
maintenance_ |
Es opcional. Es la configuración de la política de mantenimiento de todo el clúster. |
control_ |
Solo salida. Versión de lanzamiento del plano de control |
node_ |
Solo salida. Es la versión de lanzamiento más baja entre todos los nodos trabajadores. Este campo puede estar vacío si el clúster no tiene nodos de trabajador. |
control_ |
Es opcional. Es la configuración del plano de control del clúster. |
system_ |
Es opcional. Es la configuración de los complementos del sistema. |
external_ |
Es opcional. Son grupos de direcciones IPv4 para el balanceo de cargas externo del plano de datos del clúster. |
control_ |
Es opcional. Son opciones de encriptación de disco del plano de control remoto. Este campo solo se usa cuando se habilita la compatibilidad con CMEK. |
status |
Solo salida. Es el estado actual del clúster. |
maintenance_ |
Solo salida. Todos los eventos de mantenimiento programados para el clúster, incluidos los que están en curso, los que se planificaron para el futuro y los que se realizaron en el pasado (hasta 90 días). |
target_ |
Es opcional. Es la versión del clúster de destino. Por ejemplo, “1.5.0”. |
release_ |
Es opcional. Es el canal de versiones al que está suscrito un clúster. |
survivability_ |
Es opcional. Configuración de la capacidad de supervivencia del clúster, p. ej., para el caso en que se pierde la conectividad de red Nota: Esto solo se aplica a los clústeres del plano de control local. |
external_ |
Es opcional. Son grupos de direcciones IPv6 para el balanceo de cargas externo del plano de datos del clúster. |
connection_ |
Solo salida. Es el estado de conexión actual del clúster. |
external_ |
Es opcional. Son los grupos del balanceador de cargas externo para el clúster. |
zone_ |
Es opcional. Es la configuración de encriptación del almacenamiento de la zona. |
ConnectionState
ConnectionState contiene el estado de conexión actual del clúster a Google.
| Campos | |
|---|---|
state |
Solo salida. Es el estado de conexión actual. |
update_ |
Solo salida. Es la fecha y hora en que se cambió el estado de la conexión por última vez. |
Estado
Es el estado de la conexión.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
Estado de conexión desconocido. |
DISCONNECTED |
Actualmente, este clúster está desconectado de Google. |
CONNECTED |
Actualmente, este clúster está conectado a Google. |
CONNECTED_AND_SYNCING |
Actualmente, este clúster está conectado a Google, pero es posible que se haya vuelto a conectar recientemente después de una desconexión. Aún se está sincronizando. |
ControlPlane
Es la configuración del plano de control del clúster.
| Campos | |
|---|---|
Campo de unión
|
|
remote |
Es la configuración del plano de control remoto. |
local |
Es la configuración del plano de control local. Advertencia: Los clústeres de plano de control local se deben crear en su propio proyecto. Los clústeres de plano de control local no pueden coexistir en el mismo proyecto con ningún otro tipo de clústeres, incluidos los que no son de GDCE. Mezclar clústeres de GDCE de plano de control local con cualquier otro tipo de clústeres en el mismo proyecto puede provocar la pérdida de datos. |
Local
Es la configuración específica para los clústeres con un plano de control alojado de forma local.
Advertencia: Los clústeres de plano de control local se deben crear en su propio proyecto. Los clústeres de plano de control local no pueden coexistir en el mismo proyecto con ningún otro tipo de clústeres, incluidos los que no son de GDCE. Mezclar clústeres de GDCE de plano de control local con cualquier otro tipo de clústeres en el mismo proyecto puede provocar la pérdida de datos.
| Campos | |
|---|---|
node_ |
Nombre de las zonas de Google Distributed Cloud Edge en las que se creará este grupo de nodos. Por ejemplo: |
node_ |
Es la cantidad de nodos que funcionarán como réplicas del plano de control. |
machine_ |
Solo se permitirá que las máquinas que coincidan con este filtro alojen nodos del plano de control. El lenguaje de filtrado acepta cadenas como "name= |
shared_ |
Es la configuración de la política sobre cómo se implementan las aplicaciones del usuario. |
control_ |
Es opcional. Nombre del esquema de almacenamiento de los nodos del plano de control. Advertencia: La función de esquema de almacenamiento local del nodo configurable es experimental y no se recomienda para el uso general en clústeres o grupos de nodos de producción. |
Remoto
Este tipo no tiene campos.
Es la configuración específica de los clústeres con un plano de control alojado de forma remota.
ControlPlaneEncryption
Es la configuración de la compatibilidad con la clave de KMS administrada por el cliente para los nodos del plano de control.
| Campos | |
|---|---|
kms_ |
Es opcional. Es la clave criptográfica de Cloud KMS, p.ej., projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, que se usará para proteger los discos del plano de control. Si no se especifica, se usará una clave administrada por Google. |
kms_ |
Solo salida. Es la versión de CryptoKey de Cloud KMS que se usa actualmente para proteger los discos del plano de control. Solo se aplica si se configura kms_key. |
kms_ |
Solo salida. Disponibilidad de la CryptoKey de Cloud KMS. Si no es |
kms_ |
Solo salida. Es el estado de error que devuelve Cloud KMS cuando se usa esta clave. Este campo solo se puede completar si |
resource_ |
Solo salida. Es el estado actual del recurso asociado con la CMEK. |
ExternalLoadBalancerPool
Es un grupo de balanceador de cargas externo con configuración personalizada, como nombre, asignación manual o automática, IPv4 no superpuesta y rango de direcciones IPv6 opcional.
| Campos | |
|---|---|
address_ |
Es opcional. Nombre del grupo del balanceador de cargas externo. |
ipv4_ |
Obligatorio. Es el rango de direcciones IPv4 que no se superponen del grupo de balanceador de cargas externos. |
ipv6_ |
Es opcional. Es el rango de direcciones IPv6 que no se superponen del grupo de balanceador de cargas externos. |
avoid_ |
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_ |
Es opcional. Si es verdadero, las direcciones en este grupo no se asignan automáticamente a los servicios de Kubernetes. Si es verdadero, una dirección IP en este grupo se usa solo cuando un servicio lo especifica de manera explícita. Su valor predeterminado es falso. |
MaintenanceEvent
Un evento de mantenimiento es una operación que podría causar interrupciones temporales en las cargas de trabajo del clúster, incluidas las actualizaciones del clúster iniciadas por Google o por el usuario, los cambios en la configuración del clúster iniciados por el usuario que requieren el reinicio de los nodos, etcétera.
| Campos | |
|---|---|
uuid |
Solo salida. Es el UUID del evento de mantenimiento. |
target_ |
Solo salida. Es la versión de destino del clúster. |
operation |
Solo salida. Operación para ejecutar el evento de mantenimiento. Se especifica en el formato projects/*/locations/*/operations/*. Si el evento de mantenimiento se divide en varias operaciones (p.ej., debido a períodos de mantenimiento), se registra la más reciente. |
type |
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_ |
Solo salida. Es la fecha y hora en que se creó la solicitud del evento de mantenimiento. |
start_ |
Solo salida. Es la fecha y hora en que comenzó el evento de mantenimiento. |
end_ |
Solo salida. Es la fecha y hora en que finalizó el evento de mantenimiento, ya sea que se haya completado correctamente o no. Si el evento de mantenimiento se divide en varios períodos de mantenimiento, end_time solo se actualiza cuando finaliza todo el flujo. |
update_ |
Solo salida. Es la fecha y hora en que se actualizó el mensaje del evento de mantenimiento. |
Programar
Indica cuándo se debe realizar el evento de mantenimiento.
| Enums | |
|---|---|
SCHEDULE_UNSPECIFIED |
Sin especificar. |
IMMEDIATELY |
Inmediatamente después de recibir la solicitud |
Estado
Indica el estado del evento de mantenimiento.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
Sin especificar. |
RECONCILING |
El evento de mantenimiento está en curso. Es posible que el clúster no se pueda usar. |
SUCCEEDED |
El evento de mantenimiento se completó correctamente. |
FAILED |
El evento de mantenimiento falló. |
Tipo
Indica el tipo de evento de mantenimiento.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
Sin especificar. |
USER_INITIATED_UPGRADE |
Actualización iniciada por los usuarios. |
GOOGLE_DRIVEN_UPGRADE |
Actualización impulsada por Google. |
ReleaseChannel
Es el canal de versiones al que está suscrito un clúster.
| Enums | |
|---|---|
RELEASE_CHANNEL_UNSPECIFIED |
Canal de versiones sin especificar. De forma predeterminada, se seleccionará el canal REGULAR. |
NONE |
No hay canal de versiones. |
REGULAR |
Canal de versiones regular. |
Estado
Indica el estado del clúster.
| Enums | |
|---|---|
STATUS_UNSPECIFIED |
Estado desconocido. |
PROVISIONING |
El clúster se está creando. |
RUNNING |
El clúster se creó y se puede usar por completo. |
DELETING |
El clúster se está borrando. |
ERROR |
El estado indica que se produjeron algunos errores durante la conciliación o el borrado del clúster. |
RECONCILING |
El clúster está en proceso de actualización de versión, etc. |
SurvivabilityConfig
Configuración de la capacidad de supervivencia del clúster, p. ej., para el caso en que se pierde la conectividad de red
| Campos | |
|---|---|
offline_ |
Es opcional. Período que permite que los nodos del clúster se reinicien y funcionen sin conectividad de red a Google. El valor predeterminado 0 significa que no se permite. La cantidad máxima es de 7 días. |
SystemAddonsConfig
Es la configuración que los clientes pueden definir para los complementos del sistema de GDCE.
| Campos | |
|---|---|
ingress |
Es opcional. Es la configuración de Ingress. |
vm_ |
Es opcional. Es la configuración del servicio de VM. |
Entrada
Es la configuración del complemento de Ingress que permite a los clientes crear un objeto Ingress para administrar el acceso externo a los servidores de un clúster. El complemento consta de istiod y istio-ingress.
| Campos | |
|---|---|
disabled |
Es opcional. Indica si Ingress está inhabilitado. |
ipv4_ |
Es opcional. Es la VIP de entrada. |
VMServiceConfig
VMServiceConfig define la configuración del servicio de VM de GDCE.
| Campos | |
|---|---|
vmm_ |
Es opcional. Indica si el VMM está habilitado. |
ZoneStorageEncryption
Configuración para la compatibilidad con CMEK de Zone Storage
| Campos | |
|---|---|
kms_ |
Es opcional. La clave de Cloud KMS |
kms_ |
Solo salida. Es la versión de CryptoKey de Cloud KMS que se usa actualmente para la encriptación o desencriptación. |
resource_ |
Solo salida. Estado actual del recurso de CMEK |
ClusterNetworking
Configuración de herramientas de redes de todo el clúster.
| Campos | |
|---|---|
cluster_ |
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_ |
Obligatorio. A todos los servicios del clúster se les asigna una dirección IPv4 RFC1918 de estos bloques. Solo se admite un bloque. No se puede cambiar este campo después de crearlo. |
ClusterUser
Es un principal de usuario para una política de RBAC.
| Campos | |
|---|---|
username |
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_ |
Es la lista de grupos de IP de IPv4 disponibles para el balanceador de cargas externo. |
available_ |
Es la lista de grupos de IP de IPv6 disponibles para el balanceador de cargas externo. |
CreateClusterRequest
Crea un clúster.
| Campos | |
|---|---|
parent |
Obligatorio. Es la ubicación principal en la que se creará este clúster. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
cluster_ |
Obligatorio. Es un identificador único especificado por el cliente para el clúster. |
cluster |
Obligatorio. Es el clúster que se creará. |
request_ |
Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona |
CreateNodePoolRequest
Crea un grupo de nodos.
| Campos | |
|---|---|
parent |
Obligatorio. Es el clúster principal en el que se creará este grupo de nodos. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
node_ |
Obligatorio. Es un identificador único especificado por el cliente para el grupo de nodos. |
node_ |
Obligatorio. Es el grupo de nodos que se creará. |
request_ |
Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona |
CreateVpnConnectionRequest
Crea una conexión de VPN.
| Campos | |
|---|---|
parent |
Obligatorio. Es la ubicación principal en la que se creará esta conexión de VPN. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
vpn_ |
Obligatorio. Es el identificador de la conexión de VPN. |
vpn_ |
Obligatorio. Es la conexión de VPN que se creará. |
request_ |
Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona |
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_ |
Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona |
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_ |
Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona |
DeleteVpnConnectionRequest
Borra una conexión 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_ |
Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona |
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_ |
Solo salida. Token de acceso para autenticarte en api-server de k8s. |
expire_ |
Solo salida. Marca de tiempo en la que vencerá el token. |
GenerateOfflineCredentialRequest
Genera una credencial sin conexión(offline) para un clúster.
| Campos | |
|---|---|
cluster |
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_ |
Solo salida. Certificado de cliente para autenticarse en el servidor de la API de k8s. |
client_ |
Solo salida. Clave privada del cliente para autenticarse en el servidor de la API de k8s. |
user_ |
Solo salida. Identidad del cliente. |
expire_ |
Solo salida. Es la 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. 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 en una ubicación.
| Campos | |
|---|---|
parent |
Obligatorio. Es la ubicación principal, que es propietaria de esta colección de clústeres. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
page_ |
Es la cantidad máxima de recursos que se pueden incluir en la lista. |
page_ |
Es un token de página que se recibió de una solicitud de lista anterior. Es un token de página que se recibió de una solicitud de lista anterior. |
filter |
Solo se mostrarán los recursos que coincidan con este filtro. |
order_ |
Especifica el orden en que se mostrarán los recursos. |
ListClustersResponse
Es una lista de clústeres en una ubicación.
| Campos | |
|---|---|
clusters[] |
Son los clústeres en la ubicación. |
next_ |
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. Es el sitio principal, que es propietario de esta colección de máquinas. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
page_ |
Es la cantidad máxima de recursos que se pueden incluir en la lista. |
page_ |
Es un token de página que se recibió de una solicitud de lista anterior. |
filter |
Solo se mostrarán los recursos que coincidan con este filtro. |
order_ |
Especifica el orden en que se mostrarán los recursos. |
ListMachinesResponse
Es la lista de máquinas en un sitio.
| Campos | |
|---|---|
machines[] |
Son las máquinas que se encuentran en el sitio. |
next_ |
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 en un clúster.
| Campos | |
|---|---|
parent |
Obligatorio. Es el clúster principal, que es propietario de esta colección de grupos de nodos. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
page_ |
Es la cantidad máxima de recursos que se pueden incluir en la lista. |
page_ |
Es un token de página que se recibió de una solicitud de lista anterior. |
filter |
Solo se mostrarán los recursos que coincidan con este filtro. |
order_ |
Especifica el orden en que se mostrarán los recursos. |
ListNodePoolsResponse
Es una lista de grupos de nodos en un clúster.
| Campos | |
|---|---|
node_ |
Son los grupos de nodos del clúster. |
next_ |
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. Es la ubicación principal, que es propietaria de esta colección de conexiones de VPN. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
page_ |
Es la cantidad máxima de recursos que se pueden incluir en la lista. |
page_ |
Es un token de página que se recibió de una solicitud de lista anterior. |
filter |
Solo se mostrarán los recursos que coincidan con este filtro. |
order_ |
Especifica el orden en que se mostrarán los recursos. |
ListVpnConnectionsResponse
Es una lista de las conexiones VPN en una ubicación.
| Campos | |
|---|---|
vpn_ |
Son las VpnConnections en la ubicación. |
next_ |
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_ |
Es el conjunto de zonas de Google Distributed Cloud Edge disponibles en la ubicación. El mapa se indexa con el ID en minúsculas de cada zona. |
Máquina
Una máquina de Google Distributed Cloud Edge capaz de actuar como un nodo de Kubernetes
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso de la máquina. |
create_ |
Solo salida. Es la fecha y hora en que se creó el grupo de nodos. |
update_ |
Solo salida. Fecha y hora en la que se actualizó el grupo de nodos por última vez. |
labels |
Son las etiquetas asociadas a este recurso. |
hosted_ |
Es el nombre canónico del recurso del nodo que esta máquina es responsable de alojar, p.ej., projects/{project}/locations/{location}/clusters/{cluster_id}/nodePools/{pool_id}/{node}, o bien está vacío si la máquina no está asignada para asumir el rol de un nodo. Para los nodos del plano de control alojados en máquinas perimetrales, se devolverá el siguiente formato: "projects/{project}/locations/{location}/clusters/{cluster_id}/controlPlaneNodes/{node}". |
zone |
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 está inhabilitada, la máquina no puede 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 |
Se inhabilitó la máquina para su reparación agregando 1 o más reclamos de inhabilitación. |
MaintenanceExclusionWindow
Representa un período de exclusión de mantenimiento.
| Campos | |
|---|---|
window |
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_ |
Es opcional. Son las exclusiones del mantenimiento automático. El mantenimiento que no sea de emergencia no debe ocurrir en estos períodos. Cada exclusión tiene un nombre único y puede estar activa o vencida. La cantidad máxima de exclusiones de mantenimiento permitidas en un momento determinado es 3. |
MaintenanceWindow
Configuración del período de mantenimiento
| Campos | |
|---|---|
recurring_ |
Es la configuración de un período de mantenimiento recurrente. |
Grupo de nodos
Es un conjunto de nodos de Kubernetes en un clúster con configuración y especificaciones comunes.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso del grupo de nodos. |
create_ |
Solo salida. Es la fecha y hora en que se creó el grupo de nodos. |
update_ |
Solo salida. Fecha y hora en la que se actualizó el grupo de nodos por última vez. |
labels |
Son las etiquetas asociadas a este recurso. |
node_ |
Es el nombre de la zona de Google Distributed Cloud Edge en la que se creará este grupo de nodos. Por ejemplo: |
node_ |
Obligatorio. Es la cantidad de nodos del grupo. |
machine_ |
Solo se permitirá que las máquinas que coincidan con este filtro se unan al grupo de nodos. El lenguaje de filtrado acepta cadenas como "name= |
local_ |
Es opcional. Opciones de encriptación de disco local Este campo solo se usa cuando se habilita la compatibilidad con CMEK. |
node_ |
Solo salida. Es la versión de lanzamiento más baja entre todos los nodos trabajadores. |
node_ |
Es opcional. Es la configuración de cada nodo del NodePool. |
LocalDiskEncryption
Es la configuración de la compatibilidad con CMEK para la encriptación de discos locales de la máquina perimetral.
| Campos | |
|---|---|
kms_ |
Es opcional. Es la CryptoKey de Cloud KMS (p.ej., projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}) que se usará para proteger los discos locales del nodo. Si no se especifica, se usará una clave administrada por Google. |
kms_ |
Solo salida. Es la versión de CryptoKey de Cloud KMS que se usa actualmente para proteger los discos locales del nodo. Solo se aplica si se configura kms_key. |
kms_ |
Solo salida. Disponibilidad de la CryptoKey de Cloud KMS. Si no es |
kms_ |
Solo salida. Es el estado de error que devuelve Cloud KMS cuando se usa esta clave. Este campo solo se puede completar si |
resource_ |
Solo salida. Es el estado actual del recurso asociado con la CMEK. |
NodeConfig
Es la configuración de cada nodo del NodePool.
| Campos | |
|---|---|
labels |
Es opcional. Las etiquetas de nodos de Kubernetes |
node_ |
Es opcional. Nombre del esquema de almacenamiento de los nodos trabajadores. Advertencia: La función de esquema de almacenamiento local del nodo configurable es experimental y no se recomienda para el uso general en clústeres o grupos de nodos de producción. |
OperationMetadata
Son los metadatos de la operación de larga duración para los métodos de la API de Edge Container.
| Campos | |
|---|---|
create_ |
Es la fecha y hora en que se creó la operación. |
end_ |
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 |
Verbo que ejecuta la operación. |
status_ |
Estado legible de la operación, si lo hay. |
requested_ |
Identifica si el usuario solicitó la cancelación de la operación. Las operaciones que se cancelaron de forma correcta tienen el valor [Operation.error][] con un |
api_ |
Versión de la API que se usó para iniciar la operación. |
warnings[] |
Advertencias que no bloquean la operación, pero que contienen información relevante para el usuario final. |
status_ |
Estado de la operación legible por máquina, si lo hay. |
StatusReason
Indica el motivo del estado de la operación.
| Enums | |
|---|---|
STATUS_REASON_UNSPECIFIED |
Motivo desconocido. |
UPGRADE_PAUSED |
Actualmente, la actualización del clúster está en pausa. |
Cuota
Representa la cuota para los recursos de contenedores de Edge.
| 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 |
Es una RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) que indica cómo se repite este período. Se extienden durante el período comprendido entre la hora de inicio y la hora de finalización. |
ResourceState
Representa si el recurso está en estado de bloqueo o pendiente.
| Enums | |
|---|---|
RESOURCE_STATE_UNSPECIFIED |
Valor predeterminado. |
RESOURCE_STATE_LOCK_DOWN |
El recurso está en estado de BLOQUEO. |
RESOURCE_STATE_LOCK_DOWN_PENDING |
El recurso está pendiente de bloqueo. |
ServerConfig
Es la configuración del servidor para las versiones y los canales de versiones compatibles.
| Campos | |
|---|---|
channels |
Solo salida. Es la 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_ |
Solo salida. Versión predeterminada, p.ej.: "1.4.0". |
TimeWindow
Representa un período arbitrario.
| Campos | |
|---|---|
start_ |
Es la hora en la que comienza el período. |
end_ |
Es la fecha y hora en que finaliza el período. La hora de finalización debe ser posterior a la de inicio. |
UpdateClusterRequest
Actualiza un clúster.
| Campos | |
|---|---|
update_ |
La máscara de campo se usa para especificar los campos que la actualización reemplazará en el recurso Cluster. Los campos especificados en update_mask se relacionan con el recurso, no con la solicitud completa. Un campo se reemplazará si está en la máscara. Si el usuario no proporciona una máscara, se reemplazarán todos los campos. |
cluster |
Es el clúster actualizado. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
request_ |
Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona |
UpdateNodePoolRequest
Actualiza un grupo de nodos.
| Campos | |
|---|---|
update_ |
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_ |
Es el grupo de nodos actualizado. La autorización requiere el siguiente permiso de IAM en el recurso especificado
|
request_ |
Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona |
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_ |
Obligatorio. Es la versión a la que se actualizará el clúster. |
schedule |
Es la programación de la actualización. |
request_ |
Es un identificador único para esta solicitud. Se limita a 36 caracteres ASCII. Se recomienda usar un UUID aleatorio. Esta solicitud solo es idempotente si se proporciona |
Programar
Representa el programa de cuándo se actualizará el clúster.
| Enums | |
|---|---|
SCHEDULE_UNSPECIFIED |
Sin especificar. La opción predeterminada es actualizar el clúster de inmediato, que es la única opción disponible actualmente. |
IMMEDIATELY |
El clúster se actualizará inmediatamente después de recibir la solicitud. |
Versión
Es la versión de un clúster.
| Campos | |
|---|---|
name |
Solo salida. Nombre de la versión, p.ej.: "1.4.0". |
VpnConnection
Una conexión de VPN .
| Campos | |
|---|---|
name |
Obligatorio. Nombre del recurso de la conexión de VPN |
create_ |
Solo salida. Es la fecha y hora en que se creó la conexión de VPN. |
update_ |
Solo salida. Fecha y hora en la que se actualizó la conexión de VPN por última vez. |
labels |
Son las etiquetas asociadas a este recurso. |
nat_ |
IP de la puerta de enlace NAT o dirección IP de WAN Si un cliente tiene varias IPs de NAT, debe configurar la NAT de modo que solo una IP externa se asigne al clúster de Anthos de GMEC. Este campo está vacío si no se usa NAT. |
bgp_routing_mode |
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 la red de VPC a la que se conectará. |
vpc_ |
Es opcional. Detalles del proyecto de la red de VPC. Se requiere si la VPC se encuentra en un proyecto diferente del proyecto del clúster. |
enable_ |
Indica si esta conexión de VPN tiene habilitada la alta disponibilidad en el clúster. Si está habilitada, cuando se cree la conexión de VPN, intentaremos usar 2 IPs flotantes de ANG. |
router |
Es opcional. Es el nombre del Cloud Router de la conexión de VPN. |
details |
Solo salida. Son los detalles de la conexión creada. |
BgpRoutingMode
Modo de enrutamiento.
| Enums | |
|---|---|
BGP_ROUTING_MODE_UNSPECIFIED |
Desconocido. |
REGIONAL |
Modo regional. |
GLOBAL |
Modo global |
Detalles
Son los detalles de la conexión creada.
| Campos | |
|---|---|
state |
Es el estado de esta conexión. |
error |
Mensaje de error. Este campo solo se propaga cuando state=ERROR. |
cloud_ |
Es la información del Cloud Router. |
cloud_ |
Cada conexión tiene varias puertas de enlace de Cloud VPN. |
CloudRouter
Es la información del Cloud Router.
| Campos | |
|---|---|
name |
Es el nombre del Cloud Router asociado. |
CloudVpn
Es la información de Cloud VPN.
| Campos | |
|---|---|
gateway |
Es el nombre de la puerta de enlace de Cloud VPN creada. |
Estado
Es el estado de conexión actual.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
Desconocido. |
STATE_CONNECTED |
Conectado. |
STATE_CONNECTING |
Aún conectándose. |
STATE_ERROR |
Se produjo un error. |
VpcProject
Detalles del proyecto de la red de VPC.
| Campos | |
|---|---|
project_ |
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 en esta zona. |
rack_ |
Es el mapa que se codifica según el nombre del rack y tiene el valor de RackType. |
config_ |
Son los datos de configuración de la zona. |
RackType
Es el tipo de estructura.
| Enums | |
|---|---|
RACK_TYPE_UNSPECIFIED |
Tipo de estructura no especificado. Las estructuras individuales también pertenecen a este tipo. |
BASE |
Tipo de rack base, un par de dos racks Config-1 modificados que contienen conmutadores de agregación. |
EXPANSION |
Tipo de estructura de expansión, también conocidas como estructuras independientes, que los clientes agregan a pedido. |