Projekte erstellen und verwalten

Google Cloud-Projekte bilden die Grundlage für das Erstellen, Aktivieren und Nutzen aller Google Cloud-Dienste, einschließlich des Verwaltens von APIs, des Aktivierens der Abrechnung, des Hinzufügens und Entfernens von Mitarbeitern und des Verwaltens von Berechtigungen für Google Cloud-Ressourcen.

Auf dieser Seite wird erläutert, wie Sie Google Cloud-Projekte mit der Resource Manager API und der Google Cloud Console erstellen und verwalten.

Vorbereitung

Lesen Sie die Informationen zur Projektressource unter Ressourcenhierarchie.

Folgendes wird zum Identifizieren Ihres Projekts verwendet:

  • Projektname: ein von Menschen lesbarer Name für das Projekt

    Der Projektname wird von den Google APIs nicht verwendet. Sie können den Projektnamen während oder nach der Projekterstellung bearbeiten. Projektnamen müssen nicht eindeutig sein.

  • Projekt-ID: eine anpassbare, nur einmal vorkommende Kennzeichnung für das Projekt

    Die standardmäßige Projekt-ID setzt sich aus dem Projektnamen und einer zufällig zugewiesenen Zahl zusammen. Sie können die Projekt-ID nur während der Projekterstellung anpassen.

    Einige Wörter sind in Projekt-IDs nicht zulässig. Wenn Sie im Projektnamen nicht zulässige Wörter wie google oder ssl verwenden, enthält die generierte Projekt-ID diese Wörter nicht.

  • Projektnummer: eine automatisch generierte eindeutige ID für das Projekt

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

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

Projekt erstellen

Zum Erstellen eines Projekts benötigen Sie die Berechtigung resourcemanager.projects.create. 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.

Wenn Sie die übergeordnete Ressource nicht angeben, wird automatisch anhand der Domain des Nutzerkontos eine übergeordnete Ressource ausgewählt.

Sie können mit der Cloud Console, dem gcloud-Befehlszeilentool oder der Methode projects.create() ein neues Projekt erstellen.

Console

So erstellen Sie ein neues Projekt:

  1. Öffnen Sie in der Cloud Console die Seite Ressourcen verwalten:
    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 zum Erstellen eines neuen Projekts den Befehl gcloud projects create:

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.

Wenn Sie ein Projekt mit einer übergeordneten Organisation oder einem übergeordneten Ordner erstellen möchten, verwenden Sie das Flag --organization bzw. --folder. 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 mit der Methode projects.create() ein neues Projekt erstellen, können Sie in der Projekt-ID bestimmte Wörter nicht verwenden. Beispiele hierfür 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()

...

Projekt mithilfe eines Dienstkontos erstellen

Sie können ein Dienstkonto verwenden, um die Projekterstellung zu automatisieren. Wie Nutzerkonten kann auch Dienstkonten die Berechtigung zum Erstellen von Projekten innerhalb einer Organisation gewährt werden. Dienstkonten können keine Projekte außerhalb einer Organisation erstellen und müssen beim Erstellen eines Projekts die übergeordnete Ressource angeben. Dienstkonten können mit dem gcloud-Tool oder der Methode projects.create() ein neues Projekt erstellen.

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. Wenn Sie das Projektlimit erreicht haben, müssen Sie zum Erstellen von weiteren Projekten eine Erhöhung des Projektlimits beantragen. Es besteht aber auch die Möglichkeit, auf der Seite Ressourcen verwalten das Löschen einiger Projekte nach 30 Tagen zu planen. Von Nutzern vorläufig gelöschte Projekte werden auf Ihr Kontingent angerechnet. Diese Projekte werden nach 30 Tagen vollständig gelöscht.

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 Google Cloud-Ressourcen interagieren können, müssen Sie bei jeder Anfrage die Projektinformationen angeben. Ein Projekt wird anhand seiner Projekt-ID und Projektnummer identifiziert.

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

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

    Zur Seite "Dashboard"

  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 Dashboard-Karte Project info (Projektinformationen) des Projekts angezeigt:

Im obigen Beispiel lautet der Projektname My Sample Project und die Projekt-ID my-sample-project-191923.

Vorhandenes Projekt abrufen

