设置 Cloud Number Registry

本页介绍了如何在组织中设置 Cloud Number Registry。

准备工作

  1. 指定一个项目来管理此组织中的 Cloud Number Registry。
  2. 选择指定项目，以执行本指南中的步骤。
  3. 验证您是否拥有完成本指南所需的权限。

所需的角色

如需获得设置和管理 Cloud Number Registry 所需的权限，请让您的管理员为您授予项目的 Cloud Number Registry IPAM Admin (roles/cloudnumberregistry.ipamAdmin) IAM 角色。 如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

创建 IPAM 管理员范围

创建 IPAM 管理员范围后，Cloud Number Registry 会执行设置任务，识别组织中受支持的 Compute Engine 资源，并将这些资源添加到默认注册簿中。

系统最长可能需要 24 小时才能发现组织中的所有资源。您可以查看 IPAM 管理员范围的状态，以检查资源发现是否已完成。

您可以通过此默认注册簿管理云号码注册，也可以选择创建其他注册簿来整理资源。

如果您在尝试创建 IPAM 管理员范围时收到错误消息，请参阅问题排查。

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Number Registry 页面。

    前往 Cloud Number Registry

  2. 点击管理标签页。

  3. 在 Manage IPAM admin scope（管理 IPAM 管理员范围）面板中，点击 Create IPAM admin scope（创建 IPAM 管理员范围）。

IPAM 管理员范围创建过程开始。如需检查设置进度，请查看 IPAM 管理员范围的状态。

gcloud

使用 gcloud alpha number-registry ipam-admin-scopes create 命令创建 IPAM 管理员范围。

如需查看 Cloud Number Registry 设置的进度，请查看 IPAM 管理员范围的状态。

gcloud alpha number-registry ipam-admin-scopes create SCOPE_NAME \
    --enabled-addon-platforms=COMPUTE_ENGINE \
    --scopes=organizations/ORGANIZATION_ID \
    --location=global

替换以下内容：

  • SCOPE_NAME：IPAM 管理员范围的名称
  • ORGANIZATION_ID：您要管理的组织的 ID 编号。

查看 IPAM 管理员范围的状态

在设置过程中，管理员范围可能具有以下状态：

  • SETUP_IN_PROGRESS：设置已开始，但发现流程尚未完成。系统最长可能需要 24 小时才能发现组织中的所有现有资源。不过，在组织中创建的任何新资源都会在几分钟内被发现。

  • READY_TO_USE：发现过程已完成，Cloud Number Registry 已可供使用。

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Number Registry 页面。

    前往 Cloud Number Registry

  2. 点击管理标签页。

  3. 在 Manage IPAM admin scope（管理 IPAM 管理员范围）面板中，查看状态字段。

gcloud

使用 gcloud alpha number-registry ipam-admin-scopes describe 命令查看有关 IPAM 管理员范围的详细信息。

gcloud alpha number-registry ipam-admin-scopes describe SCOPE_NAME \
    --location=global

将 SCOPE_NAME 替换为 IPAM 管理员范围名称。

问题排查

以下部分介绍了如何解决设置 Cloud Number Registry 时可能遇到的问题。

IPAM 管理员范围创建失败，并显示 ALREADY_EXISTS 或 INVALID_ARGUMENT 错误

如果因上述任一错误而导致 IPAM 管理员范围创建失败，则是因为项目中已存在 IPAM 管理员范围。

  • 此项目中已存在同名的 IPAM 管理员范围：

    ALREADY_EXISTS: Resource 'projects/PROJECT_ID/locations/global/ipamAdminScopes/SCOPE_NAME'
already exists.

  • 此项目中已存在其他名称的 IPAM 管理员范围：

    INVALID_ARGUMENT: Violation in ipam_admin_scope.scopes: Scope
organizations/ORGANIZATION_ID is already administered by another ipam admin scope
'projects/PROJECT_ID/locations/global/ipamAdminScopes/EXISTING_SCOPE_NAME'

IPAM 管理员范围创建失败，并显示 FAILED_PRECONDITION 错误

如果 IPAM 管理员范围的创建失败并显示以下错误消息，则表示相应项目尚未被指定为用于此组织的 Cloud Number Registry。

FAILED_PRECONDITION: There is no existing registry for 'projects/PROJECT_ID in scope
organizations/ORGANIZATION_ID'

如需解决此问题，请执行以下操作：

  1. 检查是否已在其他项目中为此组织设置 Cloud Number Registry。

  2. 如果尚未为此组织设置 Cloud Number Registry，请检查此组织中是否已指定项目用于 Cloud Number Registry。

  3. 如果未指定任何项目，请让贵组织的管理员指定一个项目以用于 Cloud Number Registry，或授予您执行此操作的权限。

后续步骤