Cloud Number Registry に使用するプロジェクトを指定する

このページでは、Cloud Number Registry に使用するプロジェクトを指定する方法について説明します。各組織で Cloud Number Registry を使用できるプロジェクトは 1 つだけです。Cloud Number Registry を設定する前に、組織管理者は org-number-registries リソースを作成して、使用できるプロジェクトを指定する必要があります。

始める前に

  1. 親組織の Cloud Number Registry の管理に使用するプロジェクトを作成または選択します。この目的のために専用のプロジェクトを作成することを強くおすすめします。詳細については、 Cloud Number Registry のプロジェクトの指定をご覧ください。

    1. Google Cloud コンソールで、プロジェクトの選択ページに移動します。

      プロジェクト セレクタに移動

    2. Google Cloud プロジェクトの選択または作成

      プロジェクトの選択または作成に必要なロール

      • プロジェクトを選択する: プロジェクトの選択に特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトであれば、どのプロジェクトでも選択できます。
      • プロジェクトを作成する: プロジェクトを作成するには、resourcemanager.projects.create 権限を含むプロジェクト作成者ロール（roles/resourcemanager.projectCreator）が必要です。詳しくは、ロールを付与する方法をご覧ください。

  2. Cloud Number Registry API を有効にします（有効になっていない場合）。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を通じてこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を通じてこの権限を取得できます。ロールを付与する方法を確認する。

    API の有効化

  3. このガイドを完了するために必要な権限があることを確認します。

必要なロール

Cloud Number Registry で使用するプロジェクトを指定するために必要な権限を取得するには、親組織に対する Cloud Number Registry IPAM 管理者 （roles/cloudnumberregistry.ipamAdmin）IAM ロールの付与を管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

省略可: Cloud Number Registry が構成されているかどうかを確認する

各組織で Cloud Number Registry を構成できるプロジェクトは 1 つだけです。組織内の任意のプロジェクトから、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 に使用するプロジェクトを指定するには、親組織の Cloud Number Registry の設定に使用できるプロジェクトを定義する org-number-registries リソースを作成します。

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 番号。

次のステップ