建立及管理互連網路連結

本頁說明如何在 Distributed Cloud 區域中，建立及管理 Google Distributed Cloud 互連附件資源。

如要進一步瞭解 Distributed Cloud 互連附件，請參閱「Distributed Cloud 的運作方式」。

請注意以下幾點：

  • 建議您同時建立互連網路連結和對應的路由器。詳情請參閱「建立路由器」。
  • 您可以選擇指定用來標記通過互連網路連結封包的 VLAN ID。
  • 您為封包標記指定的 VLAN ID 僅適用於互連網路連結。換句話說，特定互連網路連結與其他互連網路連結相關聯的互連網路連結，或與任何互連網路連結相關聯的子網路，都不屬於同一個第 2 層網域。因此，雖然封包標記指定的 VLAN ID 在目標互連網路上建立的所有互連網路連結中必須是唯一的，但可以在其他互連網路和未與互連網路連結建立關聯的子網路中重複使用。

建立互連網路連結

如要建立 Distributed Cloud 互連網路連結，請完成本節中的步驟。

如要完成這項工作，您必須在 Google Cloud 專案中擁有邊緣網路管理員角色 (roles/edgenetwork.admin)。

gcloud

使用 gcloud edge-cloud networking interconnects attachments dedicated create 指令：

gcloud edge-cloud networking interconnects attachments dedicated create ATTACHMENT_NAME \
    --interconnect=INTERCONNECT_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --vlan-id=VLAN_ID \
    --mtu=MTU_SIZE

更改下列內容：

  • ATTACHMENT_NAME：說明名稱，可做為這個互連網路附件的專屬 ID。
  • INTERCONNECT_NAME：這個互連網路附件所連線的互連網路名稱。
  • NETWORK_NAME：這個互連附件資源服務的 Distributed Cloud 網路名稱。
  • REGION：目標 Distributed Cloud 區域所屬的 Google Cloud 區域。
  • ZONE_NAME：目標 Distributed Cloud 可用區的名稱。
  • VLAN_ID (選用)：透過這個互連網路連結傳輸的封包所標記的 VLAN ID。有效值介於 2 至 4095 之間。如果省略這個值或設為 0，封包就不會加上標記。
  • MTU_SIZE：這個互連網路連結例項化的子網路最大傳輸單位 (MTU) 大小。有效值為 1500 和 9000。

API

對 projects.locations.zones.interconnectAttachments.create 方法發出 POST 要求：

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments?interconnectAttachmentId=ATTACHMENT_ID
 {
  "labels": { LABELS,
   },
  "interconnect": { INTERCONNECT_NAME,
   },
  "network": { NETWORK_NAME,
   },
  "vlanId": { VLAN_ID,
   },
  "mtu": { MTU_SIZE,
   },       
 }

更改下列內容：

  • PROJECT_ID：目標專案的 ID。Google Cloud
  • REGION：目標 Distributed Cloud 區域所屬的 Google Cloud 區域。
  • ZONE_NAME：目標 Distributed Cloud 可用區的名稱。
  • ATTACHMENT_ID：可專屬識別這個互連附件的 ID。
  • LABELS：要套用至這個互連附件資源的標籤清單。
  • INTERCONNECT_NAME：這個互連網路附件所連線的互連網路名稱。
  • NETWORK_NAME：這個互連附件資源服務的網路。
  • VLAN_ID：這個互連網路連結在路由器上例項化的子網路 VLAN ID。有效值介於 2 至 4095 之間。值為 0 時，子網路會設為未加上標記。
  • MTU_SIZE：這個互連網路連結例項化的子網路最大傳輸單位 (MTU) 大小。有效值為 1500 和 9000。

列出互連網路連結

如要列出 Distributed Cloud 可用區中的 Distributed Cloud 互連附件，請完成本節中的步驟。

如要完成這項工作，您必須在專案中具備邊緣網路檢視者角色 (roles/edgenetwork.viewer)。 Google Cloud

