Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

設定中樞

本頁面說明如何建立中樞，以便連結其他專案中的虛擬私有雲輪輻。此外，也會詳細說明如何在建立中樞時，為虛擬私有雲輪輻選取網狀或星狀連線拓撲的預設選項。

中樞管理員可以使用 gcloud network-connectivity hubs groups update 指令更新子群組。您可以新增專案 ID 或專案編號清單，啟用自動接受功能。啟用自動接受功能後，系統會自動將自動接受專案中的輪輻連線至中樞，不必逐一審查輪輻提案，並進入 ACTIVE 狀態。如果專案不在自動接受清單中，輪輻會維持在 INACTIVE 狀態，直到您審查並接受輪輻為止。

您可以使用 gcloud network-connectivity hubs groups list --hub 指令，將特定中樞的中心和邊緣群組列為巢狀資源。如果是使用網狀拓撲建立的中心，輸出內容會傳回預設群組。如果是以星狀拓撲建立的中心，輸出內容會傳回 center 和 edge 群組。

事前準備

開始之前，請先詳閱下列各節。

建立或選取專案

如要輕鬆設定 NCC，請先找出有效的專案。

登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎建立帳戶，親自體驗產品的實際應用成效。新客戶還能獲得價值 $300 美元的免費抵免額，用於執行、測試及部署工作負載。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

如果您使用 Google Cloud CLI，請使用 gcloud config set 指令設定專案 ID。
```
gcloud config set project PROJECT_ID
```
將 PROJECT_ID 替換為您的專屬專案 ID。

本頁的 gcloud CLI 指令假設您已設定專案 ID。
如要確認專案 ID 設定正確無誤，請使用 gcloud config list 指令。
```
gcloud config list --format='text(core.project)'
```

啟用 Network Connectivity API

您必須先啟用 Network Connectivity API，才能使用 Network Connectivity Center (NCC) 執行任何工作。

控制台

如要啟用 Network Connectivity API，請按照下列步驟操作：

前往 Google Cloud 控制台的「Network Connectivity Center」(網路連線中心) 頁面。

前往 Network Connectivity Center
按一下「啟用」。

或者，您也可以使用Google Cloud 控制台 API 程式庫啟用 API，如「啟用 API」一文所述。

取得存取權

如要使用 NCC，您必須具備「角色和權限」一文所述的權限。

找出資源

使用 gcloud CLI 或 API 參照資源時，請採用下表所述的慣例。

集會/座談	僅支援	附註	範例
完整 URI	所有資源	請使用下列其中一種方法，參照 Router 設備執行個體。	"https://www.googleapis.com/compute/projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`"
相對資源名稱	所有資源	請使用下列其中一種方法，參照 Router 設備執行個體。	"projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`"
名稱	區域和全域資源	這個方法適用於中樞、輪輻、VPN 通道和 VLAN 連結。	"`HUB_NAME`"

這項工作需要的權限

必須擁有下列權限「或」IAM 角色，才能執行這項工作。

權限

networkconnectivity.hubs.create：用於建立中樞
networkconnectivity.hubs.delete 刪除中樞
networkconnectivity.hubs.listSpokes：列出輪輻
此外，如果您在 Google Cloud 控制台中工作：
- networkconnectivity.hubs.get
- networkconnectivity.hubs.list
- networkconnectivity.spokes.list
- compute.projects.get

角色

中樞與輪輻管理員 (roles/networkconnectivity.hubAdmin)
如果您是在 Google Cloud 控制台操作，請使用 Compute 網路檢視者 (roles/compute.networkViewer)

建立中樞

如要建立中心，請按照下列步驟操作。

控制台

前往 Google Cloud 控制台的「Network Connectivity Center」(網路連線中心) 頁面。

前往 Network Connectivity Center
在專案選單中選取專案。
點選「建立中樞」。
填寫表單的「基本設定」部分：
1. 輸入中樞名稱。
2. 選用：輸入說明。
3. 選擇預設拓撲類型。
4. 選用：如要新增標籤，請按一下「新增項目」，然後輸入「鍵」和「值」。
5. 確認表單顯示正確的專案 ID。如果專案 ID 不正確，請使用頁面頂端的選單選取其他專案。
在「Private Service Connect 連線傳播」部分，按一下「開啟」或「關閉」，啟用或停用 Private Service Connect 連線傳播。
執行下列其中一個步驟：
- 如要建立連結至這個中樞的子網，請按一下「下一步」，然後填寫表單的子網建立部分。如需操作說明，請參閱「建立虛擬私有雲 Spoke」。
- 如果現在不想建立輪輻，請按一下「Create」(建立)，完成建立新中樞。

