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

取得 Router 的訊息

欄位
name

string

這是必要旗標,資源名稱

GetSubnetRequest

取得子網路的訊息

欄位
name

string

這是必要旗標,資源名稱

GetZoneRequest

已淘汰:未實作。取得區域的訊息

欄位
name

string

這是必要旗標,資源名稱

InitializeZoneRequest

用於初始化指定區域的訊息

欄位
name

string

這是必要旗標,區域資源名稱。

InitializeZoneResponse

這個類型沒有任何欄位。

初始化區域的回應

互連網路

說明 Interconnect 物件的訊息

欄位
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

僅供輸出。交換裝置的雲端資源名稱。

physical_ports[]

string

僅供輸出。實體連接埠 (例如TenGigE0/0/0/1),形成互連網路。

remote_peering_network_type

RemotePeeringNetworkType

選用。互連網路的遠端對等互連網路類型。啟用對等互連分離時,必須提供這項資訊。

InterconnectType

互連網路類型。

列舉
INTERCONNECT_TYPE_UNSPECIFIED 未指定。
DEDICATED 專屬互連網路。

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

說明 Interconnect 的每個連結狀態。

欄位
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

列出 InterconnectAttachment 的回應訊息

欄位
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

無法連線的位置。

網路

描述 Network 物件的訊息

欄位
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。處理期間發生任何失敗,資源就會處於「已暫停」狀態。

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

路由器

描述 Router 物件的訊息

欄位
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 清單,可從這個路由器向北通告為靜態路徑。

Bgp

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

欄位
asn

uint32

本機指派的 BGP ASN。

keepalive_interval_in_seconds

uint32

此為向對等點傳送邊界閘道通訊協定 (BGP) 保持運作訊息的時間間隔 (單位為秒)。預設值為 20,值介於 20 到 60 之間。

BgpPeer

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

欄位
name

string

這個 BGP 對等互連的名稱。在「區域」資源中必須是唯一值。

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

這個介面項目的名稱。在「區域」資源中必須是唯一值。

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 「UP」狀態表示已建立 BGP 工作階段。
DOWN 「DOWN」狀態表示尚未建立 BGP 工作階段。

PrefixCounter

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

欄位
advertised

int64

放送廣告的前置碼數量。

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

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