Legen Sie ein Projekt für die Cloud Number Registry fest
Auf dieser Seite wird beschrieben, wie Sie ein Projekt für die Verwendung mit der Cloud Number Registry festlegen. Nur ein Projekt in jeder Organisation kann Cloud Number Registry verwenden. Bevor Sie die Cloud Number Registry einrichten können, muss ein Organisationsadministrator festlegen, welches Projekt verwendet werden kann. Dazu muss er eine org-number-registries-Ressource erstellen.
Hinweis
- Erstellen Sie ein Projekt oder wählen Sie eines aus, das zum Verwalten von Cloud Number Registry für die übergeordnete Organisation verwendet werden soll. Wir empfehlen dringend, ein separates Projekt für diesen Zweck zu erstellen. Weitere Informationen finden Sie unter
Projektzuweisung für die Cloud Number Registry.
-
Rufen Sie in der Google Cloud Console die Seite für die Projektauswahl auf.
-
Wählen Sie ein Google Cloud Projekt aus oder erstellen Sie eines.
Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts
- Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
-
Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (
roles/resourcemanager.projectCreator), die die Berechtigungresourcemanager.projects.createenthält. Weitere Informationen zum Zuweisen von Rollen
-
Aktivieren Sie die Cloud Number Registry API, falls sie noch nicht aktiviert ist.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die Berechtigung
serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen- Prüfen Sie, ob Sie die Berechtigungen haben, die für diese Anleitung erforderlich sind.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud Number Registry IPAM Admin (roles/cloudnumberregistry.ipamAdmin) für die übergeordnete Organisation zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Festlegen eines Projekts für die Verwendung für Cloud Number Registry benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Optional: Prüfen, ob die Cloud Number Registry konfiguriert ist
Nur ein Projekt in jeder Organisation kann die Cloud Number Registry konfigurieren. Sie können in jedem Projekt der Organisation prüfen, ob die Cloud Number Registry bereits in Ihrer Organisation konfiguriert ist.
Console
Rufen Sie in der Google Cloud Console die Seite Cloud Number Registry auf.
Cloud Number Registry aufrufen
- Wenn die Cloud Number Registry bereits in dieser Organisation konfiguriert ist, werden Sie zu dem Projekt weitergeleitet, in dem die Cloud Number Registry verwaltet wird.
- Wenn die Cloud Number Registry für diese Organisation nicht konfiguriert ist, wird der Button Administratorbereich erstellen angezeigt.
gcloud
Prüfen Sie mit dem Befehl gcloud alpha number-registry ipam-admin-scopes
check-availability, ob die Cloud Number Registry bereits in Ihrer Organisation konfiguriert ist.
- Wenn Cloud Number Registry bereits konfiguriert ist, lautet die Antwort
UNAVAILABLE. - Wenn keine Konfiguration vorhanden ist, lautet die Antwort
AVAILABLE.
gcloud alpha number-registry ipam-admin-scopes check-availability \
--scopes=organizations/ORGANIZATION_ID \
--location=global
Ersetzen Sie ORGANIZATION_ID durch die ID-Nummer der Organisation, die Sie verwalten möchten.
Legen Sie ein Projekt für die Cloud Number Registry fest
Wenn Sie ein Projekt für die Cloud Number Registry festlegen möchten, erstellen Sie eine org-number-registries-Ressource, in der definiert wird, welches Projekt zum Einrichten der Cloud Number Registry für die übergeordnete Organisation verwendet werden kann.
Wenn Sie die Cloud Number Registry einrichten, prüftGoogle Cloud , ob Sie den IPAM-Administratorbereich in einem Projekt erstellen, das dem in der org-number-registries-Ressource definierten Projekt entspricht.
Console
Rufen Sie in der Google Cloud Console die Seite Cloud Number Registry auf.
Klicke auf den Tab Verwalten.
Klicken Sie im Bereich Designated project verwalten im Feld Admin-Projekt auf Auswählen und wählen Sie das Projekt aus, das Sie für die Cloud Number Registry verwenden möchten.
Klicken Sie auf Projekt festlegen.
gcloud
Legen Sie mit dem Befehl gcloud alpha number-registry org-number-registries create ein Projekt für die Cloud Number Registry fest.
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
Ersetzen Sie Folgendes:
ORG_NUMBER_REGISTRY: Ein Name für die Organisationsnummer-Registrierungsressource.PROJECT_ID: die ID-Nummer des Projekts, das Sie für die Informationen zur Cloud Number Registry verwenden möchten.ORGANIZATION_ID: die ID-Nummer der Organisation, die Sie verwalten möchten.
Projektbezeichnungen auflisten und ansehen
Sie können sehen, welches Projekt für die Verwendung mit Cloud Number Registry vorgesehen ist.
Console
Rufen Sie in der Google Cloud Console die Seite Cloud Number Registry auf.
Klicke auf den Tab Verwalten.
Sehen Sie sich im Bereich Festgelegtes Projekt verwalten das Feld Administratorprojekt an.
gcloud
Verwenden Sie den Befehl
gcloud alpha number-registry org-number-registries list, um Projektzuweisungen für Cloud Number Registry aufzulisten.gcloud alpha number-registry org-number-registries list \ --organization=ORGANIZATION_ID \ --location=globalErsetzen Sie
ORGANIZATION_IDdurch die ID-Nummer der Organisation, die Sie verwalten.Wenn Sie Details zu einer Projektzuweisung für die Cloud Number Registry aufrufen möchten, verwenden Sie den Befehl
gcloud alpha number-registry org-number-registries describe.gcloud alpha number-registry org-number-registries describe ORG_NUMBER_REGISTRY \ --organization=ORGANIZATION_ID \ --location=globalErsetzen Sie Folgendes:
ORG_NUMBER_REGISTRY: Der Name der Organisationsnummer-Registrierungsressource.ORGANIZATION_ID: Die ID-Nummer der Organisation, die Sie verwalten.
Projektbezeichnung löschen
Wenn eine Projektzuweisung vorhanden ist, die Cloud Number Registry aber nicht im Projekt eingerichtet ist, können Sie die org-number-registries-Ressource löschen, die das Projekt zuweist.
Wenn die Cloud Number Registry bereits im Projekt eingerichtet ist, müssen Sie sie außer Betrieb nehmen, bevor Sie die Projektzuweisung löschen können.
Console
Rufen Sie in der Google Cloud Console die Seite Cloud Number Registry auf.
Klicke auf den Tab Verwalten.
Klicken Sie im Bereich Designiertes Projekt verwalten auf Projektzuweisung entfernen.
gcloud
Löschen Sie eine Projektbezeichnung mit dem Befehl gcloud alpha number-registry
org-number-registries delete.
gcloud alpha number-registry org-number-registries delete ORG_NUMBER_REGISTRY \
--organization=ORGANIZATION_ID \
--location=global
Ersetzen Sie Folgendes:
ORG_NUMBER_REGISTRY: Der Name der Organisationsnummer-Registrierungsressource.ORGANIZATION_ID: Die ID-Nummer der Organisation, die Sie verwalten.