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 清單，用於從這個路由器向北 advertise 靜態路由。

介面

路由器介面會定義 GDCE 可用區端第 3 層資訊，用於建立 BGP 工作階段。

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 定義了對等互連端第 3 層資訊，用於建立 BGP 工作階段。

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，在使用的區域之外沒有意義。

Bgp

這個路由器專屬的 BGP 資訊。

JSON 表示法 
{
  "asn": integer,
  "keepaliveIntervalInSeconds": integer
}
欄位
asn

integer (uint32 format)

本機指派的 BGP ASN。
keepaliveIntervalInSeconds

integer (uint32 format)

向對等互連傳送 BGP 保持運作訊息的時間間隔 (單位為秒)。預設值為 20，可設定的值介於 20 到 60 之間。

方法

create

 在指定專案和位置建立新的路由器。

delete

 刪除單一路由器。

diagnose

 取得單一路由器資源的診斷資訊。

get

 取得單一路由器的詳細資料。

list

 列出指定專案和位置中的路由器。

patch

 更新單一路由器的參數。