Projekte erstellen und verwalten

Projekte der Google Cloud Platform (GCP) bilden die Grundlage zum Erstellen, Aktivieren und Verwenden aller GCP-Dienste, einschließlich Verwaltung von APIs, Rechnungsstellung, Hinzufügen und Entfernen von Mitarbeitern sowie Verwalten von Berechtigungen für GCP-Ressourcen.

Auf dieser Seite wird erläutert, wie GCP-Projekte mit der Resource Manager API und der Google Cloud Platform Console erstellt und verwaltet werden.

Vorbereitung

Lesen Sie die Informationen zur Projektressource unter Ressourcenhierarchie.

Projekt erstellen

Sie benötigen die Berechtigung resourcemanager.projects.create, um ein Projekt erstellen zu können. Diese Berechtigung ist in der Rolle "Projektersteller" (roles/resourcemanager.projectCreator) enthalten, die standardmäßig der gesamten Domain einer neuen Organisation und Nutzern der kostenlosen Testversion gewährt wird. Informationen zum Zuweisen der Rolle für einzelne Nutzer und zum Einschränken des organisationsweiten Zugriffs finden Sie auf der Seite Standardorganisationsrollen verwalten.

Sie können ein neues Projekt über die GCP Console oder mit der Methode projects.create() erstellen.

Konsole

So erstellen Sie ein neues Projekt:

  1. Öffnen Sie die Seite Ressourcen verwalten in der GCP Console.
    WEITER ZUR SEITE "RESSOURCEN VERWALTEN"
  2. Wählen Sie oben auf der Seite in der Drop-down-Liste Organisation auswählen die Organisation aus, in der Sie ein Projekt erstellen möchten. Wenn Sie eine kostenlose Testversion verwenden, überspringen Sie diesen Schritt, da diese Liste dann nicht angezeigt wird.
  3. Klicken Sie auf Projekt erstellen.
  4. Geben Sie im angezeigten Fenster Neues Projekt einen Projektnamen ein und wählen Sie ggf. ein Rechnungskonto aus.
  5. Wenn Sie das Projekt einem Ordner hinzufügen möchten, geben Sie im Feld Speicherort den Namen des Zielordners ein.
  6. Nachdem Sie die Details zum neuen Projekt eingegeben haben, klicken Sie auf Erstellen.

gcloud

Verwenden Sie den Befehl gcloud projects create, um ein neues Projekt zu erstellen:

gcloud projects create PROJECT_ID

Dabei steht PROJECT_ID für die ID des Projekts, das Sie erstellen möchten. Die Projekt-ID muss mit einem Kleinbuchstaben beginnen, 6 bis 30 Zeichen lang sein und darf nur ASCII-Buchstaben, Ziffern oder Bindestriche enthalten.

Mit den Flags --organization und --folder können Sie ein Projekt mit einer Organisation bzw. einem Ordner als übergeordnetes Element erstellen. Da einer Ressource nur ein Element übergeordnet sein darf, kann nur eines dieser Flags verwendet werden:

gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID

gcloud projects create PROJECT_ID --folder=FOLDER_ID

API

Wenn Sie ein neues Projekt mit der Methode projects.create() erstellen, können Sie in der Projekt-ID bestimmte Wörter nicht verwenden. Einige Beispiele sind ssl und google. Wenn Sie ein nicht erlaubtes Wort verwenden, gibt die Anfrage den Fehler INVALID_ARGUMENT zurück.

Mit der folgenden Anfrage wird nur ein Projekt erstellt und nicht automatisch mit einem Rechnungskonto verknüpft. Verwenden Sie die Methode projects.updateBillingInfo, um das mit einem Projekt verknüpfte Rechnungskonto festzulegen oder zu aktualisieren.

Anfrage zum Erstellen eines Projekts:

POST https://cloudresourcemanager.googleapis.com/v1/projects/
Authorization: *************
Content-Type: application/json

{
    "projectId": "our-project-123",
    "name": "my project",
    "labels": {
      "mylabel": "prod"
    }
}