gcloud

如要建立中樞，請使用 gcloud network-connectivity hubs create 指令。

  gcloud network-connectivity hubs create HUB_NAME \
      --policy-mode="POLICY_MODE" \
      --preset-topology="TOPOLOGY_TYPE" \
      --description="DESCRIPTION" \
      --labels="KEY"="VALUE"

如要為 NCC 中樞全域啟用 Private Service Connect 傳播連線，請使用 --export-psc 旗標。

  gcloud network-connectivity hubs create HUB_NAME \
      --description="DESCRIPTION" \
      --labels="KEY"="VALUE" \
      --export-psc

替換下列值：

HUB_NAME：新中樞的名稱
POLICY_MODE：選用：啟用預設拓撲的政策模式，例如 PRESET
TOPOLOGY_TYPE：預設拓撲類型。支援的值為 STAR 或 MESH。預設值為 MESH。
DESCRIPTION：描述中樞的選填文字
KEY：鍵/值組合中的鍵，用於選用標籤文字
VALUE：鍵/值組合中的值，用於選用標籤文字

如要在現有中樞上啟用 Private Service Connect 連線傳播，請參閱「更新中樞」。如要停用現有中樞的 Private Service Connect 連線傳播功能，請使用 --no-export-psc 旗標。系統會以非同步方式移除現有的傳播連線。

API

如要建立中樞，請使用 networkconnectivity.hubs.create 方法。

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
  {
    "name":"HUB_NAME",
    "description":"DESCRIPTION",
    "labels": {
      "KEY": "VALUE"
    }
  }

如要選擇預設拓撲，請使用相同方法並指定拓撲：

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
  {
    "name":"HUB_NAME",
    "description":"DESCRIPTION",
    "preset_topology": "TOPOLOGY_TYPE"
  }

如要為 NCC 中樞啟用 Private Service Connect 傳播連線，請將 export-psc 值設為「true」。

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
  {
    "export_psc": true
  }

替換下列值：

PROJECT_ID：包含新中樞的專案 ID
HUB_NAME：新中樞的名稱
DESCRIPTION：描述中樞的選填文字
KEY：鍵/值組合中的鍵，用於選用標籤文字
VALUE：鍵/值組合中選用標籤文字的值
TOPOLOGY_TYPE：預設拓撲類型。支援的值為 STAR 或 MESH。預設值為 MESH。

如要在現有中樞上啟用 Private Service Connect 連線傳播，請參閱「更新中樞」。如要停用現有中樞的 Private Service Connect 連線傳播功能，請將 export_psc 值設為「false」。現有的傳播連線會以非同步方式移除。

如要進一步瞭解其他中心指令 (例如 list、describe 和 update)，請參閱「使用中心和輻射」。

管理輪輻群組的自動接受專案

如要更新輪輻群組的自動接受專案，請按照下列步驟操作。

控制台

前往 Google Cloud 控制台的「Network Connectivity Center」(網路連線中心)。

前往 Network Connectivity Center
在專案選單中，選取中心所在的專案。
按一下要更新自動接受專案的中樞名稱。
在「中樞詳細資料」頁面的「群組」下方，按一下群組名稱旁邊的「編輯」。如為網狀拓撲連線能力，則只有一個預設群組。如為星狀拓撲連線，群組為「中心」和「邊緣」。
在「編輯群組」窗格中，執行下列任一步驟：
- 如要新增要自動接受輪輻的專案，請按一下「Add project ID」(新增專案 ID)，然後輸入專案 ID。如要新增更多專案，請按一下「新增專案 ID」。
- 如要從自動接受清單中移除專案 ID，請按一下「專案 ID」旁的「刪除」。
按一下 [儲存]。

gcloud

如要更新 spoke 群組，請使用 gcloud network-connectivity hubs groups update 指令。

gcloud network-connectivity hubs groups update GROUP_NAME \
  --hub=HUB_NAME \
  --description=DESCRIPTION \
  --add-auto-accept-projects=PROJECT_NAME_1,PROJECT_NAME_2

更改下列內容：

GROUP_NAME：群組名稱
HUB_NAME：中樞名稱
DESCRIPTION：描述群組的選用文字
PROJECT_NAME_1、PROJECT_NAME_2：以半形逗號分隔的清單，列出一或多個要啟用自動接受功能的專案 ID 或專案編號

如要清除自動接受專案清單中的所有專案，請使用 --clear-auto-accept-projects 旗標。

gcloud network-connectivity hubs groups update GROUP_NAME \
  --hub=HUB_NAME \
  --description=DESCRIPTION \
  --clear-auto-accept-projects

