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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 列表，用于将此路由器中的静态路由向北通告。

接口

路由器接口定义了用于构建 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

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

delete

 删除单个 Router。

diagnose

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

get

 获取单个 Router 的详细信息。

list

 列出给定项目和位置中的 Router。

patch

 更新单个 Router 的参数。