Antwort zum Erstellen eines Projekts:

{
    "name": "operations/pc.123456789",
}

Anfrage zum Abrufen des Vorgangs:

GET https://cloudresourcemanager.googleapis.com/v1/operations/pc.123456789
Authorization: *************
Content-Type: application/json

Antwort zum Abrufen des Vorgangs:

{
    "name": "operations/pc.123456789",
    "done": true,
    "response": {
        "@type": "type.googleapis.com/google.cloudresourcemanager.v1.Project",
        "projectNumber": "464036093014",
        "projectId": "our-project-123",
        "lifecycleState": "ACTIVE",
        "name": "my project",
        "labels": {
        "mylabel": "prod"
        },
    "createTime": "2016-01-07T21:59:43.314Z"
    }
}

PYTHON

...
crm = discovery.build(
    'cloudresourcemanager', 'v1', http=creds.authorize(httplib2.Http()))

operation = crm.projects().create(
body={
    'project_id': flags.projectId,
    'name': 'my project'
}).execute()

...

Projektkontingente verwalten

Wenn in Ihrem Kontingent weniger als 30 Projekte vorhanden sind, wird die Anzahl der im Kontingent verbleibenden Projekte in einer Meldung auf der Seite Neues Projekt angezeigt. Von Nutzern vorläufig gelöschte Projekte werden so lange auf Ihr Kontingent angerechnet, bis diese Projekte nach 30 Tagen vollständig gelöscht wurden.

Informationen zum Anfordern von weiteren Kapazitäten für Projekte in Ihrem Kontingent finden Sie auf der Supportseite zum Thema Erhöhung des Abrechnungskontingents anfordern. Weitere Informationen zu Kontingenten und den Gründen für ihre Nutzung finden Sie auf der Supportseite zum Thema Kostenlose Testprojektkontingente anfordern.

Projekte identifizieren

Damit Sie mit GCP-Ressourcen interagieren können, müssen Sie bei jeder Anfrage die Projektinformationen angeben. Ein Projekt lässt sich auf folgende Arten identifizieren:

  • Projektname: Der benutzerdefinierte Name, den Sie beim Erstellen des Projekts oder beim Aktivieren einer API, die das Erstellen einer Projekt-ID voraussetzt, ausgewählt haben. Der Projektname eines gelöschten Projekts kann nicht wiederverwendet werden.
  • Projekt-ID: Eine eindeutige Kennzeichnung für Ihr Projekt, bestehend aus dem Projektnamen und einer zufällig zugewiesenen Nummer.
  • Projektnummer: Eine Nummer, die automatisch vom Server generiert und dem Projekt zugewiesen wird.

So rufen Sie die Projekt-ID und die Projektnummer ab:

  1. Öffnen Sie in der GCP Console die Seite Dashboard.

    Seite "Dashboard" öffnen

  2. Klicken Sie oben auf der Seite auf die Drop-down-Liste Auswählen aus. Wählen Sie im angezeigten Fenster Auswählen aus Ihr Projekt aus.

Die Projekt-ID und die Projektnummer werden auf der Dashboardkarte Projektinformationen des Projekts angezeigt:

Eine Projekt-ID ist nicht dasselbe wie ein Projektname. Mit dem menschenlesbaren Projektnamen können Sie Projekte identifizieren, er wird aber nicht von den Google APIs verwendet. Der Projektname im oben aufgeführten Beispiel lautet My Sample Project und die Projekt-ID my-sample-project-191923.

Die Projekt-ID wird aus dem Projektnamen generiert, den Sie beim Erstellen des Projekts in der Google Cloud Platform Console eingeben. Bestimmte Wörter sind in Projekt-IDs nicht zulässig. Wenn Sie im Projektnamen nicht zulässige Wörter wie google oder ssl verwenden, sind diese Wörter in der generierten Projekt-ID nicht enthalten. Das hat keine Auswirkungen auf den Projektnamen.

