Package google.cloud.edgenetwork.v1

索引

EdgeNetwork

EdgeNetwork API 提供代管的高可用性雲端動態網路設定服務，可讓 GEC 客戶啟用邊緣應用程式和網路功能解決方案。這樣一來，客戶就能輕鬆定義及設定網路和屬性，滿足工作負載需求。

CreateInterconnectAttachment

rpc CreateInterconnectAttachment(CreateInterconnectAttachmentRequest) returns (Operation)

在指定專案和位置建立新的 InterconnectAttachment。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
CreateNetwork

rpc CreateNetwork(CreateNetworkRequest) returns (Operation)

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

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
CreateRouter

rpc CreateRouter(CreateRouterRequest) returns (Operation)

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

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
CreateSubnet

rpc CreateSubnet(CreateSubnetRequest) returns (Operation)

在指定專案和位置建立新的子網路。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
DeleteInterconnectAttachment

rpc DeleteInterconnectAttachment(DeleteInterconnectAttachmentRequest) returns (Operation)

刪除單一 InterconnectAttachment。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
DeleteNetwork

rpc DeleteNetwork(DeleteNetworkRequest) returns (Operation)

刪除單一網路。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
DeleteRouter

rpc DeleteRouter(DeleteRouterRequest) returns (Operation)

刪除單一路由器。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
DeleteSubnet

rpc DeleteSubnet(DeleteSubnetRequest) returns (Operation)

刪除單一子網路。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
DiagnoseInterconnect

rpc DiagnoseInterconnect(DiagnoseInterconnectRequest) returns (DiagnoseInterconnectResponse)

取得單一互連網路資源的診斷資訊。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
DiagnoseNetwork

rpc DiagnoseNetwork(DiagnoseNetworkRequest) returns (DiagnoseNetworkResponse)

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

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
DiagnoseRouter

rpc DiagnoseRouter(DiagnoseRouterRequest) returns (DiagnoseRouterResponse)

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

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
GetInterconnect

rpc GetInterconnect(GetInterconnectRequest) returns (Interconnect)

取得單一互連網路的詳細資料。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
GetInterconnectAttachment

rpc GetInterconnectAttachment(GetInterconnectAttachmentRequest) returns (InterconnectAttachment)

取得單一 InterconnectAttachment 的詳細資料。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
GetNetwork

rpc GetNetwork(GetNetworkRequest) returns (Network)

取得單一網路的詳細資料。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
GetRouter

rpc GetRouter(GetRouterRequest) returns (Router)

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

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
GetSubnet

rpc GetSubnet(GetSubnetRequest) returns (Subnet)

取得單一子網路的詳細資料。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
GetZone

rpc GetZone(GetZoneRequest) returns (Zone)

已淘汰：未實作。取得單一可用區的詳細資料。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
InitializeZone

rpc InitializeZone(InitializeZoneRequest) returns (InitializeZoneResponse)

InitializeZone 會初始化專案中可用區的資源。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
ListInterconnectAttachments

rpc ListInterconnectAttachments(ListInterconnectAttachmentsRequest) returns (ListInterconnectAttachmentsResponse)

列出指定專案和位置中的 InterconnectAttachment。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
ListInterconnects

rpc ListInterconnects(ListInterconnectsRequest) returns (ListInterconnectsResponse)

列出指定專案和位置中的互連網路。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
ListNetworks

rpc ListNetworks(ListNetworksRequest) returns (ListNetworksResponse)

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

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
ListRouters

rpc ListRouters(ListRoutersRequest) returns (ListRoutersResponse)

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

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
ListSubnets

rpc ListSubnets(ListSubnetsRequest) returns (ListSubnetsResponse)

列出指定專案和位置中的子網路。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
ListZones

rpc ListZones(ListZonesRequest) returns (ListZonesResponse)

已淘汰：未實作。列出指定專案和位置中的可用區。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
UpdateRouter

rpc UpdateRouter(UpdateRouterRequest) returns (Operation)

更新單一路由器的參數。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。
UpdateSubnet

rpc UpdateSubnet(UpdateSubnetRequest) returns (Operation)

更新單一子網路的參數。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。

CreateInterconnectAttachmentRequest

建立 InterconnectAttachment 的訊息

欄位
parent

string

這是必要旗標，上層的值。
interconnect_attachment_id

string