Sie können ein vorhandenes Projekt mithilfe der Cloud Console oder der Methode projects.get() abrufen.

Console

So rufen Sie ein Projekt mit der Google Cloud Console auf:

  1. Wechseln Sie in der Google Cloud Console zur Seite Dashboard.

    Zur Seite "Dashboard"

  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 ist PROJECT_ID die ID des Projekts, das Sie aufrufen 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

Mit der Cloud Console oder der Methode projects.list() können Sie alle Projekte auflisten, auf die Sie Zugriff haben.

Console

So listen Sie Projekte mit der Google Cloud Console auf:

  • Wechseln Sie zur Cloud Console.

    Zur Cloud Console

  • 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.

Wenn Sie einen Filter angeben, der die Felder parent.type und parent.id enthält, ist die Berechtigung resourcemanager.projects.list für das übergeordnete Element aktiviert. Wenn der Nutzer diese Berechtigung hat, werden alle Projekte unter dem übergeordneten Element zurückgegeben, nachdem die verbleibenden Filter angewendet wurden.

Wenn dem Nutzer diese Berechtigung fehlt, werden alle Projekte, für die der Nutzer die Berechtigung resourcemanager.projects.get hat, zurückgegeben, nachdem die verbleibenden Filter angewendet wurden.

Wenn kein Filter angegeben wurde, gibt der Aufruf die Projekte zurück, für die der Nutzer die resourcemanager.projects.get-Berechtigung hat.

Weitere Informationen zur Filtersyntax finden Sie unter gcloud topic filters.

API

Sie können Felder in den Text Ihrer Anfrage aufnehmen, um bestimmte Projektressourcen zurückzugeben, die dem Filter entsprechen und für die Ihnen die Rolle "Inhaber", "Bearbeiter" oder "Betrachter" zugewiesen wurde.

Das folgende Code-Snippet gibt die Projektressource mit dem Namen "project a" zurück:

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"
    }
    ]
}

Das folgende Code-Snippet gibt alle Projektressourcen mit einem roten Label zurück:

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"
    }
    ]
}

Wenn Sie im Anfragetext die Felder parent.type und parent.id angeben, ist die Berechtigung resourcemanager.projects.list für das übergeordnete Element aktiviert. Wenn der Nutzer diese Berechtigung hat, werden alle Projekte unter dem übergeordneten Element zurückgegeben, nachdem die verbleibenden Filter angewendet wurden.

Wenn dem Nutzer diese Berechtigung fehlt, werden alle Projekte, für die der Nutzer die Berechtigung resourcemanager.projects.get hat, zurückgegeben, nachdem die verbleibenden Filter angewendet wurden.

Wenn kein Filter angegeben wurde, gibt der Aufruf die Projekte zurück, für die der Nutzer die resourcemanager.projects.get-Berechtigung hat.

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 mithilfe der Cloud Console oder 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 mit API-Anfragen verwenden, nicht ändern. Weitere Informationen zum Aktualisieren von Projekten finden Sie auf der Referenzseite der Projekt-API.

Console

So aktualisieren Sie das Feld eines Projekts mithilfe der Cloud Console:

  • Öffnen Sie in der Google Cloud Console die Seite mit den Einstellungen.

    Zur Seite "Einstellungen"

  • 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.
  • Um den Projektnamen zu ändern, 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 ist PROJECT_ID die ID des Projekts, das Sie aktualisieren möchten, und NAME der neue Name, den Sie dem Projekt zuweisen möchten.

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 mithilfe der Cloud Console oder der Methode projects.delete() beenden. Ein Projekt muss den Lebenszyklusstatus ACTIVE haben, um auf diese Weise beendet zu werden.

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. Wenn mit dem Projekt ein Rechnungskonto verknüpft ist, wird diese Verknüpfung aufgehoben und auch dann nicht wiederhergestellt, wenn der Vorgang zum Löschen des Projekts sofort abgebrochen wird. 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 zum Löschen 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.

Projekt beenden:

Console

So beenden Sie ein Projekt mithilfe der Cloud Console:

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

    Zur Seite "Einstellungen"

  • 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

Um ein Projekt zu löschen, verwenden Sie den Befehl gcloud projects delete:

gcloud projects delete PROJECT_ID

Dabei ist PROJECT_ID 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. Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten.

    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.