gcloud

使用 gcloud edge-cloud networking interconnects attachments list 指令：

gcloud edge-cloud networking interconnects attachments list \
    --location=REGION \
    --zone=ZONE_NAME

更改下列內容：

  • REGION：目標 Distributed Cloud 區域所屬的 Google Cloud 區域。
  • ZONE_NAME：目標 Distributed Cloud 可用區的名稱。

API

對 projects.locations.zones.interconnectAttachments.list 方法發出 GET 要求：

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

更改下列內容：

  • PROJECT_ID：目標專案的 ID。Google Cloud
  • REGION：目標 Distributed Cloud 區域所屬的 Google Cloud 區域。
  • ZONE_NAME：目標 Distributed Cloud 可用區的名稱。
  • FILTER：限制傳回結果為特定值的運算式。
  • PAGE_SIZE：每頁要傳回的結果數。
  • SORT_BY：以半形逗號分隔的欄位名稱清單，做為傳回結果的排序依據。預設排序順序為遞增；如要遞減排序，請在所需欄位前面加上 ~。
  • PAGE_TOKEN：在回應的 nextPageToken 欄位中，對最後一個清單要求的回應中收到的權杖。傳送這個符記即可接收下一頁結果。

取得互連網路附件的相關資訊

如要取得 Distributed Cloud 互連網路附件的相關資訊，請完成本節中的步驟。

如要完成這項工作，您必須在專案中具備邊緣網路檢視者角色 (roles/edgenetwork.viewer)。 Google Cloud

gcloud

使用 gcloud edge-cloud networking interconnects attachments describe 指令：

gcloud edge-cloud networking interconnects attachments describe ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

更改下列內容：

  • ATTACHMENT_NAME：目標互連附件的名稱。
  • REGION：目標 Distributed Cloud 區域所屬的 Google Cloud 區域。
  • ZONE_NAME：目標 Distributed Cloud 可用區的名稱。

API

對 projects.locations.zones.interconnectAttachments.get 方法發出 GET 要求：

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments/ATTACHMENT_ID

更改下列內容：

  • PROJECT_ID：目標專案的 ID。Google Cloud
  • ATTACHMENT_ID：目標互連附件的名稱。
  • REGION：目標 Distributed Cloud 區域所屬的 Google Cloud 區域。
  • ZONE_NAME：目標 Distributed Cloud 可用區的名稱。

這項作業會傳回資源的詳細資訊，包括資源的佈建狀態，如下所示：

  • PENDING：資源尚未開始佈建，也尚未在整個可用區中傳播。
  • PROVISIONING：資源正在佈建中，您必須等待資源在整個可用區中傳播。
  • RUNNING：資源已成功佈建並在整個區域中傳播，可供使用。
  • FAILED：資源佈建失敗，資源尚未在整個區域中傳播。

刪除互連網路附件

如要刪除 Distributed Cloud 互連附件，請完成本節中的步驟。

如要完成這項工作，您必須在 Google Cloud 專案中擁有邊緣網路管理員角色 (roles/edgenetwork.admin)。

gcloud

使用 gcloud edge-cloud networking interconnects attachments delete 指令：

gcloud edge-cloud networking interconnects attachments delete ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

更改下列內容：

  • ATTACHMENT_NAME：目標互連附件的名稱。
  • REGION：目標 Distributed Cloud 區域所屬的 Google Cloud 區域。
  • ZONE_NAME：目標 Distributed Cloud 可用區的名稱。

API

對 projects.locations.zones.interconnectAttachments.delete 方法發出 DELETE 要求：

DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets/SUBNETWORK_ID

更改下列內容：

  • PROJECT_ID：目標專案的 ID。Google Cloud
  • ATTACHMENT_NAME：目標互連附件的名稱。
  • REGION：目標 Distributed Cloud 區域所屬的 Google Cloud 區域。
  • ZONE_NAME：目標 Distributed Cloud 可用區的名稱。

後續步驟