Projekte ansehen und aktualisieren

Auf dieser Seite wird erläutert, wie Sie Projektmetadaten abrufen und vorhandene Projekteinstellungen ändern. Sie können auch in Ihrer Ressourcenhierarchie nach bestimmten Projekten suchen, die einen bestimmten Status oder Anzeigenamen haben.

Projektnamen, -nummer und -ID finden

Damit Sie mit Google Cloud Ressourcen interagieren können, müssen Sie bei jeder Anfrage die Projektinformationen angeben. Ein Projekt wird durch seine Projekt-ID und Projektnummer identifiziert.

Console

Rufen Sie in der Google Cloud Console die Seite Willkommen auf.
Zur Begrüßungsseite
Wählen Sie oben auf der Seite in der Projektauswahl Ihr Projekt aus.

Hinweis :In der Projektauswahl können bis zu 4.000 Ressourcen angezeigt werden. Wenn eine Ressource, die angezeigt werden sollte, nicht zu sehen ist, rufen Sie die Seite Ressourcen verwalten auf und filtern Sie die Liste nach dem Namen der Ressource.

Der Projektname, die Projektnummer und die Projekt-ID werden nach der Überschrift Willkommen angezeigt.

Vorhandenes Projekt abrufen

Wenn Sie die detaillierten Metadaten eines bestimmten Google Cloud Projekts abrufen möchten, z. B. den Lebenszyklusstatus, die Erstellungszeit und die übergeordnete Ressource des Projekts, verwenden Sie die Google Cloud CLI oder die API.

Sie benötigen den Status „Projektinhaber“ oder die Berechtigungen der Rolle „Browser“ (roles/browser), um auf Projektdetails zuzugreifen.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

PROJECT_ID: die Google Cloud Projekt-ID

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud projects describe PROJECT_ID

Windows (PowerShell)

gcloud projects describe PROJECT_ID

Windows (cmd.exe)

gcloud projects describe PROJECT_ID

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: die Google Cloud Projekt-ID

HTTP-Methode und URL:

GET https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID

JSON-Text der Anfrage:

{}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Alle Projekte unter einer Ressource auflisten

Verwenden Sie zum Auflisten aller Projekte, die direkt einer Ressource untergeordnet sind, die v3-Methode projects.list und geben Sie die übergeordnete Ressource in der Abfrage an:

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

FOLDER_ID: die Google Cloud Ordner-ID

HTTP-Methode und URL:

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

JSON-Text der Anfrage:

{
    "parent": "folders/662951040570"
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Projekte suchen

Wenn Sie Projekte suchen möchten, die bestimmten Kriterien entsprechen, z. B. einem Anzeigenamenpräfix oder einem bestimmten Lebenszyklusstatus, verwenden Sie die Methode projects.search oder den Befehl gcloud alpha resource-manager projects search.

Der Suchbereich umfasst alle Projekte, für die Sie die Berechtigung resourcemanager.projects.get haben.

Abfragesyntax

Sie können Ihre Suche mit dem Flag --query (gcloud) oder dem Parameter query (API) filtern. Zu den häufigsten Suchfiltern gehören:

displayName: der benutzerfreundliche Name des Projekts.
state: Der Lebenszyklusstatus des Projekts, z. B. ACTIVE oder DELETE_REQUESTED
parent.type und parent.id: Ergebnisse werden nach einer bestimmten Organisation oder einem bestimmten Ordner gefiltert.

Berechtigungen

Wenn Sie in der Abfrage ein übergeordnetes Element angeben (z. B. parent:folders/123), benötigen Sie die Berechtigung resourcemanager.projects.list für dieses übergeordnete Element. Wenn Sie diese Berechtigung haben, werden alle Projekte unter dem übergeordneten Element zurückgegeben, nachdem die verbleibenden Filter angewendet wurden.

Wenn Sie diese Berechtigung nicht haben, werden alle Projekte, für die Sie die Berechtigung resourcemanager.projects.get haben, zurückgegeben, nachdem die verbleibenden Filter angewendet wurden.

Wenn Sie kein übergeordnetes Element angeben, enthalten die Ergebnisse alle Projekte, für die Sie die Berechtigung resourcemanager.projects.get haben.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

PROJECT_ID: die Google Cloud Projekt-ID

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud alpha projects search --query="name:z*"

Windows (PowerShell)

gcloud alpha projects search --query="name:z*"

Windows (cmd.exe)

gcloud alpha projects search --query="name:z*"

Sie sollten eine Antwort ähnlich der folgenden erhalten:

The response contains the projects with names starting with 'z'

REST

HTTP-Methode und URL:

GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain

JSON-Text der Anfrage:

{}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
      "projects": [
        {
          "name": "projects/951040570662",
          "parent": "folders/662951040570",
          "projectId": "tokyo-rain-123",
          "state": "ACTIVE",
          "displayName": "Tokyo Rain",
          "createTime": "2013-11-13T20:31:53.308Z",
          "updateTime": "2013-11-13T20:31:53.308Z",
          "etag": "BwWUlZ6XEfY="
        }
      ]
}