這是必要旗標，要求物件的 ID。如果是在伺服器端自動生成 ID，請從 Create RPC 的 method_signature 移除這個欄位和 interconnect_attachment_id
interconnect_attachment

InterconnectAttachment

這是必要旗標，正在建立的資源
request_id

string

選用。選用的要求 ID，用於識別要求。請指定專屬要求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證從第一次要求起至少 60 分鐘內有效。

舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同的要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果是，則會忽略第二個要求。避免客戶不小心建立重複的承諾使用合約。

要求 ID 必須是有效的 UUID，但不得為零 UUID (00000000-0000-0000-0000-000000000000)。

CreateNetworkRequest

建立網路的訊息

欄位
parent

string

這是必要旗標，上層的值。
network_id

string

這是必要旗標，要求物件的 ID。如果是在伺服器端自動生成 ID，請從 Create RPC 的 method_signature 移除這個欄位和 network_id
network

Network

這是必要旗標，正在建立的資源
request_id

string

選用。選用的要求 ID，用於識別要求。請指定專屬要求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證從第一次要求起至少 60 分鐘內有效。

舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同的要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果是，則會忽略第二個要求。避免客戶不小心建立重複的承諾使用合約。

要求 ID 必須是有效的 UUID，但不得為零 UUID (00000000-0000-0000-0000-000000000000)。

CreateRouterRequest

建立路由器的訊息

欄位
parent

string

這是必要旗標，上層的值。
router_id

string

這是必要旗標，要求物件的 ID。如果是在伺服器端自動生成 ID，請從 Create RPC 的 method_signature 移除這個欄位和 router_id
router

Router

這是必要旗標，正在建立的資源
request_id

string

選用。選用的要求 ID，用於識別要求。請指定專屬要求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證從第一次要求起至少 60 分鐘內有效。

舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同的要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果是，則會忽略第二個要求。避免客戶不小心建立重複的承諾使用合約。

要求 ID 必須是有效的 UUID，但不得為零 UUID (00000000-0000-0000-0000-000000000000)。

CreateSubnetRequest

建立子網路的訊息

欄位
parent

string

這是必要旗標，上層的值。
subnet_id

string

這是必要旗標，要求物件的 ID。如果是在伺服器端自動生成 ID，請從 Create RPC 的 method_signature 移除這個欄位和 subnet_id
subnet

Subnet

這是必要旗標，正在建立的資源
request_id

string

選用。選用的要求 ID，用於識別要求。請指定專屬要求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證從第一次要求起至少 60 分鐘內有效。

舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同的要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果是，則會忽略第二個要求。避免客戶不小心建立重複的承諾使用合約。

要求 ID 必須是有效的 UUID，但不得為零 UUID (00000000-0000-0000-0000-000000000000)。

DeleteInterconnectAttachmentRequest

刪除 InterconnectAttachment 的訊息

欄位
name

string

這是必要旗標，資源名稱
request_id

string

選用。選用的要求 ID，用於識別要求。請指定專屬要求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證在第一次要求後至少 60 分鐘內，

舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同的要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果是，則會忽略第二個要求。避免客戶不小心建立重複的承諾使用合約。

要求 ID 必須是有效的 UUID，但不得為零 UUID (00000000-0000-0000-0000-000000000000)。

DeleteNetworkRequest

刪除網路的訊息

欄位
name

string

這是必要旗標，資源名稱
request_id

string

選用。選用的要求 ID，用於識別要求。請指定專屬要求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證在第一次要求後至少 60 分鐘內，

舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同的要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果是，則會忽略第二個要求。避免客戶不小心建立重複的承諾使用合約。

要求 ID 必須是有效的 UUID，但不得為零 UUID (00000000-0000-0000-0000-000000000000)。

DeleteRouterRequest

刪除路由器的訊息

欄位
name

string

這是必要旗標，資源名稱
request_id

string

選用。選用的要求 ID，用於識別要求。請指定專屬要求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證在第一次要求後至少 60 分鐘內，

舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同的要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果是，則會忽略第二個要求。避免客戶不小心建立重複的承諾使用合約。

要求 ID 必須是有效的 UUID，但不得為零 UUID (00000000-0000-0000-0000-000000000000)。

DeleteSubnetRequest

刪除子網路的訊息

欄位
name

string

這是必要旗標，資源名稱
request_id

string

選用。選用的要求 ID，用於識別要求。請指定專屬要求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證在第一次要求後至少 60 分鐘內，

舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同的要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果是，則會忽略第二個要求。避免客戶不小心建立重複的承諾使用合約。

要求 ID 必須是有效的 UUID，但不得為零 UUID (00000000-0000-0000-0000-000000000000)。

DiagnoseInterconnectRequest

要求診斷特定可用區內互連網路的訊息。

欄位
name

string

這是必要旗標，互連網路資源的名稱。

DiagnoseInterconnectResponse

DiagnoseInterconnectResponse 包含特定互連網路目前的診斷資訊。

欄位
update_time

Timestamp

上次更新互連網路診斷的時間。
result

InterconnectDiagnostics

特定互連網路的網路狀態。

DiagnoseNetworkRequest

要求診斷特定可用區內網路的訊息。

欄位
name

string

這是必要旗標，網路資源的名稱。

DiagnoseNetworkResponse

DiagnoseNetworkResponse 包含特定網路的目前狀態。

欄位
update_time

Timestamp

上次更新網路狀態的時間。
result

NetworkStatus

特定網路的網路狀態。

NetworkStatus

NetworkStatus 包含目前網路下子網路的狀態清單。

欄位
subnet_status[]

SubnetStatus

目前網路下子網路的狀態清單。

MacsecStatus

表示可用區連結的 MACsec 工作階段狀態。

列舉
MACSEC_STATUS_UNSPECIFIED 未指定 MACsec 狀態，可能是因為缺少指標。
SECURE 所有相關連結都至少有一個 MACsec 工作階段。
UNSECURE 至少有一個相關連結未啟用任何 MACsec 工作階段。

DiagnoseRouterRequest

要求診斷特定可用區內路由器的訊息。

欄位
name

string

這是必要旗標，路由器資源的名稱。

DiagnoseRouterResponse

DiagnoseRouterResponse 包含特定路由器的目前狀態。

欄位
update_time

Timestamp

上次更新路由器狀態的時間。
result

RouterStatus

特定路由器的網路狀態。

GetInterconnectAttachmentRequest

取得 InterconnectAttachment 的訊息

欄位
name

string

這是必要旗標，資源名稱

GetInterconnectRequest

取得互連網路的訊息

欄位
name

string

這是必要旗標，資源名稱

GetNetworkRequest

取得網路的訊息

欄位
name

string

這是必要旗標，資源名稱

GetRouterRequest

取得路由器的訊息

欄位
name

string

這是必要旗標，資源名稱

GetSubnetRequest

取得子網路的訊息

欄位
name

string

這是必要旗標，資源名稱

GetZoneRequest

已淘汰：未實作。進入區間的訊息

欄位
name

string

這是必要旗標，資源名稱

InitializeZoneRequest

初始化指定可用區的訊息

欄位
name

string

這是必要旗標，可用區資源的名稱。

InitializeZoneResponse

這個類型沒有任何欄位。

初始化區域的回應

互連網路

說明互連網路物件的訊息

欄位
name

string

這是必要旗標，互連網路的標準資源名稱。
create_time

Timestamp

僅供輸出。子網路的建立時間。
update_time

Timestamp

僅供輸出。上次更新子網路的時間。
labels

map<string, string>

與這項資源相關聯的標籤。
description

string

選用。資源的文字說明，長度上限為 1024 個半形字元。
interconnect_type

InterconnectType

選用。互連網路類型，目前僅接受「DEDICATED」值。
uuid

string

僅供輸出。連結的專屬 ID。
device_cloud_resource_name

string

僅供輸出。切換工具的 Cloud 資源名稱。
physical_ports[]

string

僅供輸出。構成互連網路的實體通訊埠 (例如 TenGigE0/0/0/1)。
remote_peering_network_type

RemotePeeringNetworkType

選用。互連網路的遠端對接網路類型。啟用對接分隔時，必須提供這個值。

InterconnectType

互連網路類型。

列舉
INTERCONNECT_TYPE_UNSPECIFIED 未指定。
DEDICATED Dedicated Interconnect。

InterconnectAttachment

說明 InterconnectAttachment 物件的訊息

欄位
name

string

這是必要旗標，互連網路連結的標準資源名稱。
create_time

Timestamp

僅供輸出。建立互連網路連結的時間。
update_time

Timestamp

僅供輸出。上次更新互連網路連結的時間。
labels

map<string, string>

與這項資源相關聯的標籤。
description

string

選用。資源的文字說明，長度上限為 1024 個半形字元。
interconnect

