索引
EdgeNetwork(介面)CreateInterconnectAttachmentRequest(訊息)CreateNetworkRequest(訊息)CreateRouteRequest(訊息)CreateRouterRequest(訊息)CreateSubnetRequest(訊息)DeleteInterconnectAttachmentRequest(訊息)DeleteNetworkRequest(訊息)DeleteRouteRequest(訊息)DeleteRouterRequest(訊息)DeleteSubnetRequest(訊息)DiagnoseInterconnectRequest(訊息)DiagnoseInterconnectResponse(訊息)DiagnoseNetworkRequest(訊息)DiagnoseNetworkResponse(訊息)DiagnoseNetworkResponse.NetworkStatus(訊息)DiagnoseNetworkResponse.NetworkStatus.MacsecStatus(enum)DiagnoseRouterRequest(訊息)DiagnoseRouterResponse(訊息)GetInterconnectAttachmentRequest(訊息)GetInterconnectRequest(訊息)GetNetworkRequest(訊息)GetRouteRequest(訊息)GetRouterRequest(訊息)GetSubnetRequest(訊息)GetZoneRequest(訊息) (已淘汰)InitializeZoneRequest(訊息)InitializeZoneResponse(訊息)Interconnect(訊息)Interconnect.InterconnectType(enum)InterconnectAttachment(訊息)InterconnectDiagnostics(訊息)InterconnectDiagnostics.LinkLACPStatus(訊息)InterconnectDiagnostics.LinkLACPStatus.State(enum)InterconnectDiagnostics.LinkLLDPStatus(訊息)InterconnectDiagnostics.LinkStatus(訊息)InterconnectDiagnostics.PacketCounts(訊息)LinkLayerAddress(訊息)ListInterconnectAttachmentsRequest(訊息)ListInterconnectAttachmentsResponse(訊息)ListInterconnectsRequest(訊息)ListInterconnectsResponse(訊息)ListNetworksRequest(訊息)ListNetworksResponse(訊息)ListRoutersRequest(訊息)ListRoutersResponse(訊息)ListRoutesRequest(訊息)ListRoutesResponse(訊息)ListSubnetsRequest(訊息)ListSubnetsResponse(訊息)ListZonesRequest(訊息) (已淘汰)ListZonesResponse(訊息) (已淘汰)Network(訊息)OperationMetadata(訊息)ResourceState(enum)Route(訊息)Router(訊息)Router.Bgp(訊息)Router.BgpPeer(訊息)Router.Interface(訊息)RouterStatus(訊息)RouterStatus.BgpPeerStatus(訊息)RouterStatus.BgpPeerStatus.BgpStatus(enum)RouterStatus.PrefixCounter(訊息)RouterStatus.RouteStatus(訊息)RouterStatus.RouteStatus.RouteInstallStatus(enum)Subnet(訊息)SubnetStatus(訊息)UpdateRouterRequest(訊息)UpdateSubnetRequest(訊息)Zone(訊息)
EdgeNetwork
EdgeNetwork API 可為 GEC 客戶提供代管的高可用性雲端動態網路設定服務,以啟用邊緣應用程式和網路功能解決方案。客戶可輕鬆定義及設定網路設定和屬性,以滿足工作負載需求。
| CreateInterconnectAttachment |
|---|
|
在指定專案和位置建立新的 InterconnectAttachment。
|
| CreateNetwork |
|---|
|
在指定專案和位置中建立新網路。
|
| CreateRoute |
|---|
|
在指定專案和位置中建立新路線。
|
| CreateRouter |
|---|
|
在指定專案和位置建立新的路由器。
|
| CreateSubnet |
|---|
|
在指定專案和位置中建立新的子網路。
|
| DeleteInterconnectAttachment |
|---|
|
刪除單一 InterconnectAttachment。
|
| DeleteNetwork |
|---|
|
刪除單一網路。
|
| DeleteRoute |
|---|
|
刪除單一路線。
|
| DeleteRouter |
|---|
|
刪除單一路由器。
|
| DeleteSubnet |
|---|
|
刪除單一子網路。
|
| DiagnoseInterconnect |
|---|
|
取得單一互連資源的診斷資訊。
|
| DiagnoseNetwork |
|---|
|
取得單一網路資源的診斷資訊。
|
| DiagnoseRouter |
|---|
|
取得單一路由器資源的診斷資訊。
|
| GetInterconnect |
|---|
|
取得單一互連的詳細資料。
|
| GetInterconnectAttachment |
|---|
|
取得單一 InterconnectAttachment 的詳細資料。
|
| GetNetwork |
|---|
|
取得單一網路的詳細資料。
|
| GetRoute |
|---|
|
取得單一路線的詳細資料。
|
| GetRouter |
|---|
|
取得單一路由器詳細資料。
|
| GetSubnet |
|---|
|
取得單一子網路的詳細資料。
|
| GetZone |
|---|
|
已淘汰:未實作。取得單一區域的詳細資料。
|
| InitializeZone |
|---|
|
InitializeZone 會初始化專案中某個區域的資源。
|
| ListInterconnectAttachments |
|---|
|
列出指定專案和位置中的 InterconnectAttachment。
|
| ListInterconnects |
|---|
|
列出指定專案和位置中的互連網路。
|
| ListNetworks |
|---|
|
列出指定專案和位置中的網路。
|
| ListRouters |
|---|
|
列出指定專案和位置中的路由器。
|
| ListRoutes |
|---|
|
列出指定專案和位置中的路徑。
|
| ListSubnets |
|---|
|
列出指定專案和位置中的子網路。
|
| ListZones |
|---|
|
已淘汰:未實作。列出指定專案和位置中的區域。
|
| UpdateRouter |
|---|
|
更新單一路由器的參數。
|
| UpdateSubnet |
|---|
|
更新單一子網路的參數。
|
CreateInterconnectAttachmentRequest
建立 InterconnectAttachment 的訊息
| 欄位 | |
|---|---|
parent |
這是必要旗標,父項的值。 |
interconnect_attachment_id |
這是必要旗標,要求物件的 ID。如果要在伺服器端自動產生 ID,請從 Create RPC 的 method_signature 中移除這個欄位和 interconnect_attachment_id |
interconnect_attachment |
這是必要旗標,正在建立的資源 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
CreateNetworkRequest
建立網路的訊息
| 欄位 | |
|---|---|
parent |
這是必要旗標,父項的值。 |
network_id |
這是必要旗標,要求物件的 ID。如果要在伺服器端自動產生 ID,請從 Create RPC 的 method_signature 中移除這個欄位和 network_id |
network |
這是必要旗標,正在建立的資源 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
CreateRouteRequest
要求建立新路線的訊息。
| 欄位 | |
|---|---|
parent |
這是必要旗標,父項的值。 |
route_id |
這是必要旗標,要求物件的 ID。如果要在伺服器端自動產生 ID,請從 Create RPC 的 method_signature 中移除這個欄位和 network_id |
route |
這是必要旗標,正在建立的資源 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
CreateRouterRequest
建立路由器的訊息
| 欄位 | |
|---|---|
parent |
這是必要旗標,父項的值。 |
router_id |
這是必要旗標,要求物件的 ID。如果要在伺服器端自動產生 ID,請從 Create RPC 的 method_signature 中移除這個欄位和 router_id |
router |
這是必要旗標,正在建立的資源 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
CreateSubnetRequest
建立子網路的訊息
| 欄位 | |
|---|---|
parent |
這是必要旗標,父項的值。 |
subnet_id |
這是必要旗標,要求物件的 ID。如果要在伺服器端自動產生 ID,請從 Create RPC 的 method_signature 中移除這個欄位和 subnet_id |
subnet |
這是必要旗標,正在建立的資源 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
DeleteInterconnectAttachmentRequest
用於刪除 InterconnectAttachment 的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器保證在第一次要求後至少 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
DeleteNetworkRequest
刪除網路的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器保證在第一次要求後至少 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
DeleteRouteRequest
刪除路線的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器保證在第一次要求後至少 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
DeleteRouterRequest
刪除路由器的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器保證在第一次要求後至少 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
DeleteSubnetRequest
刪除子網路的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器保證在第一次要求後至少 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
DiagnoseInterconnectRequest
要求特定區域內互連診斷的訊息。
| 欄位 | |
|---|---|
name |
這是必要旗標,互連資源的名稱。 |
DiagnoseInterconnectResponse
DiagnoseInterconnectResponse 包含特定互連的目前診斷資訊。
| 欄位 | |
|---|---|
update_time |
上次更新互連診斷的時間。 |
result |
特定互連網路的網路狀態。 |
DiagnoseNetworkRequest
要求特定區域內網路診斷的訊息。
| 欄位 | |
|---|---|
name |
這是必要旗標,網路資源的名稱。 |
DiagnoseNetworkResponse
DiagnoseNetworkResponse 包含特定網路的目前狀態。
| 欄位 | |
|---|---|
update_time |
上次更新網路狀態的時間。 |
result |
特定網路的網路狀態。 |
NetworkStatus
NetworkStatus 包含目前網路下子網路的狀態清單。
| 欄位 | |
|---|---|
subnet_status[] |
目前網路下子網路的狀態清單。 |
macsec_status_internal_links |
內部連結的 MACsec 狀態。 |
MacsecStatus
表示區域連結的 MACsec 工作階段狀態。
| 列舉 | |
|---|---|
MACSEC_STATUS_UNSPECIFIED |
未指定 MACsec 狀態,可能是因為缺少指標。 |
SECURE |
所有相關連結都至少有一個 MACsec 工作階段。 |
UNSECURE |
至少有一個相關連結沒有任何 MACsec 工作階段。 |
DiagnoseRouterRequest
要求特定區域內路由器診斷的訊息。
| 欄位 | |
|---|---|
name |
這是必要旗標,路由器資源的名稱。 |
DiagnoseRouterResponse
DiagnoseRouterResponse 包含特定路由器的目前狀態。
| 欄位 | |
|---|---|
update_time |
上次更新路由器狀態的時間。 |
result |
特定路由器網路狀態。 |
GetInterconnectAttachmentRequest
取得 InterconnectAttachment 的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
GetInterconnectRequest
取得互連網路的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
GetNetworkRequest
取得電視網的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
GetRouteRequest
取得路線的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
GetRouterRequest
取得 Router 的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
GetSubnetRequest
取得子網路的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
GetZoneRequest
已淘汰:未實作。取得區域的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,資源名稱 |
InitializeZoneRequest
用於初始化指定區域的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,區域資源名稱。 |
InitializeZoneResponse
這個類型沒有任何欄位。
初始化區域的回應
互連網路
說明 Interconnect 物件的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,互連網路的標準資源名稱。 |
create_time |
僅供輸出。子網路的建立時間。 |
update_time |
僅供輸出。子網路上次更新的時間。 |
labels |
與這個資源相關聯的標籤。 |
description |
選用。資源的自由格式文字說明。長度上限為 1024 個字元。 |
interconnect_type |
選用。互連類型,目前只接受「DEDICATED」值。 |
uuid |
僅供輸出。連結的專屬 ID。 |
device_cloud_resource_name |
僅供輸出。交換裝置的雲端資源名稱。 |
physical_ports[] |
僅供輸出。實體連接埠 (例如TenGigE0/0/0/1),形成互連網路。 |
InterconnectType
互連網路類型。
| 列舉 | |
|---|---|
INTERCONNECT_TYPE_UNSPECIFIED |
未指定。 |
DEDICATED |
專屬互連網路。 |
InterconnectAttachment
說明 InterconnectAttachment 物件的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,互連網路連結的標準資源名稱。 |
create_time |
僅供輸出。互連網路連結的建立時間。 |
update_time |
僅供輸出。互連附件的上次更新時間。 |
labels |
與這個資源相關聯的標籤。 |
description |
選用。資源的自由格式文字說明。長度上限為 1024 個字元。 |
interconnect |
這是必要旗標,此連結的流量將會周遊之基礎互連網路物件的標準名稱。名稱格式為 |
network |
選用。標準網路名稱,格式為 |
vlan_id |
這是必要旗標,使用者提供的 VLAN ID。不得與網站上的其他名稱重複。 |
mtu |
虛擬邊緣雲端的 IP (L3) MTU 值。有效值為 1500 和 9000。如未設定,則預設值為 1500。 |
state |
僅供輸出。透過設定推送將資源傳送至裝置的目前階段。 |
InterconnectDiagnostics
互連網路的診斷資訊,包含連線的 Google 端最新詳細技術資訊。
| 欄位 | |
|---|---|
mac_address |
互連組合介面的 MAC 位址。 |
link_layer_addresses[] |
LinkLayerAddress 清單,說明這個互連網路的相鄰節點 IP 位址和對應的連結層位址。 |
links[] |
LinkStatus 物件清單,用於說明互連網路的每個連結狀態。 |
LinkLACPStatus
說明 LACP 連結的狀態。
| 欄位 | |
|---|---|
state |
LACP 連結的狀態。 |
google_system_id |
LACP 交換時 Google 端通訊埠的系統 ID。 |
neighbor_system_id |
LACP 交換時鄰近端通訊埠的系統 ID。 |
aggregatable |
如果值為 true,表示參與者允許將連結做為匯總的一部分。如果值為 false,表示連結應做為個別連結使用。 |
collecting |
如果為 true,表示參與者正在收集連結上的傳入影格;否則為 false |
distributing |
如果為 true,參與者會發布外送影格;如果為 false,則會停用發布功能 |
狀態
LACP 連結的狀態列舉。
| 列舉 | |
|---|---|
UNKNOWN |
預設狀態,表示狀態不明。 |
ACTIVE |
組合中已設定並啟用的連結。 |
DETACHED |
組合中未設定連結,因此物件的其餘部分應為空白。 |
LinkLLDPStatus
說明 LLDP 連結。
| 欄位 | |
|---|---|
peer_system_name |
對等系統管理員指派的名稱。 |
peer_system_description |
LLDP 對等互連網路實體的文字說明。 |
peer_chassis_id |
與傳輸 LLDP 代理程式相關聯的端點 ID 對等機箱元件。 |
peer_chassis_id_type |
對等互連機箱 ID 字串的格式和來源。 |
peer_port_id |
與傳輸 LLDP 代理程式相關聯的端點 ID 的通訊埠元件。如果指定的通訊埠是 IEEE 802.3 中繼器通訊埠,則這個 TLV 為選用項目。 |
peer_port_id_type |
對等埠 ID 字串的格式和來源。 |
LinkStatus
說明 Interconnect 的每個連結狀態。
| 欄位 | |
|---|---|
circuit_id |
這是 Google 在啟用期間指派的連結專屬 ID。 |
lacp_status |
說明 LACP 連結的狀態。 |
lldp_statuses[] |
LinkLLDPStatus 物件清單,用於說明互連的每個連結中,每個對等互連的 LLDP 狀態。 |
packet_counts |
這個連結的封包計數專屬統計資料。 |
PacketCounts
內含介面相關統計資料物件的集合。
| 欄位 | |
|---|---|
inbound_unicast |
已傳送的封包數。 |
inbound_errors |
含有錯誤的傳入封包數量。 |
inbound_discards |
即使未偵測到任何錯誤,仍選擇捨棄的傳入封包數量,以防止封包無法傳送。 |
outbound_unicast |
要求傳輸的封包總數。 |
outbound_errors |
因發生錯誤而無法傳輸的傳出封包數量。 |
outbound_discards |
即使未偵測到任何錯誤,仍選擇捨棄的傳出封包數量,以防止傳輸。 |
LinkLayerAddress
LinkLayerAddress 包含 IP 位址和對應的連結層位址。
| 欄位 | |
|---|---|
mac_address |
這個鄰近裝置的 MAC 位址。 |
ip_address |
這個鄰居的 IP 位址。 |
ListInterconnectAttachmentsRequest
要求 InterconnectAttachments 清單的訊息
| 欄位 | |
|---|---|
parent |
這是必要旗標,ListInterconnectAttachmentsRequest 的父項值 |
page_size |
要求的頁面大小。伺服器傳回的項目數量可能會少於要求數量。如未指定,伺服器會挑選適當的預設值。 |
page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
filter |
篩選結果 |
order_by |
如何排序結果的提示 |
ListInterconnectAttachmentsResponse
列出 InterconnectAttachment 的回應訊息
| 欄位 | |
|---|---|
interconnect_attachments[] |
InterconnectAttachment 清單 |
next_page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
unreachable[] |
無法連線的位置。 |
ListInterconnectsRequest
要求互連網路清單的訊息
| 欄位 | |
|---|---|
parent |
這是必要旗標,ListInterconnectsRequest 的父項值 |
page_size |
要求的頁面大小。伺服器傳回的項目數量可能會少於要求數量。如未指定,伺服器會挑選適當的預設值。 |
page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
filter |
篩選結果 |
order_by |
如何排序結果的提示 |
ListInterconnectsResponse
回覆列出互連網路的訊息
| 欄位 | |
|---|---|
interconnects[] |
互連網路清單 |
next_page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
unreachable[] |
無法連線的位置。 |
ListNetworksRequest
要求網路清單的訊息
| 欄位 | |
|---|---|
parent |
這是必要旗標,ListNetworksRequest 的父項值 |
page_size |
要求的頁面大小。伺服器傳回的項目數量可能會少於要求數量。如未指定,伺服器會挑選適當的預設值。 |
page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
filter |
篩選結果 |
order_by |
如何排序結果的提示 |
ListNetworksResponse
回覆刊登聯播網的訊息
| 欄位 | |
|---|---|
networks[] |
網路清單 |
next_page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
unreachable[] |
無法連線的位置。 |
ListRoutersRequest
要求路由器清單的訊息
| 欄位 | |
|---|---|
parent |
這是必要旗標,ListRoutersRequest 的父項值 |
page_size |
要求的頁面大小。伺服器傳回的項目數量可能會少於要求數量。如未指定,伺服器會挑選適當的預設值。 |
page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
filter |
篩選結果 |
order_by |
如何排序結果的提示 |
ListRoutersResponse
回覆路由器資訊的訊息
| 欄位 | |
|---|---|
routers[] |
路由器清單 |
next_page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
unreachable[] |
無法連線的位置。 |
ListRoutesRequest
要求路線清單的訊息
| 欄位 | |
|---|---|
parent |
這是必要旗標,ListRoutesRequest 的父項值 |
page_size |
要求的頁面大小。伺服器傳回的項目數量可能會少於要求數量。如未指定,伺服器會挑選適當的預設值。 |
page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
filter |
篩選結果 |
order_by |
如何排序結果的提示 |
ListRoutesResponse
回應路線清單的訊息
| 欄位 | |
|---|---|
routes[] |
路徑清單 |
next_page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
unreachable[] |
無法連線的位置。 |
ListSubnetsRequest
要求子網路清單的訊息
| 欄位 | |
|---|---|
parent |
這是必要旗標,ListSubnetsRequest 的父項值 |
page_size |
要求的頁面大小。伺服器傳回的項目數量可能會少於要求數量。如未指定,伺服器會挑選適當的預設值。 |
page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
filter |
篩選結果 |
order_by |
如何排序結果的提示 |
ListSubnetsResponse
回覆列出子網路的訊息
| 欄位 | |
|---|---|
subnets[] |
子網路清單 |
next_page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
unreachable[] |
無法連線的位置。 |
ListZonesRequest
已淘汰:未實作。要求區域清單的訊息
| 欄位 | |
|---|---|
parent |
這是必要旗標,ListZonesRequest 的父項值 |
page_size |
要求的頁面大小。伺服器傳回的項目數量可能會少於要求數量。如未指定,伺服器會挑選適當的預設值。 |
page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
filter |
篩選結果 |
order_by |
如何排序結果的提示 |
ListZonesResponse
已淘汰:未實作。回應房源區域的訊息
| 欄位 | |
|---|---|
zones[] |
區域清單 |
next_page_token |
這個符記可識別伺服器應傳回的結果頁面。 |
unreachable[] |
無法連線的位置。 |
網路
描述 Network 物件的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,網路的標準資源名稱。 |
create_time |
僅供輸出。網路的建立時間。 |
update_time |
僅供輸出。上次更新網路的時間。 |
labels |
與這個資源相關聯的標籤。 |
description |
選用。資源的自由格式文字說明。長度上限為 1024 個字元。 |
mtu |
網路的 IP (L3) MTU 值。有效值為 1500 和 9000。如未設定,則預設值為 1500。 |
OperationMetadata
代表長時間執行作業的中繼資料。
| 欄位 | |
|---|---|
create_time |
僅供輸出。作業的建立時間。 |
end_time |
僅供輸出。作業完成執行的時間。 |
target |
僅供輸出。作業目標的伺服器定義資源路徑。 |
verb |
僅供輸出。作業執行的動詞名稱。 |
status_message |
僅供輸出。作業狀態 (如有)。 |
requested_cancellation |
僅供輸出。識別使用者是否要求取消作業。成功取消的作業會具有 [Operation.error][] 值,且 |
api_version |
僅供輸出。用於啟動作業的 API 版本。 |
ResourceState
ResourceState 說明資源的狀態。建立新資源的正常生命週期為:PENDING -> PROVISIONING -> RUNNING。刪除現有資源的正常生命週期為:RUNNING -> DELETING。處理期間發生任何失敗,資源就會處於「已暫停」狀態。
| 列舉 | |
|---|---|
STATE_UNKNOWN |
未指定狀態。 |
STATE_PENDING |
正在準備將資源套用至機架。 |
STATE_PROVISIONING |
資源已開始套用至機架。 |
STATE_RUNNING |
資源已推送到機架。 |
STATE_SUSPENDED |
資源無法推送至機架。 |
STATE_DELETING |
資源正在刪除中。 |
路徑
描述 Route 物件的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,路徑的標準資源名稱。 |
create_time |
僅供輸出。建立路徑的時間。 |
update_time |
僅供輸出。路線上次更新的時間。 |
labels |
選用。與這個資源相關聯的標籤。 |
network |
這是必要旗標,這個路徑所屬的網路。 |
destination_cidr |
這是必要旗標,子網路 (CIDR 格式)。 |
next_hop_address |
這是必要旗標,要設為這個路徑下一個躍點的 IP 位址。必須使用與 |destination_cidr| 相同的通訊協定。 |
state |
僅供輸出。透過設定推送將資源傳送至裝置的目前階段。 |
description |
選用。資源的自由格式文字說明。長度上限為 1024 個字元。 |
路由器
描述 Router 物件的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,路由器的標準資源名稱。 |
create_time |
僅供輸出。建立路由器時的時間。 |
update_time |
僅供輸出。上次更新路由器韌體的時間。 |
labels |
與這個資源相關聯的標籤。 |
description |
選用。資源的自由格式文字說明。長度上限為 1024 個字元。 |
network |
這是必要旗標,這個路由器所屬網路的標準名稱。名稱格式為 |
interface[] |
路由器介面。 |
bgp_peer[] |
BGP 對等互連。 |
bgp |
這個路由器專屬的 BGP 資訊。 |
state |
僅供輸出。透過設定推送將資源傳送至裝置的目前階段。 |
route_advertisements[] |
選用。以 IP/長度格式表示的 CIDR 清單,可從這個路由器向北通告為靜態路徑。 |
Bgp
這個路由器專屬的 BGP 資訊。
| 欄位 | |
|---|---|
asn |
本機指派的 BGP ASN。 |
keepalive_interval_in_seconds |
此為向對等點傳送邊界閘道通訊協定 (BGP) 保持運作訊息的時間間隔 (單位為秒)。預設值為 20,值介於 20 到 60 之間。 |
BgpPeer
BGPPeer 會定義對等互連端的第 3 層資訊,用於建立 BGP 工作階段。
| 欄位 | |
|---|---|
name |
這個 BGP 對等互連的名稱。在「區域」資源中必須是唯一值。 |
interface |
與 BGP 對等互連相關聯的 RouterInterface 名稱。 |
interface_ipv4_cidr |
Google 內介面的 IP 範圍。 |
interface_ipv6_cidr |
Google 內介面的 IPv6 範圍。 |
peer_ipv4_cidr |
Google 外部 BGP 介面的 IP 範圍。 |
peer_ipv6_cidr |
Google 外部 BGP 介面的 IPv6 範圍。 |
peer_asn |
對等互連 BGP 自治系統編號 (ASN)。每個 BGP 介面可能使用不同的值。 |
local_asn |
僅供輸出。本機 BGP 自治系統編號 (ASN)。這個欄位是 ST_NOT_REQUIRED,因為儲存的私人 ASN 在使用區域以外毫無意義。 |
介面
路由器介面會定義 GDCE 區域端的第 3 層資訊,用於建構 BGP 工作階段。
| 欄位 | |
|---|---|
name |
這個介面項目的名稱。在「區域」資源中必須是唯一值。 |
ipv4_cidr |
介面的 IP 位址和範圍。 |
ipv6_cidr |
介面的 IPv6 位址和範圍。 |
linked_interconnect_attachment |
已連結互連網路附件的標準名稱。 |
subnetwork |
這個介面所屬子網路資源的標準名稱。 |
loopback_ip_addresses[] |
指定時,在路由器中建立迴路介面。IP 位址數量必須與 TOR 裝置數量相符。 |
RouterStatus
描述路由器的目前狀態。
| 欄位 | |
|---|---|
network |
這個路由器所屬網路的標準名稱。 |
bgp_peer_status[] |
BgpPeerStatus 物件清單,說明與這個路由器相關的所有 BGP 對等互連。 |
static_route_status[] |
RouteStatus 清單,說明與這個路由器相關的所有北向路徑通告。 |
BgpPeerStatus
BGP 對等互連的狀態。
| 欄位 | |
|---|---|
name |
這個 BGP 對等互連的名稱。不得在路由器資源中重複。 |
ip_address |
本機 BGP 介面的 IP 位址。 |
peer_ip_address |
遠端 BGP 介面的 IP 位址。 |
status |
BGP 的目前狀態。 |
state |
RFC1771 中指定的 BGP 狀態。 |
uptime |
這個工作階段的執行時間。格式:14 年、51 週、6 天、23 小時、59 分鐘、59 秒 |
uptime_seconds |
這個工作階段的持續時間 (以秒為單位)。 |
prefix_counter |
前置字串的計數集合。 |
BgpStatus
BGP 對等互連狀態:{UP, DOWN}
| 列舉 | |
|---|---|
UNKNOWN |
預設狀態,表示 BGP 工作階段處於不明狀態。 |
UP |
「UP」狀態表示已建立 BGP 工作階段。 |
DOWN |
「DOWN」狀態表示尚未建立 BGP 工作階段。 |
PrefixCounter
PrefixCounter 包含與前置字元相關的計數集合。
| 欄位 | |
|---|---|
advertised |
放送廣告的前置碼數量。 |
denied |
遭拒前置字元數量。 |
received |
收到的前置碼數量。 |
sent |
傳送的前置字元數。 |
suppressed |
遭抑制的前置字元數。 |
withdrawn |
撤銷的前置碼數量。 |
RouteStatus
RouteStatus 包含與路由器上 advertise 的自訂北向靜態路徑相關指標對應的欄位。
| 欄位 | |
|---|---|
network |
這條路徑所屬的網路名稱。 |
prefix |
通告的前置字串 (CIDR 格式)。 |
next_hop |
這條路徑的下一個躍點 (IP 位址)。 |
next_hop_reachable |
下一個躍點是否可連線。 |
route_install_status |
代表路徑安裝狀態的列舉。 |
route_install_status_additional_info |
如果還有其他資訊 (例如發生錯誤時,我們會在這個欄位中加入相關資訊),這個字串會詳細說明 route_install_status。 |
route |
路線名稱 (請參閱 Route.name)。 |
device |
回報這個 RouteStatus 的裝置名稱。 |
RouteInstallStatus
列舉,用於濃縮路線的安裝狀態。
| 列舉 | |
|---|---|
ROUTE_INSTALL_STATUS_UNSPECIFIED |
未指定安裝狀態。 |
ROUTE_INSTALL_STATUS_ACTIVE |
路徑已正確安裝並啟用。 |
ROUTE_INSTALL_STATUS_PENDING |
路線尚未安裝,但沒有錯誤 (例如,路線正在安裝中) |
ROUTE_INSTALL_STATUS_FAILED |
發生錯誤,因此無法安裝路線。 |
子網路
描述子網路物件的訊息
| 欄位 | |
|---|---|
name |
這是必要旗標,子網路的標準資源名稱。 |
create_time |
僅供輸出。子網路的建立時間。 |
update_time |
僅供輸出。子網路上次更新的時間。 |
labels |
與這個資源相關聯的標籤。 |
description |
選用。資源的自由格式文字說明。長度上限為 1024 個字元。 |
network |
這是必要旗標,這個子網路所屬的網路。 |
ipv4_cidr[] |
這個子網路擁有的 IPv4 位址範圍。 |
ipv6_cidr[] |
這個子網路擁有的 IPv6 位址範圍。 |
vlan_id |
選用。使用者提供的 VLAN ID。如未指定,系統會自動指派。 |
state |
僅供輸出。透過設定推送將資源傳送至裝置的目前階段。 |
SubnetStatus
SubnetStatus 包含這個子網路資源的詳細最新技術資訊。
| 欄位 | |
|---|---|
name |
CCFE 子網路資源的名稱。 |
mac_address |
BVI MAC 位址。 |
link_layer_addresses[] |
LinkLayerAddress 清單,說明這個子網路的鄰居 IP 位址和對應的連結層位址。 |
UpdateRouterRequest
更新路由器的訊息
| 欄位 | |
|---|---|
update_mask |
這是必要旗標,欄位遮罩用於指定要透過更新作業覆寫的路由器資源欄位。update_mask 中指定的欄位與資源相關,而非完整要求。如果欄位位於遮罩中,系統會覆寫該欄位。如果使用者未提供遮罩,系統會覆寫所有欄位。 |
router |
這是必要旗標,正在更新的資源 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
UpdateSubnetRequest
更新子網路的訊息
| 欄位 | |
|---|---|
update_mask |
這是必要旗標,欄位遮罩用於指定更新作業要覆寫子網路資源中的哪些欄位。update_mask 中指定的欄位與資源相關,而非完整要求。如果欄位位於遮罩中,系統會覆寫該欄位。如果使用者未提供遮罩,系統會覆寫所有欄位。 |
subnet |
這是必要旗標,正在更新的資源 |
request_id |
選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內, 舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的承諾。 要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
可用區
Google Edge Cloud 區域。
| 欄位 | |
|---|---|
name |
這是必要旗標,區域的資源名稱。 |
create_time |
僅供輸出。建立區域的時間。 |
update_time |
僅供輸出。上次更新時區的時間。 |
labels |
已淘汰:未實作。以鍵/值組合形式呈現的標籤。 |
layout_name |
已淘汰:未實作。部署版面配置類型。 |