Jede Projektnummer und Projekt-ID kommt in der Google Cloud Platform nur einmal vor. Wenn eine Projekt-ID einem anderen Nutzer gehört, können Sie diese nicht für Ihr Projekt verwenden.

Verwenden Sie in der Projekt-ID (oder im Ressourcennamen) keine vertraulichen Informationen.

Vorhandenes Projekt abrufen

Sie können ein vorhandenes Projekt über die GCP Console oder mit der Methode projects.get() abrufen.

Konsole

So zeigen Sie ein Projekt mithilfe der Google Cloud Platform Console an:

  1. Öffnen Sie in der Google Cloud Platform Console die Seite Dashboard.

    Seite "Dashboard" öffnen

  2. Klicken Sie oben auf der Seite auf die Drop-down-Liste Auswählen aus. Wählen Sie im angezeigten Fenster Auswählen aus Ihr Projekt aus.

gcloud

Verwenden Sie den Befehl gcloud projects describe, um die Metadaten für ein Projekt abzurufen:

gcloud projects describe PROJECT_ID

Dabei steht PROJECT_ID für die ID des Projekts, das Sie abrufen möchten.

API

Anfrage:

GET
https://cloudresourcemanager.googleapis.com/v1beta1/projects/our-project-123

Antwort:

{
    "projectNumber": "464036093014",
    "projectId": "our-project-123",
    "lifecycleState": "ACTIVE",
    "name": "my project",
    "labels": {
        "mylabel": "prod"
    },
    "createTime": "2016-01-07T21:59:43.314Z"
}

PYTHON

...
crm = discovery.build(
    'cloudresourcemanager', 'v1', http=creds.authorize(httplib2.Http()))

project = crm.projects().get(projectId=flags.projectId).execute()

...

Projekte auflisten

Über die GCP Console oder die Methode projects.list() können Sie alle Projekte auflisten, auf die Sie Zugriff haben.

Konsole

So listen Sie Projekte mit der Google Cloud Platform Console auf:

  • Wechseln Sie zur GCP Console.

    GCP Console aufrufen

  • Alle Ihre Projekte sind oben in der Leiste im Drop-down Projekte aufgelistet. Sie können die Projekte mit dem Textfeld Projekte und Ordner suchen filtern.
  • Wenn Sie alle Ihre Projekte auflisten möchten, klicken Sie auf Ressourcen verwalten. Sie können die Projekte mit dem Textfeld Nach Name, ID oder Label filtern filtern.

gcloud

Verwenden Sie den Befehl gcloud projects list, um alle Projekte aufzulisten, auf die Ihr derzeit aktives Konto Zugriff hat:

gcloud projects list

Dieser Befehl gibt die Projekt-ID, den Namen und die Projektnummer für jedes Projekt zurück, für das Sie die Berechtigungen "Inhaber", "Bearbeiter" oder "Betrachter" haben.

Mit dem Flag --filter können Sie die Ergebnisse eingrenzen. Dieses Flag durchsucht die Projekt-ID, den Namen und die Projektnummer nach dem Filterbegriff und gibt nur Ergebnisse zurück, die diesen Begriff enthalten:

gcloud projects list --filter=test

Der obige Befehl gibt alle Projekte zurück, für die Sie die Berechtigung "Inhaber", "Bearbeiter" oder "Betrachter" haben und in deren Feldern für den Namen, die Projekt-ID oder die Projektnummer außerdem das Wort "test" enthalten ist. Weitere Informationen zur Filtersyntax finden Sie unter gcloud topic filters.

API

Anfrage:

GET https://cloudresourcemanager.googleapis.com/v1beta1/projects

{
    "name": "project a"
}

Antwort:

{
    "projects": [
    {
        "projectNumber": "951040570662",
        "projectId": "google.com:api-project-951040570662",
        "lifecycleState": "ACTIVE",
        "name": "project a",
        "createTime": "2013-11-13T20:31:53.308Z"
    }
    ]
}

Im folgenden Code-Snippet werden alle Projekte mit einem roten Label aufgelistet:

