指定一个用于 Cloud Number Registry 的项目

本页介绍了如何指定一个用于 Cloud Number Registry 的项目。每个组织中只能有一个项目使用 Cloud Number Registry。在设置 Cloud Number Registry 之前，Organization Administrator 必须通过创建 org-number-registries 资源来指定可使用的项目。

准备工作

  1. 创建或选择一个项目，用于管理父组织的 Cloud Number Registry。我们强烈建议为此目的创建一个专用项目。如需了解详情，请参阅 Cloud Number Registry 的项目指定。

    1. 在 Google Cloud 控制台中，前往项目选择器页面。

      转到“项目选择器”

    2. 选择或创建 Google Cloud 项目。

      选择或创建项目所需的角色

      • 选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
      • 创建项目：如需创建项目，您需要拥有 Project Creator 角色 (roles/resourcemanager.projectCreator)，该角色包含 resourcemanager.projects.create 权限。了解如何授予角色。

  2. 启用 Cloud Number Registry API（如果尚未启用）。

    启用 API 所需的角色

    如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您创建了项目，则可能已经通过 Owner 角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获取此权限。 了解如何授予角色。

    启用 API

  3. 验证您是否拥有完成本指南所需的权限。

所需的角色

如需获得指定项目以用于 Cloud Number Registry 所需的权限，请让您的管理员为您授予父组织的 Cloud Number Registry IPAM Admin (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 编号。

后续步骤