string

這是必要旗標，這個連結流量會經過的基礎互連網路物件標準名稱。名稱格式為 projects/{project}/locations/{location}/zones/{zone}/interconnects/{interconnect}。
network

string

選用。標準網路名稱，格式為 projects/{project}/locations/{location}/zones/{zone}/networks/{network}。
vlan_id

int32

這是必要旗標，使用者提供的 VLAN ID。不得與網站中的其他名稱重複。
mtu

int32

虛擬邊緣雲端的 IP (L3) MTU 值。有效值為 1500 和 9000。如未設定，預設值為 1500。
state

ResourceState

僅供輸出。透過設定推送，將資源推送至裝置的目前階段。
peering_type

RemotePeeringNetworkType

選用。基礎互連網路的遠端對接網路類型。啟用對接分隔時，必須提供這個值。

InterconnectDiagnostics

互連網路的診斷資訊，包含 Google 端連線的詳細最新技術資訊。

欄位
mac_address

string

互連網路套件介面的 MAC 位址。

LinkLACPStatus

說明 LACP 連結的狀態。

欄位
state

State

LACP 連結的狀態。
google_system_id

string

LACP 交換中 Google 端通訊埠的系統 ID。
neighbor_system_id

string

LACP 交換中鄰近端通訊埠的系統 ID。
aggregatable

bool

如果值為 true，表示參與者允許將連結用於匯總。如果值為 false，表示連結應做為個別連結使用。
collecting

bool

如果為 true，參與者會收集連結上的傳入影格，否則為 false
distributing

bool

如果為 true，參與者會發布傳出影格；如果為 false，則會停用發布功能

狀態

LACP 連結的狀態列舉。

列舉
UNKNOWN 預設狀態，表示狀態不明。
ACTIVE 連結已設定，且在套裝組合中有效。
DETACHED 連結未在套裝組合中設定，這表示物件的其餘部分應為空白。

LinkLLDPStatus

說明 LLDP 連結。

欄位
peer_system_name

string

對等互連系統的管理員指派名稱。
peer_system_description

string

LLDP 對等互連網路實體的文字說明。
peer_chassis_id

string

與傳輸 LLDP 代理程式相關聯的端點 ID 對等機箱元件。
peer_chassis_id_type

string

對等機箱 ID 字串的格式和來源。
peer_port_id

string

與傳輸 LLDP 代理程式相關聯的端點 ID 通訊埠元件。如果指定通訊埠是 IEEE 802.3 中繼器通訊埠，則這個 TLV 為選用。
peer_port_id_type

string

對等互連通訊埠 ID 字串的格式和來源。

LinkStatus

說明互連網路上各連結的狀態。

欄位
circuit_id

string

Google 在啟用期間指派的這個連結專屬 ID。
lacp_status

LinkLACPStatus

說明 LACP 連結的狀態。
lldp_statuses[]

LinkLLDPStatus

LinkLLDPStatus 物件清單，用於說明互連網路上各連結的各個對等互連 LLDP 狀態。
packet_counts

PacketCounts

這個連結的封包計數特定統計資料。

PacketCounts

包含介面相關統計資料物件的集合。

欄位
inbound_unicast

int64

已傳送的封包數量。
inbound_errors

int64

含有錯誤的傳入封包數量。
inbound_discards

int64

即使未偵測到任何錯誤，仍選擇捨棄的傳入封包數量，以防封包無法傳送。
outbound_unicast

int64

要求傳輸的封包總數。
outbound_errors

int64

因發生錯誤而無法傳輸的傳出封包數量。
outbound_discards

int64

即使未偵測到任何錯誤，仍選擇捨棄的傳出封包數量，以防止封包傳輸。

LinkLayerAddress

LinkLayerAddress 包含 IP 位址和對應的連結層位址。

欄位
mac_address

string

這個鄰近裝置的 MAC 位址。
ip_address

string

這個鄰居的 IP 位址。

ListInterconnectAttachmentsRequest

要求 InterconnectAttachments 清單的訊息

欄位
parent

string

這是必要旗標，ListInterconnectAttachmentsRequest 的父項值
page_size

int32

要求的頁面大小。伺服器傳回的項目數量可能少於要求數量。如未指定，伺服器會選擇適當的預設值。
page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
filter

string

篩選結果
order_by

string

結果排序方式提示

ListInterconnectAttachmentsResponse

列出 InterconnectAttachments 的回應訊息