更改下列內容：

GROUP_NAME：群組名稱
HUB_NAME：中樞名稱
DESCRIPTION：描述中樞的選填文字

如要從自動接受專案清單中移除特定專案，請使用 --remove-auto-accept-projects 旗標。

gcloud network-connectivity hubs groups update GROUP_NAME \
  --hub=HUB_NAME \
  --description=DESCRIPTION \
  --remove-auto-accept-projects=PROJECT_NAME_1,PROJECT_NAME_2

更改下列內容：

GROUP_NAME：群組名稱
HUB_NAME：中樞名稱
DESCRIPTION：描述中樞的選填文字
PROJECT_NAME_1、PROJECT_NAME_2：以半形逗號分隔的清單，列出一或多個要停用自動接受功能的專案 ID 或專案編號

API

如要更新 Spoke 群組的自動接受專案，請使用

networkconnectivity.hubs.groups.update 方法。

  PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME/groups/GROUP_NAME/updateMask=auto_accept.auto_accept_projects
  {
   "auto_accept": {
       "auto_accept_projects": ["PROJECT_NAME_1","PROJECT_NAME_2"],
    }
  }

更改下列內容：

PROJECT_ID：您建立中樞的專案 ID
HUB_NAME：中樞名稱
GROUP_NAME：群組名稱
PROJECT_NAME_1、PROJECT_NAME_2：以半形逗號分隔的清單，列出一或多個要新增或移除自動接受設定的專案 ID 或專案編號

刪除中樞

如要刪除中樞，請按照下列步驟操作。

刪除中樞前，必須先刪除或拒絕所有連結至中樞的輪輻。如果輪輻位於其他專案，您可能沒有刪除權限。在這種情況下，您必須拒絕輪輻。

如要瞭解如何刪除子網，請參閱「刪除子網」。

控制台

前往 Google Cloud 控制台的「Network Connectivity Center」(網路連線中心) 頁面。

前往 Network Connectivity Center
在專案選單中選取專案。
按一下「Hubs」(中樞) 分頁標籤。
在中樞裝置清單中，選取要刪除的中樞裝置。
按一下「輪輻」分頁標籤。系統會列出附加至這個中樞的所有輪輻及其狀態。
從使用中的輪輻清單中，刪除使用中的輪輻。如果沒有刪除 Spoke 的權限，請拒絕 Spoke。
按一下「刪除中心」。
在確認對話方塊中，執行下列任一操作：
- 如果不想刪除中樞，請按一下「取消」。
- 按一下「刪除」即可刪除中樞。

gcloud

如要列出附加至要刪除中樞的所有有效 spoke，請使用 gcloud network-connectivity hubs list-spokes 指令。
```
gcloud network-connectivity hubs list-spokes HUB_NAME \
    --filter="state:ACTIVE"
```
將 HUB_NAME 替換為要刪除的中樞名稱。
刪除有效輪輻。如果沒有刪除 Spoke 的權限，請拒絕 Spoke。
如要刪除中樞，請使用 gcloud network-connectivity hubs delete 指令。
```
gcloud network-connectivity hubs delete HUB_NAME
```
將 HUB_NAME 替換為中樞名稱。

API

如要列出附加至要刪除中樞的所有有效輻輪，請使用 networkconnectivity.hubs.listSpokes 方法。
```
 GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME:listSpokes
```
替換下列值：
- PROJECT_ID：專案 ID，用於存放您要列出 Spoke 的中樞
- HUB_NAME：要列出 Spoke 的中樞名稱
刪除有效輪輻。如果沒有刪除 Spoke 的權限，請拒絕 Spoke。
如要刪除中樞，請使用 networkconnectivity.hubs.delete 方法。
```
 DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME
```
替換下列值：
- PROJECT_ID：要刪除的中樞所在專案的專案 ID
- HUB_NAME：要刪除的中心名稱

後續步驟

如要建立中樞和輪輻，請參閱「使用中樞和輪輻」。
如要查看解決方案已與 NCC 整合的合作夥伴清單，請參閱 NCC 合作夥伴。
如需常見問題的解決方案，請參閱「疑難排解」。
如要進一步瞭解 API 和 Google Cloud CLI 指令，請參閱「API 和參考資料」。

設定中樞 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

建立或選取專案

啟用 Network Connectivity API

控制台

取得存取權

找出資源

這項工作需要的權限

建立中樞

控制台

gcloud

API

管理輪輻群組的自動接受專案

控制台

gcloud

API

刪除中樞

控制台

gcloud

API

後續步驟

設定中樞