REST Resource: projects.locations.zones.routers

Recurso: Router

Es el mensaje que describe el objeto Router.

Representación JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "network": string,
  "interface": [
    {
      object (Interface)
    }
  ],
  "bgpPeer": [
    {
      object (BgpPeer)
    }
  ],
  "bgp": {
    object (Bgp)
  },
  "state": enum (ResourceState),
  "routeAdvertisements": [
    string
  ]
}
Campos
name

string

Obligatorio. Es el nombre canónico del recurso del router.

createTime

string (Timestamp format)

Solo salida. Es la hora en la que se creó el router.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

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

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Son las etiquetas asociadas con este recurso.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

description

string

Es opcional. Es una descripción de texto libre del recurso. La longitud máxima es de 1,024 caracteres.

network

string

Obligatorio. Es el nombre canónico de la red a la que pertenece este router. El nombre tiene el formato projects/{project}/locations/{location}/zones/{zone}/networks/{network}.

interface[]

object (Interface)

Interfaces del router.

bgpPeer[]

object (BgpPeer)

Pares de BGP.

bgp

object (Bgp)

Información de BGP específica de este router.

state

enum (ResourceState)

Solo salida. Es la etapa actual del recurso en el dispositivo por envío de configuración.

routeAdvertisements[]

string

Es opcional. Es una lista de CIDR en formato IP/longitud para anunciar hacia el norte como rutas estáticas desde este router.

Interfaz

La interfaz del router define la información de la capa 3 del lado de la zona de GDCE para compilar la sesión de BGP.

Representación JSON
{
  "name": string,
  "ipv4Cidr": string,
  "ipv6Cidr": string,
  "linkedInterconnectAttachment": string,
  "subnetwork": string,
  "loopbackIpAddresses": [
    string
  ]
}
Campos
name

string

Es el nombre de esta entrada de interfaz. Es único dentro del recurso Zones.

ipv4Cidr

string

La dirección IP y el rango de la interfaz.

ipv6Cidr

string

Es la dirección y el rango IPv6 de la interfaz.

linkedInterconnectAttachment

string

Es el nombre canónico del adjunto de interconexión vinculado.

subnetwork

string

Es el nombre canónico del recurso de subred al que pertenece esta interfaz.

loopbackIpAddresses[]

string

Crea una interfaz de bucle invertido en el router cuando se especifique. La cantidad de direcciones IP debe coincidir con la cantidad de dispositivos TOR.

BgpPeer

BGPPeer define la información de la capa 3 del lado del par para compilar la sesión de BGP.

Representación JSON
{
  "name": string,
  "interface": string,
  "interfaceIpv4Cidr": string,
  "interfaceIpv6Cidr": string,
  "peerIpv4Cidr": string,
  "peerIpv6Cidr": string,
  "peerAsn": integer,
  "localAsn": integer
}
Campos
name

string

Es el nombre de este par de BGP. Es único dentro del recurso Zones.

interface

string

Es el nombre de la RouterInterface con la que está asociado el par de BGP.

interfaceIpv4Cidr

string

Es el rango de IP de la interfaz dentro de Google.

interfaceIpv6Cidr

string

Es el rango de IPv6 de la interfaz dentro de Google.

peerIpv4Cidr

string

Es el rango de IP de la interfaz de BGP fuera de Google.

peerIpv6Cidr

string

Es el rango IPv6 de la interfaz de BGP fuera de Google.

peerAsn

integer (uint32 format)

Número de sistema autónomo (ASN) de BGP del par. Cada interfaz de BGP puede usar un valor diferente.

localAsn

integer (uint32 format)

Solo salida. Número de sistema autónomo (ASN) de BGP local. Este campo es ST_NOT_REQUIRED porque almacena ASN privados, que no tienen sentido fuera de la zona en la que se usan.

Bgp

Información de BGP específica de este router.

Representación JSON
{
  "asn": integer,
  "keepaliveIntervalInSeconds": integer
}
Campos
asn

integer (uint32 format)

ASN de BGP asignado de forma local.

keepaliveIntervalInSeconds

integer (uint32 format)

Es el intervalo en segundos entre los mensajes keepalive de BGP que se envían al par. El valor predeterminado es 20, con un valor entre 20 y 60.

Métodos

create

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

delete

Borra un solo router.

diagnose

Obtén los diagnósticos de un solo recurso de router.

get

Obtiene detalles de un solo router.

list

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

patch

Actualiza los parámetros de un solo router.