欄位
interconnect_attachments[]

InterconnectAttachment

InterconnectAttachment 清單
next_page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
unreachable[]

string

無法連線的位置。

ListInterconnectsRequest

要求互連網路清單的訊息

欄位
parent

string

這是必要旗標，ListInterconnectsRequest 的父項值
page_size

int32

要求的頁面大小。伺服器傳回的項目數量可能少於要求數量。如未指定，伺服器會選擇適當的預設值。
page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
filter

string

篩選結果
order_by

string

結果排序方式提示

ListInterconnectsResponse

列出互連網路的回應訊息

欄位
interconnects[]

Interconnect

互連網路清單
next_page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
unreachable[]

string

無法連線的位置。

ListNetworksRequest

要求網路清單的訊息

欄位
parent

string

這是必要旗標，ListNetworksRequest 的上層值
page_size

int32

要求的頁面大小。伺服器傳回的項目數量可能少於要求數量。如未指定，伺服器會選擇適當的預設值。
page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
filter

string

篩選結果
order_by

string

結果排序方式提示

ListNetworksResponse

回覆聯播網清單的訊息

欄位
networks[]

Network

網路清單
next_page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
unreachable[]

string

無法連線的位置。

ListRoutersRequest

要求路由器清單的訊息

欄位
parent

string

這是必要旗標，ListRoutersRequest 的父項值
page_size

int32

要求的頁面大小。伺服器傳回的項目數量可能少於要求數量。如未指定，伺服器會選擇適當的預設值。
page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
filter

string

篩選結果
order_by

string

結果排序方式提示

ListRoutersResponse

列出路由器時的回應訊息

欄位
routers[]

Router

路由器清單
next_page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
unreachable[]

string

無法連線的位置。

ListSubnetsRequest

要求子網路清單的訊息

欄位
parent

string

這是必要旗標，ListSubnetsRequest 的父項值
page_size

int32

要求的頁面大小。伺服器傳回的項目數量可能少於要求數量。如未指定，伺服器會選擇適當的預設值。
page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
filter

string

篩選結果
order_by

string

結果排序方式提示

ListSubnetsResponse

列出子網路的回應訊息

欄位
subnets[]

Subnet

子網路清單
next_page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
unreachable[]

string

無法連線的位置。

ListZonesRequest

已淘汰：未實作。要求區域清單的訊息

欄位
parent

string

這是必要旗標，ListZonesRequest 的父項值
page_size

int32

要求的頁面大小。伺服器傳回的項目數量可能少於要求數量。如未指定，伺服器會選擇適當的預設值。
page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
filter

string

篩選結果
order_by

string

結果排序方式提示

ListZonesResponse

已淘汰：未實作。列出可用區的回應訊息

欄位
zones[]

Zone

可用區清單
next_page_token

string

用來識別伺服器應傳回哪一頁結果的權杖。
unreachable[]

string

無法連線的位置。

網路

說明網路物件的訊息

欄位
name

string

這是必要旗標，網路的標準資源名稱。
create_time

Timestamp

僅供輸出。建立網路的時間。
update_time

Timestamp

僅供輸出。上次更新網路的時間。
labels

map<string, string>

與這項資源相關聯的標籤。
description

string

選用。資源的文字說明，長度上限為 1024 個半形字元。
mtu

int32

網路的 IP (L3) MTU 值。有效值為 1500 和 9000。如未設定，預設值為 1500。

OperationMetadata

代表長時間執行的作業中繼資料。

欄位
create_time

Timestamp

僅供輸出。作業的建立時間。
end_time

Timestamp

僅供輸出。作業執行完成的時間。
target

string

僅供輸出。作業目標的伺服器定義資源路徑。
verb

string

僅供輸出。作業執行的動詞名稱。
status_message

string

僅供輸出。作業的人類可讀狀態 (如有)。
requested_cancellation

bool

僅供輸出。指出使用者是否已要求取消作業。已成功取消的作業會具有 [Operation.error][] 值，且 google.rpc.Status.code 為 1，對應至 Code.CANCELLED。
api_version

string

僅供輸出。用於啟動作業的 API 版本。

RemotePeeringNetworkType

定義介面的遠端對接目的地。啟用對接分隔時，必須提供這個值。

