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 fecha y hora en 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. Fecha y 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 a 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)

Son las interfaces del router.

bgpPeer[]

object (BgpPeer)

Pares de BGP

bgp

object (Bgp)

Es información del BGP específica de este router.

state

enum (ResourceState)

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

routeAdvertisements[]

string

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

Interfaz

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

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

string

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

ipv4Cidr

string

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

ipv6Cidr

string

Dirección IPv6 y rango de la interfaz.

linkedInterconnectAttachment

string

Es el nombre canónico de la adjunto de interconexión vinculada.

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 especifica. La cantidad de direcciones IP debe coincidir con la cantidad de dispositivos TOR.

BgpPeer

BGPPeer define la información de 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 RouterInterface con el que se asocia 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) del BGP del par. Cada interfaz 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 significado fuera de la zona en la que se usan.

Bgp

Es información del BGP específica de este router.

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

integer (uint32 format)

Es el 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 rango entre 20 y 60.

Métodos

create

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

delete

Borra un solo Router.

diagnose

Obtiene el diagnóstico de un solo recurso de router.

get

Obtiene detalles de un solo enrutador.

list

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

patch

Actualiza los parámetros de un solo router.