Anfrage:

GET
https://cloudresourcemanager.googleapis.com/v1beta1/projects

{
    "labels": {
    "color": "red"
    }
}

Antwort:

{
    "projects": [
    {
        "projectNumber": "350831539566",
        "projectId": "my-project-b",
        "lifecycleState": "ACTIVE",
        "name": "project b",
        "labels": {
            "color": "red"
        },
        "createTime": "2012-02-18T23:11:57.831Z"
    }
    ]
}

PYTHON

...
crm = discovery.build(
    'cloudresourcemanager', 'v1', http=creds.authorize(httplib2.Http()))

filter = "name:project a"
projects = crm.projects().list(filter=filter).execute()

...

Im folgenden Code-Snippet werden alle Projekte mit einem roten Label aufgelistet:

filter = 'labels.color:red'
projects = crm.projects().list(filter=filter).execute()

Projekte aktualisieren

Sie können Projekte über die GCP Console oder mit der Methode projects.update() aktualisieren. Derzeit können nur der Projektname und die Labels aktualisiert werden. Sie können den Projekt-ID-Wert, den Sie mit dem gcloud-Befehlszeilentool oder API-Anforderungen verwenden, nicht ändern. Weitere Informationen zum Aktualisieren von Projekten finden Sie auf der Referenzseite der Projekt-API.

Konsole

So aktualisieren Sie die Projektfelder über die GCP Console:

  • Öffnen Sie die Seite "Einstellungen" in der Google Cloud Platform Console.

    Seite "Einstellungen" öffnen

  • Klicken Sie oben auf dem Bildschirm auf die Drop-down-Liste für die Projektauswahl.
  • Klicken Sie im angezeigten Fenster Auswählen aus auf die Drop-down-Liste "Organisation" und wählen Sie Ihre Organisation aus.
  • Wählen Sie das Projekt aus der angezeigten Liste aus.
  • Wenn Sie den Projektnamen ändern möchten, bearbeiten Sie den Eintrag im Feld Projektname und klicken Sie dann auf Speichern.
  • Klicken Sie links im Navigationsbereich auf Labels, um Labels zu ändern. Weitere Informationen finden Sie unter Labels verwenden.

gcloud

Verwenden Sie den Befehl gcloud projects update, um den Namen eines Projekts zu aktualisieren:

gcloud projects update PROJECT_ID --name=NAME

Dabei steht PROJECT_ID für die ID des Projekts, das Sie aktualisieren möchten, und NAME für den neuen Namen, der dem Projekt zugewiesen werden soll.

API

So aktualisieren Sie ein Projekt:

  • Rufen Sie das Objekt project mit der Methode projects.get() ab.
  • Ändern Sie das Feld, das Sie aktualisieren möchten.
  • Aktualisieren Sie das Objekt project mit der Methode projects.update().

Im folgenden Code-Snippet wird der Name des Projekts in "myproject" geändert:

Anfrage:

    PUT https://cloudresourcemanager.googleapis.com/v1beta1/projects/my-project-123
    {
        "name": "myproject"
    }

Antwort:

    {
        "projects": [
        {
            "projectNumber": "951040570662",
            "projectId": "my-project-123",
            "lifecycleState": "ACTIVE",
            "name": "myproject",
            "createTime": "2013-11-13T20:31:53.308Z"
        }
        ]
    }

PYTHON

...
crm = discovery.build(
    'cloudresourcemanager', 'v1', http=creds.authorize(httplib2.Http()))

project = crm.projects().get(projectId=flags.projectId).execute()
project['name'] = 'myproject'
project = crm.projects().update(
projectId=flags.projectId, body=project).execute()

...

Projekte beenden (löschen)

Sie können Projekte über die GCP Console oder mit der Methode projects.delete() beenden.

