REST Resource: projects.locations.zones.routers

资源：路由器

描述路由器对象的消息

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
  ]
}
字段
name

string

必需。路由器的规范资源名称。
createTime

string (Timestamp format)

仅限输出。路由器的创建时间。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

仅限输出。路由器上次更新的时间。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
labels

map (key: string, value: string)

与此资源关联的标签。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
description

string

可选。资源的自由文本说明。长度上限为 1024 个字符。
network

string

必需。相应路由器所属网络的规范名称。名称采用 projects/{project}/locations/{location}/zones/{zone}/networks/{network} 格式。
interface[]

object (Interface)

路由器接口。
bgpPeer[]

object (BgpPeer)

BGP 对等方。
bgp

object (Bgp)

特定于此路由器的 BGP 信息。
state

enum (ResourceState)

仅限输出。通过配置推送将资源推送到设备的当前阶段。
routeAdvertisements[]

string

可选。以 IP/长度格式表示的 CIDR 列表，用于将这些 CIDR 作为静态路由从相应路由器向北通告。

接口

路由器接口定义了用于构建 BGP 会话的 GDCE 区域侧第 3 层信息。

JSON 表示法 
{
  "name": string,
  "ipv4Cidr": string,
  "ipv6Cidr": string,
  "linkedInterconnectAttachment": string,
  "subnetwork": string,
  "loopbackIpAddresses": [
    string
  ]
}
字段
name

string

相应界面条目的名称。在 Zones 资源中必须是唯一的。
ipv4Cidr

string

接口的 IP 地址和范围。
ipv6Cidr

string

接口的 IPv6 地址和范围。
linkedInterconnectAttachment

string

关联的互连连接的规范名称。
subnetwork

string

相应接口所属子网资源的规范名称。
loopbackIpAddresses[]

string

在指定时在路由器中创建环回接口。IP 地址的数量必须与 TOR 设备的数量相匹配。

BgpPeer

BGPPeer 定义了用于构建 BGP 会话的对等方第 3 层信息。

JSON 表示法 
{
  "name": string,
  "interface": string,
  "interfaceIpv4Cidr": string,
  "interfaceIpv6Cidr": string,
  "peerIpv4Cidr": string,
  "peerIpv6Cidr": string,
  "peerAsn": integer,
  "localAsn": integer
}
字段
name

string

相应 BGP 对等端的名称。在 Zones 资源中必须是唯一的。
interface

string

与 BGP 对等方关联的 RouterInterface 的名称。
interfaceIpv4Cidr

string

Google 内接口的 IP 范围。
interfaceIpv6Cidr

string

Google 内部接口的 IPv6 范围。
peerIpv4Cidr

string

Google 外部的 BGP 接口的 IP 范围。
peerIpv6Cidr

string

Google 外部的 BGP 接口的 IPv6 范围。
peerAsn

integer (uint32 format)

对等 BGP 自治系统编号 (ASN)。每个 BGP 接口可以使用不同的值。
localAsn

integer (uint32 format)

仅限输出。本地 BGP 自治系统编号 (ASN)。此字段为 ST_NOT_REQUIRED，因为它存储的是专用 ASN，这些 ASN 在其使用区域之外毫无意义。

Bgp

特定于此路由器的 BGP 信息。

JSON 表示法 
{
  "asn": integer,
  "keepaliveIntervalInSeconds": integer
}
字段
asn

integer (uint32 format)

本地分配的 BGP ASN。
keepaliveIntervalInSeconds

integer (uint32 format)

发送到对等端的 BGP keepalive 消息之间的时间间隔（以秒为单位）。默认值为 20，取值范围为 20 到 60。

方法

create

 在给定的项目和位置中创建一个新路由器。

delete

 删除单个路由器。

diagnose

 获取单个路由器资源的诊断信息。

get

 获取单个路由器的详细信息。

list

 列出给定项目和位置中的路由器。

patch

 更新单个路由器的参数。