Projekte aktualisieren

Sie können den Projektnamen, die Labels und die Tags ändern. Weitere Informationen zum Aktualisieren von Projekten finden Sie auf der Referenzseite der Projekt-API. Verwenden Sie eine der folgenden Methoden, um Projekte zu aktualisieren:

Console

So aktualisieren Sie den Namen oder die Labels eines Projekts über dieCOMMENTConsole:

Rufen Sie in der Google Cloud Console die Seite Einstellungen unter „IAM & Verwaltung“ auf.
Weiter zur Seite „IAM & Verwaltung“

Die verbleibenden Schritte werden in der Google Cloud Console angezeigt.
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. Wenn Sie eine kostenlose Testversion nutzen, überspringen Sie diesen Schritt, da die Organisationsliste nicht angezeigt wird.
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.
Wenn Sie Tags hinzufügen oder bearbeiten möchten, rufen Sie den Abschnitt Tags auf der Seite auf und klicken Sie auf Tags verwalten. Informationen zum Hinzufügen oder Aktualisieren von Tag-Schlüsseln und ‑Werten finden Sie unter Tags erstellen und verwalten.
Wenn Sie Labels ändern möchten, klicken Sie im linken Navigationsbereich auf Labels.
Weitere Informationen zum Verwenden von Labels

gcloud

Aktivieren Sie Cloud Shell in der Google Cloud Console.

Cloud Shell aktivieren

Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.
Verwenden Sie den Befehl gcloud alpha projects update, um den Namen oder die Labels eines Projekts zu aktualisieren:
```
gcloud alpha projects update PROJECT_ID \
   --name=NAME \
   --update-labels=KEY=VALUE, ...
```
Ersetzen Sie Folgendes:
- PROJECT_ID: Die ID des Projekts, das Sie aktualisieren möchten.
- NAME: der neue Name, den Sie dem Projekt zuweisen möchten.
- KEY: Der Schlüssel eines Labels, das Sie aktualisieren möchten.
- VALUE: Der Wert eines Labels, das Sie aktualisieren möchten.
Weitere Informationen und zusätzliche Flags, die mit diesem Befehl verwendet werden können, finden Sie im Google Cloud CLI SDK.

REST

So aktualisieren Sie ein Projekt:

Rufen Sie das Objekt project mit der Methode projects.get ab.
Ändern Sie die Felder, die Sie aktualisieren möchten.
Rufen Sie die Methode projects.patch auf.

Im folgenden Beispiel wird der Anzeigename des Projekts in myproject geändert und das Label color auf red festgelegt:

Anfrage:

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NUMBER?updateMask=displayName,labels

Dabei ist PROJECT_NUMBER die numerische ID des Projekts, das Sie aktualisieren möchten.

JSON-Text der Anfrage:

{
  "displayName": "myproject",
  "labels": {
    "color": "red"
  }
}

Response:

{
  "projects": [
    {
      "name": "projects/951054970012",
      "parent": "folders/662951040570",
      "projectId": "Osaka-rain-234",
      "state": "ACTIVE",
      "displayName": "myproject",
      "createTime": "2013-11-13T20:31:53.308Z",
      "updateTime": "2013-11-13T20:35:42.308Z",
      "etag": "BwWUlZ6XEfY=",
      "labels": {
        "color": "red"
      }
    }
  ]
}

Projekte ansehen und aktualisieren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Projektnamen, -nummer und -ID finden

Console

Vorhandenes Projekt abrufen

gcloud

Linux, macOS oder Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Alle Projekte unter einer Ressource auflisten

REST

curl

PowerShell

Projekte suchen

gcloud

Linux, macOS oder Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Projekte aktualisieren

Console

gcloud

REST

Nächste Schritte

Projekte ansehen und aktualisieren