Mit dieser Methode wird ein zu löschendes Projekt umgehend markiert und eine E-Mail-Benachrichtigung an den Projektinhaber gesendet. Projekte, die zum Löschen markiert sind, können nicht verwendet werden. Nach ungefähr 30 Tagen wird das Projekt vollständig gelöscht. Wenn Sie diesen Vorgang während des Zeitraums von 30 Tagen beenden möchten, lesen Sie die Schritte zum Wiederherstellen eines Projekts.

Am Ende des Zeitraums von 30 Tagen werden das Projekt und alle zugehörigen Ressourcen unwiderruflich gelöscht. Bis zur Löschung wird das Projekt auf Ihr Projektkontingent angerechnet.

Wenn Sie für ein Projekt die Abrechnung eingerichtet haben, wird es möglicherweise erst dann vollständig gelöscht, wenn der aktuelle Abrechnungszeitraum abgelaufen ist und Ihr Konto erfolgreich belastet wurde. Außerdem können sich Anzahl und Art der genutzten Dienste darauf auswirken, wann ein Projekt endgültig aus dem System gelöscht wird. Weitere Informationen zum Aufbewahren und sicheren Löschen von Daten finden Sie unter So speichert Google die erfassten Daten.

Für das Beenden eines Projekts müssen folgende Voraussetzungen erfüllt sein:

  • Es darf kein Rechnungskonto mit dem Projekt verknüpft sein.
  • Das Projekt muss den Lebenszyklusstatus ACTIVE haben.

Konsole

So beenden Sie ein Projekt über die GCP Console:

  • Öffnen Sie die Seite "Einstellungen" (unter "IAM & Verwaltung") in der Google Cloud Platform Console.

    Seite "Einstellungen" öffnen

  • Klicken Sie auf Projekt auswählen.

  • Wählen Sie ein Projekt aus, das Sie löschen möchten, und klicken Sie auf Öffnen.

  • Klicken Sie auf Beenden.

  • Geben Sie die Projekt-ID ein und klicken Sie anschließend auf Beenden.

gcloud

Verwenden Sie den Befehl gcloud projects delete, um ein Projekt zu löschen:

gcloud projects delete PROJECT_ID

Dabei steht PROJECT_ID für die ID des Projekts, das Sie löschen möchten.

API

Mit dem folgenden Code-Snippet wird das angegebene Projekt gelöscht:

Anfrage:

DELETE
https://cloudresourcemanager.googleapis.com/v1beta1/projects/my-project-123

PYTHON

...
crm = discovery.build(
    'cloudresourcemanager', 'v1', http=creds.authorize(httplib2.Http()))

project = crm.projects().delete(projectId=flags.projectId).execute()

...

Projekt wiederherstellen

Projektinhaber können ein gelöschtes Projekt innerhalb der 30-tägigen Wiederherstellungsfrist wiederherstellen, die mit dem Beenden des Projekts beginnt. Durch die Wiederherstellung wird das Projekt in seinen Zustand vor der Beendigung zurückversetzt. Cloud Storage-Ressourcen werden vor Ablauf der 30-tägigen Frist gelöscht und sind unter Umständen nicht vollständig wiederherstellbar.

Einige Dienste müssen möglicherweise manuell neu gestartet werden. Weitere Informationen finden Sie unter Google Cloud Platform-Dienste neu starten.

So stellen Sie ein Projekt wieder her:

  1. Rufen Sie in der Google Cloud Platform Console die Seite Ressourcen verwalten auf.

    Weiter zur Seite "Ressourcen verwalten"

  2. Wählen Sie links oben im Drop-down-Menü Organisation Ihre Organisation aus.

  3. Klicken Sie unter der Liste der Projekte auf Zum Löschen vorgemerkte Ressourcen.

  4. Klicken Sie auf das Kästchen für das wiederherzustellende Projekt und dann auf Wiederherstellen. Bestätigen Sie im daraufhin angezeigten Dialogfeld, dass Sie das Projekt wiederherstellen möchten.

Hat Ihnen diese Seite weitergeholfen? Teilen Sie uns Ihr Feedback mit:

Feedback geben zu...

Dokumentation zu Resource Manager