指定用來管理 Cloud Number Registry 的專案

本頁說明如何指定用來管理 Cloud Number Registry 的專案。每個機構組織只能有一個專案使用 Cloud Number Registry。如要設定 Cloud Number Registry，機構管理員必須先建立org-number-registries資源，指定可使用的專案。

事前準備

  1. 建立或選取專案，以便管理上層機構的 Cloud Number Registry。強烈建議您為此建立專用專案。詳情請參閱「 為 Cloud Number Registry 指定專案」。

    1. 前往 Google Cloud 控制台的專案選擇器頁面。

      前往專案選取器

    2. 選取或建立 Google Cloud 專案。

      選取或建立專案所需的角色

      • 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您在專案中獲派角色，即可選取該專案。
      • 建立專案：如要建立專案，您需要「專案建立者」角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。

  2. 如果尚未啟用，請啟用 Cloud Number Registry API。

    啟用 API 時所需的角色

    如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    啟用 API

  3. 確認您具備完成本指南所需的權限。

必要的角色

如要取得指定專案以使用 Cloud Number Registry 的權限，請要求管理員授予父項機構的 Cloud Number Registry IPAM 管理員 (roles/cloudnumberregistry.ipamAdmin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

選用：檢查是否已設定 Cloud Number Registry

每個機構組織只能有一個專案可設定 Cloud Number Registry。您可以透過機構中的任何專案，確認機構是否已設定 Cloud Number Registry。

控制台

  1. 前往 Google Cloud 控制台的「Cloud Number Registry」頁面。

    前往 Cloud Number Registry

    • 如果這個機構已設定 Cloud Number Registry，系統會將您重新導向至管理 Cloud Number Registry 的專案。
    • 如果這個機構尚未設定 Cloud Number Registry，系統會顯示「建立管理員範圍」按鈕。

gcloud

使用 gcloud alpha number-registry ipam-admin-scopes check-availability 指令，檢查貴機構是否已設定 Cloud Number Registry。

  • 如果已設定 Cloud Number Registry，回應為 UNAVAILABLE。
  • 如果沒有現有設定，回應會是 AVAILABLE。
gcloud alpha number-registry ipam-admin-scopes check-availability \
    --scopes=organizations/ORGANIZATION_ID \
    --location=global

將 ORGANIZATION_ID 替換為要管理的機構 ID 編號。

指定用來管理 Cloud Number Registry 的專案

如要指定專案做為 Cloud Number Registry 的用途，請建立 org-number-registries 資源，定義可用於為上層機構設定 Cloud Number Registry 的專案。

設定 Cloud Number Registry 時，Google Cloud 會檢查您是否在符合 org-number-registries 資源中定義的專案內，建立 IPAM 管理員範圍。

控制台

  1. 前往 Google Cloud 控制台的「Cloud Number Registry」頁面。

    前往 Cloud Number Registry

  2. 按一下「管理」分頁標籤。

  3. 在「管理指定專案」面板的「管理專案」欄位中，按一下「選取」，然後選取要用於 Cloud Number Registry 的專案。

  4. 按一下「指定專案」。

gcloud

使用 gcloud alpha number-registry org-number-registries create 指令，指定要用於 Cloud Number Registry 的專案。

gcloud alpha number-registry org-number-registries create ORG_NUMBER_REGISTRY \
    --admin-project=projects/PROJECT_ID \
    --target-scopes=organizations/ORGANIZATION_ID \
    --organization=ORGANIZATION_ID \
    --location=global

更改下列內容：

  • ORG_NUMBER_REGISTRY：機構號碼登錄資源的名稱。
  • PROJECT_ID：您要用來存放 Cloud Number Registry 資訊的專案 ID 編號。
  • ORGANIZATION_ID：要管理的組織 ID 號碼。

列出及查看專案指定項目

您可以查看指定與 Cloud Number Registry 搭配使用的專案。

控制台

  1. 前往 Google Cloud 控制台的「Cloud Number Registry」頁面。

    前往 Cloud Number Registry

  2. 按一下「管理」分頁標籤。

  3. 在「管理指定的專案」面板中，查看「管理專案」欄位。

gcloud

  • 如要列出 Cloud Number Registry 的專案指定項目，請使用 gcloud alpha number-registry org-number-registries list 指令。

    gcloud alpha number-registry org-number-registries list \
    --organization=ORGANIZATION_ID \
    --location=global

    將 ORGANIZATION_ID 替換為您管理的機構 ID 編號。

  • 如要查看 Cloud Number Registry 專案指派的詳細資料，請使用 gcloud alpha number-registry org-number-registries describe 指令。

    gcloud alpha number-registry org-number-registries describe ORG_NUMBER_REGISTRY \
    --organization=ORGANIZATION_ID \
    --location=global

    更改下列內容：

    • ORG_NUMBER_REGISTRY：機構號碼登錄檔資源的名稱。
    • ORGANIZATION_ID：您管理的機構 ID 號碼。

刪除專案名稱

如果專案指定存在，但專案中未設定 Cloud Number Registry，您可以刪除指定專案的 org-number-registries 資源。

如果專案中已設定 Cloud Number Registry，您必須先停用 Cloud Number Registry，才能刪除專案指定。

控制台

  1. 前往 Google Cloud 控制台的「Cloud Number Registry」頁面。

    前往 Cloud Number Registry

  2. 按一下「管理」分頁標籤。

  3. 在「管理指定的專案」面板中，按一下「移除專案指定項目」。

gcloud

使用 gcloud alpha number-registry org-number-registries delete 指令刪除專案指定項目。

gcloud alpha number-registry org-number-registries delete ORG_NUMBER_REGISTRY \
    --organization=ORGANIZATION_ID \
    --location=global

更改下列內容：

  • ORG_NUMBER_REGISTRY：機構號碼登錄檔資源的名稱。
  • ORGANIZATION_ID：您管理的機構 ID 號碼。

後續步驟