列舉
REMOTE_PEERING_NETWORK_TYPE_UNSPECIFIED 未指定。
REMOTE_PEERING_NETWORK_TYPE_CUSTOMER_INTERNAL 客戶信任的內部網路。
REMOTE_PEERING_NETWORK_TYPE_CUSTOMER_INTERNET 客戶可存取網際網路的不信任網路。

ResourceState

ResourceState 說明資源的狀態。建立新資源的正常生命週期為：PENDING -> PROVISIONING -> RUNNING。刪除現有資源的正常生命週期為：RUNNING -> DELETING。處理期間如有任何失敗，資源會進入「SUSPENDED」狀態。

列舉
STATE_UNKNOWN 未指定狀態。
STATE_PENDING 正在準備將資源套用至機架。
STATE_PROVISIONING 資源已開始套用至機架。
STATE_RUNNING 資源已推送至機架。
STATE_SUSPENDED 無法將資源推送至機架。
STATE_DELETING 資源正在刪除中。

路由器

說明路由器物件的訊息

欄位
name

string

這是必要旗標，路由器的標準資源名稱。
create_time

Timestamp

僅供輸出。建立路由器的時間。
update_time

Timestamp

僅供輸出。上次更新路由器的時間。
labels

map<string, string>

與這項資源相關聯的標籤。
description

string

選用。資源的文字說明，長度上限為 1024 個半形字元。
network

string

這是必要旗標，這個路由器所屬網路的標準名稱，名稱格式為 projects/{project}/locations/{location}/zones/{zone}/networks/{network}。
interface[]

Interface

路由器介面。
bgp_peer[]

BgpPeer

BGP 對等互連。
bgp

Bgp

這個路由器的 BGP 資訊。
state

ResourceState

僅供輸出。透過設定推送，將資源推送至裝置的目前階段。
route_advertisements[]

string

選用。IP/長度格式的 CIDR 清單，用於從這個路由器向北 advertise 靜態路由。

Bgp

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

欄位
asn

uint32

本機指派的 BGP ASN。
keepalive_interval_in_seconds

uint32

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

BgpPeer

BGPPeer 定義了對等互連端第 3 層資訊，用於建立 BGP 工作階段。

欄位
name

string

這個 BGP 對等互連的名稱。在 Zones 資源中不得重複。
interface

string

與 BGP 對等互連相關聯的 RouterInterface 名稱。
interface_ipv4_cidr

string

Google 內部的介面 IP 範圍。
interface_ipv6_cidr

string

Google 內部的介面 IPv6 範圍。
peer_ipv4_cidr

string

Google 外部 BGP 介面的 IP 範圍。
peer_ipv6_cidr

string

Google 外部 BGP 介面的 IPv6 範圍。
peer_asn

uint32

對等互連 BGP 自治系統編號 (ASN)。每個 BGP 介面都可以使用不同的值。
local_asn

uint32

僅供輸出。本機 BGP 自治系統編號 (ASN)。這個欄位是 ST_NOT_REQUIRED，因為它儲存私人 ASN，在使用的區域之外沒有意義。

介面

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

欄位
name

string

這個介面項目的名稱。在 Zones 資源中不得重複。
ipv4_cidr

string

介面的 IP 位址和範圍。
ipv6_cidr

string

介面的 IPv6 位址和範圍。
linked_interconnect_attachment

string

連結的互連網路連結標準名稱。
subnetwork

string

這個介面所屬子網路資源的標準名稱。
loopback_ip_addresses[]

string

指定時，在路由器中建立回送介面。IP 位址數量必須與 TOR 裝置數量相符。

RouterStatus

說明路由器目前的狀態。

欄位
network

string

這個路由器所屬網路的標準名稱。
bgp_peer_status[]

BgpPeerStatus

BgpPeerStatus 物件清單，說明與這個路由器相關的所有 BGP 對等互連。

BgpPeerStatus

BGP 對等互連狀態。

欄位
name

string

這個 BGP 對等互連的名稱。在路由器資源中不得重複。
ip_address

string

本機 BGP 介面的 IP 位址。
peer_ip_address

string

遠端 BGP 介面的 IP 位址。
status

BgpStatus

BGP 的目前狀態。
state

string

RFC1771 指定的 BGP 狀態。
uptime

string

這個工作階段的持續時間。格式：14 年 51 週 6 天 23 小時 59 分 59 秒
uptime_seconds

int64

這個工作階段的持續時間 (以秒為單位)。
prefix_counter

PrefixCounter

前置字串的計數集合。

BgpStatus

BGP 對等互連狀態：{UP, DOWN}

列舉
UNKNOWN 預設狀態，表示 BGP 工作階段處於不明狀態。
UP 「運作中」狀態表示已建立 BGP 工作階段。
DOWN 「DOWN」狀態表示尚未建立 BGP 工作階段。

PrefixCounter

PrefixCounter 包含與前置字元相關的計數集合。

欄位
advertised

int64

advertise 的前置字串數量。
denied

int64

遭拒的前置字元數量。
received

int64

收到的前置字串數量。
sent

int64

傳送的前置字串數量。
suppressed

int64

已隱藏的前置字元數量。
withdrawn

int64

撤銷的前置字元數量。

子網路

說明子網路物件的訊息

欄位
name

string

這是必要旗標，子網路的標準資源名稱。
create_time

Timestamp

僅供輸出。子網路的建立時間。
update_time

Timestamp

僅供輸出。上次更新子網路的時間。
labels

map<string, string>

與這項資源相關聯的標籤。
description

string

選用。資源的文字說明，長度上限為 1024 個半形字元。
network

string

這是必要旗標，這個子網路所屬的網路。
ipv4_cidr[]

string

這個子網路擁有的 IPv4 位址範圍。
ipv6_cidr[]

string

這個子網路擁有的 IPv6 位址範圍。
vlan_id

int32

選用。使用者提供的 VLAN ID。如未指定，系統會自動指派。
bonding_type

BondingType

選用。建立子網路時，繫結類型會指定要建立的 VLAN 是否會出現在繫結或非繫結或兩者連接埠類型。此外，這個旗標可用來設定特定網路設定，叢集可根據綁定選擇，將該設定用於工作負載。
state

ResourceState

僅供輸出。透過設定推送，將資源推送至裝置的目前階段。

BondingType

子網路中的繫結類型。

列舉
BONDING_TYPE_UNSPECIFIED 如果使用者在建立 VLAN 時選擇不指定繫結類型，則預設為未指定繫結類型。系統會將這種情況視為混合繫結，VLAN 與機器之間會有繫結和非繫結連線能力。
BONDED 多宿。
NON_BONDED 單一主機。

SubnetStatus

SubnetStatus 包含這項子網路資源的詳細和最新技術資訊。

欄位
name

string

CCFE 子網路資源的名稱。
mac_address

string

BVI MAC 位址。

UpdateRouterRequest

更新路由器的訊息

欄位
update_mask

FieldMask

這是必要旗標，欄位遮罩用於指定路由器資源中要由更新覆寫的欄位。update_mask 中指定的欄位與資源相關，而非完整要求。如果欄位在遮罩中，系統會覆寫該欄位。如果使用者未提供遮罩，系統會覆寫所有欄位。
router

Router

這是必要旗標，正在更新的資源
request_id

string

選用。選用的要求 ID，用於識別要求。請指定專屬要求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證從第一次要求起至少 60 分鐘內有效。

舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同的要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果是，則會忽略第二個要求。避免客戶不小心建立重複的承諾使用合約。

要求 ID 必須是有效的 UUID，但不得為零 UUID (00000000-0000-0000-0000-000000000000)。

UpdateSubnetRequest

更新子網路的訊息

欄位
update_mask

FieldMask

這是必要旗標，欄位遮罩用於指定子網路資源中要由更新覆寫的欄位。update_mask 中指定的欄位與資源相關，而非完整要求。如果欄位位於遮罩中，系統會覆寫該欄位。如果使用者未提供遮罩，系統會覆寫所有欄位。
subnet

Subnet

這是必要旗標，正在更新的資源
request_id

string

選用。選用的要求 ID，用於識別要求。請指定專屬要求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證從第一次要求起至少 60 分鐘內有效。

舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同的要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果是，則會忽略第二個要求。避免客戶不小心建立重複的承諾使用合約。

要求 ID 必須是有效的 UUID，但不得為零 UUID (00000000-0000-0000-0000-000000000000)。

可用區

Google Edge Cloud 可用區。

欄位
name

string

這是必要旗標，可用區的資源名稱。
create_time

Timestamp

僅供輸出。建立可用區的時間。
update_time

Timestamp

僅供輸出。上次更新可用區的時間。
labels
(deprecated)

map<string, string>

已淘汰：未實作。標籤為鍵/值組合。
layout_name
(deprecated)

string

已淘汰：未實作。部署作業版面配置類型。